Os Agentes de Código Claude Não Lêem Automaticamente a Documentação do Projeto

Como os Agentes do Claude Code Lidam com a Documentação do Projeto

Ao trabalhar com o sistema de agentes do Claude Code, os desenvolvedores devem estar cientes de uma limitação específica em como os subagentes acessam a documentação do projeto. De acordo com um relato de usuário do r/ClaudeAI, quando o Claude Code despacha agentes para lidar com tarefas de codificação, esses agentes operam com contexto limitado.

Detalhes Principais da Fonte

O problema foi descoberto durante uma sessão de depuração em que um agente repetidamente encontrou armadilhas documentadas. Quando questionado sobre por que ignorou os avisos documentados, o agente respondeu: "Não li o CLAUDE.md antes de escrever o callback. Eu tinha os padrões da base de código no contexto do meu prompt da fase de exploração, mas quando despachei o agente Sonnet para escrever as rotas OAuth, o prompt do agente descreveu o que construir, não quais armadilhas verificar."

O agente esclareceu ainda mais: "Os subagentes Sonnet veem apenas o que eu coloco em seu prompt. Eles não leem automaticamente o CLAUDE.md, MEMORY.md ou qualquer contexto do projeto, a menos que eu diga explicitamente para fazerem isso."

Implicações Práticas

• Subagentes como o Sonnet trabalham apenas com o contexto fornecido em seu prompt específico
• Arquivos de documentação do projeto (CLAUDE.md, MEMORY.md) não são carregados automaticamente
• Os agentes escrevem código do zero sem consultar listas de armadilhas existentes, a menos que explicitamente instruídos
• Isso pode levar os agentes a repetirem problemas documentados que poderiam ter sido evitados

Esse comportamento significa que os desenvolvedores precisam ser explícitos sobre a inclusão de referências à documentação ao despachar agentes para lidar com tarefas específicas de codificação. Os agentes mantêm os padrões da base de código da fase de exploração, mas não consultam automaticamente os arquivos de documentação específicos do projeto.