Prise en main des Superpowers : installation, flux de travail et essai

Superpowers regroupe une méthodologie complète pilotée par les spécifications dans des compétences Claude installables, en imposant le brainstorming, la planification, la mise en œuvre pilotée par des sous-agents et un TDD strict, au lieu de laisser cette structure à votre charge.

La plupart des configurations SDD (Spec-Driven Development) avec Claude Code échouent de la même manière : quelqu’un écrit une solide compétence specify-plan-implement une fois, l’utilise consciencieusement pendant une semaine, puis dérive discrètement vers un prompting non structuré dès qu’une échéance approche. Rien dans une compétence artisanale n’arrête réellement ce phénomène. Superpowers est une réponse directe à ce problème de discipline – un paquet de compétences créé par Jesse Vincent et l’équipe de Prime Radiant qui traite le brainstorming, la planification, la revue par sous-agent et le TDD rouge-vert-refactor comme des étapes obligatoires que l’agent vérifie avant chaque tâche, et non comme des suggestions facultatives qu’il peut ignorer sous pression.

Ce qui mérite un regard dédié plutôt qu’une simple note de bas de page est l’histoire de l’installation. Superpowers fournit des manifests de plugins pour Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot CLI, Grok Build CLI, Kimi Code, OpenCode, Pi, Devin CLI, Factory Droid et Hermes Agent, si bien que la même méthodologie vous suit à travers les différents cadres d’exécution (harnesses) au lieu de vivre dans le dossier .claude/skills/ d’un seul dépôt. Ce guide couvre ce qu’est réellement Superpowers, comment l’installer et le vérifier sur l’agent que vous utilisez, à quoi ressemble une première exécution de bout en bout, et où il se situe par rapport aux autres outils de développement piloté par les spécifications.

Qu’est-ce que Superpowers ?

Superpowers se décrit lui-même comme « une méthodologie complète de développement logiciel pour vos agents de codage, construite sur un ensemble de compétences composables et quelques instructions initiales qui s’assurent que votre agent les utilise ». Cette dernière clause est la partie qui compte. De nombreux ensembles de compétences existent ; le différenciateur ici est l’instruction de démarrage qui force l’agent à vérifier les compétences pertinentes avant de commencer toute tâche, si bien que le flux de travail s’active automatiquement au lieu de vous obliger à vous souvenir d’une commande slash.

La philosophie qui se cache derrière est énoncée clairement dans la documentation du projet :

• Développement piloté par les tests (TDD) – écrire les tests d’abord, toujours
• Systématique plutôt qu’ad hoc – processus plutôt que devinettes
• Réduction de la complexité – la simplicité comme objectif principal
• Preuves plutôt qu’affirmations – vérifier avant de déclarer le succès

En pratique, cette philosophie se manifeste par une séquence de compétences qui se passent le relais. Si vous avez lu Claude Skills and SKILL.md for Developers, la mécanique vous semblera familière – Superpowers est un grand ensemble d’opinions de ce type de répertoire SKILL.md, distribué sous forme de plugin installable plutôt que quelque chose que vous créez vous-même.

Installer Superpowers sur les agents de codage

L’installation est spécifique à chaque cadre d’exécution (harness), et le projet est explicite sur le fait que vous devez l’installer séparément pour chaque agent que vous utilisez – il n’y a pas d’installation globale unique.

Claude Code

Superpowers est distribué via deux marketplaces pour Claude Code :

# Official Anthropic plugin marketplace
/plugin install superpowers@claude-plugins-official

Ou via le marketplace dédié Superpowers, qui contient également quelques plugins liés :

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

Cursor

/add-plugin superpowers

Vous pouvez également rechercher « superpowers » directement dans l’interface du marketplace de plugins de Cursor.

Autres agents

Quelques détails d’installation méritent d’être signalés avant d’exécuter une tâche réelle :

