Démarrage rapide de Superpowers : installation, flux de travail et prise en main

Superpowers encapsule une méthodologie complète pilotée par les spécifications (spec-driven) dans des Claude Skills installables, imposant le brainstorming, la planification, une implémentation guidée par des sous-agents et du TDD strict, au lieu de vous laisser le soin d’adopter cette structure vous-même.

La plupart des configurations SDD (Spécifications Driven Development) de Claude Code échouent de la même manière : quelqu’un écrit un solide skill specify-plan-implement une fois, l’utilise rigoureusement pendant une semaine, puis dérive silencieusement vers du promptage non structuré dès qu’une échéance approche. Rien dans un skill artisanal n’empêche réellement cela. Superpowers est une réponse directe à ce problème de discipline : un paquet de skills conçu par Jesse Vincent et l’équipe de Prime Radiant qui traite le brainstorming, la planification, la revue par sous-agents et le TDD rouge-vert-refactor (red-green-refactor) comme des étapes obligatoires que l’agent vérifie avant chaque tâche, plutôt que comme des suggestions optionnelles qu’il peut ignorer sous pression.

Ce qui justifie un examen approfondi plutôt qu’une simple mention en note de bas de page est le parcours d’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, de sorte que la même méthodologie vous suit d’un environnement à l’autre (harnesses) 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 à d’autres outils de développement pilotés 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 skills composables et quelques instructions initiales qui s’assurent que votre agent les utilise ». Cette dernière clause est la partie importante. Il existe de nombreuses collections de skills ; le facteur différenciant ici est l’instruction de bootstrap qui force l’agent à vérifier la présence de skills pertinents avant de commencer toute tâche, de sorte que le flux de travail s’active automatiquement au lieu de dépendre de votre mémoire pour taper une commande slash.

La philosophie qui sous-tend le projet est clairement énoncée dans les documents du projet lui-même :

• Développement piloté par les tests – écrire les tests en premier, 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 que affirmations – vérifier avant de déclarer le succès

En pratique, cette philosophie se manifeste sous forme d’une séquence de skills qui se passent le relais. Si vous avez lu Claude Skills et SKILL.md pour développeurs, les mécanismes vous sembleront familiers : Superpowers est un grand ensemble, très avisé, de ce type exact de répertoire SKILL.md, distribué sous forme de plugin installable plutôt que quelque chose que vous devriez créer vous-même.

Installation de Superpowers sur différents agents de codage

L’installation spécifique à chaque environnement (harness), et le projet précise explicitement qu’il faut 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 de plugins officiel 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émarrage de session du plugin, de sorte que Superpowers est actif dès le premier message ; réinstallez avec la même commande pour mettre à jour.
• Pi charge les skills via une petite extension qui injecte le bootstrap using-superpowers au démarrage de la session et après la compaction du contexte, et n’exige pas l’outil de compatibilité Skill de Pi puisque Pi prend en charge nativement les skills.
• Hermes Agent n’a pas de hook de post-compaction : une session très longue qui se compacte au-delà de son premier tour peut perdre le bootstrap, il est donc conseillé de démarrer une session fraîche si les skills cessent de se déclencher.
• OpenCode considère cela comme un chemin d’installation complètement séparé de tout autre environnement 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 :

Quelles compétences sont disponibles ?

Si Superpowers a été installé correctement, l’agent devrait lister des skills tels 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 déboguer les Claude Skills qui ne se déclenchent pas : si le skill 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 skills comme « le flux de travail de base », chacun s’activant à un point précis et passant le relais au suivant :

⬇

1. brainstorming s’active avant que du code ne soit écrit. Il affine une idée générale à travers des questions, explore des alternatives et présente le design en courts blocs 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 le design. 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 que l’implémentation ne commence.
3. writing-plans découpe le design approuvé en tâches de petite taille – Superpowers vise de deux à cinq minutes de travail par tâche – avec des chemins de fichiers exacts, du code complet là où c’est 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) dispatche un nouveau sous-agent 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-refactor : écrire un test qui échoue, le regarder échouer, écrire le code minimal pour qu’il passe, le regarder passer, engager (commit). Le code écrit avant qu’un test défaillant n’existe pour lui est supprimé, non conservé.
6. requesting-code-review s’active entre les tâches, révisant la diff par rapport au plan et signalant les problèmes par gravité ; les problèmes critiques bloquent l’avancement 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 (merge), ouvrir une PR, conserver la branche, ou abandonner – et nettoie le worktree.

