Was macht AgentFlow?
Übersicht
AgentFlow verwandelt dein bestehendes Kanban-Board in eine vollautonome KI-Entwicklungspipeline. Statt eine eigene Orchestrierungsinfrastruktur zu bauen, wird dein Projektmanagement-Tool (Asana, GitHub Projects, Linear) als verteilter Zustandsautomat genutzt – Aufgaben durchlaufen Phasen, KI-Agenten lesen und schreiben Zustände über Kommentare, und Menschen greifen über die ihnen vertraute Oberfläche ein.
Das Ergebnis ist vollständige Pipelin-Transparenz vom Handy aus, kostenlose Wiederherstellung nach Abstürzen (der Zustand lebt in deinem PM-Tool, nicht im Speicher) und menschliches Eingreifen an jedem Punkt durch Ziehen einer Karte.
Wann dieser Skill verwendet werden sollte
- Wenn du mehrere Claude Code Worker über einen gesamten Entwicklungslebenszyklus (Build, Review, Test, Integrieren) orchestrieren möchtest.
- Wenn du deterministische Qualitätstore (tsc/eslint/tests) vor dem KI-Review auf KI-generiertem Code nutzen möchtest.
- Wenn du volle Pipeline-Sichtbarkeit von deinem Kanban-Board oder Handy aus haben möchtest.
- Wenn du ein Solo- oder Teamprojekt betreibst, das autonome Aufgabenverteilung mit Kostenverfolgung benötigt.
- Wenn du eine absturzsichere Orchestrierung benötigst, die Sitzungsneustarts überlebt.
Kernkonzepte
7-stufige Kanban-Pipeline
Aufgaben durchlaufen: Backlog, Research, Build, Review, Test, Integrate, Done. Jede Phase hat spezifische Tore. Das Kanban-Board IST die Orchestrierungsschicht – keine separate Datenbank, keine Nachrichtenwarteschlange, keine benutzerdefinierte Infrastruktur.
Zustandsloser Orchestrator
Ein crontab-gesteuerter Einzeldurchlauf wird alle 15 Minuten ausgeführt. Kein Daemon, keine Sitzungsabhängigkeit. Wenn er abstürzt, setzt der nächste Durchlauf dort fort, wo er aufgehört hat, weil der gesamte Zustand in deinem PM-Tool lebt.
Deterministisch vor probabilistisch
Harte Tore (tsc + eslint + tests) werden vor jedem KI-Review ausgeführt und erkennen etwa 60 % der Probleme zu nahezu null Kosten. Das KI-Review kommt danach als zweite Schicht.
Adversariales Review
Ein anderer KI-Agent überprüft den Code und muss 3 Dinge auflisten, die falsch sind, bevor er entscheidet, ihn zu bestehen. Dies verhindert reine Abnick-Entscheidungen.
Transitive Prioritätsverteilung
Aufgaben, die die meisten nachgelagerten Arbeiten entblocken, werden zuerst erstellt, wobei automatisch der kritische Pfad berechnet wird.
Befehle / Skills
/spec-to-board
Zerlegt eine SPEC.md in atomare Aufgaben auf deinem Kanban-Board mit abgebildeten Abhängigkeiten.
/sdlc-orchestrate
Verteilt Aufgaben an Worker basierend auf transitiver Priorität und Konflikterkennung. Wird als crontab-Durchlauf ausgeführt.
/sdlc-worker --slot <N>
Startet einen Worker in einem Terminal-Slot, der Aufgaben aufnimmt, Code erstellt und PRs erzeugt. Starte 3-4 Worker parallel.
/sdlc-health
Echtzeit-Pipeline-Status-Dashboard mit aktueller Phase, zugewiesenem Agenten, Wiederholungsanzahl und akkumulierten Kosten für jede Aufgabe.
/sdlc-stop
Geordnetes Herunterfahren: Aktive Worker beenden ihre aktuelle Aufgabe, nicht gestartete Aufgaben kehren in den Backlog zurück.
Schritt-für-Schritt-Anleitung
1. Schreibe deine Spezifikation
Erstelle eine SPEC.md für dein Projekt, die beschreibt, was du bauen möchtest.
2. Zerlege in Aufgaben
claude -p "/spec-to-board"
Dies liest deine SPEC.md, zerlegt sie in atomare Aufgaben, bildet Abhängigkeiten ab und erstellt sie auf deinem Kanban-Board.
3. Starte Worker
Öffne 3-4 Terminal-Fenster, jedes als ein Worker-Slot:
# Terminal 2 — Builder
claude -p "/sdlc-worker --slot T2"
# Terminal 3 — Builder
claude -p "/sdlc-worker --slot T3"
# Terminal 4 — Reviewer
claude -p "/sdlc-worker --slot T4"
# Terminal 5 — Tester
claude -p "/sdlc-worker --slot T5"
4. Starte den Orchestrator
# Zu crontab hinzufügen (wird alle 15 Minuten ausgeführt)
crontab -e
# Hinzufügen: */15 * * * * ~/.claude/sdlc/agentflow-cron.sh >> /tmp/agentflow-orchestrate.log 2>&1
5. Überwache und greife ein
Öffne dein Kanban-Board auf deinem Handy. Beobachte, wie Aufgaben durch die Pipeline fließen. Ziehe eine Karte auf „Needs Human“, um einzugreifen. Führe /sdlc-health für ein Terminal-Dashboard aus.
6. Stoppe die Pipeline
claude -p "/sdlc-stop"
Qualitätstore
Jede Phase erzwingt bestimmte Tore vor dem Hochstufen:
- Build zu Review:
tsc+eslint+npm testmüssen alle bestehen (deterministisch) - Review zu Test: Der adversariale Reviewer muss 3 Probleme auflisten, bevor er bestehen kann
- Test zu Integrate: 80 % Abdeckungsschwelle für neue Dateien
- Integrate zu Done: Vollständige Testsuite auf main nach dem Merge; automatischer Rückbau bei Fehlschlag
Kostenverfolgung
Kostenverfolgung pro Aufgabe mit Phasenobergrenzen (Sonnet-Standard):
- Research: ~0,10 €
- Build: ~0,40 €
- Review: ~0,10 €
- Test: ~0,05 €
- Integrate: ~0,03 €
Automatische Leitplanken: Warnung bei 3 €/8 €, harter Stopp bei 10 €/20 € (Sonnet/Opus) mit Eskalation an einen Menschen.
Sicherheit und Wiederherstellung
- Auto-Revert: Fehlgeschlagene Integrationen lösen
git revertaus (neuer Commit, kein Force-Push) - Blockierte Aufgaben: Nach 2 fehlgeschlagenen Versuchen werden Aufgaben an einen Menschen eskaliert
- Dead-Agent-Erkennung: Heartbeat alle 5 Minuten, Neuzuweisung nach 10 Minuten Timeout
- Geordnetes Herunterfahren:
/sdlc-stopleert Worker, gibt nicht gestartete Aufgaben an das Backlog zurück - Scope-Creep-Erkennung: PR-Diff-Dateien werden mit der vorhergesagten Dateiliste verglichen
- Spec-Drift-Erkennung: SHA-256-Hash-Vergleich erfasst Anforderungsänderungen mitten im Sprint
Installation
# Repository klonen
git clone https://github.com/UrRhb/agentflow.git
# Skills und Prompts in die Claude Code Konfiguration kopieren
cp -r agentflow/skills/* ~/.claude/skills/
cp -r agentflow/prompts/* ~/.claude/sdlc/prompts/
cp agentflow/conventions.md ~/.claude/sdlc/conventions.md
Oder als Claude Code Plugin installieren:
/plugin marketplace add UrRhb/agentflow
/plugin install agentflow
Best Practices
- Tun: Schreibe eine klare SPEC.md, bevor du
/spec-to-boardausführst - Tun: Starte mit 3-4 Workern für ein typisches Projekt
- Tun: Überwache von deinem Kanban-Board und ziehe Karten bei Bedarf auf „Needs Human“
- Tun: Überprüfe regelmäßig LEARNINGS.md – es enthält häufige Fehlermuster
- Nicht tun: Überspringe die deterministischen Qualitätstore – sie erkennen die meisten Probleme kostengünstig
- Nicht tun: Führe einen Force-Push auf main durch – AgentFlow verwendet
git revertzur Sicherheit - Nicht tun: Starte mehr Worker, als die Parallelität deines Projekts unterstützt
Fehlerbehebung
Problem: Worker scheint festzustecken oder tot zu sein
Symptome: Aufgabenkarte hat sich seit 15+ Minuten nicht bewegt, keine neuen Kommentare
Lösung: Der Orchestrator erkennt tote Agenten über Heartbeats und weist nach 10 Minuten neu zu. Wenn das Problem bestehen bleibt, führe /sdlc-health aus, um den Status zu überprüfen, und ziehe die Karte manuell zurück in den Backlog.
Problem: Kostenleitplanke ausgelöst
Symptome: Aufgabe mit dem Tag COST:CRITICAL zu „Needs Human“ verschoben Lösung: Überprüfe den Kommentarthread der Aufgabe auf den gesammelten Kontext. Entscheide, ob das Budget erhöht, die Aufgabe vereinfacht oder in kleinere Teile aufgeteilt werden soll.
Problem: Integrationstestfehler nach dem Merge
Symptome: Aufgabe automatisch von main zurückgesetzt Lösung: Der automatische Revert schützt die Stabilität von main. Überprüfe den Wiederholungskontext der Aufgabe in den Kommentaren, der festhält, was versucht wurde und was fehlgeschlagen ist. Der nächste zugewiesene Worker nutzt diesen Kontext.
Verwandte Skills
@brainstorming– Vor AgentFlow verwenden, um deine SPEC.md zu entwerfen@writing-plans– Ergänzt die Spezifikationserstellung für die Aufgabenzerlegung@test-driven-development– Funktioniert gut mit AgentFlows Qualitätstoren@subagent-driven-development– Alternativer Ansatz zur Multi-Agenten-Koordination
Zusätzliche Ressourcen
Einschränkungen
- Verwende diesen Skill nur, wenn die Aufgabe eindeutig dem oben beschriebenen Umfang entspricht.
- Behandle die Ausgabe nicht als Ersatz für umgebungsspezifische Validierung, Tests oder Expertenüberprüfung.
- Halte inne und frage nach Klärung, wenn erforderliche Eingaben, Berechtigungen, Sicherheitsgrenzen oder Erfolgskriterien fehlen.