fr-goal
Un point de contact unique de l'objectif à la PR reviewée : brainstorming contextuel → UNE session Q&A groupée → spécification → revue → fr-plan → revue → implémentation TDD → revue → une seule PR. Chaque revue corrige tout ce qu'elle trouve ; l'instruction d'autonomie de l'opérateur remplace chaque pause d'approbation par un cycle revue-et-correction. En cas de blocage : arrêtez-vous, dites ce qui bloque et ce que vous avez essayé, et demandez — une mauvaise hypothèse livrée dans une PR coûte plus cher qu'une exécution en pause.
Annoncer au début : "J'utilise fr-goal pour exécuter cet objectif de manière autonome."
Ce qui reste interactif
| Moment | Pourquoi |
|---|---|
| La session Q&A groupée (une fois, au brainstorming) | Les décisions de conception appartiennent à l'opérateur — pas de réponse = arrêt, jamais de valeur par défaut |
| Emplacement du dépôt multi-projets | Question d'accès — uniquement si le système de fichiers ne peut pas y répondre |
| Phases manuelles | Secrets, opérations UI, déploiements sont réservés aux humains — voir la politique de placement |
| Fusion PR | L'agent ne fusionne jamais lui-même |
| Plan de test post-fusion | Prouve un déploiement réel ; nécessite l'environnement de l'opérateur |
1. Brainstorming avec Q&A groupée — en isolation
Invoquez fr-brainstorming (exécute fr isolation up d'abord ; pas de profil devcontainer
→ pause pour l'interview fr-init). L'isolation précède TOUT —
exploration, mesures, opérations cluster incluses ; un "commencez par X" de l'opérateur
change le premier élément de travail, jamais la première action. Explorez, collectez TOUTE
décision appartenant à l'opérateur, posez tout en UN appel AskUserQuestion (max 4 questions,
recommandé en premier). Incluez une question de Plan de test post-fusion UNIQUEMENT lorsque
le livrable se déploie (service/bot/infra), jamais du code pur. Regroupez les retardataires.
Barrière dure : un appel sans réponse est un signal d'arrêt — terminez le tour en
réitérant les questions ouvertes et attendez ; ne remplacez jamais les valeurs par défaut par une réponse réelle.
2. Spécification — puis revue
Écrivez docs/superpowers/specs/<YYYY-MM-DD-slug>-design.md, puis révisez-la
par rapport aux réponses Q&A ET à la réalité du code (les fichiers/helpers/services qu'elle
nomme existent-ils ?). Corrigez chaque constat. Plan de test choisi → la spécification porte une ## Test Plan des étapes post-fusion.
3. Vérification multi-projets
Pour une spécification multi-dépôt (owner/repo:path), cette session possède le
plan et la PR d'UN SEUL dépôt. Pour chaque autre dépôt : localisez sa copie de travail vous-même
(répertoires frères, racines habituelles) ; demandez un chemin/clonage uniquement s'il n'est pas trouvé — regroupez
cela dans la Q&A. Dispensez un agent par dépôt (isolation: "worktree") avec la référence de spécification
et ce pipeline à partir de l'étape 4. Un plan, une PR par dépôt.
4. Planification — fr-plan, puis revue
Invoquez fr-plan, en ignorant l'approbation section par section (la spécification encode la
conception). Gardez le plan v2 sous forme de dossier, avec des étapes en forme de TDD. Revue : fr plan self-review
doit passer et les phases doivent correspondre à la spécification (toutes couvertes). Corrigez, implémentez.
5. Phases manuelles — reportées par défaut
La barrière de pureté agentique de fr-plan collecte le travail manuel dans des phases [manual]
dédiées. fr-goal ajoute une politique de placement (une phase manuelle au milieu du plan bloque l'exécution) :
- Report par défaut : TOUT le travail manuel dans la DERNIÈRE phase, aucune phase
agentique n'en dépend. La PR le livre délibérément non implémenté, marqué pour
l'opérateur, qui l'implémente et pousse vers la même PR (
fr plan edit --complete-phase N --note). - Placer en avant uniquement si le travail agentique en dépend réellement. Terminez le plan + la revue, ouvrez une PR de spécification + plan (les instructions manuelles SONT le livrable), faites une pause ; reprenez UNIQUEMENT sur le feu vert de l'opérateur.
- Multi-dépôt : modélisez les dépendances entre dépôts —
depends_onest uniquement intra-plan, donc l'ordonnancement vit dans la spécification et le séquencement des PR (un secret dans un dépôt peut en bloquer les phases d'un autre).
6. Implémentation — fr-execute en mode local, TDD, pas de sous-agents
L'espace de travail d'isolation de l'étape 1 est la copie de travail — chaque commande via
fr isolation exec. Exécutez les phases via fr-execute en mode LOCAL (dossier-plan +
phase), PAS en mode dispatché (la spécification/plan ne sont pas sur main, fr apply --yes refuse).
Implémentez en ligne, pas via des sous-agents (le contexte a besoin de l'historique Q&A + spécification).
TDD par étape ; cochez les étapes / terminez les phases via fr plan edit. Jamais une phase manuelle.
La couche d'implémentation pousse UNIQUEMENT la branche — elle n'ouvre jamais la PR (en ligne, ou via un constructeur multi-dépôt délégué). L'ouvrir ici réordonne la livraison (8) avant la revue (7), permettant à l'opérateur de fusionner avant que les correctifs n'existent — ils deviennent orphelins sur une branche fusionnée (#320, 3×). L'orchestrateur ouvre une PR brouillon pour la visibilité — non fusionnable jusqu'à l'étape 8, son badge "Brouillon" signifie "ne pas fusionner encore".
7. Revue aux jalons — corrigez tout ce qui est trouvé
Après chaque jalon (phase terminée, ou implémentation complète pour les petits plans),
invoquez superpowers:requesting-code-review sur spécification + plan + code. Corrigez
chaque constat immédiatement, avec des tests ; un constat factuellement erroné reçoit un raisonnement de réfutation
(superpowers:receiving-code-review), jamais un rejet silencieux. Tenez une liste de constats.
8. Livraison — une PR par dépôt, tous les artefacts à bord
Vérifiez d'abord (superpowers:verification-before-completion) : sortie complète de la suite de tests,
auto-revue passée, étapes cochées. La PR devient fusionnable UNIQUEMENT maintenant (après
les correctifs de l'étape 7) : gh pr ready sur le brouillon — ne dites jamais "prêt à fusionner" avant
cela. Corps de la PR : résumé + chemins spécification/plan ; constats de revue et leurs correctifs (plus
les constats réfutés) ; la phase manuelle reportée marquée "non implémentée —
l'opérateur pousse vers cette PR" ; le Plan de test textuel, étiqueté "post-fusion —
conduit par l'opérateur". Arrêtez-vous ; l'opérateur fusionne.
9. Clôture post-fusion
Quand l'opérateur signale la fusion : vérifiez d'abord que le correctif a atteint main —
exécutez fr isolation verify-merge --branch <b> (squash/rebase/merge-safe ; code de sortie 1
= non vérifié). Non vérifié → ARRÊTEZ et récupérez (cherry-pick / nouvelle PR).
Ensuite, exécutez le Plan de test s'il est présent (l'agent lance les vérifications, l'opérateur confirme ce
qu'il ne peut pas atteindre), confirmez les phases terminées (fr status), fr archive <plan-dir>, commitez via une PR de maintenance, fr isolation down.