Claude Code modifie trop de fichiers

Claude Code corrige un problème, mais ajoute des refactors, renomme des fichiers ou modifie des zones voisines non demandées. Ce symptôme donne souvent l’impression que le modèle est mauvais ou que l’outil n’est pas assez puissant. En pratique, il révèle surtout un problème de système de travail : contexte dispersé, sortie mal définie, critères implicites ou validation trop tardive.

• Repérer exactement où le résultat devient inutilisable.
• Distinguer problème d’outil, problème de contexte et problème de validation.
• Mesurer le coût réel : reprises, erreurs, perte de confiance ou blocage d’équipe.

La consigne décrit une intention globale sans fichiers autorisés, non-objectifs, taille de diff ni critères de sortie. L’IA complète ce qui manque avec des hypothèses plausibles. Tant que ces hypothèses restent invisibles, chaque nouvelle tentative peut sembler différente alors que la vraie faille reste la même : le workflow ne dit pas assez clairement ce qui doit être stable.

• Écrire les règles que l’IA ne doit plus deviner.
• Séparer contexte permanent, demande du moment et décisions déjà prises.
• Nommer les limites : ce que l’IA peut proposer, modifier ou refuser.

Donne une mission courte, liste les fichiers modifiables, interdits les refactors opportunistes et demande un plan avant édition. La correction ne consiste pas à chercher un prompt miracle. Elle consiste à transformer la tâche en processus relisible : objectif, entrées, étapes, critères de sortie et revue. Cette structure réduit les variations et rend les erreurs plus faciles à corriger.

• Commencer par un brief court avec objectif, public, contraintes et livrable attendu.
• Découper la tâche en étapes : cadrage, production, critique, correction et livraison.
• Conserver les décisions utiles dans une note ou un fichier de contexte réutilisable.

Le diff doit rester minimal, justifier chaque fichier touché et montrer les tests ou vérifications liés au comportement demandé. Un bon contrôle qualité n’a pas besoin d’être lourd. Il doit seulement arriver au bon moment, avec une grille claire. Plus le livrable influence une décision, un client, un repo ou une donnée métier, plus la revue doit être explicite.

• Demander une revue adverse pour identifier omissions, contradictions et hypothèses fragiles.
• Vérifier sources, exemples, données, tests ou critères d’acceptation selon le livrable.
• Garder une validation humaine pour les décisions sensibles ou les sorties externes.

La revue devient lente, les régressions augmentent et l’équipe perd confiance dans les agents de code. Ce risque est souvent progressif : au début, tu corriges vite. Puis les corrections deviennent la norme, les standards se dispersent et les personnes arrêtent de faire confiance aux sorties IA. Le coût n’est plus seulement technique ; il devient organisationnel.

• Accumulation de dette invisible dans les contenus, fichiers, specs ou automatisations.
• Difficulté à transmettre la méthode à une autre personne ou à une équipe.
• Perte du gain de temps initial parce que chaque sortie demande une reprise manuelle.

Ce sujet concerne surtout les builders et développeurs qui utilisent Claude Code sur un repo existant. Workshop Claude/Cowork est le point de départ le plus pertinent si tu veux traiter ce blocage sur des cas réels, avec une méthode directement applicable. Workshop ChatGPT/Codex peut compléter quand le problème touche aussi aux documents, au code, aux workflows ou à la production d’équipe.

• Travailler sur tes propres exemples plutôt que sur des démonstrations génériques.
• Produire des modèles de contexte, checklists et workflows réutilisables.
• Décider quoi automatiser, quoi garder manuel et quoi valider avant usage réel.