Planung und Ausführung

Ein Planungs- und Ausführungsworkflow verteilt eine Arbeit auf zwei Rollen: eine Planungssitzung, die die Arbeit vorbereitet und prüft, und eine oder mehrere Ausführungssitzungen, die sie umsetzen. Dieses Kapitel beschreibt, wie Sie einen Workflow über das Menü oder aus einer Sitzung heraus starten, eine Aufgabenaufteilung prüfen, Arbeitsverzeichnisse wählen und den Fortschritt des Workflows verfolgen.

1. So läuft der Workflow ab

Ein Workflow hat zwei Rollen, die jeweils als eigene Sitzung in der Seitenleiste laufen:

• Planung und Prüfung. Die Planungssitzung untersucht die Aufgabe und das Projekt, formuliert den Auftrag für die Ausführungssitzung und prüft jedes Ergebnis. Sie fordert Korrekturen an, bis das Ergebnis akzeptabel ist, und nimmt es erst ab, nachdem sie die tatsächlichen Änderungen und die Nachweise der Überprüfung kontrolliert hat.
• Umsetzung. Die Ausführungssitzung setzt den Auftrag um und meldet das Ergebnis zurück. Korrekturen gehen an dieselbe Ausführungssitzung, die ihren Kontext von Runde zu Runde behält.

Die Ausführungssitzung erscheint in der Seitenleiste als Untersitzung der Planungssitzung. Beide Sitzungen laufen in der Gesprächsansicht. Nachrichten, die sich die Rollen gegenseitig senden, zeigen das Agentensymbol, den Sitzungsnamen und die Rolle des Absenders („Planung“ oder „Umsetzung“), sodass Sie den Austausch in beiden Gesprächen verfolgen können.

Beide Rollen benötigen einen Agenten, der die Gesprächsansicht unterstützt: Claude Code, Codex, OpenCode, Pi oder OMP. Planungs- und Ausführungssitzung dürfen unterschiedliche Agenten, Modelle und Einstellungen für den Denkaufwand verwenden.

Sie können jede der beiden Sitzungen jederzeit lesen, beantworten oder unterbrechen. Berechtigungsanfragen beider Rollen warten weiterhin auf Ihre Antwort.

2. Start über das Menü

Öffnen Sie das Kontextmenü eines Projekts, einer Gruppe oder einer Sitzung oder deren Untermenü „Neue Untersitzung“, und wählen Sie „Neue Planungs-/Ausführungssitzung…“. Der Dialog enthält:

• „Erstellen in“: wo die Planungssitzung erstellt wird. Die Ausführungssitzung entsteht unterhalb der Planungssitzung.
• „Aufgabenbeschreibung“: Beschreiben Sie Aufgabe, Anforderungen und Abnahmekriterien. Sie können Bilder einfügen; sie werden mit der Aufgabe der Planungssitzung und dem ersten Auftrag der Ausführungssitzung gesendet.
• „Automatisch in mehrere Aufgaben aufteilen“: siehe §4.
• „Planung und Prüfung“ und „Umsetzung“: Agent („Sitzungstyp“), „Modell“ und „Denkaufwand“ für jede Rolle. Die Auswahl für Modell und Denkaufwand richtet sich nach dem gewählten Agenten. Der Dialog merkt sich Ihre letzte Auswahl für jede Rolle.
• „Pfad zum Arbeitsverzeichnis“ und die Verzeichnisauswahl: siehe §5.

Wählen Sie „Erstellen und starten“, um die Planungssitzung zu starten. Sie erstellt die Ausführungssitzung, sobald der Plan steht. Das Öffnen oder Abbrechen des Dialogs erstellt nichts. Der Dialog hat eine eigene Adresse; Sie können also den Link kopieren, die Seite neu laden oder Zurück und Vorwärts verwenden, ohne ihn zu verlieren.

3. Start aus einer Sitzung

Führen Sie in einer beliebigen Sitzung, die VelaTerm gestartet hat, Folgendes aus:

vspawn --plan-execute \
  --plan-agent claude --plan-model opus --plan-effort high \
  --exec-agent codex --exec-model gpt-5.5 --exec-effort medium \
  "Implement the agreed changes and verify all acceptance criteria"

In Claude Code bewirkt /vspawn --plan-execute <task> dasselbe; in Codex verwenden Sie $vspawn --plan-execute <task>. Der Skill formuliert aus dem aktuellen Gespräch eine in sich geschlossene Aufgabe, bevor er den Workflow startet. Diese Skills erfordern Vela Skills (Einstellungen ▸ Allgemein).

Die neue Planungssitzung wird unterhalb der Sitzung erstellt, die den Befehl ausgeführt hat. Die Anfrage öffnet zuerst die Bestätigungskarte, die in Untersitzungen und Git-Zusammenarbeit §4 beschrieben ist; dort können Sie die Aufgabe und die Einstellungen beider Rollen prüfen und ändern.

Ohne ausdrücklich angegebenen Agenten verwendet eine Planungssitzung, die aus einer Sitzung mit Claude, Codex, OpenCode, Pi oder OMP gestartet wird, denselben Agenten; aus jeder anderen Sitzung heraus verwendet sie Claude Code. Ein Modell oder Denkaufwand, den der gewählte Agent nicht unterstützt, wird abgelehnt, bevor irgendetwas startet.

