Если ваш AGENTS.md успел устареть, Claude Code может заметить, что документация уже расходится с реальным кодом, и всё же продолжить следовать старым инструкциям.
Исследователи намеренно создали такую ситуацию и провели 80 запусков. В 79 случаях Claude Code распознал противоречие, но всё равно попался в эту ловушку.
С Codex дело обстояло ещё хуже: примерно в одном случае из четырёх он начинал переписывать уже работающий код лишь затем, чтобы привести его в соответствие с устаревшей документацией.
Исправление оказалось удивительно простым. Достаточно добавить в AGENTS.md одну строку. После этого оба агента стали следовать существующему коду в 91% случаев вместо прежних 4%:
«Если документация репозитория противоречит существующему коду, следуй соглашениям, принятым в самом коде, а в финальном ответе укажи каждое найденное несоответствие между документацией и кодом».