Utiliser des agents IA dans de grands monorepos

Dans un monorepo, un agent IA se perd facilement dans le mauvais sous-projet – avec la bonne structure de CLAUDE.md, il reste concentré.

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.

EXEMPLE

Un monorepo avec packages/api, packages/web et packages/shared reçoit un CLAUDE.md racine (« Trois paquets : api (Node/Express), web (React/Vite), shared (utilitaires TS). Toujours exécuter les commandes depuis le dossier du paquet concerné. ») plus un packages/api/CLAUDE.md propre avec les commandes de test spécifiques à l'API. Si l'agent démarre directement dans packages/api/, il voit les deux fichiers – mais rien de packages/web/.

QUIZ RAPIDE

Que se passe-t-il par défaut si tu démarres Claude Code directement dans un sous-dossier d'un monorepo (par ex. packages/api/) plutôt qu'à la racine ?