Superpowers est un framework open source conçu pour transformer les agents de codage IA comme Claude Code, Cursor ou OpenCode en partenaires de développement efficaces. Contrairement aux outils IA qui génèrent du code de manière isolée, Superpowers impose une méthodologie d'ingénierie logicielle complète, de l'analyse des exigences à la revue de code, garantissant ainsi une qualité et une maintenabilité supérieures.

Architecture et Principes Fondamentaux

Ce système repose sur une architecture modulaire en trois couches :

• Noyau partagé : Fournit les mécanismes de base et l'enregistrement des compétences.
• Adaptateurs de plateforme : Interfaces spécifiques pour Claude Code, Cursor, et OpenCode.
• Compétences modulaires : Un ensemble d'étapes de workflow chargeables à la demande.

Les compétences clés incluent :

Configuration et Installation

Prérequis système : OS Windowss 10+, macOS 12+, ou Linux. 4 Go de RAM minimum (8 Go recomandés). Un accès réseau stable.

Pour Claude Code CLI

# Installer le CLI (macOS/Linux)
curl -fsSL https://claudecode.dev/install-script.sh | bash

# Ajouter le registre Superpowers (dans une session Claude)
/plugin registry add superpowers-official https://registry.sp.dev

# Installer le plugin
/plugin install superpowers-suite

Pour Cursor

# Via la palette de commandes (Cmd+K / Ctrl+K)
> Install Extension: Superpowers Workflow

# Ou manuellement
git clone https://github.com/superpowers-workflow/core.git ~/.cursor/extensions/superpowers
echo "Charger Superpowers au démarrage." > .cursorrules

Pour OpenCode

# Ajout du plugin
opencode plugin add superpowers-workflow

# Vérification
opencode plugin list

Utilisation et Flux de Travail

Les commandes principales guident l'IA à travers un processus rigoureux :

# 1. Analyse et conception
/superpowers:analyser-besoins "Système de gestion de panier d'achat avec calcul de taxes"

# 2. Planification détaillée
/superpowers:creer-plan "Refonte du module de recommandation"

# 3. Exécution contrôlée
/superpowers:executer-plan --profil=strict

# 4. Revue de code post-implémentation
/superpowers:lancer-revue --criticite=haute

Pour le débogage systématique :

# Déclenchement du diagnostic
/superpowers:diagnostiquer "La requête API renvoie 403, mais le token JWT est valide."

# L'IA suivra ensuite un protocole en 4 étapes :
# 1. Reproduction du scénario d'erreur
# 2. Isolation des composants suspects
# 3. Test des hypothèses avec des données instrumentées
# 4. Proposition d'un correctif minimal

Intégration dans les Processus Existants

Pour une collaboration d'équipe, créez un fichier .superpowers.yml à la racine du projet définissant les normes partagées. Les branches Git peuvent être gérées via :

# Isoler le développement d'une fonctionnalité
/superpowers:isoler-travail --nom-fonctionnalite=nouvel-algo

# Finaliser avant la fusion
/superpowers:finaliser-branche --avec-checklist-deploiement

L'intégration CI/CD se fait naturellement : les tests générés par developpement-dirige-par-tests sont récupérables par le pipeline, et les rapports de revue-de-code-demandee peuvent bloquer le merge si des défauts critiques sont détectés.

Personnalisation et Extensions

Créez vos propres compétences adaptées aux besoins spécifiques de votre projet. Définissez un fichier JSON dans le répertoire skills/custom :

{
  "id": "audit-securite-owasp",
  "nom": "Vérification Sécurité OWASP",
  "declencheurs": ["audit", "pentest", "vulnerabilite"],
  "script": "./scripts/owasp-audit.js"
}

Cette compétence personnalisée pourra ensuite être invoquée via /superpowers:executer audit-securite-owasp.