Claude Code est puissant dès le départ, mais sans structure, il se lance directement dans le code : pas de planification, pas de tests, pas d'approche systématique. Le plugin Superpowers résout ce problème en appliquant des workflows de développement éprouvés qui préviennent le chaos.
Ce que fait réellement Superpowers
Superpowers est un framework de compétences qui intercepte Claude Code à des moments clés. Au lieu d'écrire immédiatement du code lorsque vous demandez quelque chose, il s'arrête et pose d'abord des questions. Ensuite, il applique le TDD, crée des plans d'implémentation et révise son propre travail avant de continuer.
Le workflow principal :
- Brainstorm : affine votre idée par questionnement socratique
- Plan : crée des tâches de petite taille (2 à 5 minutes chacune) avec des chemins de fichiers exacts
- Execute : déploie des sous-agents par tâche avec révision en deux étapes
- Finish : vérifie les tests, propose des options PR/merge, nettoie
Installation (10 secondes)
bash
Ouvrir le menu des plugins
/plugin
Naviguer vers l'onglet "Discover"
Rechercher "superpowers"
Sélectionner et installer
Après l'installation, redémarrez Claude Code. Vous verrez "SessionStart:startup hook succeeded: Success" confirmant que le plugin est actif.
Ce qui est installé
Le plugin regroupe tout ce dont vous avez besoin :
| Composant | Inclus |
|---|---|
| Commands | execute-plan, write-plan, brainstorm |
| Agents | code-reviewer |
| Skills | 14 compétences incluant TDD, débogage, git worktrees, revue de code |
| Hooks | SessionStart (amorce automatiquement le workflow) |
Les trois commandes principales
/superpowers:brainstorm
Utilisez ceci avant TOUTE nouvelle fonctionnalité. Claude va :
- poser des questions de clarification sur votre objectif
- explorer des alternatives que vous n'avez pas envisagées
- présenter la conception en morceaux digestibles pour validation
- sauvegarder un document de conception pour référence
Quand déclencher : Au début de toute fonctionnalité, refactorisation ou migration.
/superpowers:write-plan
Après le brainstorming, ceci crée un plan d'implémentation où :
- chaque tâche prend 2 à 5 minutes maximum
- chaque tâche a des chemins de fichiers exacts et des extraits de code complets
- les étapes de vérification sont intégrées dans chaque tâche
- le plan suppose qu'un "ingénieur junior enthousiaste sans contexte" va l'exécuter
/superpowers:execute-plan
Exécute le plan en utilisant le développement piloté par sous-agents :
- nouveau sous-agent créé par tâche (contexte propre)
- révision en deux étapes : conformité aux spécifications, puis qualité du code
- points de contrôle humains entre les lots
- les problèmes critiques bloquent automatiquement la progression
Les 14 compétences expliquées
| Compétence | Ce qu'elle fait |
|---|---|
| test-driven-development | Applique ROUGE-VERT-REFACTORISER. Supprime le code écrit avant les tests. |
| systematic-debugging | Processus de cause racine en 4 phases avec défense en profondeur |
| using-git-worktrees | Crée une branche isolée, exécute la configuration, vérifie une base propre |
| using-superpowers | Introduction au système de compétences |
| dispatching-parallel-agents | Workflows de sous-agents concurrents |
| executing-plans | Exécution par lots avec points de contrôle |
| finishing-a-development-branch | Options merge/PR/conserver/rejeter, nettoyage |
| brainstorming | Raffinement de conception socratique |
| writing-plans | Planification d'implémentation détaillée |
| requesting-code-review | Liste de vérification pré-révision, bloque sur les problèmes critiques |
| receiving-code-review | Répondre aux retours de manière systématique |
| writing-skills | Méta-compétence pour créer de nouvelles compétences |
| verification-before-completion | Garantit que les corrections fonctionnent réellement |
| subagent-driven-development | Révision en deux étapes par tâche |
Comment les compétences se déclenchent automatiquement
Les compétences ne sont pas des commandes que vous appelez, elles s'activent selon le contexte :
- commencer à discuter d'une nouvelle fonctionnalité → brainstorming s'active
- conception approuvée → using-git-worktrees s'active
- l'implémentation commence → test-driven-development s'active
- tâche terminée → requesting-code-review s'active
- toutes les tâches terminées → finishing-a-development-branch s'active
Claude vérifie les compétences pertinentes avant toute tâche. Ce sont des workflows obligatoires, pas des suggestions.
Intégration des git worktrees
Superpowers utilise les git worktrees pour un développement isolé : bash
Ce qui se passe en coulisses :
git worktree add ../project-feature feature-branch cd ../project-feature
Claude travaille ici, la branche main reste propre
Avantages :
- exécuter plusieurs instances Claude sur différentes fonctionnalités
- garder la branche main stable pendant l'expérimentation
- nettoyage facile si les choses tournent mal
Développement piloté par sous-agents
Le pattern le plus puissant. Au lieu d'une longue session Claude :
- L'agent principal crée le plan
- Un nouveau sous-agent exécute chaque tâche
- L'agent de révision (code-reviewer) vérifie le travail
- L'agent principal continue ou demande des corrections
Pourquoi cela fonctionne : chaque sous-agent démarre avec un contexte propre concentré sur UNE tâche. Pas de confusion accumulée des longues sessions.
Application du TDD
Superpowers prend le TDD au sérieux. La compétence :
- exige un test échouant AVANT l'implémentation
- observe l'échec du test (prouve qu'il teste quelque chose)
- implémente le code minimal pour réussir
- commit au vert
- refactorise uniquement après le vert
Si Claude écrit du code avant les tests, la compétence lui demande de supprimer ce code et de recommencer.
Exemple pratique
Vous : J'ai besoin d'une authentification utilisateur pour mon app Express
Claude (avec Superpowers) : → Active la compétence brainstorming → Demande : OAuth ou mots de passe ? Session ou JWT ? Quels fournisseurs ? → Explore : Limitation de débit ? Verrouillage de compte ? Exigences de mot de passe ? → Présente la conception en sections pour votre approbation
Vous : Ça a l'air bien, planifions
Claude : → Active la compétence writing-plans → Crée 12 tâches, chacune de 2 à 5 minutes → Tâche 1 : Créer un test échouant pour l'endpoint /signup → Tâche 2 : Implémenter le gestionnaire signup pour réussir le test → Chaque tâche a des chemins de fichiers exacts et du code
Vous : Exécute
Claude : → Crée un sous-agent pour la Tâche 1 → L'agent code-reviewer valide la sortie → Crée un sous-agent pour la Tâche 2 → Rapporte la progression, demande l'approbation pour continuer
Gérer le plugin
Depuis le menu /plugin vous pouvez :
- Disable plugin : désactiver temporairement
- Mark for update : marquer pour le prochain cycle de mise à jour
- Update now : obtenir la dernière version immédiatement
- Uninstall : supprimer complètement
- View on GitHub : voir le code source
Quand NE PAS utiliser Superpowers
- questions ponctuelles rapides
- modifications simples de fichiers
- tâches de moins de 5 minutes
Pour celles-ci, la surcharge n'en vaut pas la peine. Superpowers brille sur les fonctionnalités multi-fichiers, les refactorisations et les migrations nécessitant une exécution systématique.
Référence rapide
| Action | Comment |
|---|---|
| Installer | /plugin → Discover → superpowers |
| Démarrer la conception | /superpowers:brainstorm |
| Créer un plan | /superpowers:write-plan |
| Exécuter le plan | /superpowers:execute-plan |
| Mettre à jour | /plugin → sélectionner superpowers → Update now |
Superpowers transforme Claude Code de "assistant utile qui déraille parfois" en "partenaire de développement systématique qui suit des processus éprouvés". Le workflow structuré prévient les modes d'échec les plus courants : tests sautés, cas limites manquants et fonctionnalités qui dérivent des exigences.
