Superpowers : Guide de démarrage rapide — Installation, flux de travail et essai

Les Superpowers encapsulent une méthodologie complète pilotée par les spécifications dans des Compétences Claude installables, en imposant le brainstorming, la planification, une implémentation pilotée par des sous-agents et une TDD stricte, au lieu de laisser cette structure à votre discrétion.

La plupart des configurations de développement piloté par spécifications (SDD) avec Claude Code échouent de la même manière : quelqu’un écrit une solide compétence specify-plan-implement une seule fois, l’utilise avec diligence pendant une semaine, puis dérive doucement vers du prompting non structuré dès qu’une échéance approche. Rien dans une compétence maison n’empêche réellement cela. 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 considère le brainstorming, la planification, la revue par sous-agent et la TDD rouge-vert-refactorer 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 justifie un examen approfondi plutôt qu’une simple note de bas de page, c’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 d’un harnais à l’autre au lieu de vivre dans le dossier .claude/skills/ d’un seul dépôt. Ce guide couvre ce que c’est réellement, 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 spécifications.

Qu’est-ce que Superpowers ?

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

La philosophie qui en est à l’origine 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 – le processus plutôt que les suppositions
• 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 traduit par une séquence de compétences qui se relayent entre elles. Si vous avez lu Compétences Claude et SKILL.md pour les développeurs, la mécanique vous semblera familière – Superpowers est un ensemble large et opinionné de répertoires SKILL.md de exactement ce type, distribué sous forme de plugin installable plutôt que de quelque chose que vous devriez rédiger vous-même.

Installer Superpowers sur les agents de codage

L’installation est spécifique au harnais, et le projet est explicite : 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 :

# Marketplace officiel de plugins Anthropic
/plugin install superpowers@claude-plugins-official

Ou via le marketplace dédié Superpowers, qui contient également quelques plugins associé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 de lancer une tâche réelle :

• Antigravity exécute automatiquement le hook de début 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 bootstrap using-superpowers au démarrage de la session et après la compaction du contexte, et ne requiert pas l’outil de compatibilité Skill de Pi car Pi prend en charge nativement les compétences.
• Hermes Agent n’a pas de hook post-compaction – une session très longue qui se compacte au-delà de son premier tour peut perdre le bootstrap, il faut donc démarrer une nouvelle session si les compétences cessent de se déclencher.
• OpenCode considère cela comme un chemin d’installation complètement séparé de tout autre harnais que vous utilisez déjà, même sur la même machine.

Vérifier l’installation

Une fois installé, demandez directement à l’agent au lieu de faire confiance à un message de succès silencieux :

Quelles compétences sont disponibles ?

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 le même contrôle de découverte recommandé pour le débogage des Compétences Claude qui échouent à se déclencher – si la compétence existe mais ne s’active jamais, la description de routage est presque toujours le problème, pas 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 la main à la suivante :

⬇

1. brainstorming s’active avant que du code soit écrit. Il affine une idée vague à travers des questions, explore des 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 ligne de base de tests propre avant le début de l’implémentation.
3. writing-plans décompose la conception approuvée en tâches digestes – Superpowers vise deux à cinq minutes de travail par tâche – avec des chemins de fichiers exacts, du code complet si pertinent, 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) déploie un sous-agent neuf par tâche, avec une revue en deux étapes : conformité à la spécification d’abord, puis qualité du code.
5. test-driven-development impose un strict rouge-vert-refactorer – écrire un test qui échoue, observer l’échec, écrire le code minimal pour le faire passer, observer le passage, committer. Le code écrit avant qu’un test d’échec n’existait pour lui est supprimé, pas 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 que toutes les tâches sont terminées. Il vérifie que les tests passent, puis présente des options – fusionner, ouvrir une PR, conserver la branche, ou supprimer – et nettoie le worktree.

Cela correspond étroitement à la boucle neutre en outils en cinq phases du Flux de travail de développement piloté par spécifications : des exigences au code : spécifier devient brainstorming, planifier devient writing-plans, tâches et implémentation se replient dans subagent-driven-development, et valider est réparti entre TDD et revue de code. La différence est l’application – Superpowers est conçu pour que l’agent vérifie automatiquement ces compétences au lieu de compter sur vous pour invoquer chaque phase.

L’essayer : un aperçu de la première tâche

N’orientez pas Superpowers vers votre fonctionnalité la plus importante pour la première exécution. Choisissez quelque chose de réel mais borné – une petite fin de point, une correction de bug ciblée, une refonte d’un module unique – et démarrez une session dans un projet qui a déjà une suite de tests, car l’application de la TDD y est la plus visible.

Je veux ajouter une limitation de débit à nos points de terminaison d'API publics.

Avec Superpowers installé, attendez-vous à ce que la session s’ouvre avec des questions de brainstorming plutôt qu’avec du code : quels points de terminaison, quelle limite, par utilisateur ou par clé, que devrait se passer lorsque la limite est atteinte. Cette friction est intentionnelle – c’est la même discipline de non-objectifs couverte dans le Flux de travail de développement piloté par spécifications : des exigences au code, simplement imposée par la compétence au lieu d’être laissée à votre mémoire. Une fois que vous approuvez la conception par morceaux, attendez-vous à un plan avec des tâches numérotées et petites avant tout changement de fichier, puis un sous-agent déployé par tâche avec un diff que vous examinez à chaque point de contrôle.

