claude-code-superpowers-how-i-actually-use-it.html
< BACK Image hero pour Comment j'utilise vraiment obra/superpowers — la couche méthodologique manquante de Claude Code

Comment j'utilise obra/superpowers -- la couche méthodologique manquante de Claude Code

Si vos sessions Claude Code ressemblent encore à garder un ingénieur junior qui refuse de planifier avant d'écrire, vous n'êtes pas seul. La vraie version du travail avec les agents de code en 2026, c'est que l'agent est rapide, capable, et structurellement optimiste. Il va sauter la réflexion préalable, ignorer les tests, écrire la mauvaise abstraction, et expédier le bug. La solution n'est pas un meilleur prompt. La solution est une couche méthodologique au-dessus de l'agent.

Cette couche, pour moi, c'est obra/superpowers -- le framework de compétences agentiques de Jesse Vincent pour Claude Code. Approchant les 180 000 stars GitHub en mai 2026, actuellement à la v5.1.0. Ce n'est pas un modèle de prompt, pas un pack de commandes slash, pas une vibe. C'est une méthodologie de développement complète qui s'active automatiquement selon le contexte, impose le développement piloté par les tests, et divise le travail en tâches de 2 à 5 minutes avec des spécifications explicites.obra/superpowers -- Jesse Vincent's agentic skills framework for Claude Code. Approaching 180,000 GitHub stars as of May 2026, currently at v5.1.0. It is not a prompt template, not a slash command pack, not a vibe. It is a complete development methodology that triggers automatically based on context, enforces test-driven development, and breaks work into 2-5 minute tasks with explicit specifications.

J'exécute Superpowers sur chaque projet que je touche depuis six mois -- le site personnel que vous lisez en ce moment, mon travail de conseil chez Seahawk Media, le répertoire HostList, la production de contenu pour le blog, et pas mal de travail de design et d'outillage ponctuel. L'avis honnête, après cette utilisation intensive : c'est le plus grand changement de productivité pour mon workflow Claude Code depuis que l'agent lui-même a été livré. Cet article en est la vraie décomposition -- ce que c'est, comment je l'utilise pour les cinq catégories dans lesquelles je travaille, et les parties qui ont encore besoin de travail.

Ce que Superpowers est vraiment, en 90 secondes

Superpowers arrive comme un plugin marketplace pour Claude Code. Une commande d'installation :

/plugin install superpowers@claude-plugins-official

Après cela, votre agent Claude Code a accès à une bibliothèque de compétences composable. Chaque compétence est un fichier markdown dans le répertoire du plugin qui décrit quand et comment appliquer un workflow spécifique -- TDD, lancement d'agent parallèle, revue de code, brainstorming, rédaction de plan, débogage, et des dizaines d'autres. Claude lit les métadonnées de la compétence, reconnaît la situation dans votre conversation, et retire la compétence pertinente dans le contexte automatiquement. Vous n'invoquez pas les compétences manuellement la plupart du temps. Vous décrivez le problème et Claude se route lui-même.

Le modèle mental qui a enfin fait tilt pour moi : c'est ce que le savoir tribal des équipes d'ingénierie senior utilisait d'être -- les règles non écrites sur comment cette équipe planifie, teste, examine et livre -- sauf que maintenant c'est une bibliothèque portable que vous pouvez installer sur n'importe quel projet et l'agent la lit avant chaque tâche.

Le workflow en sept étapes qui fait le gros du travail