• Antigravity exécute automatiquement le hook de démarrage de session du plugin, si bien que Superpowers est actif dès le premier message ; réinstallez avec la même commande pour mettre à jour.
• Pi charge les compétences via une petite extension qui injecte le démarrage using-superpowers au lancement de la session et après la compaction du contexte, et n’exige pas l’outil de compatibilité Skill de Pi puisque Pi a un support natif des compétences.
• Hermes Agent n’a pas de hook post-compaction – une session très longue qui se compacte sur son premier tour peut perdre le démarrage, si bien qu’il faut démarrer une nouvelle session si les compétences cessent de se déclencher.
• OpenCode traite cela comme un chemin d’installation complètement séparé de tout autre cadre d’exécution que vous utilisez déjà, même sur la même machine.

Vérifier l’installation

Une fois installé, demandez directement à l’agent plutôt que de faire confiance à un message de succès silencieux :

What skills are available?

Si Superpowers est installé correctement, l’agent devrait lister des compétences telles que brainstorming, writing-plans, test-driven-development et subagent-driven-development parmi les résultats. C’est la même vérification de découverte recommandée pour le débogage de Claude Skills qui ne se déclenchent pas – si la compétence existe mais ne s’active jamais, la description de routage est presque toujours le problème, et non le modèle.

Le flux de travail Superpowers : du brainstorming au code livré

Superpowers documente sept compétences comme « le flux de travail de base », chacune s’activant à un point spécifique et passant le relais à la suivante :

⬇

1. brainstorming s’active avant que du code soit écrit. Il affine une idée vague par des questions, explore les alternatives et présente la conception en petits morceaux révisables plutôt qu’en un long document – puis enregistre le résultat comme un artefact de conception.
2. using-git-worktrees s’active une fois que vous approuvez la conception. Il crée un espace de travail isolé sur une nouvelle branche, exécute la configuration du projet et vérifie une base de tests propre avant le début de la mise en œuvre.
3. writing-plans découpe la conception approuvée en tâches de petite taille – Superpowers vise deux à cinq minutes de travail par tâche – avec des chemins de fichiers exacts, du code complet le cas échéant et des étapes de vérification explicites.
4. subagent-driven-development (itération rapide) ou executing-plans (exécution par lots avec points de contrôle humains) dispatche un nouveau sous-agent par tâche, avec une revue en deux étapes : conformité aux spécifications d’abord, puis qualité du code.
5. test-driven-development impose un strict rouge-vert-refactor – écrire un test défaillant, le voir échouer, écrire le code minimal pour le faire passer, le voir passer, commettre. Le code écrit avant qu’un test défaillant n’existe pour lui est supprimé, et non conservé.
6. requesting-code-review s’active entre les tâches, en examinant le diff par rapport au plan et en signalant les problèmes par gravité ; les problèmes critiques bloquent la progression vers la tâche suivante.
7. finishing-a-development-branch s’active une fois toutes les tâches terminées. Il vérifie que les tests passent, puis présente des options – fusion, ouverture d’une PR, conservation de la branche ou abandon – et nettoie le worktree.

Cela correspond étroitement à la boucle à cinq phases neutre en outils dans Spec-Driven Development Workflow From Requirements to Code : « specify » devient brainstorming, « plan » devient writing-plans, « tasks » et « implement » se fondent dans subagent-driven-development, et « validate » est réparti entre le TDD et la revue de code. La différence est l’application – Superpowers est conçu pour que l’agent vérifie ces compétences automatiquement plutôt que de compter sur vous pour invoquer chaque phase.

L’essayer : un tour d’horizon d’une première tâche

Ne pointez pas Superpowers vers votre fonctionnalité la plus importante lors de la première exécution. Choisissez quelque chose de réel mais limité – un petit endpoint, une correction de bug ciblée, une refactorisation d’un seul module – et démarrez une session dans un projet qui a déjà une suite de tests, car l’application du TDD y est la plus visible.

