Один рядок в 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.