Agents.md — открытый формат файла AGENTS.md с инструкциями для AI-агентов, которые пишут код. Это «README для агентов»: как собрать проект, запустить тесты и какие правила соблюдать.
Главное отличие — один файл для многих инструментов: AGENTS.md читают OpenAI Codex, Cursor, Jules, Aider, GitHub Copilot и другие агенты, поэтому не нужно дублировать правила в отдельных конфигах.
Что писать в AGENTS.md
- Команды: установка зависимостей, сборка, запуск тестов и линтера.
- Структура проекта: где лежат модули, что нельзя трогать.
- Стиль кода: соглашения, библиотеки по умолчанию, именование.
- Проверки: что агент должен прогнать перед коммитом.
- Вложенные файлы: в монорепозитории свой AGENTS.md на каждый пакет, ближайший к коду имеет приоритет.
Кому подходит
Разработчикам и командам, которые работают с несколькими AI-агентами и хотят одинаковое поведение во всех инструментах.
Как начать
Создайте AGENTS.md в корне репозитория, опишите команды сборки и тестов, правила стиля и запреты. Обычный Markdown, без обязательных полей.
Совет
Пишите коротко и проверяемо: «перед коммитом запусти pnpm test», а не «пиши качественный код». Каждое правило, которое агент нарушил дважды, добавляйте в файл.
Ограничения
Это соглашение, а не гарантия: агент может проигнорировать инструкцию. Некоторые инструменты используют свои файлы правил, туда достаточно вписать ссылку на AGENTS.md.