Chapitre 4 · Quand ça coince
La règle des deux échecs
Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.
Suivre gratuitementPourquoi cette règle
Voici le piège classique. Claude Code tente une correction. Ça ne marche pas. Il en tente une deuxième par-dessus. Toujours pas. Une troisième, une quatrième. Chaque essai ajoute des changements aux précédents. Au bout d'un moment, le fichier est plein de corrections empilées, le bug d'origine n'est pas réglé, et d'autres problèmes sont apparus.
Exemple : le menu mobile ne s'ouvre plus. Premier essai : Claude Code modifie le script du menu. Toujours bloqué. Deuxième essai : il change le style du bouton. Le menu s'ouvre, mais il passe maintenant derrière l'image d'accueil. Troisième essai : il modifie la mise en page de l'en-tête. Le logo est décalé sur ordinateur. Tu es parti d'un problème, tu en as trois.
La règle est simple :
Si une correction échoue deux fois, on revient au dernier commit qui fonctionnait et on reprend l'analyse à zéro.
Comment appliquer la règle
1. Compter les essais
Un essai, c'est : correction, puis vérification dans le navigateur. Si le problème est toujours là après la vérification, c'est un échec. Au deuxième échec, tu t'arrêtes.
2. Revenir au dernier point sûr
Grâce à ton commit « Avant », tu sais exactement où revenir. Demande à Claude Code d'annuler les essais ratés. Comme tu l'as vu au chapitre 2, git revert défait des commits sans rien effacer de l'historique. Si les essais n'ont pas encore été enregistrés dans un commit, git restore remet les fichiers dans l'état du dernier commit (en perdant ces changements non sauvegardés, ce qui est justement le but ici).
3. Reprendre l'analyse avec plus d'informations
Deux échecs, c'est le signe que la cause n'a pas été trouvée. Avant un troisième essai, enrichis la description : nouvelle capture, messages de la console, autre appareil, étapes plus précises. Demande à Claude Code de relire le code depuis le début, sans s'appuyer sur ses hypothèses précédentes.
Le prompt à copier
Deux corrections ont échoué. On applique la règle des deux échecs.
1. Montre-moi les derniers commits (git log --oneline) et l'état des
fichiers (git status).
2. Propose de revenir au commit « [message du dernier commit qui
marchait] » : explique-moi la méthode que tu vas utiliser
(git revert de préférence), puis attends mon accord.
N'utilise pas git reset --hard.
3. Une fois revenu, vérifions ensemble que le site est bien comme avant.
4. Puis reprends l'analyse à zéro : relis le code concerné, oublie tes
hypothèses précédentes, et explique-moi la cause probable en mots
simples avant de proposer une nouvelle correction.
Voici de nouvelles informations : [capture, console, appareil, étapes].
Tu peux aussi ajouter la règle dans ton CLAUDE.md, pour que Claude Code l'applique de lui-même :
## Règle des deux échecs
Si une correction échoue deux fois, ne tente pas de troisième correction.
Propose de revenir au dernier commit qui fonctionnait et reprends
l'analyse à zéro.
Erreurs à éviter
- « Encore un essai, ça va finir par marcher. » C'est exactement ce que la règle t'interdit. Chaque essai de plus éloigne ton site de son état sain.
- Enchaîner les essais sans vérifier entre chaque. Si tu ne vérifies pas, tu ne sais même pas lequel a aggravé les choses.
- Revenir en arrière avec une commande destructive.
git reset --hardefface sans retour possible les changements non sauvegardés. Préfèregit revert, et demande toujours une explication avant. - Recommencer avec la même description. Si la description n'a pas suffi deux fois, elle ne suffira pas une troisième. Ajoute des informations.
À toi de jouer
- Ouvre ton
CLAUDE.md(ou demande à Claude Code de le créer) et ajoute la règle des deux échecs avec le bloc ci-dessus. - Tape
git log --onelineet repère le dernier commit « Après » de ton historique. C'est ton point sûr actuel. - Écris sur un papier la phrase que tu diras à Claude Code le jour où deux essais échoueront. L'avoir prête à l'avance, c'est ne pas paniquer le moment venu.