Retour aux articles • IA • • 3 min de lecture

Superpowers : imposer le TDD à l'IA

Utiliser le framework Superpowers (obra/superpowers) pour imposer un cycle strict Brainstorm -> Plan -> TDD (Red/Green) -> Subagent Review aux agents de codage IA.

Superpowers : imposer le TDD à l'IA

Laisser un agent IA coder directement à partir d’une consigne floue mène presque toujours au même résultat : du code écrit à l’aveugle, des tests rédigés après coup qui ne vérifient que le cas nominal, et une dérive progressive par rapport au besoin initial.

Créé par Jesse Vincent, le framework open-source Superpowers (obra/superpowers) transforme radicalement le comportement des agents (Claude Code, Cursor, Codex, OpenCode) en leur imposant une discipline d’ingénierie logicielle obligatoire en 4 étapes.

Architecture & Flux : Superpowers : TDD & Subagents pour l'IA

1. Les 4 piliers obligatoires de Superpowers

Contrairement à de simples conseils de style, Superpowers fonctionne comme un ensemble de skills auto-déclenchés qui bloquent le passage à l’étape suivante tant que les critères de validation ne sont pas remplis :

  1. brainstorming (Avant le code) : après avoir challengé vos hypothèses (idéalement avec Grill Me), l’agent formalise une spécification courte découpée en petits paragraphes intelligibles et attend votre validation explicite ;
  2. writing-plans (Le découpage chirurgical) : l’agent décompose l’implémentation en micro-tâches de 2 à 5 minutes maximum. Chaque tâche indique exactement quels fichiers sont touchés, quel test doit être exécuté et quelle sortie est attendue ;
  3. test-driven-development (La loi d’airain RED -> GREEN -> REFACTOR) :
    • RED : l’agent écrit d’abord le test automatisé et doit l’exécuter pour prouver qu’il échoue ;
    • GREEN : il écrit uniquement le code minimal nécessaire pour faire passer le test au vert ;
    • Sanction immédiate : tout code métier écrit avant son test est automatiquement supprimé ;
  4. subagent-driven-development (La double revue par sous-agents) : chaque micro-tâche est confiée à un sous-agent dédié avec un contexte frais, puis inspectée en deux passes : d’abord la conformité stricte à la spec, puis la qualité du code.

2. Pourquoi le TDD est le garde-fou ultime contre les hallucinations

Un LLM peut halluciner qu’une fonction marche en la relisant visuellement, mais il ne peut pas tricher face au code retour 0 d’un test réel. En combinant Superpowers avec nos bancs de tests canaries :

  • Aucun bug corrigé ne peut réapparaître silencieusement six mois plus tard ;
  • Le contexte de l’agent principal reste propre et léger puisque l’exécution unitaire et le débogage (systematic-debugging) sont isolés dans des sous-agents ;
  • Associé à gstack pour empiler les Pull Requests et à Grill Me pour stress-tester l’architecture en amont, on obtient une chaîne de production logicielle quasi indestructible.

3. Dépôt GitHub Officiel & Ressources