Spec-Driven Development (fr)

Pourquoi ce livre

Chapitre 1 : Le vibe coding : ça marche jusqu’à ce que ça ne marche plus

1. Le projet qui va bien jusqu’à ce qu’il n’aille plus bien
2. Les trois symptômes
3. Le symptôme que tu ne vois pas
4. Le coût réel
5. Pourquoi ça arrive
6. L’erreur que presque tout le monde commet
7. Ce n’est pas un problème d’IA
8. Ce qui vient ensuite

Chapitre 2 : Qu’est-ce que le SDD (et ce qu’il n’est pas)

1. Ce que ce n’est pas
2. Comment on en est arrivés là
3. Pourquoi maintenant
4. Le tableau qui résume tout
5. Ce que le SDD ne résout pas
6. Une définition à garder

Chapitre 3 : La spec comme artefact primaire

1. Pourquoi les specs traditionnelles échouent
2. La spec vivante
3. Comportement, pas architecture
4. Ce qu’une spec contient et ce qu’elle ne contient pas
5. Le contrat entre toi et l’agent
6. Combien de temps prend l’écriture d’une spec
7. La spec la plus courte que tu puisses écrire
8. Avant de continuer

Chapitre 4 : Les 7 phases du développement avec l’IA

1. Phase 1 : Idée
2. Phase 2 : Research
3. Phase 3 : Prototype
4. Phase 4 : PRD
5. Phase 5 : Kanban
6. Phase 6 : Execution loop
7. Phase 7 : QA
8. Quand sauter des phases
9. Le flux complet

Chapitre 5 : Le PRD — comment écrire une spec que l’IA ne va pas mal interpréter

1. Avant d’écrire : le grilling
2. Les huit parties du PRD
3. Un PRD complet
4. Où vit le PRD
5. La bonne longueur

Chapitre 6 : Du PRD aux issues — vertical slices et tracer bullets

1. Qu’est-ce qu’un vertical slice
2. Tracer bullets : l’incertain passe en premier
3. Blocking relationships
4. Ce que doit contenir une issue exécutable
5. Une issue mal écrite et une bien écrite
6. Comment créer les issues
7. Avant le prochain chapitre

Chapitre 7 : La boucle d’exécution

1. Le contrat avec l’agent
2. Ralph loop
3. Boucle multi-agent
4. Quand intervenir
5. L’humain lit toujours le code
6. GSD : gestion du contexte entre les sessions
7. Le QA comme issue, pas comme rustine de dernière minute
8. La boucle complète en une image

Chapitre 8 : GitHub SpecKit — le SDD avec une structure formelle

1. Qu’est-ce que SpecKit ?
2. Installation et structure de répertoires
3. La constitution
4. Les 5 commandes du flux principal
5. Les 3 commandes de qualité
6. Branch strategy : la spec voyage avec le code
7. Quand utiliser SpecKit
8. En pratique

Chapitre 9 : openSpec — des specs légères pour des projets existants

1. Qu’est-ce qu’openSpec
2. Le problème qu’il résout
3. Comment ça marche
4. Le cas brownfield
5. Un exemple réel
6. La différence avec « bien écrire le prompt »
7. Quand migrer vers SpecKit
8. Points clés
9. En pratique

Chapitre 10 : Flux agnostiques de l’outil

1. Ralph loop
2. GSD
3. BMAD
4. ShipSpec
5. Tessl
6. Living-spec platforms
7. Comment choisir
8. Ce qui arrive dans la Partie IV
9. En pratique

Chapitre 11 : Greenfield vs brownfield

1. Greenfield : le scénario idéal
2. Le piège du greenfield
3. Brownfield : la réalité de la plupart
4. L’adoption graduelle
5. Le retrofit de SpecKit
6. Brownfield sans SpecKit
7. Ce que le brownfield enseigne sur le greenfield
8. Une règle pour chaque contexte

Chapitre 12 : Les 5 anti-patterns qui détruisent une spec

1. Anti-pattern 1 : Le PRD kilométrique
2. Anti-pattern 2 : Prescrire l’implémentation
3. Anti-pattern 3 : Out of Scope vide
4. Anti-pattern 4 : Assumptions vides ou absentes
5. Anti-pattern 5 : Acceptance Criteria vagues
6. Anti-pattern 6 (bonus) : Abandonner la spec en plein milieu de l’exécution
7. Le check rapide

Chapitre 13 : SDD en équipe

1. La spec comme langage commun
2. Qui écrit le PRD
3. Review des specs, pas du code
4. La constitution partagée
5. SDD asynchrone
6. Le risque des specs de façade
7. SDD comme pratique de gouvernance
8. Ce que SDD ne remplace pas
9. Avant le cas pratique

Chapitre 14 : le SDD en pratique — le cycle complet

1. Le ticket tel qu’il arrive
2. Le grilling
3. Le PRD
4. Du PRD aux issues
5. La boucle d’exécution
6. Ce que produit l’agent
7. Ce que la spec a acheté
8. Le plan de QA

Chapitre 15 : Cas complet — système de notifications multicanal

1. Le ticket tel qu’il arrive
2. Le grilling
3. Le PRD
4. Du PRD aux issues : trois vertical slices
5. La boucle d’exécution
6. Le plan de QA
7. Ce que la spec a acheté
8. La différence entre les deux cas

Chapitre 16 : Cas complet — transformer une API interne en un contrat public avec OpenSpec

1. Le ticket tel qu’il arrive
2. Le problème avant le code
3. /opsx:onboard — photographie du système réel
4. Le grilling — les questions du contrat
5. Le PRD — le contrat avant le code
6. /opsx:propose partner-orders-v1 + revue des artefacts
7. /opsx:apply + la décision de versioning
8. /opsx:archive — le spec delta comme artefact business
9. Ce que reçoit Acme Corp
10. /opsx:verify — quand le contrat se heurte à la réalité
11. La politique de versioning comme gate de CI
12. Ce qu’OpenSpec ajoute que le SDD manuel n’a pas

Annexe : Glossaire SDD