Planning Sessions

In der Planung scheitern die meisten Projekte. Nicht wegen fehlender Ideen oder Talente, sondern weil Teams direkt mit dem Bauen beginnen, ohne Annahmen zu prüfen, den Umfang zu hinterfragen oder die Risiken vor ihnen zu erkennen.

Planning Sessions in Almirant sind kein Tool zur Aufgabenerzeugung. Sie sind dein KI-Sparringspartner, der dich herausfordert, hinterfragt und dazu zwingt, nachzudenken, bevor du eine einzige Codezeile schreibst.

Was sind Planning Sessions

Eine Planning Session ist ein mehrteiliger Dialog mit der KI. Sie ist kein einzelner Prompt, der eine Item-Liste erzeugt, sondern ein iterativer Dialog, in dem die KI als Sparringspartner jede deiner Entscheidungen hinterfragt:

• Hinterfragt Annahmen, die du für selbstverständlich hältst.
• Identifiziert Risiken in deiner Planung.
• Schlägt Alternativen vor, die du nicht berücksichtigt hast.
• Verfeinert den Umfang, sodass klar ist, was dazugehört und was nicht.

Das Ergebnis ist nicht nur eine Liste von Work Items, sondern ein validierter Umfang und hinterfragte Annahmen.

Dein Sparringspartner, kein Generator

Der Unterschied ist grundlegend. Ein Generator nimmt deinen Input und erzeugt Output. Ein Sparringspartner hinterfragt deinen Input. Er fragt dich warum, welche Alternativen du berücksichtigt hast und wo die Risiken liegen.

Sitzung starten

1. Öffne im Projekt, in dem du planen möchtest, die Route /plan.
2. Wähle das Ziel-Board, in dem die resultierenden Work Items erstellt werden.
3. Wähle optional Seeds für die Ideenfindung, um ersten Kontext beizusteuern.
4. Schreibe deine erste Nachricht, die beschreibt, was du erreichen möchtest.
5. Starte den Dialog.

Sitzungstitel

Beim Start kannst du der Sitzung einen aussagekräftigen Titel geben. Er hilft dir, die Sitzung im Verlauf zu identifizieren. Beispiele:

• "OAuth-Authentifizierung planen"
• "Datenbankmigration analysieren"
• "Benachrichtigungssystem entwerfen"

Gesprächsablauf

Die Sitzung folgt einem natürlichen Dialogablauf:

1. Du stellst deine Idee vor

Du beschreibst, was du erreichen willst. Du musst nicht alles klar haben: Genau dafür ist der Sparringspartner da.

2. Die KI hinterfragt

Statt sofort Items zu erzeugen, stellt die KI Fragen:

• Warum ist das notwendig?
• Welche Alternativen hast du berücksichtigt?
• Wo liegen die blinden Flecken?
• Was passiert, wenn das fehlschlägt?

3. Du verteidigst oder überdenkst

Du beantwortest die Fragen. Manchmal verteidigst du deine Position, manchmal erkennst du, dass es einen besseren Ansatz gibt.

4. Der Umfang wird verfeinert

Mit jeder Iteration wird der Umfang klarer. Die KI versteht deinen Kontext besser und du verstehst die Risiken besser.

5. Work Items erzeugen

Wenn der Umfang validiert ist, erzeugt die KI strukturierte Work Items: Epics, Features, Stories und Tasks mit Definitionen für die Fertigstellung.

6. Prüfen und annehmen

Du prüfst jedes vorgeschlagene Item. Du nimmst passende an und lehnst unpassende ab. Angenommene Items werden automatisch im ausgewählten Board erstellt.

Sitzungsphasen

Jede Sitzung durchläuft Phasen, die du in der Oberfläche sehen kannst:

