Module 10 — Playbooks : workflows prêts à l'emploi — Développement par spécification — le pack Praktik

Temps de pratique : 25 min

Objectif

À la fin de ce module, tu auras 5 playbooks copier-coller pour les situations les plus courantes.

Playbook 1 : Hotfix en 10 min

Quand : Bug en production, pas le temps de niaiser.

Framework : BMAD Quick Flow

# 1. Créer la story (30 sec)
npx bmad-method create-story --track quick-flow --id hotfix-$(date +%s)

# 2. Décrire le bug dans la story
# "Login échoue avec erreur 500 sur /api/auth quand email contient un +"

# 3. Développer (5 min)
npx bmad-method dev-story --id hotfix-XXXX

# 4. Vérifier le diff (2 min)
# Relis chaque fichier avant d'accepter

# 5. Commit et push
git add .
git commit -m "fix(auth): handle + in email addresses"
git push origin main

Playbook 2 : Nouvelle feature from scratch

Quand : Tu démarres une feature utilisateur complète.

Combo : Spec Kit → Superpowers

# 1. Constitution (2 min)
/speckit.constitution TDD strict, pas d'abstraction prématurée

# 2. Spec (5 min)
/speckit.specify Système de tags pour les articles de blog

# 3. Clarify (3 min)
/speckit.clarify Tags uniques ? Limite de tags par article ?

# 4. Plan (3 min)
/speckit.plan Next.js, Prisma, PostgreSQL, Zod

# 5. Tasks (2 min)
/speckit.tasks

# 6. Implement (10 min)
/speckit.implement

# 7. TDD avec Superpowers
superpowers worktree feature/tags
superpowers test --watch
superpowers review
superpowers merge

Playbook 3 : Refacto legacy sans casser

Quand : Tu dois moderniser du code sans régression.

Combo : Open GSD → Superpowers

# 1. Cartographier (5 min)
/gsd-map-codebase

# 2. Planifier (5 min)
/gsd-new-project --auto @refacto.md

# 3. Exécuter en TDD (20 min)
superpowers worktree feature/refacto-auth
superpowers plan
superpowers dev --task 1
superpowers test --watch
superpowers review
superpowers merge

Playbook 4 : POC en un après-midi

Quand : Tu veux valider une idée rapidement.

Framework : Open GSD (yolo)

# 1. Initialiser (2 min)
/gsd-new-project --auto @idee.md

# 2. Planifier sans recherche (3 min)
/gsd-plan-phase 1 --yolo --skip-research

# 3. Exécuter (1h)
/gsd-execute-phase 1

# 4. Vérifier (10 min)
/gsd-verify-work 1

# 5. Décider : jeter ou structurer
# Si ça marche → passer à Spec Kit pour la vraie spec

Playbook 5 : API publique documentée

Quand : Tu exposes une API pour des tiers.

Combo : Spec Kit → BMAD Enterprise

# 1. Spec complète (15 min)
/speckit.constitution API-First, OpenAPI 3.1, rate limiting 100 req/min
/speckit.specify API de réservation de salles de réunion
/speckit.clarify Fuseaux horaires ? Récurrence ? Annulation < 24h ?
/speckit.checklist
/speckit.plan Node.js, Fastify, Prisma, Redis
/speckit.tasks
/speckit.analyze

# 2. Implémentation structurée
npx bmad-method create-story --track enterprise --id api-reservation
npx bmad-method dev-story --id api-reservation
npx bmad-method code-review --id api-reservation

Tableau de choix rapide

Situation	Playbook	Framework	Durée
Bug en prod	Hotfix	BMAD Quick Flow	10 min
Nouvelle feature	Feature	Spec Kit → Superpowers	2–4 h
Refacto legacy	Refacto	Open GSD → Superpowers	1–2 j
POC rapide	POC	Open GSD (yolo)	1–4 h
API publique	API	Spec Kit → BMAD Enterprise	3–5 j

Checklist de validation

J’ai copié au moins 1 playbook
Je sais quel playbook utiliser selon la situation
Je peux estimer le temps nécessaire
Je connais les points de friction de chaque playbook

Fin du pack

Tu as maintenant :

Une matrice de décision (Module 1)
4 frameworks maîtrisés (Modules 2–7)
Des combos pour les cas complexes (Module 8)
6 scénarios réels (Module 9)
5 playbooks copier-coller (Module 10)

Prochaine étape : choisir un projet réel et appliquer le Module 1.