Was macht Dev Cycle Orchestrator?
Orchestriere den vollständigen Entwicklungslebenszyklus: Brainstorming → Planung → Review → Issues → Implementierung → Code-Review → PR.
Abgrenzung: Wenn der Nutzer nur ein PRD möchte, leite zu /write-a-prd weiter. Wenn er nur einen Plan möchte, leite zu /prd-to-plan weiter. Dieser Skill ist für den vollständigen End-to-End-Lebenszyklus gedacht.
Die 7-Phasen-Pipeline
Jede Phase ist obligatorisch. Keine Phase darf übersprungen werden.
| # | Phase | Delegiert an | Gate-Bedingung |
|---|---|---|---|
| 1 | Brainstorming | write-a-prd | Issue-URL aufgezeichnet |
| 2 | Planung | prd-to-plan | Plan-Datei existiert unter docs/plans/ |
| 3 | CEO-Review | plan-ceo-review (empfehle HOLD SCOPE) | Review abgeschlossen, Benutzer stimmt zu |
| 4 | Issues | Orchestrator (Plan-Slices → GitHub-Issues) | Alle Issue-URLs aufgezeichnet |
| 5 | Implementierung | Orchestrator (tdd pro Issue, subagent-development) | Alle Issues gelöst, Tests bestehen |
| 6 | Code-Review | daa-code-review | Sauberes Review |
| 7 | PR | commit + github-cli | PR-URL aufgezeichnet |
Wiedereinstiegslogik
Bei jedem Aufruf:
Keine Argumente (/dev-cycle)
- Scanne
docs/dev-cycle/nach*.state.md-Dateien mitstatus: in_progress - Falls eine gefunden → frage: „{feature} fortsetzen (
{branch})? Derzeit bei {phase}.“ - Falls mehrere gefunden → liste sie mit Branchnamen auf, frage, welche fortgesetzt werden soll
- Falls keine gefunden → frage: „An welchem Feature arbeitest du?“ → starte Phase 1
Mit Argument (/dev-cycle {slug})
- Suche nach
docs/dev-cycle/{slug}.state.md - Gefunden → setze bei
current_phasefort - Nicht gefunden → erstelle Zustandsdatei, starte Phase 1
Slug-Kollision
Beim Erstellen einer neuen Zustandsdatei prüfe docs/dev-cycle/ auf vorhandene Slugs. Falls der Slug bereits existiert (abgebrochen oder abgeschlossen), hänge -2, -3 usw. an.
Kontextwiederherstellung bei Fortsetzung
Lade vor der Fortsetzung ALLE referenzierten Artefakte:
- Brainstorming:
gh issue viewfür das PRD-Issue - Planung: Lese Plan-Datei von der Festplatte
- CEO-Review: Lese die Plan-Datei (enthält Review-Überarbeitungen)
- Issues:
gh issue viewfür jedes Implementierungsissue - Implementierung: Überprüfe Git-Status auf Feature-Branch, überprüfe geschlossene Issues
Präsentiere Zusammenfassung: „{feature} bei {phase} fortsetzen. Hier haben wir aufgehört: …“
Phasenausführung
Phase 1: Brainstorming
Rufe write-a-prd auf. Vertraue dem internen Ablauf des Skills (Interview → PRD → GitHub-Issue). Zeichne die Issue-URL in der Zustandsdatei auf.
Phase 2: Planung
Übergebe die PRD-Issue-URL an prd-to-plan. Zeichne den Pfad zur Plan-Datei (unter docs/plans/{feature}.md) auf.
Phase 3: CEO-Review
Übergebe den Pfad zur Plan-Datei an plan-ceo-review. Empfehle den HOLD-SCOPE-Modus, aber lasse die eigene Modusauswahl des Skills (Schritt 0F) laufen. Zeichne auf, wann das Review abgeschlossen ist und der Benutzer zustimmt.
Phase 4: Issues
Vom Orchestrator verwaltet. Lies die vertikalen Slices des Plans. Erstelle für jeden Slice ein GitHub-Issue mit gh issue create, das:
- Das PRD-Issue referenziert
- Akzeptanzkriterien aus dem Plan enthält
- In Abhängigkeitsreihenfolge erstellt wird
Zeichne jede Issue-URL sofort nach der Erstellung in der Issues-Tabelle auf. Siehe references/phase-transitions.md für die Wiederherstellung nach teilweisem Abschluss.
Phase 5: Implementierung
Vom Orchestrator verwaltet. Erstelle Feature-Branch feat/{feature-slug} (siehe Branch-Handling in references/phase-transitions.md).
Weise einen Subagenten pro GitHub-Issue gemäß der subagent-development-Methodik zu:
- Jeder Subagent ruft den
tdd-Skill auf - Code-Review läuft zwischen jeder Subagenten-Zuweisung
- Zustandsdatei wird nach Abschluss jedes Subagenten aktualisiert (nicht gebündelt)
Protokolliere Ereignisse pro Subagent:
- „Subagent für Issue #N gestartet: {titel}“
- „Subagent für Issue #N abgeschlossen: {bestanden/fehlgeschlagen}“
- „Code-Review nach Issue #N: {sauber/blockierende Probleme gefunden}“
Phase 6: Code-Review
Rufe daa-code-review für alle geänderten Dateien auf dem Feature-Branch auf. Falls blockierende Probleme gefunden werden → beheben, erneut ausführen. Wiederhole bis sauber.
Falls architektonische Probleme eine Überarbeitung des Plans erfordern → löse Rückwärtstransition zu Phase 2 aus.
Phase 7: PR
Prüfe zuerst auf Konflikte mit dem Standard-Branch. Rufe commit für konventionelle Commits auf, dann github-cli zum Öffnen des PR. Zeichne PR-URL auf, setze status: completed. Führe dann den Archivierungsschritt aus (siehe Archivierung unten).
Zustandsdatei
Jedes Feature wird unter docs/dev-cycle/{feature-slug}.state.md verfolgt. Siehe references/state-file-schema.md für das vollständige Format, Felddefinitionen und Übergangsregeln.
Fehler & Wiederherstellung
Siehe references/phase-transitions.md für:
- Wiederholungslogik bei blockierten Phasen (blockiert → beim nächsten Aufruf erneut versuchen)
- Rückwärtstransitionen (Implementierung/Code-Review → Planung)
- Feature-Abbruch. Archivierte Dateien werden nach
docs/archive/verschoben.
Branch-Verwaltung
- Phasen 1–4: Auf aktuellem Branch ausführen (nur Dokumentation)
- Phase 5: Erstelle
feat/{feature-slug}-Branch - Phase 7: PRs zum Standard-Branch (erkannt via
gh repo view --json defaultBranchRef) - Fortsetzung ab Phase 5+: Feature-Branch auschecken, falls nicht bereits darauf
Archivierung
Wenn ein Feature einen Endzustand (completed oder abandoned) erreicht, archiviere seine Artefakte:
- Erstelle Archiv-Verzeichnisse:
mkdir -p docs/archive/dev-cycle docs/archive/plans - Verschiebe die Zustandsdatei:
git mv docs/dev-cycle/{slug}.state.md docs/archive/dev-cycle/ - Verschiebe die Plan-Datei: Lies den Plan-Pfad aus der Artefakt-Tabelle, dann
git mv {plan_path} docs/archive/plans/ - Committe die Verschiebungen mit der Nachricht:
chore(dev-cycle): {slug} archivieren
Archivierung läuft automatisch:
- Am Ende von Phase 7 (nachdem die PR-URL aufgezeichnet und der Status auf
completedgesetzt wurde) - Bei Feature-Abbruch (nachdem der Status auf
abandonedgesetzt wurde)