AGENTS.md: одни правила для всех ИИ-агентов проекта
Готовый AGENTS.md: общие команды, зоны ответственности, обязательные проверки и критерии качества
Какую задачу решает
Написать единые правила проекта для всех агентов
Что будет на выходе
Файл AGENTS.md: структура, команды, CI, правила
- Кому подойдёт
Вайбкодер, который работает с несколькими агентами и каждому объясняет проект заново
- Тема
- Агенты и Claude Code
- Инструменты
- Claude CodeCodexCursor
В одном проекте легко оказаться с тремя агентами сразу: в Cursor правишь вёрстку, Claude Code ведёт большие задачи, ещё один агент в облаке ревьюит изменения. У каждого свои инструкции в своём файле, и через месяц они расходятся: в одном написано «тесты через npm test», в другом уже pnpm test, а третий вообще не знает, что папку legacy/ трогать нельзя.
AGENTS.md — общий файл инструкций в корне проекта, который читают многие агенты для кода. Этот промпт собирает его так, чтобы команды, зоны ответственности и проверки были записаны один раз, а файлы конкретных инструментов просто ссылались на него.
Агент собирает все существующие инструкции проекта, находит в них противоречия и выдаёт один AGENTS.md: команды, кто за какую часть проекта отвечает, обязательные проверки и критерии качества. Остальные файлы инструкций становятся короткими ссылками на него.
Что получишь
- ⌨️Одни команды на всех
Установка, запуск, тесты, линтер, сборка. Одна версия правды вместо трёх разных в разных файлах.
- 🧭Зоны ответственности
Какие папки за кем: где агент работает свободно, где только по задаче, куда не заходит никогда.
- 🧪Обязательные проверки
Что любой агент запускает перед тем, как сказать «готово», и что прикладывает к отчёту.
- 📏Критерии качества
Проверяемые правила: размер изменения, тесты к новой функции, без новых зависимостей без согласия.
Как использовать
- 1Собери старые инструкции
Найди в проекте всё, что агенты уже читают: CLAUDE.md, .cursor/rules, .cursorrules, README с договорённостями. Шаг 1 промпта попросит агента найти их сам.
- 2Разбери противоречия
Агент покажет таблицу расхождений. Реши по каждой строке, какой вариант правильный. На этот шаг уйдёт больше всего времени.
- 3Сохрани AGENTS.md в корень
«Сохрани это как AGENTS.md в корне проекта». В обычном чате скопируй ответ в файл с этим именем.
- 4Сократи остальные файлы
В CLAUDE.md и правилах Cursor оставь только то, что касается только этого инструмента, и ссылку на AGENTS.md. В CLAUDE.md для этого хватит строки @AGENTS.md.
Не все инструменты подхватывают AGENTS.md автоматически. Открой новую сессию в каждом агенте и спроси: «Какой командой запускаются тесты в этом проекте?» Если ответ не из AGENTS.md, добавь ссылку на файл в инструкции этого агента.
Рядом по теме: CLAUDE.md, который агент правда читает, Стартовые файлы проекта: память для ИИ-агента, Личный агент, который знает тебя с первого сообщения, статья «Cursor или Claude Code» и ИИ-отдел за выходные: шаблон команды агентов (бесплатно).
Дальше — для участников
Регистрация бесплатная и занимает минуту. Часть закрытых материалов откроется сразу, без карты.
Что дальше
Ставить агентам задачи с понятными границами помогает материал Задача для ИИ-агента с границами, а проверять их работу — приёмка без поблажек. Как распределить роли между несколькими агентами по шаблону, показано в шаблоне Агентный отдел из восьми ролей (990 ₽).
