Los Agentes de Código Claude No Leen Automáticamente la Documentación del Proyecto

Cómo los Agentes de Claude Code Manejan la Documentación del Proyecto

Al trabajar con el sistema de agentes de Claude Code, los desarrolladores deben tener en cuenta una limitación específica en cómo los subagentes acceden a la documentación del proyecto. Según un informe de usuario de r/ClaudeAI, cuando Claude Code envía agentes para manejar tareas de codificación, esos agentes operan con un contexto limitado.

Detalles Clave de la Fuente

El problema se descubrió durante una sesión de depuración donde un agente encontró repetidamente problemas documentados. Cuando se le preguntó por qué ignoró las advertencias documentadas, el agente respondió: "No leí CLAUDE.md antes de escribir la función de retorno. Tenía los patrones de la base de código en mi contexto de instrucción desde la fase de exploración, pero cuando envié al agente Sonnet para escribir las rutas de OAuth, la instrucción del agente describía qué construir, no qué problemas evitar."

El agente aclaró además: "Los subagentes Sonnet solo ven lo que pongo en su instrucción. No leen automáticamente CLAUDE.md, MEMORY.md ni ningún contexto del proyecto a menos que se lo indique explícitamente."

Implicaciones Prácticas

• Los subagentes como Sonnet trabajan solo con el contexto proporcionado en su instrucción específica
• Los archivos de documentación del proyecto (CLAUDE.md, MEMORY.md) no se cargan automáticamente
• Los agentes escriben código desde cero sin consultar listas de problemas existentes a menos que se les indique explícitamente
• Esto puede llevar a que los agentes repitan problemas documentados que podrían haberse evitado

Este comportamiento significa que los desarrolladores deben ser explícitos al incluir referencias de documentación cuando envían agentes para manejar tareas de codificación específicas. Los agentes mantienen los patrones de la base de código desde la fase de exploración, pero no consultan automáticamente los archivos de documentación específicos del proyecto.