Deux choses à surveiller pour une première exécution :

• Confirmez que la TDD est réellement imposée. Demandez à l’agent d’implémenter une tâche et vérifiez si un test d’échec 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 cela vaut la peine de relancer le contrôle de découverte de la section d’installation.
• Surveillez la granularité des tâches. Le dimensionnement des tâches de deux à cinq minutes est agressif pour certaines bases de code. Si les tâches semblent inutilement fragmentées 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 d’assistance 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 domaine que les sous-agents de Claude Code – contexte isolé, revue indépendante, et un résumé rapporté à la session principale au lieu de la submerger avec une sortie intermédiaire.

Quand Superpowers convient (et quand il ne convient pas)

Bonnes adaptations :

• Vous aimez déjà l’approche par compétences de Claude Code pour le Développement piloté par spécifications vs Coding Vibe mais vous glissez constamment vers un prompting non structuré parce que rien n’impose les portes de revue.
• Vous travaillez avec plusieurs agents de codage et voulez une méthodologie qui vous suit au lieu d’une compétence limitée à Claude Code.
• Vous voulez une application stricte de la TDD sans écrire la logique d’application vous-même.
• 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 le Développement piloté par spécifications vs Coding Vibe.

Adaptations moins bonnes :

• Les scripts rapides, les prototypes jetables et l’automatisation ponctuelle – le surcoût de brainstorming et de planification est réel, et il ne vaut pas la peine de le payer pour un changement de cinquante lignes.
• Les équipes ayant une compétence SDD spécifique au projet déjà existante et bien ajustée. Superpowers échange cette personnalisation contre une cérémonie imposée et opinionnée ; vous préférerez peut-être garder ce qui fonctionne déjà et emprunter seulement des idées de compétences individuelles.
• Les environnements où la granularité stricte des tâches de deux à cinq minutes ou la 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 à la couche des compétences Claude Code / multi-agents plutôt qu’en tant que CLI autonome ou IDE. Spec Kit vous donne des artefacts Markdown portables et une indépendance d’agent ; Kiro vous donne une expérience IDE guidée et intégrée ; une compétence Claude Code maison vous donne une flexibilité maximale avec zéro application. Superpowers se situe entre les deux derniers : le même mécanisme basé sur les compétences qu’un flux de travail Claude Code DIY, mais avec une application d’allure obligatoire et une distribution de plugin multi-agent qu’une compétence locale au dépôt ne fournit pas.

Pour la décomposition complète de la portabilité, de la friction de configuration, des portes de revue et de la dépendance logicielle entre Spec Kit, Kiro, les compétences Claude Code, OpenSpec, BMAD-METHOD et Tessl – y compris où Superpowers se situe dans le tableau comparatif et le cadre de décision – voir GitHub Spec Kit vs Kiro vs Flux de travail SDD Claude Code. Si vous voulez moins de cérémonie imposée et plus de liberté pour itérer sur une base de code brune, la début rapide d’OpenSpec couvre l’alternative plus légère et centrée sur les changements.

Dépannage et choses à savoir

Les mises à jour sont principalement automatiques mais dépendent de l’agent. L’actualité de votre installation dépend du harnais – Antigravity relance le hook de début 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 brainstorming charge le logo Prime Radiant depuis leur site web, ce qui inclut votre version de Superpowers mais aucune donnée de projet, de prompt ou de clic. Configurez SUPERPOWERS_DISABLE_TELEMETRY à toute valeur vraie pour la désactiver. Superpowers respecte également les opt-outs DISABLE_TELEMETRY et CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC de Claude Code.

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

Si une compétence ne se déclenche pas, traitez-la comme tout autre problème de Compétence Claude. Demandez « Quelles compétences sont disponibles ? » 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 la compaction d’une longue session si le bootstrap tombe 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 Qu’est-ce que le développement piloté par spécifications ? – il rend une idée existante plus difficile à sauter, 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 harnais que vous utilisez quotidiennement, exécutez une petite tâche bornée à travers le cycle complet de brainstorming à finition, et décidez à partir de là si la cérémonie imposée vaut la peine sur votre charge de travail réelle.

Liens utiles

• Dépôt Superpowers – source, compétences et manifests de plugins pour chaque agent pris en charge
• Marketplace Superpowers – Marketplace Claude Code pour Superpowers et plugins associés
• GitHub Spec Kit vs Kiro vs Flux de travail SDD Claude Code – comparaison complète des outils et cadre de décision
• Compétences Claude et SKILL.md pour les développeurs – les mécaniques sous-jacentes de compétences sur lesquelles Superpowers se construit
• Sous-agents Claude Code : Configuration, Setup et Quand les utiliser – revue de contexte isolé, le mécanisme derrière subagent-driven-development
• Flux de travail de développement piloté par spécifications : des exigences au code – le processus neutre en outils en cinq phases que Superpowers automatise
• Qu’est-ce que le développement piloté par spécifications ? La spécification comme source de vérité – concepts et terminologie de base du SDD
• Installation et configuration de Claude Code pour Ollama, llama.cpp, tarifs – installer Claude Code lui-même avant d’ajouter Superpowers