Die neuen Sitzungen sehen das auslösende Gespräch nicht. Nehmen Sie die bisher getroffenen Entscheidungen, bestehende Änderungen, Randbedingungen und den Ort, an dem das Ergebnis abgeliefert werden soll, in die Aufgabe auf.

4. Aufteilen in mehrere Aufgaben

Aktivieren Sie im Dialog „Automatisch in mehrere Aufgaben aufteilen“, oder ergänzen Sie vspawn --plan-execute um --split-tasks. Die Planungssitzung untersucht dann die Arbeit und schlägt zwischen 1 und 12 unabhängige Aufgaben vor. Keine Ausführungssitzung startet, bevor Sie die Aufgaben bestätigt haben.

Der Vorschlag öffnet den Dialog „Ausführungsaufgaben prüfen“:

• Wählen Sie eine Aufgabe in der Liste aus, um die Felder „Sitzungsname“, „Aufgabenbeschreibung“, Agent, „Modell“ und „Denkaufwand“ zu bearbeiten. Beim Wechsel zwischen Aufgaben bleiben Ihre Änderungen erhalten.
• „Aufgabe entfernen“ verwirft eine Aufgabe; „Entfernen rückgängig machen“ holt sie zurück. Mindestens eine Aufgabe muss übrig bleiben.
• Die Startschaltfläche („N Sitzungen starten“) erstellt eine Ausführungssitzung pro Aufgabe.
• Wenn Sie den Dialog schließen, wartet der Vorschlag weiter. Ein Link „Ausführungsaufgaben prüfen“ bleibt dann sichtbar, über den Sie ihn wieder öffnen. Wenn Sie den Vorschlag abbrechen, wird der Workflow beendet, ohne dass Ausführungssitzungen entstehen.
• Der Dialog hat eine eigene Adresse und bleibt beim Neuladen der Seite erhalten; noch nicht bestätigte Änderungen gehen beim Neuladen jedoch verloren.

Wird der Skill mit Aufgabenaufteilung verwendet, ergänzt er --yes, sodass nur diese abschließende Prüfung erscheint. In der Prüfung lassen sich die Einstellungen jeder Ausführungssitzung ändern, nicht aber die der Planungssitzung, die bereits läuft.

Eine einzige Planungssitzung erhält die Berichte aller Ausführungssitzungen und prüft jede Aufgabe einzeln, mit eigenen Korrekturrunden. Der Workflow als Ganzes ist erst abgeschlossen, wenn jede Aufgabe abgenommen wurde.

Teilen Sie die Arbeit so auf, dass die Aufgaben nicht dieselben Dateien bearbeiten. Jede Ausführungssitzung betreibt einen eigenen Agentenprozess; wählen Sie die Anzahl der Aufgaben daher mit Blick auf die Ressourcen des Rechners.

5. Arbeitsverzeichnisse und Worktrees

Die Verzeichnisauswahl gilt für jede Rolle im Workflow:

Neue Worktrees basieren auf dem aktuellen Commit und enthalten keine uncommitteten Änderungen. Kann ein Worktree nicht erstellt werden, startet die betroffene Sitzung nicht; sie weicht nicht auf ein anderes Verzeichnis aus. Auf der Kommandozeile bedeutet --worktree allein shared.

Die Ergebnisse bleiben in den Worktrees, bis Sie sie zusammenführen. Verwenden Sie „Git ▸ Merge…“ an einer Sitzung, um einen Branch zusammenzuführen (siehe Untersitzungen und Git-Zusammenarbeit §6). Der Workflow führt von sich aus weder Merges noch Pushes durch und löscht keine Worktrees.

6. Den Fortschritt verfolgen

• Das Planungsgespräch zeigt jeden Bericht und jede Korrektur, sobald sie eintreffen. Während Ausführungssitzungen arbeiten, wartet die Planungssitzung auf deren Berichte.
• vflow status <workflow-id> zeigt den Zustand eines Workflows, seine Aufgaben, Sitzungen und die aktuelle Runde. Die Workflow-ID erscheint in den Workflow-Nachrichten.
• vflow stop <workflow-id> beendet weitere Runden und fordert die laufenden Sitzungen zum Anhalten auf. Das Anhalten des gesamten Workflows hält alle seine Aufgaben an; das Anhalten einer einzelnen Aufgabe wirkt sich nicht auf die anderen aus.
• vstat zeigt, welche Sitzungen arbeiten, um eine Berechtigung bitten oder warten. Eine wartende Ausführungssitzung hat ihre Aufgabe nicht unbedingt abgeschlossen; maßgeblich ist allein die Abnahme durch die Planungssitzung.
• Beendet eine Rolle ihren Durchlauf, ohne die Arbeit weiterzugeben, ist der Workflow blockiert. Prüfen Sie das Gespräch, beantworten Sie, was nötig ist, und setzen Sie die Arbeit von der Planungssitzung aus fort.

Die Befehle sind in Sitzungsbefehle beschrieben.