Агенты Claude Code не читают документацию проекта автоматически

Как агенты Claude Code работают с проектной документацией

При работе с системой агентов Claude Code разработчикам следует учитывать определённое ограничение в том, как суб-агенты получают доступ к проектной документации. Согласно отчёту пользователя из r/ClaudeAI, когда Claude Code отправляет агентов для выполнения задач по написанию кода, эти агенты работают с ограниченным контекстом.

Ключевые детали из источника

Проблема была обнаружена во время сессии отладки, когда агент неоднократно натыкался на задокументированные подводные камни. На вопрос, почему он проигнорировал задокументированные предупреждения, агент ответил: "Я не читал CLAUDE.md перед написанием колбэка. У меня были шаблоны кодовой базы в контексте промпта из фазы исследования, но когда я отправил агента Sonnet для написания OAuth-маршрутов, промпт агента описывал, что нужно построить, а не какие подводные камни проверить."

Агент дополнительно пояснил: "Суб-агенты Sonnet видят только то, что я помещаю в их промпт. Они не читают автоматически CLAUDE.md, MEMORY.md или любой другой проектный контекст, если я явно не скажу им сделать это."

Практические последствия

• Суб-агенты, такие как Sonnet, работают только с контекстом, предоставленным в их конкретном промпте
• Файлы проектной документации (CLAUDE.md, MEMORY.md) не загружаются автоматически
• Агенты пишут код с нуля, не консультируясь с существующими списками подводных камней, если им не дано явное указание
• Это может привести к тому, что агенты будут повторять задокументированные проблемы, которых можно было бы избежать

Такое поведение означает, что разработчикам необходимо явно указывать ссылки на документацию при отправке агентов для выполнения конкретных задач по написанию кода. Агенты сохраняют шаблоны кодовой базы из фазы исследования, но не обращаются автоматически к файлам проектной документации.