Installer spec-kit · Guide complet

Le principe en 10 secondes

Sans spec-kit (vibe coding) : tu prompts au hasard, code spaghetti, bugs partout, projet ingérable en 30 min.

Avec spec-kit (spec-driven) : tu écris une spec claire d'abord, architecture carrée, tâches ordonnées, projet propre et maintenable.

Prérequis

• uv : gestionnaire de paquets Python
• Python 3.11+
• Git
• Un agent IA compatible : Claude Code, Cursor, Copilot, Gemini CLI, Codex…

Étape 1 : Installer Specify CLI

Installation persistante (recommandée) :

uv tool install specify-cli --from git+https://github.com/github/spec-kit.git

Vérifie que tout est OK :

specify check

Étape 2 : Initialiser ton projet

# Nouveau projet
specify init mon-projet --ai claude

# Ou dans le dossier courant
specify init . --ai claude

Lance ensuite ton agent (claude) dans le dossier. Tu sais que c'est bon quand les commandes /speckit.* apparaissent.

Étape 3 : Le workflow en 5 commandes

1. /speckit.constitution : Tu poses les règles du projet (qualité, tests, UX, performance)
2. /speckit.specify : Tu décris CE que tu veux (le quoi et le pourquoi, pas la stack)
3. /speckit.plan : Tu donnes la stack et l'architecture
4. /speckit.tasks : L'IA découpe en tâches ordonnées avec dépendances
5. /speckit.implement : L'IA construit dans le bon ordre, en suivant le plan

Commandes optionnelles

• /speckit.clarify : Clarifie les zones floues (avant /speckit.plan)
• /speckit.analyze : Vérifie la cohérence entre spec, plan et tâches
• /speckit.checklist : Génère des checklists qualité

Récap express

1. uv tool install specify-cli … → 2. specify init . --ai claude → 3. /speckit.constitution → /speckit.specify → /speckit.plan → /speckit.tasks → /speckit.implement.

La spec d'abord. Le code ensuite.