Cela correspond étroitement à la boucle à cinq phases neutre en outils dans Flux de travail de Développement Piloté par les Spécifications : des exigences au code : spécifier devient brainstorming, planifier devient writing-plans, les tâches et l’implémentation s’intègrent dans subagent-driven-development, et la validation est répartie entre le TDD et la revue de code. La différence est l’exécution : Superpowers est conçu de sorte que l’agent vérifie automatiquement ces skills au lieu de dépendre de vous pour invoquer chaque phase.

Essai en pratique : une première tâche pas à pas

Ne pointez pas Superpowers vers votre fonctionnalité la plus importante dès la première exécution. Choisissez quelque chose de réel mais limité – une petite fin de point (endpoint), une correction de bug ciblée, un refactor d’un seul module – et commencez une session dans un projet qui possède déjà une suite de tests, car l’application stricte du TDD est la plus visible là.

Je veux ajouter une limitation de débit (rate limiting) à nos fin de points d'API publiques.

Avec Superpowers installé, attendez-vous à ce que la session s’ouvre avec des questions de brainstorming plutôt qu’avec du code : quels fin de points, quelle limite, par utilisateur ou par clé, que devrait-il se passer lorsque la limite est atteinte. Cette friction est intentionnelle – c’est la même discipline des non-objectifs couverte dans Flux de travail de Développement Piloté par les Spécifications : des exigences au code, juste appliquée par le skill plutôt que laissée à votre mémoire. Une fois que vous approuvez le design par blocs, attendez-vous à un plan avec des tâches numérotées et petites avant tout changement de fichier, puis à un sous-agent dispatché par tâche avec une diff que vous réviserez à chaque point de contrôle.

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

• Confirmer 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 apparaît en premier, le skill ne s’est pas déclenché pour cette étape, et il vaut la peine de rejouer la vérification de découverte de la section d’installation.
• Surveiller la granularité des tâches. La taille de deux à cinq minutes par tâche est agressive pour certaines bases de code. Si les tâches semblent fragmentées inutilement pour votre projet, c’est un point à soulever lors du point de contrôle de revue de writing-plans plutôt qu’a posteriori.

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

En plus des sept skills du flux de travail, Superpowers fournit des skills de support regroupés 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 l’inonder de sortie intermédiaire.

Quand Superpowers convient (et quand il ne convient pas)

Bonne adéquation :

• Vous appréciez déjà l’approche des skills Claude Code pour le Développement Piloté par les Spécifications vs Vibe Coding mais vous glissez sans cesse vers un promptage non structuré parce que rien n’impose les points de contrôle de revue.
• Vous travaillez avec plusieurs agents de codage et vous voulez une méthodologie unique qui vous suit au lieu d’un skill exclusif à 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 Développement Piloté par les Spécifications vs Vibe Coding.

Adéquation plus faible :

• Scripts rapides, prototypes jetables et automatisations ponctuelles – le surcoût de brainstorming et de planification est réel, et il ne vaut pas le coup pour un changement de cinquante lignes.
• Les équipes ayant déjà un skill SDD spécifique au projet, bien affiné. Superpowers échange cette personnalisation contre une cérémonie appliquée et avisée ; vous préférerez peut-être conserver ce qui fonctionne déjà et emprunter uniquement des idées de skills individuels.
• Les environnements où la granularité stricte de deux à cinq minutes par tâche ou le TDD obligatoire seraient en conflit avec un processus d’équipe établi que vous n’êtes pas prêt à modifier.

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 skills Claude Code / multi-agents plutôt que comme un CLI autonome ou une IDE. Spec Kit vous fournit des artefacts markdown portables et une indépendance des agents ; Kiro vous offre une expérience IDE guidée et intégrée ; un skill Claude Code artisanal vous donne une flexibilité maximale avec une application nulle. Superpowers se situe entre les deux derniers : même mécanisme basé sur les skills qu’un flux de travail Claude Code fait maison, mais avec une application qui semble obligatoire et une distribution de plugins multi-agents qu’un skill local au dépôt ne fournit pas.