Phase	Beschreibung
idle	Wartet darauf, dass du den Dialog startest
booting	Bereitet Sitzung und Kontext vor
chatting	Tauscht Nachrichten mit der KI aus
streaming	Empfängt Antwort in Echtzeit
thinking	Die KI verarbeitet und schlussfolgert (Thinking-Modus aktiv)
waiting_for_answer	Die KI wartet auf deine Antwort auf eine Frage
reviewing	Prüft vorgeschlagene Items zum Annehmen oder Ablehnen
completed	Sitzung mit erstellten Items abgeschlossen
paused	Sitzung pausiert, um sie später fortzusetzen

Seeds für die Ideenfindung auswählen

Vor dem Start des Dialogs kannst du Seeds auswählen: zuvor in Almirant erfasste Ideen, die als Ausgangspunkt dienen. Seeds liefern der Sitzung ersten Kontext:

• Gespeicherte Brainstorming-Notizen.
• Ideen aus früheren Sitzungen.
• Anforderungen aus Gesprächen mit Stakeholdern.
• Verarbeitetes Benutzerfeedback.

Wenn du Seeds auswählst, analysiert die KI sie als Teil des ersten Kontexts und ermöglicht so eine fundiertere Planung.

Seeds auswählen

1. Auf dem Startbildschirm der Sitzung siehst du den Abschnitt Verfügbare Seeds.
2. Markiere die für diese Planung relevanten Seeds.
3. Die ausgewählten Seeds werden in den ersten Sitzungskontext aufgenommen.

Das Feld seedsProcessed im Sitzungsergebnis gibt an, wie viele Seeds analysiert wurden.

Work Items erzeugen

Sobald der Dialog einen Punkt erreicht, an dem der Umfang klar ist, erstellt die KI einen Vorschlag strukturierter Work Items.

Typen erzeugter Items

Typ	Beschreibung
Epic	Große Initiative, die mehrere Features gruppiert
Feature	Konkrete Funktionalität, die Wert liefert
Story	User Story mit Akzeptanzkriterien
Task	Spezifische, umsetzbare technische Aufgabe

Struktur jedes Items

Jedes vorgeschlagene Item enthält:

• Einen aussagekräftigen, umsetzbaren Titel.
• Eine detaillierte Beschreibung mit Kontext.
• Eine vorgeschlagene Priorität (urgent, high, medium, low).
• Die Hierarchie (parentTempId bezeichnet das Eltern-Item).
• Die Herkunft (fromSeedId, wenn es von einem bestimmten Seed stammt).

Prüfen und annehmen

In der Prüfphase kannst du:

• Einzelne Items annehmen.
• Nicht passende Items ablehnen.
• Alle annehmen, wenn dich der vollständige Vorschlag überzeugt.

Angenommene Items werden automatisch im ausgewählten Board erstellt und behalten die vorgeschlagene Hierarchie bei.

Sitzungsverlauf

Alle Sitzungen werden automatisch gespeichert und können später aufgerufen werden:

Status	Beschreibung
active	Laufende Sitzung. Du kannst den Dialog fortsetzen.
completed	Abgeschlossene Sitzung. Items wurden im Board erstellt.
archived	Sitzung für künftige Referenz gespeichert.

Über den Verlauf kannst du:

• Den vollständigen Dialog jeder Sitzung ansehen.
• Die erstellten Items einsehen.
• Eine archivierte Sitzung reaktivieren und fortsetzen.

Kosten-Tracking

Jede Sitzung erfasst Nutzungsmetriken, damit du deinen Quotenverbrauch optimieren kannst:

Metrik	Beschreibung
totalInputTokens	An die KI gesendete Tokens
totalOutputTokens	Von der KI empfangene Tokens
estimatedCost	Geschätzte Kosten der Sitzung
durationMs	Gesamtdauer der Sitzung

Diese Metriken helfen dir zu verstehen, wie viel jede Sitzung verbraucht, und deine KI-Quote zu optimieren.

Sitzungskonfiguration

Jede Sitzung kann eine eigene Konfiguration haben:

