// Best Practices IA

Superpowers

Le kit de skills, sous-agents et commandes signé Jesse Vincent qui transforme Claude Code d'agent généraliste en équipe disciplinée. Crédit intégral à l'auteur — je n'en suis qu'utilisateur.

Outil conçu par Jesse Vincent (obra)· 2026-05-09

Ce que c'est

Superpowers est un kit de fichiers à déposer dans `.claude/` qui ajoute trois choses à Claude Code : des skills (mémos d'expertise réutilisables), des sub-agents (rôles spécialisés avec leur propre contexte et leur propre périmètre d'outils), et des slash-commands (workflows orchestrés).

L'effet de bord, peut-être le plus important, c'est que Claude Code arrête de répondre tout seul à tout. Il appelle le bon skill, il dispatche au bon sous-agent, il suit le workflow. La discipline n'est plus dans la mémoire du dev, elle est dans le repo.

Comment ça marche

Un sous-agent Superpowers est un fichier markdown avec un frontmatter qui décrit son nom, son modèle, ses outils et sa mission. Exemple, mon agent CSO (Chief Security Officer) que j'invoque sur tout ce qui est sensible :

---
name: cso
model: opus
tools: [Read, Grep, Glob]
description: Security review — IDOR, RLS, CSP
---

Mission : challenger les risques sécurité de la PR.

Quand je lance un /call-tech-lead, l'orchestrateur dispatche en parallèle plusieurs sous-agents (sécurité, tests, perf, accessibilité) qui répondent SANS voir les avis des autres au premier round. Ensuite seulement, le tech lead compare les opinions, détecte les désaccords, arbitre. C'est la convergence après débat, pas la convergence par mimétisme.

Le routing de profondeur est explicite : lean pour un bug compris ou un petit refacto, standard pour une feature normale (le défaut), full pour les sujets sensibles — auth, paiement, PII, IA, pricing. Si la tâche est triviale, pas de sous-agent : édition directe.

Comment l'installer

Cloner le kit depuis GitHub et le poser dans le projet (ou en global dans `~/.claude/`) :

git clone https://github.com/obra/superpowers ~/superpowers
cp -R ~/superpowers/.claude/agents .claude/
cp -R ~/superpowers/.claude/skills .claude/
cp -R ~/superpowers/.claude/commands .claude/

Au prochain lancement de Claude Code, les skills et sous-agents apparaissent automatiquement. Les commandes s'invoquent par /nom-de-commande.

Comment je l'utilise au quotidien

Sur ce site qaconsulting.fr par exemple, chaque plan d'implémentation passe par : skill `brainstorming` pour cadrer, skill `writing-plans` pour produire le plan, skill `subagent-driven-development` pour exécuter, et un final review par sous-agent dédié avant la PR.

Le bénéfice n'est pas juste une meilleure qualité — c'est aussi que je n'ai plus besoin de me souvenir des étapes. Le repo se souvient pour moi. Et un autre dev qui reprend le projet a accès au même outillage que moi sans onboarding.

Sources & crédits

Superpowers est conçu et maintenu par Jesse Vincent (handle GitHub : `obra`). Tout le crédit du design des skills, sous-agents et commandes lui revient. Cet article reflète mon usage personnel.

Sources & crédits