fr-goal
Ein Operator-Touchpoint vom Ziel zum geprüften PR: Brainstorming-Kontext → EINER gestaffelten Q&A → Spezifikation → Review → fr-Plan → Review → TDD-Implementierung → Review → einzelner PR. Jede Überprüfung behebt alles, was sie findet; die Autonomieanweisung des Operators ersetzt jeden Superpowers-Freigabestopp durch einen Review-und-Fix-Durchlauf. Bei Blockade: anhalten, sagen, was blockiert ist und was versucht wurde, und fragen – eine falsche Annahme, die in einem PR landet, kostet mehr als ein angehaltener Durchlauf.
Zu Beginn ankündigen: „Ich verwende fr-goal, um dieses Ziel autonom auszuführen.“
Was interaktiv bleibt
| Moment | Warum |
|---|---|
| Die gestaffelte Q&A (einmalig, beim Brainstorming) | Designentscheidungen gehören dem Operator – unbeantwortet = anhalten, niemals Standardwerte übernehmen |
| Speicherort des Multi-Repo-Projekts | Zugriffsfrage – nur, wenn das Dateisystem sie nicht beantworten kann |
| Manuelle Phasen | Secrets, UI-Operationen, Deployments sind nur für Menschen – siehe Platzierungsrichtlinie |
| PR-Merge | Der Agent merged niemals selbst |
| Testplan nach dem Merge | Beweist das echte Deployment; benötigt die Umgebung des Operators |
1. Brainstorming mit gestaffelter Q&A – in Isolation
fr-brainstorming aufrufen (führt zuerst fr isolation up aus; kein Devcontainer-Profil → für das fr-Init-Interview anhalten). Isolation geht ALLEM voraus – Erkundung, Messungen, Cluster-Operationen eingeschlossen; ein Operator-Befehl „starte mit X“ ändert das erste Arbeitselement, niemals die erste Aktion. Erkunden, JEDE operator-entschiedene Frage sammeln, alle in EINEM AskUserQuestion-Aufruf stellen (maximal 4 Fragen, erste empfohlen). Eine Frage zum Testplan nach dem Merge NUR einfügen, wenn das auslieferbare Produkt deployed wird (Service/Bot/Infrastruktur), niemals bei reinem Code. Nachzügler bündeln. Harte Sperre: Ein unbeantworteter Aufruf ist ein Stoppsignal – die Runde mit einer erneuten Nennung der offenen Fragen beenden und warten; niemals Standardwerte als echte Antwort ersetzen.
2. Spezifikation – dann prüfen
docs/superpowers/specs/<YYYY-MM-DD-slug>-design.md schreiben, dann gegen die Q&A-Antworten UND die Codebasis-Realität prüfen (existieren die genannten Dateien/Helper/Dienste?). Jeden Befund beheben. Testplan ausgewählt → die Spezifikation erhält einen Abschnitt ## Testplan mit Schritten nach dem Merge.
3. Multi-Projekt-Check
Bei einer projektübergreifenden Spezifikation (Form owner/repo:path) besitzt diese Sitzung den Plan und PR für EIN Repository. Für jedes andere Repository: die Arbeitskopie selbst lokalisieren (Geschwisterverzeichnisse, übliche Wurzelverzeichnisse); nur nach Pfad/Klon fragen, wenn nicht gefunden – in die Q&A bündeln. Einen Agenten pro Repository ausliefern (isolation: "worktree") mit der Spezifikationsreferenz und dieser Pipeline ab Schritt 4. Ein Plan, ein PR pro Repository.
4. Plan – fr-plan, dann prüfen
fr-plan aufrufen, dabei die abschnittsweise Freigabe überspringen (die Spezifikation kodiert das Design). V2-Plan-als-Ordner mit TDD-förmigen Schritten beibehalten. Prüfen: fr plan self-review muss bestehen und die Phasen gegen die Spezifikation rücklesen (alle abgedeckt). Beheben, implementieren.
5. Manuelle Phasen – standardmäßig nach hinten verschieben
Das agentische-Reinheits-Tor von fr-plan sammelt manuelle Arbeit in dedizierte [manual]-Phasen. fr-goal fügt eine Platzierungsrichtlinie hinzu (eine manuelle Phase in der Mitte des Plans stoppt den Durchlauf):
- Standardmäßig nach hinten verschieben: ALLE manuellen Arbeiten in die LETZTE Phase, keine agentische Phase hängt davon ab. Der PR liefert sie bewusst unimplementiert aus, markiert für den Operator, der implementiert und in denselben PR pusht (
fr plan edit --complete-phase N --note). - Nur nach vorne verschieben, wenn agentische Arbeit wirklich davon abhängt. Plan + Prüfung abschließen, einen PR mit Spezifikation + Plan öffnen (die manuellen Anweisungen SIND das auslieferbare Produkt), anhalten; nur auf das Go des Operators fortsetzen.
- Multi-Repo: Abhängigkeiten zwischen Repos modellieren –
depends_ongilt nur innerhalb des Plans, daher liegen die Reihenfolge in der Spezifikation und der PR-Sequenzierung (ein Secret in einem Repo kann die Phasen eines anderen sperren).
6. Implementieren – fr-execute im lokalen Modus, TDD, keine Subagenten
Der Isolationsarbeitsbereich aus Schritt 1 ist die Arbeitskopie – jeder Befehl über fr isolation exec. Phasen über fr-execute im LOKALEN Modus ausführen (Plan-Verzeichnis + Phase), NICHT ausgeliefert (Spezifikation/Plan sind nicht auf main, fr apply --yes lehnt ab). Inline implementieren, nicht über Subagenten (der Kontext benötigt die Q&A- und Spezifikationshistorie). TDD pro Schritt; Schritte abhaken / Phasen über fr plan edit abschließen. Niemals eine manuelle Phase.
Die implementierende Schicht pusht NUR den Branch – sie öffnet niemals den PR (inline oder durch einen delegierten Multi-Repo-Builder). Das Öffnen hier würde Ausliefern (8) vor Prüfung (7) stellen, sodass der Operator vor den Fixes mergen könnte – sie landen als Waisen auf einem gemergten Branch (#320, 3×). Der Orchestrator öffnet einen Entwurfs-PR für die Sichtbarkeit – nicht mergebar bis Schritt 8, sein „Entwurf“-Abzeichen bedeutet „noch nicht mergen“.
7. Prüfung an Meilensteinen – alles Gefundene beheben
Nach jedem Meilenstein (abgeschlossene Phase oder vollständige Implementierung bei kleinen Plänen) superpowers:requesting-code-review über Spezifikation + Plan + Code aufrufen. Jeden Befund sofort mit Tests beheben; ein sachlich falscher Befund erhält eine widerlegende Begründung (superpowers:receiving-code-review), niemals ein stilles Fallenlassen. Eine Befundliste führen.
8. Ausliefern – ein PR pro Repository, alle Artefakte an Bord
Zuerst verifizieren (superpowers:verification-before-completion): vollständige Test-Suite-Ausgabe, Selbstprüfung bestanden, Schritte abgehakt. Der PR wird ERST JETZT mergebar (nach den Fixes aus Schritt 7): gh pr ready auf dem Entwurf – niemals vorher „bereit zum Mergen“ sagen. PR-Beschreibung: Zusammenfassung + Pfade zu Spezifikation/Plan; Prüfungsbefunde und deren Behebungen (plus etwaige widerlegte Befunde); die nach hinten verschobene manuelle Phase, markiert als „nicht implementiert – Operator pusht in diesen PR“; der Testplan wörtlich, beschriftet als „nach dem Merge – vom Operator ausgeführt“. Anhalten; der Operator merged.
9. Abschluss nach dem Merge
Wenn der Operator den Merge meldet: zuerst überprüfen, ob der Fix auf main gelandet ist – fr isolation verify-merge --branch <b> ausführen (squash/rebase/merge-sicher; Exit 1 = nicht verifiziert). Nicht verifiziert → ANHALTEN und wiederherstellen (Cherry-Pick / frischer PR). Dann den Testplan ausführen, falls vorhanden (Agent führt Prüfungen aus, Operator bestätigt, was der Agent nicht erreichen kann), Phasenabschluss bestätigen (fr status), fr archive <plan-dir>, über einen Haushalts-PR committen, fr isolation down.