Premier projet¶

De git init au premier commit, étape par étape.

Étape 1 — Créer le projet¶

mkdir mon-projet
cd mon-projet
git init
git checkout -b main

Étape 2 — Générer le PROMPT.md¶

Lancez Claude Code :

claude

Collez le prompt générateur et répondez aux questions.

Claude génère PROMPT.md à la racine.

Étape 3 — Commit initial¶

git add PROMPT.md
git commit -m "docs: add project specification"

Étape 4 — Nouvelle session¶

Session fraîche obligatoire

L'interview a consommé du contexte. Quittez et relancez :

# Quitter la session en cours
/exit

# Relancer avec un contexte propre
claude

Étape 5 — Écrire le plan de la Phase 1¶

Le workflow Superpowers est la source de vérité : on invoque les skills, on ne réécrit pas leur logique.

Dans la nouvelle session :

Lis PROMPT.md à la racine. C'est la spec complète du projet.
Invoque /superpowers:brainstorming pour la Phase 1 — Fondations
(setup projet, CLAUDE.md, linting/tests, structure, commit initial).

Le skill brainstorming creuse l'intention, les cas limites et les choix structurants avant toute ligne de code.

Une fois le brainstorming convergé, passez à l'écriture du plan :

Invoque /superpowers:writing-plans pour produire le plan d'exécution
de la Phase 1. Stocke-le dans superpowers/plans/.

Le plan est un artefact versionné, découpé en tâches granulaires avec critères d'acceptation.

Étape 6 — Exécuter le plan¶

Pour une exécution séparée avec checkpoints de review :

Invoque /superpowers:executing-plans sur le plan de la Phase 1.

Pour une exécution dans la session courante avec sous-agents :

Invoque /superpowers:subagent-driven-development sur le plan de la Phase 1.

Isoler dans un worktree

Pour les plans longs ou les exécutions en arrière-plan, demandez un worktree dédié : Invoque /superpowers:using-git-worktrees avant de démarrer l'exécution.

Étape 7 — Le CLAUDE.md est généré¶

À la fin de la Phase 1, Claude aura crée un CLAUDE.md qui contient :

Les commandes du projet (pnpm dev, pnpm test, pnpm lint)
La structure de dossiers réelle
Les conventions issues du PROMPT.md, adaptées au code existant

Ce fichier est lu automatiquement à chaque nouvelle session.

Étape 8 — Itérer feature par feature¶

Pour chaque feature d'une phase suivante, répétez la chaîne de skills :

Phase 2, feature 5 : [nom de la feature].
1. /superpowers:brainstorming — cas limites et règles métier
2. /superpowers:writing-plans — plan granulaire
3. /superpowers:executing-plans — exécution avec checkpoints
Pour les librairies 🟡/🔵 du PROMPT.md, invoque Context7 avant chaque API.

Un prompt par feature

Ne demandez pas toute la Phase 2 d'un coup. Une feature à la fois = meilleur contexte = meilleur code.

Étape 9 — Review et commit¶

Après chaque feature implémentée, déléguez la review au skill dédié :

Invoque /superpowers:requesting-code-review sur les changements
depuis le dernier commit. Vérifie la conformité avec PROMPT.md
et CLAUDE.md, lance les tests et le linter.

Puis /superpowers:verification-before-completion avant toute revendication de complétion, enfin le commit :

/commit

Ou pour le workflow complet (commit + push + PR) :

/commit-push-pr

Claude stage les fichiers, génère un message conventional, pousse et ouvre une PR.

Étape 10 — Finir la branche¶

Quand l'implémentation est complète, tests au vert :

Invoque /superpowers:finishing-a-development-branch.

Le skill présente les options d'intégration (merge, PR, cleanup) et guide la finalisation — incluant /clean_gone pour supprimer les branches [gone] et leurs worktrees.