I want to add rate limiting to our public API endpoints.

Avec Superpowers installé, attendez-vous à ce que la session s’ouvre avec des questions de brainstorming plutôt que du code : quels endpoints, quelle limite, par utilisateur ou par clé, que se passe-t-il lorsque la limite est atteinte. Cette friction est intentionnelle – c’est la même discipline des objectifs non visés couverte dans Spec-Driven Development Workflow From Requirements to Code, simplement appliquée par la compétence au lieu de vous laisser le souvenir. Une fois que vous approuvez la conception par morceaux, attendez-vous à un plan avec des tâches numérotées et petites avant toute modification de fichier, puis un sous-agent dispatché par tâche avec un diff que vous examinez à chaque point de contrôle.

Deux choses à surveiller lors d’une première exécution :

• Confirmez que le TDD est réellement appliqué. Demandez à l’agent d’implémenter une tâche et vérifiez si un test défaillant apparaît avant l’implémentation. Si le code arrive en premier, la compétence ne s’est pas déclenchée pour cette étape, et il est utile de relancer la vérification de découverte de la section d’installation.
• Surveillez la granularité des tâches. La dimension des tâches de deux à cinq minutes est agressive pour certaines bases de code. Si les tâches semblent fragmentées inutilement pour votre projet, cela vaut la peine d’être soulevé lors du point de contrôle de revue de writing-plans plutôt qu’après coup.

Ce qu’il y a à l’intérieur : la bibliothèque de compétences

Au-delà des sept compétences de flux de travail, Superpowers fournit des compétences de support regroupées par domaine :

dispatching-parallel-agents mérite d’être souligné séparément : il couvre les flux de travail de sous-agents concurrents, ce qui est le même terrain que les Claude Code subagents – contexte isolé, revue indépendante et un résumé renvoyé à la session principale au lieu de l’inonder de sorties intermédiaires.

Quand Superpowers convient (et quand il ne convient pas)

Bonnes correspondances :

• Vous appréciez déjà l’approche des compétences Claude Code pour le Spec-Driven Development vs Vibe Coding mais vous glissez constamment vers un prompting non structuré parce que rien n’applique les portes de revue.
• Vous travaillez avec plusieurs agents de codage et voulez une méthodologie qui vous suit plutôt qu’une compétence exclusive à Claude Code.
• Vous voulez une application stricte du TDD sans écrire vous-même la logique d’application.
• Les fonctionnalités multi-sessions où la dérive architecturale et les contraintes oubliées sont un risque réel – le mode d’échec exact décrit dans Spec-Driven Development vs Vibe Coding.

Correspondances plus faibles :

• Scripts rapides, prototypes jetables et automatisations ponctuelles – le surcoût du brainstorming et de la planification est réel, et il ne vaut pas la peine de le payer pour une modification de cinquante lignes.
• Les équipes ayant une compétence SDD spécifique au projet existante et bien ajustée. Superpowers échange cette personnalisation contre une cérémonie appliquée et opinionée ; vous préférerez peut-être conserver ce qui fonctionne déjà et emprunter uniquement des idées de compétences individuelles.
• Les environnements où la granularité stricte des tâches de deux à cinq minutes ou le TDD obligatoire entrerait en conflit avec un processus d’équipe établi que vous n’êtes pas prêt à changer.

Comment Superpowers diffère des autres outils SDD

Superpowers n’est pas un concurrent de GitHub Spec Kit ou AWS Kiro au sens habituel – il opère au niveau des compétences Claude Code / inter-agents plutôt que sous forme de CLI autonome ou d’IDE. Spec Kit vous donne des artefacts markdown portables et une indépendance d’agents ; Kiro vous donne une expérience IDE guidée et intégrée ; une compétence Claude Code artisanale vous donne une flexibilité maximale avec zéro application. Superpowers se situe entre les deux derniers : même mécanisme basé sur les compétences qu’un flux de travail Claude Code fait maison, mais avec une application qui semble obligatoire et une distribution de plugins inter-agents qu’une compétence locale au dépôt ne fournit pas.

