Chapitre 12.3 — Les anti-patterns nommés
⏱️ TL;DR — Un playbook, ce sont aussi des pièges nommés — parce qu’on ne fuit bien que ce qu’on sait reconnaître. Voici le bestiaire des anti-patterns du pilotage de Claude Code, chacun avec son symptôme, sa cause et son remède (renvoyé au chapitre concerné). Apprends à les repérer en temps réel : la plupart des mauvaises sessions sont l’un de ces pièges, et le nommer, c’est déjà en sortir.
🎯 Objectifs
- Reconnaître les anti-patterns classiques en direct.
- Associer chaque symptôme à sa cause et son remède.
- Faire de « nommer le piège » un réflexe de correction.
Le bestiaire
1. Le vibe-coding
Symptôme : tu enchaînes « fais ci », « non, plutôt ça », sans plan ni critère, en espérant que ça converge. Cause : pas d’objectif clair ni de vérification (P2, P5). Remède : cadrer (objectif + ancrages + critère), plan mode sur l’ambigu, exiger la preuve. Le vibe-coding produit du code que personne ne comprend — toi le premier.
2. Le distributeur
Symptôme : tu colles du code, tu demandes, tu jettes si raté ; résultats incohérents. Cause : tu traites l’agent en distributeur, pas en membre d’équipe (12.1). Remède : donne contexte + conventions + ancrages ; revois.
3. Le culte du prompt
Symptôme : tu cherches « la formule magique » de prompt, tu répètes les mêmes consignes à chaque session. Cause : tu mises sur le prompt au lieu du terrain (12.1). Remède : convertis les consignes répétées en CLAUDE.md / hooks / skills / fichiers-modèles.
4. Le CLAUDE.md obèse
Symptôme : ton CLAUDE.md fait 300 lignes et l’agent en ignore la moitié. Cause : fourre-tout, descriptif, non priorisé (3.2). Remède : élaguer (supprime le déductible, déplace le mécanique en hook), prioriser, garder tranchable.
5. Le contexte pollué
Symptôme : l’agent oublie, ré-explore, mélange deux tâches, ralentit. Cause : contexte saturé de bruit, plusieurs intentions dans une session (5.2). Remède : /clear au changement d’intention, déléguer le bruyant à un subagent, une intention par session.
6. La sur-délégation
Symptôme : tu découpes une tâche simple en cinq subagents « pour paralléliser ». Cause : le multi-agent pris pour un but (8.2). Remède : ne déléguer que le bruyant / l’indépendant / le regard neuf ; garder le petit et le couplé en session principale.
7. La sur-spécification
Symptôme : tu écris un brief de 15 pages détaillant l’implémentation. Cause : peur de perdre le contrôle (2.1). Remède : décris les contrats, pas l’implémentation ; contrôle par le cadre + la vérification, pas le micro-management.
8. Le tout-autoriser sans filet
Symptôme : autonomie large sur un repo sans tests, sur main. Cause : recherche de confort avant sécurité (5.3, 12.2). Remède : installer le filet d’abord (git, tests, hooks, garde-fous) ; l’autonomie se gagne.
9. Croire au lieu de vérifier
Symptôme : tu acceptes « ça devrait marcher » ; tu découvres le bug en prod. Cause : confiance décrétée, pas construite (5.4). Remède : exiger l’observation (tests montrés, flux exercé, rendu vu).
10. Moderniser à la sauvage
Symptôme : l’agent « améliore » l’existant au passage ; deux styles cohabitent. Cause : pas de consigne « respecte l’existant », refactor glissé dans une feature (6.2, 11.3). Remède : « ne refactore rien sans demande » ; refactor = chantier séparé et cadré.
11. La mémoire périmée
Symptôme : l’agent suit une règle abandonnée, cherche un fichier renommé. Cause : CLAUDE.md/skills non mis à jour (3.4). Remède : mettre à jour la mémoire dans le même mouvement que le code ; la relire comme du code.
12. Les valeurs en dur
Symptôme : chaque écran a ses couleurs/marges ; UI « presque cohérente ». Cause : pas de tokens imposés (4.1). Remède : tokens sémantiques + lint anti-arbitraire.
Une grille de diagnostic
💡 Réflexe d’architecte — Garde ce bestiaire près de toi. Quand une session dérape, nomme le piège avant de t’énerver sur l’agent : neuf fois sur dix, c’est l’un des douze, et le remède est déjà écrit. Nommer, c’est diagnostiquer ; diagnostiquer, c’est corriger. La frustration vient presque toujours d’un anti-pattern qu’on n’a pas encore identifié.
✏️ Exercices
Exercice 1 — Tes trois pièges. Parmi les douze, lesquels sont tes trois plus fréquents ? Pour chacun, écris ton signal d’alerte personnel (« quand je fais X, c’est que je suis en train de… »).
✅ Solution
Les plus courants chez les devs qui « ont l’impression de mal s’y prendre » : culte du prompt (répéter au lieu de configurer), croire ≠ vérifier, et contexte pollué. Identifier tes trois te donne des signaux d’alerte concrets. Le but n’est pas de ne jamais tomber dedans, mais de le repérer vite.
Exercice 2 — Nomme en direct. Lors de ta prochaine session qui dérape, arrête-toi et nomme le piège (via la grille). Applique le remède associé. La sortie est-elle plus rapide qu’en « insistant » ?
✅ Solution
Nommer coupe court à la spirale (« j’insiste, ça empire »). Une fois le piège identifié, le remède est mécanique (cadrer, /clear, configurer le terrain, exiger la preuve). Tu passes de « ça marche pas » à « je suis en contexte pollué → /clear » — un diagnostic actionnable en secondes.
🧠 Quiz de révision
1. Qu’est-ce que le « vibe-coding » et son remède ?
Enchaîner « fais ci / non, ça » sans plan ni critère, en espérant que ça converge. Remède : cadrer (objectif + ancrages + critère), plan mode sur l’ambigu, exiger la preuve. Sinon on produit du code que personne ne comprend.
2. Le « culte du prompt » : symptôme et remède ?
Symptôme : chercher la formule magique, répéter les mêmes consignes. Remède : configurer le terrain (convertir les consignes en CLAUDE.md/hooks/skills/modèles). Le levier est le terrain, pas le prompt.
3. « Tout-autoriser sans filet » : pourquoi c’est un piège ?
Parce que l’autonomie large sans filet (tests, hooks, git, garde-fous) mène aux dégâts silencieux et irréversibles. Remède : installer le filet d’abord — l’autonomie se gagne.
4. Comment reconnaître un « contexte pollué » ?
L’agent oublie des contraintes, ré-explore, mélange deux tâches, ralentit. Remède : /clear au changement d’intention, déléguer le bruyant, une intention par session.
5. Quel réflexe adopter quand une session dérape ?
Nommer le piège (via la grille) avant de s’énerver : c’est presque toujours l’un des anti-patterns connus, et son remède est déjà écrit. Nommer = diagnostiquer = corriger.
Chapitre suivant : Monter TOI en niveau — grandir avec l’IA, sans t’atrophier.