La majeure partie de la valeur provient d'un workflow central que Superpowers impose par défaut. Les étapes, dans l'ordre, avec le nom de la compétence entre crochets :

  • Brainstorming -- affiner l'idée par des questions avant que du code soit écrit. (brainstorming)
  • Isolation de worktree -- chaque tâche non triviale s'exécute dans un git worktree, pas sur votre branche principale. (using-git-worktrees)
  • Planification d'écriture -- décomposer le travail en tâches discrètes de 2 à 5 minutes avec des spécifications exactes, avant de toucher au code. (writing-plans)
  • Développement piloté par sous-agents -- des sous-agents frais par tâche avec examen en deux étapes, pour que l'agent principal reste orienté et les agents workers restent concentrés. (subagent-driven-development)
  • Développement piloté par les tests -- RED-GREEN-REFACTOR est obligatoire, pas optionnel. (test-driven-development)
  • Revue de code -- examen basé sur la sévérité avec blocage explicite des problèmes critiques. (requesting-code-review)
  • Finition de branche -- décision structurée de fusion ou PR quand le travail est terminé. (finishing-a-development-branch)

En pratique, vous ne parcourez pas les sept étapes manuellement pour une modification de 10 lignes. Le framework décide quelles étapes s'appliquent en fonction de la complexité de la tâche, et ignore celles qui seraient excessives. Une correction de typo exécute brièvement la compétence de planification et ignore le TDD. Une nouvelle fonctionnalité sur un répertoire de 25 000 pages exécute la séquence complète.

Comment j'utilise Superpowers pour la rédaction de blog et le SEO

C'est le cas d'usage dont personne ne parle parce que le framework a été construit pour le code, mais la production de contenu à grande échelle est le même problème déguisé : planification structurée, exécution parallèle et examen avant publication. Les cinq schémas concrets que j'utilise :

1. Brainstorming d'un article avant la rédaction

Chaque article commence par la compétence de brainstorming. Je décris le sujet en une ou deux lignes et Claude lance un véritable interrogatoire : qui lit cela, que savent-ils déjà, quel est l'angle contrarian, quels signaux spécifiques de mon propre travail méritent d'être dans le brouillon. La plupart des articles qui prenaient autrefois une session de 90 minutes pour l'outline prennent maintenant 15 minutes de questions guidées et produisent un brief plus serré.

2. Plan-writing pour les articles en cluster

Les clusters de contenu multi-articles (le cluster HIPAA que j'ai livré cette semaine est l'exemple le plus récent) utilisent la compétence writing-plans. Je décris le sujet parent, Claude planifie les 3 à 5 articles de soutien avec leurs angles, leur structure de liens internes et leurs mots-clés cibles. Le plan va dans un fichier markdown du projet. Chaque article devient une tâche distincte de 30 à 45 minutes. Le cluster se livre en un jour plutôt qu'en une quinzaine.

3. Dispatch d'agent parallèle pour la recherche de mots-clés

La compétence dispatching-parallel-agents est ce qui rend les grands projets de recherche SEO réalisables. Pour une analyse concurrentielle, j'ai besoin des SERPs DataForSEO pour 8 mots clés, des audits de contenu pour 4 concurrents classés, et des vérifications de citations d'AI Overview pour le sujet parent. Trois agents parallèles partent, chacun revient avec des résultats structurés, l'agent principal synthétise. Ce qui prenait autrefois une demi-journée de basculement manuel de SERP est maintenant 10 minutes d'analyse structurée.

4. Portes de qualité de contenu pilotées par les tests

Ça semble contre-intuitif mais ça marche : mon pipeline de contenu a une suite de tests. Compte de mots, score Flesch-Kincaid, longueur de meta description 140-155, vérification des mots interdits, minimum de liens internes, validité du schema, complétude du hreflang. Chaque brouillon passe par le filtre. La compétence TDD de Superpowers l'applique -- si un article échoue le filtre, le brouillon ne sort pas tant que l'échec n'est pas résolu. RED-GREEN-REFACTOR pour la prose.

5. Isolation des worktree pour les réécrits de contenu à l'échelle du site

Quand j'ai réécrit 17 copies de héros ce mois-ci pour l'alignement TRIBE v2, la compétence worktree a gardé la réécriture isolée de la branche principale jusqu'à ce que tout le lot soit terminé et révisé. Pas de copie de héros inachevée en production. La compétence est tellement automatisée maintenant que je remarque quand d'autres projets ne l'ont pas.

Comment j'utilise Superpowers pour le travail de design