Pour le détail complet de la portabilité, de la friction de configuration, des portes de revue et de l’enfermement (lock-in) entre Spec Kit, Kiro, les compétences Claude Code, OpenSpec, BMAD-METHOD et Tessl – y compris l’endroit où Superpowers se situe dans le tableau comparatif et le cadre de décision – voir GitHub Spec Kit vs Kiro vs Claude Code SDD Workflows.

Dépannage et choses à savoir

Les mises à jour sont principalement automatiques mais dépendent de l’agent. À quel point votre installation reste à jour dépend du cadre d’exécution – Antigravity relance le hook de démarrage de session lors de la réinstallation, les installations basées sur npm ou Git ont besoin d’une commande de mise à jour explicite, et les installations basées sur le marketplace suivent généralement le flux de mise à jour des plugins propre à l’agent hôte.

La télémétrie est activée par défaut mais facile à désactiver. Le compagnon visuel optionnel de la compétence de brainstorming charge le logo de Prime Radiant depuis leur site web, qui contient votre version de Superpowers mais aucune donnée de projet, de prompt ou de clic. Configurez SUPERPOWERS_DISABLE_TELEMETRY sur n’importe quelle valeur vraie pour la désactiver. Superpowers respecte également les opt-outs DISABLE_TELEMETRY et CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC propres à Claude Code.

Les contributions nécessitent la branche dev. Si vous souhaitez modifier ou ajouter des compétences, forkez le dépôt, passez sur dev et suivez la compétence writing-skills pour créer et tester les modifications – les contributions de nouvelles compétences ne sont généralement pas acceptées, car chaque compétence doit fonctionner de manière identique sur tous les agents pris en charge.

Si une compétence ne se déclenche pas, traitez-le comme tout autre problème de Claude Skill. Demandez « What skills are available? » pour confirmer la découverte, vérifiez que vous avez installé pour l’agent spécifique que vous utilisez actuellement (et non un autre sur la même machine), et rappelez-vous que les sessions Hermes ont besoin d’un nouveau démarrage après une compaction de longue session si le démarrage est perdu silencieusement.

Conclusion

Superpowers vaut la peine d’être installé lorsque l’écart entre vos intentions SDD et ce qui se passe réellement dans une session est le problème que vous essayez de résoudre. Il n’introduit pas une nouvelle idée specify-plan-implement – cette boucle est déjà bien couverte par What Is Spec-Driven Development? – il rend une idée existante plus difficile à ignorer, et il le fait sur plus d’agents qu’une compétence locale au dépôt ne peut en atteindre. Installez-le d’abord sur le cadre d’exécution que vous utilisez quotidiennement, exécutez une petite tâche limitée à travers le cycle complet du brainstorming à la fin, et décidez ensuite si la cérémonie appliquée vaut la peine sur votre charge de travail réelle.

Liens utiles

• Superpowers repository – source, compétences et manifests de plugins pour chaque agent pris en charge
• Superpowers marketplace – marketplace Claude Code pour Superpowers et les plugins liés
• GitHub Spec Kit vs Kiro vs Claude Code SDD Workflows – comparaison complète des outils et cadre de décision
• Claude Skills and SKILL.md for Developers – la mécanique sous-jacente des compétences sur laquelle Superpowers se construit
• Claude Code Subagents: Setup, Config, and When to Use Them – revue à contexte isolé, le mécanisme derrière subagent-driven-development
• Spec-Driven Development Workflow From Requirements to Code – le processus à cinq phases neutre en outils que Superpowers automatise
• What Is Spec-Driven Development? The Spec as Source of Truth – concepts et terminologie SDD fondamentaux
• Claude Code install and config for Ollama, llama.cpp, pricing – installer Claude Code lui-même avant d’ajouter Superpowers