Recovery bei Fehlern

AgentFlow speichert explizite Aufgabenstatus statt Fortschritt aus verstreuten Dateien zu rekonstruieren. Sauberes Wiederanlaufen bedeutet, diese Übergänge zu respektieren — oder dokumentierte Ausnahmen wie --force und Hilfsbefehle zur Wiederaufnahme zu nutzen, wo der Orchestrator Wiederholungen erlaubt.

Zustandsautomat

Aufgaben durchlaufen klare Statuswerte in workflow/state_machine.go:

stateDiagram-v2
  [*] --> pending
  pending --> planned
  planned --> enriched
  enriched --> running
  running --> implemented
  implemented --> verified
  verified --> reviewed
  reviewed --> ready_for_pr
  running --> failed
  implemented --> verify_failed
  verified --> review_failed
  verify_failed --> implemented
  review_failed --> verified

Ungültige Übergänge liefern Fehler, es sei denn, der jeweilige Befehl erlaubt --force für diese Transition.

Häufige Wiederanlauf-Rezepte

Verifikation fehlgeschlagen

Code im zugehörigen Worktree korrigieren, dann erneut verifizieren:

agentflow verify billing-v2 --force

Review fehlgeschlagen

agentflow review billing-v2 --agent codex --force

Unterbrochener Lauf

agentflow status
agentflow resume <run-id>          # gibt den nächsten Schritt aus: plan | enrich | dev | verify | review
agentflow continue "resume billing-v2"

Veraltete Worktrees entfernen

agentflow clean

Entfernt Worktrees gemäß worktrees.cleanup_policy (keep_failed behält Trees fehlgeschlagener Aufgaben).

Reports für die Nachbereitung

Für Analyse im Nachhinein oder Abgleich mit Reviewern stehen report und zusammenfassende investigate-Ausgaben zur Verfügung:

agentflow report <run-id>
agentflow investigate billing-v2

Verwandtes

• Worktree-Isolation
• CLI: resume
• CLI: continue