Les agents de programmation possèdent une fâcheuse tendance. Face à une consigne, ils génèrent du code sans recul, accumulent les hypothèses erronées et contournent les tests. Superpowers résout cette dérive. Ce projet open source, conçu par Jesse Vincent et l’équipe de Prime Radiant, injecte une méthodologie d’ingénierie logicielle au cœur des modèles linguistiques via un ensemble de compétences combinables.
L’agent cesse de deviner.
Il écoute, interroge, structure une spécification lisible, élabore un plan d’action d’une précision chirurgicale, puis déroule un protocole de développement piloté par les tests.
Architecture et dynamique de fonctionnement
Superpowers ne repose pas sur une simple incitation textuelle passive. Le système modifie le comportement opérationnel de l’agent dès la première seconde de session grâce à un jeu d’instructions initiales et de déclencheurs d’outils stricts.
Philosophie fondamentale :
1. Test-Driven Development (TDD) : Écrire les tests avant le code, sans exception.
2. Systématique plutôt qu’empirique : Le processus prévaut sur la conjecture.
3. Réduction de la complexité : La simplicité reste l’objectif premier.
4. Preuve contre affirmation : Vérifier les faits avant de déclarer un succès.
Dès que vous exprimez le besoin de concevoir un composant, l’agent freine son envie d’écrire du code. Il dialogue avec vous pour clarifier la portée du projet. Il extrait une spécification concise, puis découpe le travail en tâches si explicites qu’un ingénieur débutant sans contexte ni goût particulier pourrait les réussir sans faux pas. Ensuite, le système lance un cycle d’agents secondaires. Chaque sous-agent prend en charge une micro-tâche, valide son travail sous double relecture et progresse en totale autonomie sur des plages de plusieurs heures sans dévier du plan établi.
Découverte et installation selon les plateformes
L’installation s’adapte à votre environnement d’exécution. Si vous utilisez plusieurs interfaces, installez Superpowers sur chacune d’elles.
| Environnement | Méthode d’installation |
|---|---|
| Claude Code (Officiel) | /plugin install superpowers@claude-plugins-official |
| Claude Code (Marketplace Superpowers) | /plugin marketplace add obra/superpowers-marketplace puis /plugin install superpowers@superpowers-marketplace |
| Antigravity | agy plugin install https://github.com/obra/superpowers |
| Cursor | Tapez /add-plugin superpowers dans le chat Agent ou cherchez dans la place de marché intégrée. |
| Devin CLI | devin plugins install obra/superpowers |
| Factory Droid | droid plugin marketplace add https://github.com/obra/superpowers puis droid plugin install superpowers@superpowers |
| Gemini CLI | gemini extensions install https://github.com/obra/superpowers |
| GitHub Copilot CLI | copilot plugin marketplace add obra/superpowers-marketplace puis copilot plugin install superpowers@superpowers-marketplace |
| Grok Build CLI | grok plugin install superpowers@xai-official --trust ou navigation via /marketplace |
| Hermes Agent | hermes plugins install obra/superpowers --enable |
| Kimi Code | Via l’interface /plugins puis Marketplace, ou /plugins install https://github.com/obra/superpowers |
| OpenCode | Consultez les directives de l’installateur OpenCode |
| Pi | pi install git:github.com/obra/superpowers (ou pi -e /path/to/superpowers en local) |
Pour le client graphique Codex, ouvrez la barre latérale, cliquez sur Plugins, localisez Superpowers dans la section Coding, puis validez. Sur Codex CLI, ouvrez l’interface avec /plugins, cherchez superpowers et confirmez l’installation.
Pour mettre à jour Devin CLI ou Gemini CLI, exécutez respectivement devin plugins update superpowers et gemini extensions update superpowers. Sur Kimi Code et OpenCode, référez-vous aux guides dédiés docs/README.kimi.md et docs/README.opencode.md.
Le cycle de vie opérationnel : flux étape par étape
L’agent vérifie ses compétences avant chaque action. Les étapes suivantes constituent des obligations formelles, non des recommandations optionnelles.
- brainstorming : S’active avant la frappe du premier caractère de code. L’agent affine vos idées brutes par questions socratiques, explore les alternatives techniques, découpe le concept en sections digestes et enregistre la spécification finale validée.
- using-git-worktrees : Isole le chantier sur une nouvelle branche via un worktree Git distinct, initialise l’environnement et s’assure d’une base de tests saine.
- writing-plans : Découpe l’implémentation en tâches minuscules de 2 à 5 minutes. Chaque item spécifie les chemins exacts de fichiers, les extraits de code complets et les commandes de vérification. Ce plan applique les principes YAGNI (You Aren’t Gonna Need It) et DRY (Don’t Repeat Yourself).
- subagent-driven-development ou executing-plans : Lance un sous-agent dédié par tâche. Ce travailleur opère sous deux filtres de relecture successifs : la conformité stricte au plan, puis la qualité intrinsèque du code. Le mode par lot inclut des points de contrôle humains.
- test-driven-development : Applique le cycle ROUGE-VERT-REFACTORISER. L’agent rédige un test unitaire qui échoue, constate l’échec, écrit le code minimal nécessaire pour le faire passer au vert, puis valide le commit. Tout code produit avant son test correspondant subit une suppression pure et simple.
- requesting-code-review : Analyse les modifications entre chaque tâche selon une grille de sévérité. Un problème critique bloque la suite des opérations.
- finishing-a-development-branch : Contrôle l’intégralité des suites de tests, propose les options de sortie (fusion, pull request, conservation ou abandon) et nettoie l’arbre de travail Git.
Bibliothèque complète des compétences
Le dépôt structure ses modules en quatre grands axes fonctionnels.
Tests
test-driven-development: Cycle ROUGE-VERT-REFACTORISER strict avec documentation sur les anti-modèles de test.
Débogage
systematic-debugging: Protocole de recherche de cause racine en 4 étapes (traçage d’origine, défense en profondeur, attentes basées sur conditions explicites).verification-before-completion: Confirmation de la résolution effective avant clôture du ticket.
Collaboration et exécution
brainstorming: Élucidation socratique du besoin.writing-plans: Rédaction de plans d’exécution granulaires.executing-plans: Déroulement par lots avec arrêts sur décision humaine.dispatching-parallel-agents: Orchestration de sous-agents simultanés.requesting-code-review: Liste de contrôle avant soumission.receiving-code-review: Intégration méthodique des retours critiques.using-git-worktrees: Isolation des branches de développement.finishing-a-development-branch: Clôture propre du flux de travail.subagent-driven-development: Boucle d’itération rapide sous double revue.
Méta-compétences
writing-skills: Création de nouvelles compétences conformes aux standards de Superpowers.using-superpowers: Amorçage initial et injection du contexte dans la session.
Détails d’intégration, limites et support
Sur l’environnement Pi, le paquet Superpowers injecte le bootstrap using-superpowers au démarrage puis après chaque compaction de contexte. Pi gère nativement les compétences sans outil de compatibilité externe, tandis que les sous-agents et listes de tâches restent des extensions optionnelles.
Sur Hermes Agent, une limite technique existe : l’absence de point d’ancrage post-compaction implique qu’une session très longue ayant compressé son premier tour perd l’amorce Superpowers. Il faut alors relancer une session propre si les compétences cessent de se déclencher.
Pour le suivi des bugs et les retours techniques, le projet met à disposition son espace GitHub Issues et une communauté Discord dédiée au partage d’expériences et aux annonces de versions. Pour les entreprises en quête de déploiements industriels avec support commercial, gestion des coûts d’API ou outillage sur mesure, les équipes de Prime Radiant répondent via l’adresse sales@primeradiant.com.