Spec-Driven Multi-Agent Workflow

Generisches Spec-Driven Workflow Framework für Multi-Agent-Software-Entwicklung. Jeder Agent hat eine klar abgegrenzte Aufgabe und gibt erst nach Human Feedback weiter. Spec → Design → Implementierungsplan → Code (mit Architecture, Security und Test Review nach jedem Schritt).

---

Schnellstart

Option A — Slash Command (empfohlen)

# 1. specs/spec_outline.md für dein Projekt anpassen
#    (die Zeile "TEMPLATE-STATUS: unbearbeitet" dabei entfernen)

# 2. Claude Code im Projektverzeichnis starten
claude

# 3. Workflow starten
/workflow

Der Orchestrator prüft automatisch, ob specs/spec_outline.md bereits angepasst wurde — falls nicht, stoppt er mit einem Hinweis, bevor irgendetwas ausgeführt wird.

Option B — Manuell

# 1. In das Projektverzeichnis wechseln
cd /pfad/zu/spec-driven-workflow

# 2. Claude Code starten (liest CLAUDE.md automatisch)
claude

# 3. Orchestrator-Prompt einfügen (Inhalt aus der Datei kopieren)
cat orchestrator/prompt.md

Danach den kopierten Inhalt als erste Nachricht in Claude Code eingeben.

---

Mehrere Features (sequenzieller Workflow)

Nach dem ersten Feature-Zyklus kannst du weitere Features auf demselben Codebase aufbauen:

# 1. Neuen Feature-Zyklus starten
bash scripts/new_feature.sh
# → archiviert outputs/, setzt workflow.json zurück

# 2. spec_outline.md für das neue Feature anpassen

# 3. Workflow starten — läuft automatisch mit Code-Analyse
/workflow

Was passiert automatisch:

[Code-Analysis Agent]    ← liest bestehenden Code, erstellt codebase_summary.md
        ↓  Human Feedback
[Spec-Writer Agent]      ← kennt bestehende Features, schreibt nur was neu ist
        ↓
[Designer Agent]         ← erweitert bestehende Architektur statt neu zu erfinden
        ↓
...

Der Code-Analysis Agent erstellt outputs/codebase_summary.md — eine strukturierte Zusammenfassung des bestehenden Codes. Spec-Writer und Designer lesen diese automatisch als Kontext, bevor sie mit der neuen Feature-Spec starten.

Vorherige Outputs werden unter outputs/archive/feature_N/ gesichert.

---

Dashboard

Fortschritt des Workflows live im Browser verfolgen:

bash dashboard/serve.sh
# → öffnet http://localhost:8080/dashboard/ automatisch

Was das Dashboard zeigt:

• Pipeline-Fortschritt (alle Steps mit Status-Indikator)
• Haupt-Schritte (Spec Writer → Designer → Implementation) mit Output-Links
• Coding Steps mit Architecture-, Security- und Test-Review-Status
• GitHub-Refs (Branches, PRs, Issues) wenn GitHub-Integration aktiv ist
• Auto-Refresh alle 10 Sekunden

Voraussetzung: Python 3 (auf macOS vorinstalliert). Kein npm, kein Node.js nötig.

---

GitHub Integration (optional)

Das Framework kann optional mit einem GitHub Repository verbunden werden. Beim Start fragt der Orchestrator einmalig, ob die Integration aktiviert werden soll.

Was automatisiert wird:

Zeitpunkt	Aktion
Nach Implementation approved	Milestone-Issue + Step-Issues anlegen
Vor jedem Coding Step	Feature-Branch erstellen (step-N-{label})
Nach Reviews alle PASSED	Pull Request mit Review-Summary erstellen
Bei Review FAILED	Issues für CRITICAL/MAJOR Findings anlegen

Konfiguration in state/workflow.json:

"github": {
  "enabled": true,
  "owner": "dein-user",
  "repo": "dein-repo",
  "base_branch": "main"
}

Benötigt: GitHub MCP Server konfiguriert in Claude Code.