Ton agent IA n'arrive pas à lire tes gros fichiers en entier. Le vrai problème, c'est qu'il continue quand même, puis t'assure avoir respecté un contexte qu'il n'a jamais vu. Voilà les deux piliers d'architecture qui règlent ça, et surtout comment poser le garde-fou au niveau du système, là où le modèle ne peut pas passer outre.
<aside> 🧱
Ce que tu tiens entre les mains
La vidéo te donne le QUOI : modulariser, puis vérifier au niveau du système. Cette page te donne le COMMENT, de bout en bout, avec les fichiers à copier.
À la fin, tu as un plafond de taille de fichier qui s'impose à ton agent même quand il n'en fait qu'à sa tête, et tu sais pourquoi ça marche. Compte une heure, pas un week-end.
</aside>
<aside> ⚠️
Tu n'as pas encore Claude Code ?
Copie ce prompt dans ton IA (Claude, ChatGPT, Gemini) :
Aide-moi à installer Claude Code sur mon ordinateur. D'abord, va lire la documentation officielle https://code.claude.com/docs/en/setup pour vérifier la procédure exacte selon mon système (Mac, Windows ou Linux) et la dernière version. Ne te fie pas à tes connaissances de pré-entraînement : la doc officielle est la seule source fiable. Ensuite, donne-moi les étapes une par une. Je n'ai jamais utilisé un terminal.
Ton IA va te guider pas à pas. Reviens ici après.
</aside>
<aside> ✅
Tu as déjà Claude Code ? Continue, tout est prêt.
</aside>
<aside> 🧭
Tu ne codes pas toi-même ? Lis quand même.
Ce qui suit est une règle de gouvernance, pas une astuce de développeur : quand une limite compte vraiment, elle ne doit pas dépendre de la bonne volonté de celui qui l'exécute. Remplace « fichier de code » par « dossier client », « procédure » ou « base de données », et le raisonnement tient à l'identique. Le pilier 2 est celui qui te concerne le plus.
</aside>
Un God file, c'est un fichier qui a grossi jusqu'à tout faire : la logique, l'affichage, les règles, les accès aux données. Le nom vient du God object, un anti-pattern reconnu de longue date. La plus ancienne référence traçable est le livre d'Arthur Riel, Object-Oriented Design Heuristics (1996), dont l'heuristique 3.2 dit déjà : « ne crée pas de god classes dans ton système ». Ce n'est donc pas une lubie de 2026 : les développeurs ont nommé ce défaut il y a trente ans. Ce qui est nouveau, c'est qu'un agent IA le paie beaucoup plus cher que nous.
Quand ton agent croise un fichier trop volumineux, il ne le lit pas en entier. C'est vrai. Mais l'outil, lui, prévient. Quand une lecture dépasse le budget, Claude Code renvoie une première page accompagnée d'une notice explicite, dont le texte injecté est sans ambiguïté :
<aside> 🔎
[Truncated: PARTIAL view ... Do NOT answer from this page alone if the answer may be further in the file.]
Traduction : « attention, tu n'as qu'un morceau, ne réponds pas comme si tu avais tout lu ».
</aside>
Le système va même plus loin : la documentation officielle précise qu'une lecture interrompue par cette notice ne compte pas comme une lecture valide, et bloque l'édition qui suivrait. Le harnais fait donc déjà son travail de garde-fou.
Le trou n'est pas là. Il est dans ce que le modèle te rapporte, à toi. Il voit l'avertissement, et il te répond quand même « c'est fait, j'ai bien respecté ton contexte ». Voilà le « il ne te le dit pas » : ce n'est pas une cécité technique, c'est un rapport complaisant.
Et ce n'est pas une impression. Anthropic a mesuré que ses propres modèles ne mentionnent l'indice qui a réellement guidé leur réponse qu'environ une fois sur quatre, et qu'ils ne verbalisent presque jamais le fait d'avoir pris un raccourci. Des chercheurs d'OpenAI ont donné la raison économique : les modèles sont entraînés et évalués d'une manière qui récompense le fait de deviner plutôt que d'admettre l'incertitude. Un modèle qui dit « je n'ai pas tout lu » perd des points, un modèle qui affirme en gagne.
<aside> 🚨
Chez les autres outils, c'est parfois pire, et c'est écrit dans leur code source.
Chez Codex (OpenAI), le fichier d'instructions projet AGENTS.md est coupé au-delà de 32 Ko, et le commentaire du code dit littéralement que les fichiers plus gros sont tronqués silencieusement. Là, il n'y a même pas d'avertissement. Tu crois avoir donné tes règles à ton agent, la moitié n'est jamais arrivée.
</aside>