Feld	Beschreibung
model	Zu verwendendes KI-Modell (e.g., claude-3-opus)
provider	KI-Anbieter (anthropic, openai, etc.)
systemPrompt	Benutzerdefinierter System-Prompt
temperature	Temperatur für die Generierung (0.0 - 1.0)

Die Standardkonfiguration stammt aus den Organisationseinstellungen, kann aber für bestimmte Sitzungen angepasst werden.

Antwortmodi

Die KI kann je nach Komplexität dessen, was du besprichst, in verschiedenen Modi arbeiten:

Streaming

Du siehst die Antwort während sie erzeugt wird. Ideal für schnelle Iteration und flüssigen Dialog.

Thinking

Die KI schlussfolgert vor der Antwort Schritt für Schritt. Besser für komplexe Probleme, bei denen du eine tiefgehende Analyse benötigst.

Du kannst während der Sitzung zwischen den Modi wechseln.

Effektive Prompts schreiben

Deine erste Nachricht ist wichtig. Hier sind Beispiele für gute Ausgangspunkte:

Gute Ausgangspunkte

Prompt	Warum er funktioniert
"Ich möchte Social Login hinzufügen, weiß aber nicht, ob sich der Aufwand gegenüber Magic Links lohnt"	Fordert die KI auf, Alternativen zu vergleichen
"Ich muss die Leistung der Produktliste verbessern, Benutzer beschweren sich über Langsamkeit"	Definiert das tatsächliche Problem, nicht die angenommene Lösung
"Wir müssen von REST zu GraphQL migrieren, das Team sagt, es sei besser, aber ich bin nicht überzeugt"	Schafft Raum, die Entscheidung zu hinterfragen

Vermeiden

Prompt	Problem
"Erzeuge Tasks für Authentifizierung"	Schließt den Dialograum und fordert direkten Output
"Erstelle ein Benutzer-CRUD"	Kein zu lösendes Problem, nur Mechanik
"Verbessere das ganze System"	Ohne Fokus, unmöglich zu hinterfragen

Voraussetzungen

Für Planning Sessions benötigst du:

• Einen konfigurierten KI-Anbieter mit gültigem API-Key.
• Verfügbare Quote in deiner Organisation.
• Ein Projekt mit mindestens einem aktiven Board, in dem die Items erstellt werden.

Für Entwickler

Datenstruktur

Die Sitzung wird mit folgenden Hauptfeldern gespeichert:

Feld	Typ	Beschreibung
id	uuid	Eindeutige Kennung
organizationId	text	Eigentümerorganisation
projectId	uuid	Zugeordnetes Projekt
boardId	uuid	Board, in dem Items erstellt werden
title	text	Titel der Sitzung
status	enum	active, completed, archived
config	json	model, provider, systemPrompt, temperature
result	json	summary, workItemsCreated, seedsProcessed

Sitzungsnachrichten

Jede Nachricht des Dialogs enthält:

Feld	Typ	Beschreibung
role	enum	user, assistant, system
content	text	Nachrichteninhalt
messageType	varchar	Nachrichtentyp
inputTokens	integer	Eingabe-Tokens
outputTokens	integer	Ausgabe-Tokens

MCP-Tools

Tool	Beschreibung	Wichtigste Parameter
record_ai_session	Zeichnet eine Planungssitzung auf	projectId, prompt, response, tokensUsed
get_ai_sessions	Ruft den Sitzungsverlauf eines Projekts ab	projectId, limit

Beispiel: Sitzung aufzeichnen

Tool: record_ai_session
Parameter:
  projectId: "uuid-del-proyecto"
  prompt: "Ich brauche ein Push-Benachrichtigungssystem"
  response: "Von der KI erzeugter Vorschlag..."
  tokensUsed: 1250

Zugriffsroute

Die Hauptroute für Planning Sessions ist /plan. Von dort kannst du neue Sitzungen starten, den Verlauf ansehen und pausierte Sitzungen fortsetzen.