Utiliser des agents IA dans de grands monorepos

Le problème dans les gros repos

Un monorepo contient souvent plusieurs sous-projets : un backend, un frontend, des bibliothèques partagées. Un seul fichier CLAUDE.md pour tout devient soit énorme (et bouffe du contexte à chaque session, même pour des tâches qui n'en ont pas besoin), soit reste trop général pour vraiment aider.

La solution : plusieurs fichiers CLAUDE.md

Au lieu d'un seul fichier pour tout, tu crées un CLAUDE.md propre à chaque sous-projet. Un fichier à la racine contient les règles valables partout (style de commit, structure générale). Chaque sous-projet reçoit son propre fichier avec ses commandes et conventions spécifiques.

Comment fonctionne le chargement

Si tu démarres l'agent à la racine, il ne charge au lancement que le CLAUDE.md racine ; les fichiers dans les sous-dossiers ne sont chargés que quand l'agent y lit effectivement des fichiers. Si tu le démarres directement dans un sous-projet, il reçoit le fichier de ce dossier plus tous ceux des dossiers parents – mais par défaut, il n'a accès qu'à cette sous-arborescence.

Forcer le focus

Pour les tâches qui appartiennent clairement à un sous-projet, ça vaut le coup de démarrer l'agent directement là plutôt qu'à la racine. Ça garde le contexte et l'accès aux fichiers automatiquement restreints – sans que tu aies besoin d'expliquer à chaque tâche quelles parties du repo sont hors sujet.