tdd — Rouge-Vert-Refactorisation
La Loi Infaillible
PAS DE CODE DE PRODUCTION SANS UN TEST ÉCHOUANT D'ABORD.
Vous avez écrit du code avant le test ? Supprimez-le. Recommencez. Aucune exception — ne le conservez pas comme "référence", ne l'"adaptez" pas en écrivant les tests, ne le regardez pas. Implémentez à nouveau à partir des tests.
Violer la lettre des règles, c'est en violer l'esprit.
Déclencheur
Déclenchez sur : "TDD ceci" · "rouge-vert-refactorisation" · "test d'abord" · nouvelle fonctionnalité · correction de bug · refactorisation · changement de comportement. En mode AFK, tâche selon [[afk-vs-hitl-tasks]] avec infrastructure de test présente, déclenchez silencieusement.
Exceptions (demandez d'abord) : prototypes jetables, code généré, fichiers de configuration.
Vous pensez "sauter le TDD juste cette fois" ? Arrêtez. C'est une rationalisation — voir references/rationalizations.md si vous hésitez.
Précondition
Boucle de test < 60 s selon [[feedback-loops-are-the-ceiling]]. Boucle lente → corrigez la boucle D'ABORD, ne sautez jamais le TDD pour contourner des tests lents.
Lisez d'abord CONTEXT.md + les ADR du domaine — les noms de tests et le vocabulaire des interfaces correspondent au langage du domaine du projet. (Étape vocabulaire-domaine de Matt Pocock 2026-07-08.)
Points de couture — accordez d'abord
Point de couture = frontière publique où vous observez le comportement, sans accéder à l'interne. Les tests vivent aux coutures, jamais sur les parties internes. Le code change ; les tests ancrés aux coutures survivent.
Confirmez les points de couture avec l'utilisateur avant d'écrire tout test. Aucun test écrit sur une couture non confirmée. L'effort porte sur les chemins critiques + la logique complexe, pas sur tous les cas limites. Demandez : "Quels points de couture devrions-nous tester ?" (Cadre des coutures de Matt Pocock 2026-07-08.)
Le cycle — ordre strict
| Étape | Action | Doit vérifier |
|---|---|---|
| ROUGE | UN test échouant sur une couture convenue. Comportement observable le plus petit. Vrai code, pas de mocks sauf inévitable. Nom clair, pas de "et". | Le test ÉCHOUE avec l'erreur attendue. Réussi immédiatement ? Vous testez un comportement existant — corrigez le test. Erreurs ? Corrigez l'erreur, relancez jusqu'à ce qu'il échoue correctement. |
| VERT | Code minimum pour passer. Pas d'options YAGNI. Pas de gestion d'erreur non testée. | Le test RÉUSSIT. Les autres tests réussissent toujours. Résultat impeccable. Échec ? Corrigez le code, jamais le test. |
| REFACTORISATION | Extrayez des modules profonds selon [[deep-modules-over-shallow]]. Renommez pour plus de clarté. N'ajoutez jamais de comportement pendant la refactorisation. | Reste vert. |
| BOUCLE | Test échouant suivant. Tranche verticale — un test → une implémentation → répétez, chaque balle tracer répond à ce que le cycle précédent a appris. Retour à ROUGE. | — |
Anti-patrons — verrouillés
- Couplé à l'implémentation — mocke les collaborateurs internes, teste les méthodes privées, vérifie par canaux secondaires (requête DB vs interface). Indice : casse lors d'une refactorisation sans changement de comportement.
- Tautologique — l'assertion recalcule la valeur attendue comme le code le fait (
expect(add(a,b)).toBe(a+b), snapshot dérivé à la main, constante-égale-à-elle-même). Passe par construction. Valeurs attendues issues d'une source indépendante : littéral connu correct, exemple travaillé, spécification. (Cadre tautologique de Matt Pocock 2026-07-08.) - Tranche horizontale — tous les tests d'abord, puis toute l'implémentation. Vérifie un comportement imaginé ; les tests deviennent insensibles aux changements réels. Travaillez uniquement en tranches verticales. (Cadre horizontal vs vertical de Matt Pocock 2026-07-08.)
Anti-triche — verrouillé
- DOIT voir le résultat du test échouant avant d'écrire du code de production.
- NE DOIT PAS écrire plusieurs tests avant que le premier ne passe.
- NE DOIT PAS sauter la refactorisation.
- NE DOIT PAS réécrire le test pour correspondre à l'implémentation après coup.
Test écrit APRÈS le code = en forme de code, pas en forme de spécification. Cela rejette l'objectif.
Format de sortie par cycle
COUTURE : <interface publique testée>
ROUGE : <nom du test> → <message d'échec attendu>
VERT : <fichiers modifiés, delta LOC>
REFACTORISATION : <ce qui a été extrait/renommé>
Références croisées
- feedback-loops-are-the-ceiling
- deep-modules-over-shallow
- afk-vs-hitl-tasks
references/rationalizations.md— chaque contre-argument "le TDD est dogmatique" + la contrepartie- Source : Kent Beck 1999 · obra/superpowers test-driven-development fusionné le 2026-07-04 · Matt Pocock 2026-07-04 (liste de vérification de la compétence) + 2026-07-08 (coutures, tautologique, tranche verticale, CONTEXT.md)