Одна строка в AGENTS.md заставила Claude Code и Codex следовать коду, а не устаревшей документации
Одна строка в AGENTS.md заставила Claude Code и Codex следовать коду, а не устаревшей документации
Исследователи показали, что агенты кода часто следуют устаревшей документации даже при наличии противоречий с реальным кодом. Одна инструкция в AGENTS.md повысила следование существующему коду с 4% до 91%.
Если ваш AGENTS.md успел устареть, Claude Code может заметить, что документация уже расходится с реальным кодом, и всё же продолжить следовать старым инструкциям.
Исследователи намеренно создали такую ситуацию и провели 80 запусков. В 79 случаях Claude Code распознал противоречие, но всё равно попался в эту ловушку.
С Codex дело обстояло ещё хуже: примерно в одном случае из четырёх он начинал переписывать уже работающий код лишь затем, чтобы привести его в соответствие с устаревшей документацией.
Исправление оказалось удивительно простым. Достаточно добавить в AGENTS.md одну строку. После этого оба агента стали следовать существующему коду в 91% случаев вместо прежних 4%:
«Если документация репозитория противоречит существующему коду, следуй соглашениям, принятым в самом коде, а в финальном ответе укажи каждое найденное несоответствие между документацией и кодом».
Почему это важно
АналитикаУстаревшие инструкции могут незаметно снижать качество агентного кодинга. Простой приоритет кода над документацией помогает агентам реже ломать рабочее поведение и точнее сообщать о несоответствиях.
Обсудить в сообществе
Делитесь опытом и мыслями с ИИ-разработчиками
Связанные материалы экосистемы
Практические гайды, терминология и агентские скиллы
Claude Code Projects: как один ИИ координирует команду автономных агентов
Глубокий разбор Claude Code Projects: архитектура Coordinator и Threads, параллельные ветки, общая память MEMORY.md и управление облачными агентами.
Codex как помощник внутри Claude Code: Делегирование рутины через Claudex
Настоящее ограничение в работе с Claude — не то, насколько модель модель рассуждает, а то, сколько задач содержится в контекстном окне, прежде чем оно заполнится.
Claude Code
Официальный терминальный агент разработки от Anthropic, работающий непосредственно в командной строке через Claude 3.7 Sonnet с нативной поддержкой Bash, Git, файловой системы и протокола MCP.
AI-агенты (Autonomous Agents)
Программные системы на базе LLM, способные самостоятельно воспринимать состояние окружающей среды, декомпозировать сложные цели, вызывать внешние инструменты и итеративно исправлять собственные ошибки.
Claude начнёт по умолчанию использовать Auto Mode на тарифах Pro, Max и Team
Anthropic объявила, что со следующей недели Claude будет по умолчанию использовать Auto Mode для управления разрешениями в тарифах Pro, Max и Team.
improve-codebase-architecture
Refactor messy codebases into clean, modular, and maintainable layered architectures.