Один AGENTS.md на три агенти: передача без переказу

Що лежить у папці

Уся схема спирається на те, що агенти при відкритті папки самі шукають файл з інструкціями. Пам'ять проєкту зберігається в чотирьох Markdown-файлах, а не в історії чату. Їх можна відкрити будь-яким блокнотом.

• AGENTS.md — єдиний звід правил для всіх трьох. Це єдиний файл, який автор редагує.
• CLAUDE.md — лише рядок імпорту AGENTS.md, більше його не чіпають.
• HANDOFF.md — журнал, найновіша нотатка зверху. Агент перед виходом підписує нотатку: що закінчив, що ні, звідки продовжувати.
• DECISIONS.md — ухвалені рішення, наприклад «на малому проєкті лишаємося на чистому HTML».

Файли автор згенерував за допомогою Claude, але порядок роботи склав сам, виходячи з того, як реально перемикається між трьома застосунками.

Що прописати в AGENTS.md

Окрім читання журналу, звід правил розподіляє ролі за тим, що в кого виходить краще. Antigravity бере візуальні перевірки в браузері, бо може відкрити сторінку й подивитися на неї. Claude Code і Codex ділять між собою планування та виправлення. Codex, за спостереженням автора, часто доробляє код, який Claude лишає напівготовим. Формулювання для свого файлу можна будувати так:

• Before touching anything, read HANDOFF.md (newest note at the top).
• Before you finish, add a signed note: what you finished, what you didn't, where the next agent should start.
• Do not reverse anything in DECISIONS.md. If you disagree, flag it in your handoff note for the owner.

У Claude Code і Codex завершення сесії винесене в окремий handoff-скіл. Це збережений набір інструкцій, який агент виконує, коли його викликають на ім'я. Так нотатку не доводиться щоразу просити вручну.

Робочі ситуації

Ліміт закінчився посеред задачі. Ту саму папку відкривають в іншому застосунку, і робота продовжується з останньої нотатки без відновлення контексту. Автор називає це головною вигодою. Із цим налаштуванням можна працювати й далі, навіть якщо скасувати підписки Google та OpenAI.

Треба подивитися результат очима. Задачу передають Antigravity як агенту з роллю візуальної перевірки. Наступний агент бачить його висновки в журналі, а не в чужому чаті.

Агенту потрібне рішення людини. Питання до власника потрапляють у HANDOFF.md і не губляться в історії одного застосунку. Antigravity, наприклад, завершив свою чергу вказівкою наступному агенту погодити з власником будь-які нові додавання. Журнал заодно стає історією проєкту простою мовою, яку можна переглянути за хвилину.

Де ламається і що перевірити

• Два агенти одночасно. Автор пускає в папку тільки одного. Паралельні сесії можуть редагувати ті самі файли, не прочитавши нотаток одна одної.
• Агент не написав нотатку. Агенти дотримуються правил по-різному: Antigravity знадобився явніший промпт, ніж Codex. Після кожної сесії перевіряйте, що зверху в HANDOFF.md з'явився новий підписаний запис.
• Роздутий звід правил. Google обмежує rule-файли Antigravity 12 000 символів, тож AGENTS.md варто тримати коротким.
• Скасування рішень. Заборона чіпати DECISIONS.md — запобіжник. Автор визнає, що сценарій без цього правила не перевірено.
• Новий агент. Перш ніж довіряти, перевірте перший рядок сесії: чи назвав агент попередника і нотатку, з якої продовжує.

Точного синтаксису рядка імпорту в CLAUDE.md і тексту handoff-скілу в матеріалі немає.