Usar agentes de IA en monorepos grandes

El problema en repos grandes

Un monorepo suele contener muchos subproyectos: un backend, un frontend, bibliotecas compartidas. Un único archivo CLAUDE.md para todo se vuelve o bien enorme (y consume contexto en cada sesión, incluso cuando la tarea no lo necesita) o demasiado general como para ayudar de verdad.

La solución: varios archivos CLAUDE.md

En lugar de un archivo para todo, creas un CLAUDE.md propio por cada subproyecto. Un archivo en el directorio raíz contiene las reglas que aplican en todas partes (estilo de commit, estructura general). Cada subproyecto tiene su propio archivo con sus comandos y convenciones específicas.

Cómo funciona la carga

Si inicias el agente en el directorio raíz, al arrancar carga solo el CLAUDE.md de la raíz; los archivos en subcarpetas se cargan solo cuando el agente realmente lee archivos ahí. Si lo inicias directamente en un subproyecto, obtiene el archivo de esa carpeta más todos los de las carpetas superiores, pero por defecto solo tiene acceso a ese subárbol.

Forzar el enfoque

Para tareas que claramente pertenecen a un subproyecto, vale la pena iniciar el agente ahí directamente en lugar de en el directorio raíz. Eso mantiene el contexto y el acceso a archivos automáticamente acotados, sin que tengas que explicar en cada tarea qué partes del repo son irrelevantes en ese momento.