# Что такое AGENTS.md?

URL: https://agentvera.dev/ru/glossary/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 или файлы правил проекта.

- **AGENTS.md — формальный стандарт?** Это открытый формат без обязательных полей и схемы: обычный Markdown с любыми полезными заголовками. Его сайт — agents.md.
- **Нужны ли одновременно CLAUDE.md и AGENTS.md?** Не обязательно. Свежие версии Claude Code читают AGENTS.md, если нет CLAUDE.md. Если нужны правила только для Claude, держите короткий CLAUDE.md, который импортирует AGENTS.md через @AGENTS.md.
- **Куда класть файл?** В корень репозитория. В больших репозиториях можно добавить файлы и в подпапки; приоритет у ближайшего к редактируемому коду, а прямая инструкция в чате важнее всех.
- **Какой длины он должен быть?** Настолько коротким, насколько возможно без потери пользы. Он занимает контекст в каждой сессии, а правило, затерянное в длинном файле, агент пропускает легче.

---

**Об AgentVera.** AgentVera — настольное приложение для macOS, Windows и Linux от Solviera Teknoloji. Оно запускает 18 ИИ-агентов для программирования (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) рядом, по проектам, в настоящих терминалах с собственными установками CLI и входами пользователя. В бесплатном тарифе количество агентов не ограничено. Скачать: https://agentvera.dev/ru/download/ · Цены: https://agentvera.dev/ru/pricing/