Module 4 — Spec Kit : spécifications exécutables — Développement par spécification — le pack Praktik

Temps de pratique : 30 min

Objectif

À la fin de ce module, tu auras créé une spec exécutable, généré un plan technique, et produit du code via /speckit.implement.

Quand utiliser Spec Kit

Scénario	Pourquoi Spec Kit
API publique / SDK	Contracts + traceability
Équipe avec standards	Constitution partagée
Projet greenfield from scratch	Workflow complet 0-to-1
Besoin de compliance	Presets réglementaires
Multi-stack (explorer plusieurs techs)	Creative Exploration
Legacy à moderniser	Brownfield iteratif

Prérequis

Python 3.11+
uv (curl -LsSf https://astral.sh/uv/install.sh | sh)
Git
Un agent IA (Claude Code, Copilot, Gemini, Codex)

Étape 1 — Installation

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

Vérifie :

specify version
specify check

Étape 2 — Initialiser

specify init mon-projet --integration claude
cd mon-projet

Étape 3 — Le workflow complet

3a. Constitution

/speckit.constitution Ce projet suit une approche API-First. TDD systématique. Pas d'abstraction prématurée. Dépendances minimisées.

3b. Specify (le QUOI)

/speckit.specify Construis un gestionnaire de photos avec albums groupés par date. Drag-and-drop sur la page principale. Pas d'albums imbriqués. Photos en grille de tuiles.

Règle d’or : pas de stack technique ici.

3c. Clarify

/speckit.clarify Concentre-toi sur les cas limites : deux albums même date ? Format HEIC ?

3d. Checklist

/speckit.checklist

3e. Plan (le COMMENT)

/speckit.plan Vite, vanilla HTML/CSS/JS, SQLite locale via sql.js.

3f. Tasks

/speckit.tasks

3g. Analyze

/speckit.analyze

3h. Implement

/speckit.implement

Le workflow en résumé

@diagram:flow
constitution :: Principes du projet (API-First, TDD...).
specify :: Le QUOI, sans stack technique.
clarify :: Cas limites et ambiguïtés.
checklist :: Critères de complétude.
plan :: Le COMMENT, stack incluse.
tasks :: Tâches ordonnées.
analyze :: Cohérence du plan.
implement :: Génération du code.

Pour un prototype rapide, raccourci :

specify → plan → tasks → implement

Extensions et Presets

# Ajouter une capacité (Jira, code review post-implé...)
specify extension search
specify extension add <nom>

# Personnaliser le format (compliance, langue...)
specify preset search
specify preset add <nom>

Checklist de validation

specify version retourne un numéro
.specify/memory/constitution.md existe
specs/001-.../spec.md décrit le QUOI sans stack
plan.md détaille le COMMENT
tasks.md a des tâches ordonnées
/speckit.implement a produit du code

Piège courant

Mélanger quoi et comment dans specify. → Mentionner React dans specify contraint l’agent avant validation. Garde la stack pour /speckit.plan.

Prochaine étape

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