La conception via Claude Code est une forme de problème différente -- Figma n'est pas entre les mains de l'agent, mais tout ce qui l'entoure l'est : design tokens, spécifications de composants, copy, espacement, audits d'accessibilité, decks de présentation. Trois modèles auxquels je m'appuie :

1. Architecture des tokens à partir d'un brief de marque

Brainstorming + planification d'écriture sur un brief de marque produit une spec de design-token complet -- couche primitive, couche sémantique, couche composant -- en une session. Claude route par la compétence design (quand elle est en scope) et la compétence writing-plans en parallèle. Le résultat est des variables CSS prêtes pour le codebase, pas un fichier Figma que quelqu'un doit traduire plus tard.

2. Génération de spécification de composant

Receiving-code-review et dispatching-parallel-agents gèrent le travail de spec de composants. Je décris un composant (une pricing card, un bloc de hub de services, un tableau de comparaison) et Claude écrit la spec complète -- props, variantes, états, notes d'accessibilité -- qu'un ingénieur ou un autre agent peut implémenter. La spec est examinée par un agent parallèle avant d'être transmise.

3. Production de présentations

Tout mon travail de présentation passe par Superpowers maintenant. Brainstorming du narratif, planification d'écriture pour la structure des slides, agents parallèles pour la génération de graphiques et l'affinage du copy. Un deck de 25 slides qui prenait un jour de travail fait deux heures de session guidée -- et les slides sortent en HTML avec Chart.js, pas en un binaire que quelqu'un doit recréer plus tard.

Comment j'utilise Superpowers pour le développement web

C'est le cas d'usage original et c'est là que la profondeur du framework ressort. Deux exemples de cette semaine :

L'outil WordPress Stack Advisor

J'ai construit WordPress Stack Advisor -- un outil gratuit qui accepte une URL, récupère le site, détecte le CMS et plus de 30 plugins, et retourne une recommandation de stack générée par Claude -- en environ 8 heures de travail en session. La compétence brainstorming a produit la spécification entrée/sortie et l'approche system prompt. Writing-plans a décomposé la construction en tâches discrètes : module de détection, intégration Claude, page UI, câblage CSP, test de fumée. Le développement piloté par sous-agents a livré chaque tâche en isolation avec un contexte d'agent frais, tandis que l'agent principal conservait la vue architecturale. Le TDD sur le module de détection a attrapé deux bugs regex avant qu'ils ne se retrouvent en production. Le tout est sorti comme une PR propre avec un vrai historique de commits.the WordPress Stack Advisor -- a free tool that takes a URL, fetches the site, detects the CMS and 30+ plugins, and returns a Claude-generated stack recommendation -- in roughly 8 working hours of session time. The brainstorming skill produced the input/output spec and the system prompt approach. Writing-plans broke the build into discrete tasks: detection module, Claude integration, UI page, CSP wiring, smoke test. Subagent-driven development delivered each task in isolation with a fresh agent context, while the main agent kept the architectural picture. TDD on the detection module caught two regex bugs before they landed in production. The whole thing went out as a clean PR with a real commit history.

Le cluster d'articles HIPAA

