Claude Code, Cursor і Codex: як агенти читають документацію? Чому CLAUDE.md нічого не гарантує

⬇ Відкрито набір на новий потік Agentic Engineering — практичну авторську програму, де ти побудуєш production-ready AI workflow на власному проєкті. На виході — готовий воркфлоу під свої задачі та можливість пройти сертифікацію Claude Code Architect. Заповнити анкету передзапису:

Ти пишеш у CLAUDE.md: «Перед змінами прочитай архітектуру. Після змін запусти тести. Перевір результат». Агент відкриває файл. Але чи означає це, що він справді виконав правила?

У цьому відео розбираю нове дослідження 557 реальних сесій із Claude Code, Codex, Cursor, Gemini CLI та іншими coding-агентами. Майже 95 тисяч дій, понад 3 тисячі взаємодій із документацією й окремий аналіз понад 33 тисяч pull request’ів.

Серед 1 328 читань документації лише тричі саме наступною зафіксованою дією була правка коду. А явних випадків, коли агент узяв документацію за еталон і звірив із нею результат, дослідники не знайшли взагалі.

Це не означає, що агенти не читають документацію. Читають, і доволі багато. Проблема в іншому: прочитати правило, виконати його та перевірити результат — це три різні дії.

У відео розбираю:

* що Claude Code, Cursor, Codex та інші агенти насправді читають у репозиторії;
* чим CLAUDE.md, AGENTS.md, SKILL.md і звичайна документація відрізняються для агента;
* чому критичне правило не варто ховати за ланцюжком посилань;
* як працюють імпорти файлів у Claude Code та багаторівневе завантаження скілів;
* що агент робить після читання документації;
* чому рядок «обов’язково запусти тести» ще не створює verification loop;
* що таке executable documentation: runnable examples, doctest і schema contracts;
* як перевіряти виконання правил через tests, hooks, linter і CI;
* чому тимчасові нотатки агента треба відокремлювати від постійних інструкцій;
* навіщо рев’ювати зміни в CLAUDE.md та AGENTS.md так само уважно, як зміни в коді;
* як окремий subagent може звіряти готовий diff із правилами та вимогами задачі.

Головна ідея проста: CLAUDE.md — не пульт керування агентом. Документація передає контекст, але не гарантує дію. Критичне правило має складатися з двох шарів: короткої й однозначної інструкції та механічної перевірки, яка спрацює незалежно від бажання агента.

Посилання та ресурси:

Таймкоди:

Соцмережі:

Відкрий свій CLAUDE.md або AGENTS.md і знайди хоча б одне правило, виконання якого зараз нічим не перевіряється. А в коментарях напиши, яке саме правило ти першим перетвориш із побажання на нормальну перевірку