Module 5 — Superpowers : skills auto-déclenchés et TDD strict

Temps de pratique : 20 min

---

Objectif

À la fin de ce module, tu auras configuré Superpowers, utilisé un skill auto-déclenché, et passé une feature complète avec TDD.

---

Quand utiliser Superpowers

Scénario	Pourquoi Superpowers
Solo dev autonome	Pas de doc lourde, skills auto
TDD strict	Iron Law : tests avant code
Code review automatique	Critique agent avant commit
Refacto legacy	Map codebase + tests de non-régression
Projet long (multi-sessions)	Plans persistants dans docs/plans/

---

Prérequis

• Node.js ≥ 20 (node -v)
• Git initialisé (git init)
• Un agent IA (Claude Code, Codex, Cursor)

---

Étape 1 — Installation

git clone https://github.com/obra/superpowers.git
cd superpowers
npm install

Ou via npm (si publié) :

npm install -g superpowers-cli

---

Étape 2 — Structure d’un skill

Un skill = un fichier YAML dans skills/.

# skills/api-endpoint.yaml
name: api-endpoint
triggers:
  - pattern: "créer un endpoint"
  - pattern: "nouvelle route API"
  - pattern: "POST /.*"
steps:
  1_plan:
    action: brainstorm
    output: docs/plans/{timestamp}-api-plan.md
  2_test:
    action: generate_tests
    framework: vitest
    rule: tests_must_fail_first
  3_impl:
    action: implement
    constraint: make_tests_pass
  4_review:
    action: critique
    criteria: [security, performance, edge_cases]
  5_commit:
    action: commit
    message_template: "feat(api): {description}"

---

Étape 3 — Workflow complet

3a. Brainstorm

/superpowers brainstorm "Système de notifications push"

Génère docs/plans/20250601-push-notif.md avec :

• Architecture
• Endpoints
• Modèle de données
• Dépendances

3b. Worktree

/superpowers worktree feature/push-notif

Crée une branche isolée. Le skill s’active automatiquement quand tu entres dans le dossier.

3c. Plan

/superpowers plan

Décompose en tâches atomiques. Chaque tâche = 1 subagent.

3d. Subagent Dev

/superpowers dev --task 1

1 subagent par tâche. Pas de dépendances croisées.

3e. TDD

/superpowers test --watch

Iron Law : les tests doivent échouer avant que le code ne soit écrit.

3f. Review

/superpowers review

Critique agent sur :

• Sécurité (injection, auth)
• Performance (N+1, mémoire)
• Edge cases (null, overflow)

3g. Merge

/superpowers merge

Squash + message conventionnel.

---

Le workflow en résumé

@diagram:flow
brainstorm :: Plan d'architecture dans docs/plans/.
worktree :: Branche isolée, skill auto-activé.
plan :: Décomposition en tâches atomiques.
subagent-dev :: 1 subagent par tâche.
TDD :: Tests d'abord (Iron Law).
review :: Critique sécurité, perf, edge cases.
merge :: Squash + message conventionnel.

---

Checklist de validation

• Un skill YAML créé dans skills/
• Le skill s’active sur le bon pattern
• brainstorm a généré un plan dans docs/plans/
• worktree a créé une branche isolée
• Les tests échouent avant l’implémentation (TDD)
• review a détecté au moins un problème
• Le merge est propre (squash + message conventionnel)

---

Piège courant

Sauter le brainstorm. → Sans plan, le subagent dérive. 5 min de brainstorm = 30 min de refacto en moins.

---

Prochaine étape

→ Module 8 (Enchaînements) pour combiner Superpowers + Spec Kit