Pour l’analyse complète de la portabilité, la friction de configuration, les points de contrôle de revue et la dépendance (lock-in) à travers Spec Kit, Kiro, les skills Claude Code, OpenSpec, BMAD-METHOD et Tessl – y compris l’endroit où Superpowers se situe dans le tableau de comparaison et le cadre décisionnel – voir GitHub Spec Kit vs Kiro vs Flux de travail SDD Claude Code. Si vous préférez une cérémonie moins contraignante et plus de liberté pour itérer sur une base de code existante (brownfield), le guide de démarrage rapide OpenSpec couvre l’alternative plus légère, centrée sur le changement. Et si les rôles qui vous manquent sont ceux que Superpowers n’endosse pas – revue produit, QA navigateur, audit de sécurité, génie logiciel de release – gstack les encapsule comme une équipe d’ingénierie virtuelle qui peut être combinée avec Superpowers, Superpowers fournissant la discipline dans la phase d’implémentation.

Dépannage et choses à savoir

Les mises à jour sont en grande partie automatiques mais dépendent de l’agent. Le niveau de mise à jour de votre installation dépend de l’environnement – Antigravity ré-exécute le hook de démarrage de session lors de la réinstallation, les installations basées sur npm ou Git nécessitent une commande de mise à jour explicite, et les installations basées sur le marketplace suivent généralement le propre flux de mise à jour des plugins de l’agent hôte.

La télémétrie est activée par défaut mais facile à désactiver. Le compagnon visuel optionnel du skill de 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. Définissez SUPERPOWERS_DISABLE_TELEMETRY sur n’importe quelle valeur vraie pour le 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 skills, fourchez le dépôt (fork), passez sur dev et suivez le skill writing-skills pour créer et tester les modifications – les contributions de nouveaux skills ne sont généralement pas acceptées, car chaque skill doit fonctionner identiquement sur tous les agents pris en charge.

Si un skill ne se déclenche pas, traitez-le comme tout autre problème de Claude Skill. 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 de sessions longues si le bootstrap est perdu silencieusement.

Conclusion

Superpowers mérite 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 de spécifier-planifier-implémenter – cette boucle est déjà bien couverte par Qu’est-ce que le Développement Piloté par les Spécifications ? – il rend une idée existante plus difficile à sauter, et il le fait sur plus d’agents qu’un skill local au dépôt ne peut atteindre. Installez-le d’abord sur l’environnement que vous utilisez au quotidien, exécutez une petite tâche limitée à travers le cycle complet de 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

• Dépôt Superpowers – source, skills et manifests de plugins pour chaque agent pris en charge
• Marketplace Superpowers – marketplace Claude Code pour Superpowers et les plugins associés
• GitHub Spec Kit vs Kiro vs Flux de travail SDD Claude Code – comparaison complète des outils et cadre décisionnel
• Claude Skills et SKILL.md pour développeurs – les mécanismes de skill sous-jacents sur lesquels Superpowers est construit
• Sous-agents Claude Code : configuration, params et quand les utiliser – revue du contexte isolé, le mécanisme derrière subagent-driven-development
• Flux de travail de Développement Piloté par les Spécifications : des exigences au code – le processus à cinq phases neutre en outils que Superpowers automatise
• Qu’est-ce que le Développement Piloté par les Spécifications ? La Spécification comme Source de Vérité – concepts et terminologie SDD fondamentaux
• Installation et configuration de Claude Code pour Ollama, llama.cpp, tarification – installer Claude Code lui-même avant d’ajouter Superpowers