Что такое AGENTS.md?
AGENTS.md — открытый простой Markdown-файл в репозитории, который объясняет ИИ-агентам для программирования, как работать с проектом: как его собирать и тестировать, каких соглашений придерживаться и чего избегать. Можно считать его README для агентов, который читают многие разные инструменты.
Какие агенты его читают
Формат описан на agents.md, где перечислено больше 20 поддерживающих его инструментов. Детали поддержки различаются, так что загляните и в документацию своего агента.
- Его читают Codex, Cursor, кодинг-агент GitHub Copilot, opencode, Amp, Aider, goose, Zed, Warp, Junie, Jules и другие.
- Gemini CLI по умолчанию читает GEMINI.md; если добавить AGENTS.md в настройку context.fileName в settings.json, он прочитает и его.
- Claude Code читает CLAUDE.md, а начиная с версии 2.1.277 читает AGENTS.md, если в репозитории нет CLAUDE.md. Можно также импортировать его в CLAUDE.md через @AGENTS.md.
AGENTS.md, CLAUDE.md и GEMINI.md
CLAUDE.md и GEMINI.md — собственные файлы Claude Code и Gemini CLI, а AGENTS.md — общий. Во всех трёх хранится одно и то же по сути содержимое. Распространённый подход — держать общие правила в AGENTS.md, а в файлах конкретных инструментов ссылаться на него и добавлять только специфичное, чтобы инструкции не расходились. Если есть оба файла, Claude Code по умолчанию читает только CLAUDE.md, поэтому импортируйте AGENTS.md оттуда или измените настройку Project instructions.
Что в него писать
Запишите то, что новому коллеге нужно знать в первый день, и то, что иначе вы повторяли бы в каждом промпте. Держите файл коротким: агенты загружают его в контекст в начале сессии.
- Команды установки, сборки и тестов — ровно так, как их запускают.
- Стиль кода и соглашения, которые не проверяет линтер.
- Структуру проекта: что где лежит и какие папки генерируются.
- Правила для коммитов и pull request.
- Чего нельзя делать никогда, например править сгенерированные файлы или коммитить секреты.
Короткий пример
Минимальный AGENTS.md для проекта на TypeScript может выглядеть так. В монорепозитории у каждого пакета может быть свой AGENTS.md, и агенты берут ближайший к файлу, который правят.
- ## Команды: pnpm install; перед каждым коммитом запускать pnpm test, после переноса файлов — pnpm lint.
- ## Стиль: TypeScript в strict-режиме, одинарные кавычки, без точек с запятой.
- ## Структура: код приложения в src/; API-клиент в src/gen/ генерируется, вручную не править.
- ## Pull request: заголовок в виде «[пакет] Краткое описание»; линтер и тесты должны проходить.
Где здесь AgentVera
AgentVera запускает собственный CLI каждого агента в папке проекта, поэтому AGENTS.md и файлы инструментов действуют как обычно; поле роли и инструкций агента добавляет поверх постоянные инструкции, а CLI без флага для дополнительных инструкций (например, Cursor, Gemini CLI и Amp) опираются на AGENTS.md или файлы правил проекта.
FAQ
AGENTS.md — формальный стандарт?
Это открытый формат без обязательных полей и схемы: обычный Markdown с любыми полезными заголовками. Его сайт — agents.md.
Нужны ли одновременно CLAUDE.md и AGENTS.md?
Не обязательно. Свежие версии Claude Code читают AGENTS.md, если нет CLAUDE.md. Если нужны правила только для Claude, держите короткий CLAUDE.md, который импортирует AGENTS.md через @AGENTS.md.
Куда класть файл?
В корень репозитория. В больших репозиториях можно добавить файлы и в подпапки; приоритет у ближайшего к редактируемому коду, а прямая инструкция в чате важнее всех.
Какой длины он должен быть?
Настолько коротким, насколько возможно без потери пользы. Он занимает контекст в каждой сессии, а правило, затерянное в длинном файле, агент пропускает легче.