superpowers: systematic-debugging
Interdit de corriger un bug qu'on n'a pas compris. Cause racine d'abord.
par Jesse Vincent (obra)
Ce que ça fait
Elle s'active dès qu'il y a un bug, un test qui casse ou un comportement bizarre, et elle bloque la tentation de patcher au pif.
- Phase 1 : investigation de la cause racine (reproduire, lire les erreurs, remonter le flux de données).
- Phase 2 : analyse comparative avec du code qui marche.
- Phase 3 : hypothèse testée avec un seul changement à la fois.
- Phase 4 : on écrit d'abord un test qui échoue, puis un seul fix ciblé.
La phase 1 est non négociable : pas de fix proposé sans diagnostic. Si trois tentatives échouent, elle pousse à remettre l'architecture en question.
Cas d'usage
Bug qui revient sans arrêt
Force l'agent à remonter jusqu'à l'origine au lieu de masquer le symptôme.
Test qui casse sans raison claire
Compare le code cassé à un exemple qui marche pour isoler la différence.
Système multi-composants
Trace le flux de données à rebours pour trouver d'où vient vraiment le problème.
Comment l'installer
Claude
- Inclus dans le plugin Superpowers : `/plugin install superpowers@claude-plugins-official`
- Alternative : `/plugin marketplace add obra/superpowers-marketplace` puis `/plugin install superpowers@superpowers-marketplace`
Codex
- Supporté sur Codex via le plugin Superpowers (interface `/plugins`) ou en plaçant les skills du repo dans un dossier de skills lu par Codex
Le verdict NXUS
À coupler avec la skill TDD. Quand ton agent part en mode 'j'ajoute un try/catch et on verra', celle-ci le remet dans le droit chemin. Indispensable sur du code complexe.
Skills similaires
Apprends à créer tes propres skills & agents
Découvre nos formations pour construire tes outils IA.
Voir les formations