Communitygithub.com

chirag127/skill-tdd

Cycle Rouge-Vert-Refactorisation TDD. PAS DE CODE DE PRODUCTION SANS UN TEST ÉCHOUANT D'ABORD. Empêche la triche des IA (écrire des tests APRÈS l'implémentation). À utiliser pour toute fonctionnalité ou correction de bug.

Qu'est-ce que skill-tdd ?

Cette compétence TDD impose une discipline de développement strictement pilotée par les tests, en appliquant le cycle Rouge-Vert-Refactorisation. Elle garantit qu'aucun code de production n'est écrit avant qu'un test ne prouve son besoin en échouant d'abord. Supporte les agents IA (Claude Code, Cursor, etc.) et les workflows AFK, avec déclenchement automatique silencieux si l'infrastructure de test est présente. Le skill vérifie que les tests échouent avec le message attendu (pas immédiatement verts), interdit les anti-patrons comme les tests couplés à l'implémentation ou tautologiques, et impose des tranches verticales (un test → une implémentation → refactorisation). Il commence par confirmer les points de couture public avec l'utilisateur avant d'écrire tout test. Chaque cycle est documenté formellement (couture, test Rouge, code Vert, refactorisation). La compétence est particulièrement utile pour bloquer les comportements de triche des IA qui écriraient des tests après l'implémentation.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add chirag127/skill-tdd

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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

ÉtapeActionDoit vérifier
ROUGEUN 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.
VERTCode 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.
REFACTORISATIONExtrayez des modules profonds selon [[deep-modules-over-shallow]]. Renommez pour plus de clarté. N'ajoutez jamais de comportement pendant la refactorisation.Reste vert.
BOUCLETest é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

Skills associés