# AGENTS.md: пример, шаблон и 5 правил за 30 минут > Разберитесь, как AGENTS.md помогает Codex, Cursor, Copilot и Junie работать по общим инструкциям: составьте файл правил для проекта и узнайте, когда его читает Claude Code. Source: https://ailoot.ai/blog/ru/agents-md-guide-template/ Canonical: https://ailoot.ai/blog/ru/agents-md-guide-template/ Language: ru Publisher: Ailoot (https://ailoot.ai/) Translation: guide-034 Revision: sha256-82247fe337d99f543ae2bf63b1d45baf29b8927e2ed314e3a8d1da58ebe531df Практические советы по вайб-кодингу и работе с ИИ-агентами собраны в [документации Ailoot](https://ailoot.ai/docs/). ## AGENTS.md в одном абзаце
**Главное** AGENTS.md — обычный Markdown-файл в корне проекта с инструкциями для ИИ-агента: как установить зависимости, запускать тесты, оформлять код и какие части проекта нельзя менять. Это открытый формат, представленный OpenAI в августе 2025 года и переданный Linux Foundation в декабре того же года. Его могут использовать разные инструменты, но способ загрузки зависит от клиента и версии: одни находят AGENTS.md автоматически, другим нужны явное имя файла или настройка чтения. Начиная с версии 2.1.277, выпущенной в сентябре 2026 года, Claude Code тоже читает AGENTS.md, если в проекте отсутствует CLAUDE.md. Если CLAUDE.md есть, Claude Code по умолчанию использует только его; подключить AGENTS.md можно строкой `@AGENTS.md` или символической ссылкой.
В этом руководстве формат рассматривается по материалам [agents.md](https://agents.md), документации [OpenAI Codex](https://github.com/openai/codex), [JetBrains Junie](https://junie.jetbrains.com/docs/guidelines-and-memory.html), [Cursor Rules](https://cursor.com/docs/rules), [GitHub Copilot Coding Agent](https://github.blog/changelog/2025-08-28-copilot-coding-agent-now-supports-agents-md-custom-instructions/) и [пресс-релизу Linux Foundation об Agentic AI Foundation](https://www.linuxfoundation.org/press/linux-foundation-announces-the-formation-of-the-agentic-ai-foundation). Числа и сведения о возможностях приведены по состоянию на 30 мая 2026 года. О поддержке AGENTS.md в Claude Code рассказывается по [документации Anthropic](https://code.claude.com/docs/en/memory#agents-md), с учётом обновления от 24 сентября 2026 года. Если пока сложно разобраться в многообразии инструментов и понять, для чего им нужен общий файл инструкций, начните с руководства [«Чем кодить в 2026: 8 ИИ-инструментов от Claude Code до Antigravity»](https://ailoot.ai/blog/ru/ai-coding-tools/). Здесь речь пойдёт о самом формате AGENTS.md и о том, как подготовить собственный файл примерно за полчаса. ## Что такое AGENTS.md и откуда он взялся?
**Главное** AGENTS.md — открытый Markdown-формат для инструкций ИИ-агентам, содержание которого задаёт разработчик. OpenAI представила его в августе 2025 года вместе с Codex CLI и пригласила к совместной работе Cursor, Sourcegraph Amp, Google Jules и Factory. Замысел заключался в том, чтобы заменить набор отдельных форматов одним общим. 9 декабря 2025 года AGENTS.md вошёл в Linux Foundation вместе с MCP от Anthropic и goose от Block как один из трёх проектов-основателей Agentic AI Foundation. К декабрю 2025 года файл уже находился в корне более чем 60 000 репозиториев GitHub.
Прежде у каждого инструмента были собственные инструкции: у Anthropic — `CLAUDE.md`, у Cursor — `.cursorrules`, у GitHub — `.github/copilot-instructions.md`, у Aider — `.aider.conf.yml`, у JetBrains — `.junie/guidelines.md`. Команда, использующая сразу несколько агентов, должна была поддерживать несколько файлов с похожими правилами. Со временем их содержание начинало расходиться. В августе 2025 года OpenAI выпустила Codex CLI и представила открытый формат на сайте [agents.md](https://agents.md). Там его сравнили с README, предназначенным для агентов: > «Представьте AGENTS.md как README для агентов». > > ([agents.md](https://agents.md), перевод с английского) Файл AGENTS.md дополняет README. README объясняет людям, что это за проект, как запустить его локально и как вносить изменения. В AGENTS.md указывают точные команды для командной строки, проверяемые условия готовности и ограничения, например запрет на изменение отдельных файлов. На сайте также объясняется: > «AGENTS.md дополняет README дополнительным, иногда подробным контекстом для агента: шагами сборки, командами тестирования и соглашениями, которые перегрузили бы README или не пригодились бы людям, участвующим в разработке». > > ([agents.md](https://agents.md), перевод с английского) В сентябре 2025 года формат появился в GitHub Copilot Coding Agent ([сообщение от 28.08.2025](https://github.blog/changelog/2025-08-28-copilot-coding-agent-now-supports-agents-md-custom-instructions/)). К декабрю его также поддерживали Cursor, Junie, Gemini CLI, Aider и другие инструменты. 9 декабря 2025 года Linux Foundation объявила о создании [Agentic AI Foundation (AAIF)](https://www.linuxfoundation.org/press/linux-foundation-announces-the-formation-of-the-agentic-ai-foundation). Среди трёх проектов-основателей были AGENTS.md от OpenAI, MCP от Anthropic и goose от Block. В число основателей фонда вошли AWS, Anthropic, Block, Bloomberg, Cloudflare, Google, Microsoft и OpenAI. К 24 февраля 2026 года к AAIF присоединились [146 организаций](https://www.linuxfoundation.org/press/agentic-ai-foundation-welcomes-97-new-members), включая Red Hat, ServiceNow, Akamai, Lenovo, JPMorgan Chase, Huawei, UiPath и Hitachi. Так общий файл инструкций стал форматом, который используют разные разработчики ИИ-инструментов, а не только OpenAI. ## Какие ИИ-агенты читают AGENTS.md, а какие нет?
**Главное** AGENTS.md используется в разных инструментах разработки, включая перечисленные ниже. Таблица показывает способы загрузки, а не обещает одинаковую встроенную поддержку: автоматическое обнаружение, явная настройка, приоритет имён и обработка вложенных файлов могут различаться. Claude Code от Anthropic долго оставался исключением. Запрос на поддержку в issue №6235 оставался открытым с августа 2025-го до августа 2026 года. С версии 2.1.277 от 18 сентября 2026 года Claude Code сам читает AGENTS.md, если в проекте нет CLAUDE.md. Когда CLAUDE.md присутствует, обычно используется он; AGENTS.md можно подключить строкой `@AGENTS.md` или символической ссылкой.
Сводка поддержки на 30 мая 2026 года; сведения о Claude Code обновлены 24 сентября 2026 года: | Инструмент | Читает AGENTS.md | Дата / источник | |----|----|----| | OpenAI Codex CLI | Да (родной формат) | август 2025, [agents.md](https://agents.md) | | GitHub Copilot Coding Agent | Да | 28.08.2025, [GitHub Changelog](https://github.blog/changelog/2025-08-28-copilot-coding-agent-now-supports-agents-md-custom-instructions/) | | Cursor | Да, корневой и вложенные файлы | [документация Cursor Rules](https://cursor.com/docs/rules) | | JetBrains Junie | Да, файл проекта и глобальный `~/.junie/AGENTS.md` | [документация Junie](https://junie.jetbrains.com/docs/guidelines-and-memory.html) | | Gemini CLI (Google) | Да, через `.gemini/settings.json` с `fileName: AGENTS.md` | [agents.md](https://agents.md) | | Jules (Google) | Да, соавтор стандарта | август 2025 | | Sourcegraph Amp | Да, соавтор стандарта | август 2025 | | Aider | Да, через `read: AGENTS.md` в `.aider.conf.yml` | [agents.md](https://agents.md) | | Factory | Да, соавтор стандарта | август 2025 | | OpenCode | Да | — | | Zed | Да | [agents.md](https://agents.md) | | Warp | Да | [agents.md](https://agents.md) | | VS Code | Да | [agents.md](https://agents.md) | | Windsurf | Да | — | | Devin (Cognition) | Да, через Spec Kit Skills | апрель 2026 | | RooCode, Kilo Code, Augment Code | Да | [agents.md](https://agents.md) | | **Claude Code (Anthropic)** | **Да, если в проекте нет CLAUDE.md** | с версии 2.1.277 (18.09.2026), [документация Claude Code](https://code.claude.com/docs/en/memory#agents-md) | В августе 2025 года в официальном репозитории `anthropics/claude-code` открыли issue №6235 с запросом на поддержку AGENTS.md. В ней отмечалось, что Codex, Amp, Cursor и другие инструменты движутся к общему Markdown-файлу с инструкциями по проекту, тогда как CLAUDE.md предназначен только для Claude Code. Обсуждение закрыли 17 августа 2026 года, а 18 сентября вышла версия 2.1.277 с поддержкой AGENTS.md. Правило Anthropic таково: CLAUDE.md имеет приоритет, а AGENTS.md используется, если CLAUDE.md нет в рабочей папке и родительских каталогах. [Документация](https://code.claude.com/docs/en/memory#agents-md) описывает следующие случаи: | Что лежит в проекте | Что читает Claude Code | |----|----| | Только AGENTS.md | AGENTS.md | | AGENTS.md и CLAUDE.md (или CLAUDE.local.md) | Только CLAUDE.md | | CLAUDE.md со строкой `@AGENTS.md` | CLAUDE.md, включающий AGENTS.md | Учитывается и личный файл `CLAUDE.local.md`: если он есть, Claude Code перестаёт самостоятельно читать AGENTS.md. Настройку можно изменить в `/config`, в разделе Project instructions, например включив чтение обоих файлов. В версиях старше 2.1.277 файл AGENTS.md по-прежнему нужно подключать строкой `@AGENTS.md` внутри CLAUDE.md. AGENTS.md и другие форматы инструкций удобно сопоставить по тому, какие инструменты их читают и как эти файлы устроены. ## Чем AGENTS.md отличается от CLAUDE.md и `.cursorrules`?
**Главное** По сути, все четыре формата — AGENTS.md, CLAUDE.md, `.cursorrules` и `.github/copilot-instructions.md` — представляют собой Markdown-инструкции для агента. Отличаются они поддерживающими их инструментами и расположением. AGENTS.md может хранить общие инструкции для нескольких клиентов; способы обнаружения и подключения настраиваются для каждого отдельно. CLAUDE.md рассчитан на Claude Code и поддерживает его специальные возможности: правила для отдельных путей, личный `CLAUDE.local.md`, директиву `@import` и уровни настроек пользователя, проекта и локальной среды. В Cursor вместо устаревшего `.cursorrules` рекомендуется использовать `.cursor/rules/*.mdc`, где правила можно автоматически подключать для определённых файлов. `.github/copilot-instructions.md` предназначен для GitHub Copilot.
Сравнение форматов по состоянию на 30 мая 2026 года: | Формат | Кто читает | Где лежит | Сильная сторона | Ограничение | |----|----|----|----|----| | **AGENTS.md** | Разные клиенты со своими правилами загрузки | Корень репозитория и вложенные папки | Один общий файл для агентов разных разработчиков | Нет уровней «пользователь + проект + локальные настройки»; правила собраны в одном месте | | **CLAUDE.md** | Только Claude Code | Корень, `~/.claude/CLAUDE.md` и `CLAUDE.local.md` | Иерархия, правила для путей, `@import`, skills и hooks | Не работает в Cursor, Codex и Copilot | | **`.cursor/rules/*.mdc`** | Только Cursor | `.cursor/rules/.mdc` | Автоматическое подключение по типу файла или пути | Только Cursor; формат `.mdc` специфичен для него | | **`.github/copilot-instructions.md`** | GitHub Copilot (веб и классический интерфейс) | `.github/` | Действует и на GitHub.com в браузере | Только Copilot; может дублировать AGENTS.md | AGENTS.md решает задачу общих правил для разных агентов, но не предоставляет личные настройки, которые не нужно коммитить. Для этого в Claude Code есть `CLAUDE.local.md`, а в Cursor — локальные файлы `.mdc`. Сам по себе AGENTS.md таких настроек не даёт: можно сочетать форматы или отдельно договориться в команде, как хранить личные правила и исключать их из Git. Есть и вопрос расположения файлов в монорепозитории. Codex и Cursor применяют правило ближайшего AGENTS.md: отдельный файл можно поместить в пакет, а инструмент использует инструкции, ближайшие к текущей папке. > «В монорепозитории можно создавать отдельный AGENTS.md для каждого пакета. Агент находит ближайший файл в дереве каталогов и применяет его». > > ([agents.md](https://agents.md), перевод с английского) На [agents.md](https://agents.md) также указано, что в основном монорепозитории OpenAI находятся 88 файлов AGENTS.md для разных пакетов. Если проект устроен как монорепозиторий, разместите общие правила в корне, а требования для отдельных частей — во вложенных файлах. ## Что должно быть внутри хорошего AGENTS.md?
**Главное** Практичный шаблон AGENTS.md включает восемь разделов: обзор проекта, команды настройки, стиль кода, особенности среды разработки, тестирование, правила для pull request, безопасность и границы допустимых действий. Остальное добавляется по необходимости. Формулируйте пункты как точные команды или примеры: общего совета вроде «пишите чистый код» недостаточно.
Сайт [agents.md](https://agents.md) оставляет структуру свободной: подойдёт любой Markdown. Однако во многих полезных файлах повторяется один набор из восьми разделов. Следите, чтобы каждый пункт содержал конкретную команду или пример, а не расплывчатое пожелание. 1. **Обзор проекта** — две-три строки о назначении проекта, его пользователях и основной цели; без рекламных формулировок. Например: «Telegram-бот для онбординга в платный практикум. Стек: Next.js 14, Prisma, PostgreSQL. Запускается при добавлении новой записи в `purchases`». 2. **Команды настройки** — точные команды для запуска проекта локально: `npm install`, `npm run dev`, `npm run build`. Не ограничивайтесь советом «обычно делаем так». 3. **Стиль и соглашения по коду** — конкретные требования с примерами. Например: «Строгая типизация TypeScript, одинарные кавычки, без экспортов по умолчанию; компоненты называются в PascalCase, хуки — с префиксом `use`». 4. **Среда разработки** — укажите важные параметры: какие переменные нужны в `.env`, где хранить секреты, какие порты используются и как работать с локальной базой данных. 5. **Тестирование** — опишите команду запуска и условие успешного результата. Например: `npm test -- --testPathPattern=user-auth`; все тесты должны завершиться успешно. 6. **Правила для PR и коммитов** — задайте формат сообщений коммитов, проверок перед PR и согласования изменений. 7. **Безопасность** — перечислите конкретные запреты: «Не коммить `.env`. Храни секреты только в Vault. Не добавляй персональные данные пользователей в логи». 8. **Границы и запреты** — укажите, чего не делать, и приведите безопасный вариант. Например: «Не запускай `git push --force` для main. Для отката используй `git revert` или `git reset` в feature-ветке». Для каждого раздела полезно правило «команда вместо общего пожелания». Совет «осторожно работай с миграциями» легко понять по-разному. Инструкция «перед `alembic upgrade head` запусти `alembic check`; если команда вернула ошибку, остановись и уточни, как действовать» задаёт конкретную последовательность и условие. ## Готовый шаблон AGENTS.md: скопируйте и адаптируйте
**Главное** Ниже приведён начальный вариант AGENTS.md для типового веб-проекта. Скопируйте его в корень репозитория, замените `` и `` на сведения о проекте, укажите действительные команды и удалите ненужные разделы. Если вы впервые настраиваете такой файл, на адаптацию обычно требуется 20–30 минут.
````markdown # AGENTS.md ## Project overview - <одна фраза про назначение>. Stack: . Главные сущности: . Подробности для людей - в README.md. ## Setup commands ```bash # первая установка npm install cp .env.example .env # потом заполнить вручную, см. список ниже # запуск npm run dev # dev-сервер на :3000 npm run build # production-сборка npm run start # запуск production-сборки ``` ## Dev environment - Node 20+ (через nvm: `nvm use 20`) - PostgreSQL 16 локально на :5432 (`docker-compose up postgres`) - Redis опционален, нужен только для очередей (`docker-compose up redis`) - `.env`: `DATABASE_URL`, `STRIPE_KEY`, `RESEND_API_KEY`, `JWT_SECRET` - Никогда не читай `.env` целиком. Если нужна одна переменная: `grep "^VAR=" .env` ## Code style - TypeScript strict mode - Single quotes, no semicolons (если не требует ESLint) - Импорты: внешние, потом внутренние через `@/`, потом относительные - Компоненты в PascalCase, хуки начинаются с `use` - Никаких `any` без явного комментария «почему нельзя типизировать» Пример хорошего модуля: ```ts import { z } from 'zod' const UserSchema = z.object({ email: z.string().email(), name: z.string().min(2), }) export function parseUser(raw: unknown) { return UserSchema.parse(raw) } ``` ## Testing ```bash npm test # все тесты npm test -- --testPathPattern=auth # только auth npm test -- --watch # watch-режим ``` Все тесты должны проходить (зелёные) перед коммитом. Если тест красный - не коммить, спроси меня, что делать. ## Pull request guidelines - Commit-формат: `(): <описание>` (`feat(auth): добавить magic-link`) - Перед PR: `npm run build && npm test && npm run lint` - PR-описание = что меняется, зачем, как тестировать - Не аппрувь PR сам - всегда жди ревью человека ## Security - Секреты только в `.env` и в Vault, никогда в коде - Персональные данные (email, телефон, имя) не выводи в логи - При работе с production-БД - только read-only запросы без явного разрешения - API-ключи внешних сервисов (Stripe, OpenAI) не хардкодь в тестах ## Never do this - Не делай `git push --force` на main. Если нужно откатить - `git revert` или новый PR - Не запускай миграции БД без `alembic check` (или эквивалента в твоей ORM) - Не используй `npm install -g` или `sudo` для проектных зависимостей - Не добавляй новые зависимости без согласования (особенно тяжёлые: webpack-плагины, ORM) ```` Обычно такой файл занимает 80–120 строк. Если объём превысил 150 строк, проверьте, какие подробности можно вынести в `docs/`, заменить ссылкой или сформулировать короче. По приведённым в исходном тексте данным исследования, оптимальная длина находится в пределах 100–150 строк, а после превышения этого объёма прирост качества начинает снижаться. ## Какие 5 правил делают AGENTS.md действительно полезным?
**Главное** Пять принципов помогают сделать AGENTS.md практичным: заменяйте общие пожелания командами, дополняйте запреты безопасными альтернативами, поддерживайте один источник актуальных правил, задавайте проверяемые условия готовности и старайтесь не превышать 150 строк. При этом конкретные количественные заявления об улучшении качества в исходном тексте опирались на неподтверждённые сторонние исследования и здесь не приводятся.
1. **Команды вместо пожеланий.** Фразу «осторожно работай с миграциями» легко пропустить. Команда `alembic check` перед `alembic upgrade head` задаёт ясное действие. Формулируйте правило как «сделай X; если условие Y не выполнено — поступи так-то». 2. **Запреты вместе с альтернативами.** Одного «не делай force push» может быть недостаточно. Лучше написать: «Не используй `git push --force` для main; если нужно отменить изменение, выполни `git revert` или создай новый PR». 3. **Единое место для актуальных правил.** Корневой AGENTS.md содержит общие инструкции проекта. В монорепозитории к ним можно добавлять отдельные AGENTS.md в подпапках, чтобы ближайший к рабочей области файл уточнял локальные правила. Проверяйте, чтобы файлы не противоречили друг другу. 4. **Условия готовности, которые можно проверить.** «Тесты должны проходить» — недостаточно конкретно. Лучше задать критерий: команда `npm test` завершается с кодом 0 и не выводит `FAIL`. Условие «код должен быть чистым» можно уточнить так: `npm run lint` завершается без предупреждений. 5. **Умеренный размер.** Старайтесь уложить файл в 150 строк. Дополнительное описание архитектуры перенесите в `docs/architecture.md`, а из AGENTS.md дайте ссылку. В основном файле оставьте команды, ключевые правила и ограничения. ## Какие 10 ошибок превращают AGENTS.md в бесполезный файл?
**Главное** Инструкции теряют пользу, если в них нет конкретики. Не повторяйте README, не превращайте файл в сплошной текст и не составляйте длинные списки запретов без предлагаемых действий. Также избегайте конфликтующих приоритетов, настоящих секретов, устаревших сведений и чрезмерных архитектурных подробностей для простых задач. Дальше разобраны десять типичных проблем и способы их исправить.
1. **Общие пожелания вместо точных действий.** Совет «осторожно выполняй миграции» не объясняет, что делать. Укажите последовательность: «Перед `alembic upgrade head` запусти `alembic check`. Если проверка завершилась ошибкой, не применяй миграцию и уточни дальнейшие действия». 2. **Фраза «чистый код».** Она не задаёт конкретного образца. Замените её правилом: «Используй функциональные компоненты и хуки. Например: `function LoginForm() { const [email, setEmail] = useState(''); ... }`». 3. **Текст без заголовков и списков.** В документе на сотни строк сплошного текста нужное правило легко потерять. Разбейте содержание заголовками H2/H3 и короткими пунктами. 4. **Слишком длинный файл.** Если AGENTS.md занимает больше 150 строк, перенесите подробности в отдельные документы в `docs/` и оставьте на них ссылки. 5. **Много запретов без указания следующего шага.** Перечень «не делай X, не делай Y» оставляет агента без понятной альтернативы. К каждому запрету добавьте разрешённое действие. 6. **Повторение README.md.** Не копируйте инструкции по установке и запуску, если они уже есть в README. Дайте ссылку и оставьте в AGENTS.md контекст, нужный агенту. 7. **Настоящие секреты в файле.** AGENTS.md может храниться в Git и быть доступен другим. Не вставляйте ключи API, токены и пароли; вместо этого укажите место их безопасного хранения, например Vault: `secret/staging/db`. 8. **Неясная расстановка приоритетов.** Правила «делай быстро» и «обеспечь покрытие тестами на 90%» могут конфликтовать. Укажите, что главнее: «Сначала добейся покрытия не ниже 80%, затем оптимизируй скорость. Если требования конфликтуют, приоритет у тестов». 9. **Устаревшая документация.** Если описание говорит о REST и опросе сервера, а проект уже перешёл на WebSockets, агент может принять неверное решение. Обновляйте AGENTS.md в том же PR, что и соответствующий код. 10. **Избыточные детали архитектуры.** Чтобы изменить пару строк конфигурации, агенту не нужно читать описание всех 14 микросервисов. Вынесите подробную схему в `docs/architecture.md`, а здесь добавьте правило читать её для архитектурных задач. В официальной публикации GitHub Blog о разборе более 2500 файлов AGENTS.md общий вывод сформулирован так: чрезмерно общие инструкции часто мало помогают; фраза «You are a helpful coding assistant» сама по себе не даёт агенту полезных указаний. ## Как хранить AGENTS.md и CLAUDE.md в одном репозитории?
**Главное** Выбор зависит от набора инструментов. Если команда пользуется только Claude Code, достаточно CLAUDE.md. Для Codex, Cursor, Copilot или Junie удобно сделать AGENTS.md единственным источником общих правил. В смешанной команде можно взять его за основу: когда специальных инструкций для Claude нет, отдельный CLAUDE.md не обязателен, поскольку версия Claude Code 2.1.277 и новее читает AGENTS.md автоматически. Если специальные правила есть, подключите общий файл к CLAUDE.md символической ссылкой или через `@AGENTS.md`. В macOS и Linux переименовывать можно только при отсутствии AGENTS.md. Если оба файла существуют, сначала сохраните и объедините правила, затем используйте короткий CLAUDE.md с `@AGENTS.md`. Не перезаписывайте существующий AGENTS.md. В Windows проще использовать импорт, если создание символической ссылки требует дополнительных настроек.
Чтобы поддерживать оба файла и не дублировать правила, сначала определите, какими инструментами пользуется команда. Возможны три варианта. **Сценарий 1: используется только Claude Code.** Оставьте CLAUDE.md и используйте возможности Claude Code: `~/.claude/CLAUDE.md` для общих пользовательских инструкций, `CLAUDE.md` для проекта, `CLAUDE.local.md` для личных изменений, `@import` для подключения дополнительных документов и `.claude/skills/` для специальных навыков. AGENTS.md в таком случае не обязателен. **Сценарий 2: несколько клиентов разработки.** Храните общие правила в AGENTS.md и отдельно подключайте и проверяйте каждый клиент. Gemini CLI поддерживает настройку имени файла контекста, а Aider — загрузку через настройку чтения. Это явные способы подключения, а не одинаковый автоматический поиск. | Способ загрузки | Что проверить | |----|----| | Автоматическое обнаружение AGENTS.md | Документированные правила установленного клиента для корня, вложенных файлов и приоритета | | Явная настройка, например Gemini CLI или Aider | Имя файла или путь чтения и список загруженного контекста клиента | | Условная загрузка или импорт в Claude Code | Установленную версию и приоритет файлов; см. [отдельное руководство об AGENTS.md в Claude Code](https://ailoot.ai/blog/ru/claude-code-agents-md-support/) | Откройте новую сессию в безопасном тестовом репозитории. Добавьте уникальную безвредную инструкцию, например «включи маркер instructions-loaded в тестовый ответ», и проверьте как ответ, так и документированный список загруженных файлов или журнал клиента. Повторите для каждого используемого клиента и версии. Заявление самой модели о чтении файла не является независимым доказательством загрузки; один успешный тест не подтверждает поддержку во всех остальных инструментах. **Сценарий 3: Claude Code работает вместе с другими агентами.** Основным файлом можно назначить AGENTS.md. Если отдельные инструкции для Claude Code не нужны, CLAUDE.md можно не создавать: начиная с версии 2.1.277 Claude Code сам прочитает AGENTS.md, когда в проекте нет CLAUDE.md. Если специальные правила нужны, подключите AGENTS.md символической ссылкой или импортом `@AGENTS.md`. Перед изменением изучите и сохраните оба файла. Если они уже существуют, объедините непротиворечивые общие правила в AGENTS.md, а специальные инструкции Claude оставьте в CLAUDE.md с импортом `@AGENTS.md`. Существующие символические ссылки сохраняйте. Для обычного CLAUDE.md **только при отсутствии AGENTS.md** следующая проверка macOS/Linux не перезапишет ни файл, ни символическую ссылку: ```bash if [ -e AGENTS.md ] || [ -L AGENTS.md ]; then printf '%s\n' 'STOP: AGENTS.md exists; merge both files first.' >&2 elif [ -f CLAUDE.md ] && [ ! -L CLAUDE.md ]; then mv CLAUDE.md AGENTS.md && ln -s AGENTS.md CLAUDE.md else printf '%s\n' 'STOP: inspect the existing CLAUDE.md path first.' >&2 fi ``` После успешного переименования CLAUDE.md становится символической ссылкой на AGENTS.md. Инструменты находят общие правила по обоим именам. В Windows для создания символической ссылки может потребоваться режим разработчика или права администратора. Более простой вариант — короткий CLAUDE.md, импортирующий AGENTS.md: ```markdown # CLAUDE.md @AGENTS.md ## Claude Code specific - Используй .claude/skills/ для специализированных промптов - При работе с Skills - сверяйся с .claude/skills/INDEX.md - Plan Mode перед большими изменениями (Shift+Tab) ``` Claude Code подставляет содержимое AGENTS.md в место строки импорта, после чего в файле можно добавить дополнительные инструкции для Claude Code. Если общий файл больше не нужен, импорт можно убрать. Согласно документации Claude Code, повторного чтения одного AGENTS.md не происходит, даже когда он доступен инструменту напрямую. Для команды, использующей несколько инструментов, структура репозитория может выглядеть так: ``` repo-root/ ├── AGENTS.md # общий источник правил, не более 150 строк ├── CLAUDE.md # только при наличии особых правил для Claude: ссылка или @AGENTS.md и дополнения ├── .cursor/rules/ # точечные правила для Cursor ├── .github/copilot-instructions.md # «См. AGENTS.md», если файл используется └── docs/architecture.md # подробная архитектура, на которую ссылается AGENTS.md ``` Подробнее о CLAUDE.md рассказывает руководство [«Как настроить CLAUDE.md правильно»](https://ailoot.ai/blog/ru/kak-nastroit-claude-md/). О контекст-инжиниринге можно узнать в [отдельном руководстве](https://ailoot.ai/blog/ru/context-engineering/). ## Что изменилось в 2026 году: почему AAIF включила AGENTS.md в Linux Foundation?
**Главное** 9 декабря 2025 года Linux Foundation объявила о создании Agentic AI Foundation (AAIF). В число трёх проектов-основателей вошли AGENTS.md от OpenAI, MCP от Anthropic и goose от Block. Среди основателей были AWS, Anthropic, Block, Bloomberg, Cloudflare, Google, Microsoft и OpenAI. К 24 февраля 2026 года фонд объединял 146 организаций. AGENTS.md стал общим форматом с отраслевой поддержкой, а не отдельным решением OpenAI. Если продукт должен работать с агентами разных разработчиков, общий файл инструкций помогает избежать сопровождения нескольких версий правил.
Одно из заметных изменений в области ИИ-инструментов для разработки в 2026 году — согласование общих форматов. Ранее разные компании предлагали отдельные файлы с инструкциями, что усложняло работу команд, использующих сразу несколько инструментов. В [пресс-релизе от 9 декабря 2025 года](https://www.linuxfoundation.org/press/linux-foundation-announces-the-formation-of-the-agentic-ai-foundation) Linux Foundation сообщила о создании Agentic AI Foundation и назвала три проекта, вошедших в неё: - **AGENTS.md** от OpenAI — формат файла инструкций для ИИ-агентов. - **Model Context Protocol (MCP)** от Anthropic — протокол подключения внешних инструментов к агентам. - **goose** от Block — агентский фреймворк с открытым исходным кодом. В пресс-релизе Linux Foundation отмечалось: > «Объединение этих проектов в AAIF создаёт условия для их развития при открытом управлении, обеспечивающем прозрачность и стабильность». > > ([пресс-релиз Linux Foundation от 9 декабря 2025 года](https://www.linuxfoundation.org/press/linux-foundation-announces-the-formation-of-the-agentic-ai-foundation), перевод с английского) К 24 февраля 2026 года в AAIF входили [146 организаций](https://www.linuxfoundation.org/press/agentic-ai-foundation-welcomes-97-new-members); за два месяца к фонду присоединились ещё 97 участников. Среди новых золотых участников — Red Hat, ServiceNow, Akamai, Lenovo, JPMorgan Chase, Huawei, Hitachi, UiPath, American Express и Autodesk. Anthropic, OpenAI и Block вошли в число платиновых участников и поддерживали соответственно MCP, AGENTS.md и goose. Таким образом, AGENTS.md получил поддержку организаций, работающих над разными агентскими инструментами. В сентябре 2026 года Claude Code также научился читать этот файл, хотя расположенный в проекте CLAUDE.md обычно имеет приоритет. Для проекта, использующего агентов от нескольких разработчиков, практический вариант — хранить общие инструкции в AGENTS.md. Добавляйте CLAUDE.md, если нужны дополнительные правила только для Claude Code; общий файл можно подключить импортом `@AGENTS.md` или символической ссылкой. ## Что дальше AGENTS.md помогает заранее определить правила работы агента. Следующий шаг — собрать в отдельной папке проектные сведения, которые нужны для задач: информацию о компании, аудитории, продуктах и ценах. Затем можно настроить контекст-инжиниринг — определить, какие файлы агент получает на каждом шаге, как переносить состояние между сессиями и как менять модели. Практические материалы по работе с ИИ-инструментами и агентами доступны в [документации Ailoot](https://ailoot.ai/docs/).
### Источники - [agents.md — официальный сайт формата AGENTS.md](https://agents.md) - [Linux Foundation: объявление о создании Agentic AI Foundation (9 декабря 2025 года)](https://www.linuxfoundation.org/press/linux-foundation-announces-the-formation-of-the-agentic-ai-foundation) - [AAIF приветствует 97 новых участников (24 февраля 2026 года)](https://www.linuxfoundation.org/press/agentic-ai-foundation-welcomes-97-new-members) - [OpenAI: соучредители Agentic AI Foundation](https://openai.com/index/agentic-ai-foundation/) - [GitHub Changelog: поддержка AGENTS.md в Copilot Coding Agent (28 августа 2025 года)](https://github.blog/changelog/2025-08-28-copilot-coding-agent-now-supports-agents-md-custom-instructions/) - [GitHub Blog: выводы из анализа более 2500 репозиториев с AGENTS.md](https://github.blog/ai-and-ml/github-copilot/how-to-write-a-great-agents-md-lessons-from-over-2500-repositories/) - [Документация Claude Code: чтение AGENTS.md](https://code.claude.com/docs/en/memory#agents-md) - [Официальная документация JetBrains Junie](https://junie.jetbrains.com/docs/guidelines-and-memory.html) - [Официальная документация Cursor Rules](https://cursor.com/docs/rules)
Больше материалов и инструментов — на [Ailoot](https://ailoot.ai/). ## Вопросы и ответы ### Что делать, если AGENTS.md и CLAUDE.md уже существуют? Сохраните и сравните оба файла. Общие правила объедините в AGENTS.md, специальные правила Claude оставьте в CLAUDE.md и добавьте импорт @AGENTS.md. Не переименовывайте один поверх другого. ### Как сделать инструкции проверяемыми? Укажите точные команды настройки и тестов, ожидаемый результат и запреты на изменения. Подробную архитектуру вынесите в связанные документы, чтобы основные инструкции было легко просмотреть. ## Ailoot · Компания и портфель её проектов Ailoot опирается на накопленный опыт работы, большую клиентскую базу, стабильный сервис и постоянный контроль KPI. Компания и портфель её проектов: миллионы клиентов; продажи на миллиарды ежемесячно. Этот опыт Ailoot использует для API-доступа к нейросетям в продуктах клиентов, агентах, приложениях и автоматизациях.