Communitygithub.com

derio-net/super-fr

Suite de plugins Claude Code : planification superpuissante, isolation devcontainer+worktree, autonomie objectif-vers-PR et dispatch de phases vers les runners VibeKanban

Qu'est-ce que super-fr ?

fr-goal est un agent autonomique qui guide un opérateur d'un objectif à une Pull Request reviewée et fusionnée, en remplaçant les pauses d'approbation par des cycles revue-et-correction. Il prend en charge l'isolation complète via devcontainer/worktree, la génération de spécifications, la planification dirigée par TDD, l'exécution de phases manuelles avec placement stratégique, et la revue systématique après chaque étape clé. Conçu pour Claude Code et VibeKanban, ce plugin garantit que l'opérateur reste maître des décisions de conception tout en automatisant les tâches de routine. Chaque phase de revue corrige tous les problèmes trouvés, et en cas de blocage, l'agent s'arrête, explique ce qui bloque et demande de l'aide plutôt que de livrer une hypothèse non vérifiée.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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

MomentPourquoi
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-projetsQuestion d'accès — uniquement si le système de fichiers ne peut pas y répondre
Phases manuellesSecrets, opérations UI, déploiements sont réservés aux humains — voir la politique de placement
Fusion PRL'agent ne fusionne jamais lui-même
Plan de test post-fusionProuve 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_on est 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.

Skills associés