Communitygithub.com

derio-net/super-fr

Claude Code Plugin-Suite: Superpowers-gestützte Planung, Devcontainer+Worktree-Isolation, Goal-to-PR-Autonomie und Phasen-Dispatch an VibeKanban-Runners

Was ist super-fr?

Dieses Skill-Set für Claude Code ermöglicht einen vollständig autonomen Workflow von einer groben Idee bis zum auslieferbaren Pull Request – mit eingebauten Qualitätsprüfungen. Es kombiniert Planung in Isolation, batched Q&A, automatisierte Code-Reviews und eine strikte Trennung von manuellen und agentischen Phasen. Der Prozess beginnt mit einem Brainstorming in einer isolierten Umgebung, gefolgt von einer Spezifikation, die gegen die Codebasis verifiziert wird. Jeder Schritt (Spezifikation, Plan, TDD-Implementierung) durchläuft eine obligatorische Review-Runde, bei der alle gefundenen Probleme sofort behoben werden. Manuelle Aufgaben (wie Secrets oder Deployments) werden standardmäßig in die letzte Phase verschoben, sodass der Agent ungehindert arbeiten kann, während der Operator an kritischen Stellen die Kontrolle behält. Der Skill unterstützt Isolation via Devcontainer und Worktrees, Multi-Repo-Projekte und stellt sicher, dass nur ein einziger, vollständig getesteter PR pro Repository erstellt wird – nie automatisch gemerged.

Funktioniert mit✓Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add derio-net/super-fr

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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

MomentWarum
Die gestaffelte Q&A (einmalig, beim Brainstorming)Designentscheidungen gehören dem Operator – unbeantwortet = anhalten, niemals Standardwerte übernehmen
Speicherort des Multi-Repo-ProjektsZugriffsfrage – nur, wenn das Dateisystem sie nicht beantworten kann
Manuelle PhasenSecrets, UI-Operationen, Deployments sind nur für Menschen – siehe Platzierungsrichtlinie
PR-MergeDer Agent merged niemals selbst
Testplan nach dem MergeBeweist 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_on gilt 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.

Verwandte Skills