Astuce CLAUDE.md, tests avant correction de bugs

C'est probablement le meilleur rapport entre l'effort et le résultat de toute cette vitrine. Quatre lignes collées une fois, et vos bugs cessent de revenir.

La règle

Quand je signale un bug, ne commence pas par essayer de le corriger.
Commence plutôt par écrire un test qui reproduit le bug.
Ensuite, utilise des sous-agents pour corriger le bug et prouve-le
avec un test qui passe.

Version anglaise, si votre CLAUDE.md est en anglais :

When I report a bug, don't start by trying to fix it. Instead, start by
writing a test that reproduces the bug. Then, have subagents try to fix
the bug and prove it with a passing test.

Pourquoi ça marche

Le comportement par défaut face à un bug signalé est de proposer une correction tout de suite. Elle a l'air juste, elle est appliquée, et on passe à la suite. Trois problèmes en découlent, et vous les avez tous rencontrés.

On corrige un symptôme. Sans reproduction, rien ne prouve que la cause a été touchée. Le bug revient sous une autre forme la semaine suivante.

On ne sait pas si c'est réparé. « Ça devrait marcher » n'est pas une preuve. Un test qui échouait et qui passe en est une.

Le bug peut revenir. Un correctif sans test ne laisse aucune trace. Le prochain remaniement le défait, et personne ne s'en aperçoit.

Écrire le test d'abord règle les trois d'un coup. Et il y a un effet secondaire que peu de gens anticipent : dans un cas sur cinq environ, l'écriture du test révèle que le bug n'est pas là où on croyait.

Comment l'installer

Collez le bloc dans ~/.claude/CLAUDE.md pour qu'il s'applique à tous vos projets, ou dans le CLAUDE.md d'un projet précis.

Puis tenez bon les premières fois. La tentation de dire « corrige juste ça vite fait » est forte, surtout quand le bug paraît évident. Ce sont précisément les bugs évidents qui reviennent.

Où ça se trouve

Cette ressource vit chez son auteur, et c'est mieux ainsi : elle y reste à jour. https://claude.ai/code