Trois articles, entièrement inter-liés, avec des images héros, un balisage schema, et une structure de lien interne vers l'article Next.js conforme HIPAA existant. Le brainstorming a mis en évidence l'analyse des lacunes (ce qu'AccountableHQ ne couvre pas, où les fils Reddit sont obsolètes). Les plans-d'écriture ont structuré le cluster : mise à niveau du post parent, deux nouveaux posts de soutien (Supabase + Vercel BAA, IA HIPAA), squelette de lien interne partagé. Les agents parallèles ont extrait les SERPs DataForSEO et mené des recherches web en direct sur Vercel, Supabase, OpenAI, Anthropic, Azure HIPAA pricing. Le développement piloté par subagent a produit chaque article. Le cluster a été livré en une session focalisée.HIPAA-compliant Next.js post. Brainstorming surfaced the gap analysis (what AccountableHQ doesn't cover, where Reddit threads are out of date). Writing-plans structured the cluster: parent post upgrade, two new supporting posts (Supabase + Vercel BAA, AI HIPAA), shared internal-link skeleton. Parallel agents pulled DataForSEO SERPs and live web research on Vercel, Supabase, OpenAI, Anthropic, Azure HIPAA pricing. Subagent-driven development produced each post. The cluster shipped in one focused session.

Comment j'utilise Superpowers pour les projets personnels

Le framework s'adapte remarquablement bien aux problèmes non professionnels. Trois exemples honnêtes :

Recherche de voyages

Planification des vacances en famille : brainstorming pour le brief réel (ce que les enfants tolèreront, quel est le budget réel, quelles dates fonctionnent), agents parallèles pour la recherche de restaurants, l'analyse d'hébergement et la notation d'itinéraire. Le résultat est un plan d'une page avec des citations vers les sources réelles, pas un article générique listicle. La seule compétence brainstorming vaut le coup d'installer -- elle force la conversation que la plupart des planifications familiales ignorent.

Finance et décisions

Les décisions financelles personnelles plus importantes (refinancement hypothécaire, achat de propriété, voiture) reçoivent le même traitement plan-writing que le travail commercial. Le résultat est une comparaison structurée avec les compromis explicites, pas une recommandation basée sur des impressions. La compétence receiving-code-review -- adaptée aux révisions non-code -- détecte les analyses manquantes que j'aurais sautées.

Contenu pour ma propre pratique d'écriture

Les essais personnels (le blog hors ligne, l'écriture au café, les réflexions tech) passent tous d'abord par le brainstorming. La plupart de mes meilleurs écrits personnels ont commencé par une conversation Superpowers de 30 minutes qui a fait émerger un angle que je n'aurais pas écrit par moi-même. La compétence agit comme un éditeur sympathique qui ne vous laissera pas écrire la version ennuyeuse.

Où Superpowers ne paie pas encore

  • Modifications triviales -- changements CSS une ligne, correction d'une typo unique, modification de copie d'un paragraphe. La surcharge des Superpowers devient une friction ici. Désactivez les étapes de workflow ou invoquez l'agent directement.
  • Exploration pure -- quand vous ne savez vraiment pas ce que vous construisez encore et vous avez besoin de tâtonner à travers cinq prototypes rapides. La compétence plan-writing essaie de structurer trop tôt ; le mode manuel est plus rapide.
  • Débogage sous pression temporelle -- la production est en panne, vous avez 10 minutes, le réflexe plan-first du framework est le mauvais réflexe. Utilisez la compétence systematic-debugging si nécessaire et sautez le workflow à sept étapes.
  • D'autres personnes dans l'équipe sans le framework. Si votre collaborateur utilise Claude Code brut et vous utilisez Superpowers, les artefacts (fichiers de plan, branches worktree, commits structurés) embrouillent le workflow plutôt que de le clarifier. Soit tout le monde l'exécute, soit personne ne le fait.

Installation et les premières 24 heures

Si vous utilisez Claude Code, l'installation est une seule commande :

/plugin install superpowers@claude-plugins-official

Après l'installation, les compétences se chargent automatiquement selon le contexte. Vous n'avez pas besoin de les mémoriser -- Claude se routifie lui-même. Les 24 premières heures les plus utiles sont de choisir intentionnellement un vrai projet (pas un jouet) et de laisser le framework s'exécuter. Le workflow à sept étapes sur une vraie fonctionnalité est ce qui vous enseigne la cadence. Lire le README ne suffit pas ; la valeur se compose avec l'usage.

Deux conseils de configuration qui m'ont pris une semaine à apprendre à la dure : gardez le répertoire worktree sur un SSD rapide (la compétence worktree en crée beaucoup), et ajoutez le plugin de compétence à votre dotfiles pour qu'il se déplace entre les machines. Il n'y a rien de pire que de démarrer une session sur un nouvel ordinateur portable et de manquer le workflow dont vous avez pris l'habitude.

FAQ

Superpowers est-il gratuit ?

Oui. Le framework est open source sous une licence permissive. L'installation se fait via la place de marché officielle du plugin Claude Code à aucun coût. Vous payez toujours Anthropic pour l'utilisation de Claude Code aux tarifs standard -- Superpowers ne change pas cela, mais il tend à utiliser plus de tokens par tâche parce qu'il exécute des plans plus riches et des agents parallèles. En pratique, cela a été un échange positif pour moi : plus de tokens, moins de sessions gaspillées.

Est-ce que ça remplace les compétences intégrées de Claude Code ?

Non. Superpowers est additif. Le propre système de compétences de Claude Code (compétences au niveau du projet, plugins de la place de marché) fonctionne toujours de la même façon. Superpowers s'insère à côté en tant que couche méthodologique -- le workflow à sept étapes, l'application du TDD, la dispatch d'agents parallèles -- qui orchestre comment les compétences sous-jacentes sont utilisées.

Est-ce que ça marche pour les tâches non codage ?

Oui, avec des réserves. Le framework a été construit pour le développement logiciel, et les compétences TDD et code-review sont évidemment orientées code. Mais le brainstorming, la rédaction de plans, la dispatch d'agents parallèles, et les compétences worktree se généralisent facilement à la production de contenu, au design, à la recherche, et aux projets personnels. Environ 40 % de mon utilisation de Superpowers maintenant est non-code, et le gain de productivité est comparable.

Comment ça se compare à d'autres frameworks agentiques ?

Les comparaisons les plus proches sont le mode agent de Cursor, Cline, et les workflows de planification d'Aider. Le différentiateur de Superpowers est la profondeur de la bibliothèque de compétences et l'application du TDD. Cursor et Cline excellent au niveau IDE ; Superpowers opère au niveau méthodologique. Ils sont complémentaires, non concurrents -- j'exécute Superpowers à l'intérieur de Claude Code tout en gardant Cursor pour l'édition en direct sur les tâches plus petites.

Quel est le piège ?

Deux réels. D'abord, vous devez vraiment l'utiliser ; lire le README et ne pas lancer le workflow vous laisse avec le même Claude Code qu'avant. Ensuite, le réflexe plan-first du framework est mauvais pour certaines tâches (exploration pure, débogage urgent). Savoir quand désactiver le workflow fait partie de la courbe d'apprentissage. Après environ deux semaines d'utilisation régulière, la cadence devient habituelle et vous arrêtez de penser à quelles compétences se déclenchent.

Lecture connexe

Claude Code pour WordPress : le workflow que mon agence exécute en 2026 -- le workflow d'agence Claude Code plus large, avec Superpowers s'intégrant en tant que couche méthodologique. -- the broader Claude Code agency workflow, with Superpowers slotting in as the methodology layer.

WordPress Stack Advisor -- un outil fonctionnel que j'ai construit en utilisant Superpowers en environ 8 heures de session, du début à la fin. -- a working tool I built using Superpowers in roughly 8 hours of session time, end to end.

Les alternatives à WordPress en 2026 : quand le no-code n'est pas la réponse -- le post regroupé que le workflow Superpowers writing-plans + parallel-research a produit en une seule session. -- the cluster post that the Superpowers writing-plans + parallel-research workflow produced as a single session.

L'agent est rapide. L'agent est capable. L'agent est structurellement optimiste. C'est la méthodologie qui empêche cet optimisme de se concrétiser.

Si vous voulez discuter de la façon d'intégrer Superpowers dans une vraie équipe d'ingénierie ou de contenu -- les problèmes humains, la conception du workflow, l'économie des coûts -- réservez un appel de 30 minutes. Je l'exécute maintenant sur chaque projet chez Seahawk Media et les modèles se généralisent selon la taille de l'équipe.book a 30-minute call. I run this on every project at Seahawk Media now and the patterns generalise across team sizes.

< BACK