Agents.md - это readme для агентов - 2026

Материал из Wiki - Iphoster - the best ever hosting and support. 2005 - 2026
Перейти к:навигация, поиск

Published: 2026-08-20


AGENTS.md — это открытый, вендорно-нейтральный формат файла инструкций для искусственного интеллекта, работающего с программным кодом. Если говорить просто — это «README для агентов»: предсказуемое, выделенное место в репозитории, где лежит вся информация, необходимая ИИ-кодинг-агенту для эффективной работы с конкретным проектом. Файл размещается в корне репозитория и содержит команды сборки, инструкции по запуску тестов, правила оформления кода, требования к pull request и многое другое, что разработчик сказал бы новому члену команды.

Стандарт был создан компанией OpenAI в августе 2025 года, стремительно распространился по индустрии и к началу 2026 года поддерживается более чем двадцатью инструментами — от Claude Code и Cursor до GitHub Copilot и opencode. В декабре 2025 года управление стандартом было передано в Agentic AI Foundation (AAIF) — нейтральный фонд, действующий под эгидой Linux Foundation, что гарантирует независимость формата от интересов какой-либо одной компании.

Данная статья — глубокий обзор формата AGENTS.md по состоянию на середину 2026 года: его история, технические особенности, экосистема инструментов, сравнение с альтернативными форматами, научные данные об эффективности и перспективы развития.

Проблема, которую решает AGENTS.md

Прежде чем разбирать сам формат, важно понять, какую проблему он решает. С появлением ИИ-кодинг-агентов — программных инструментов, способных самостоятельно читать репозиторий, писать код, запускать тесты и создавать pull request — возникла острая потребность передавать агенту контекст о проекте. Агент, в отличие от человека, не имеет опыта работы с проектом, не знает его историю и договорённости команды. Он «видит» только то, что попадает в его контекст — набор файлов, которые он читает перед началом работы.

Разрозненные проприетарные форматы

До появления AGENTS.md каждый инструмент решал эту проблему по-своему, создавая собственные файлы инструкций с разными именами и в разных местах:

  • CLAUDE.md — формат компании Anthropic для инструмента Claude Code;
  • .cursor/rules/*.mdc — правила для редактора Cursor;
  • .github/copilot-instructions.md — инструкции для GitHub Copilot;
  • GEMINI.md — инструкции для Gemini CLI от Google;
  • .clinerules — правила для RooCode / Cline;
  • .cursorrules — устаревший формат Cursor.

Проблема была очевидна: содержание этих файлов почти всегда одинаково — команды сборки, тесты, стиль кода, запреты. Но имя файла и его расположение различались от инструмента к инструменту. Разработчик, работающий с несколькими агентами, был вынужден поддерживать несколько копий одних и тех же инструкций в разных форматах, а команды разработчиков — решать, какой инструмент «официальный» в их репозитории. Переход с одного агента на другой означал миграцию инструкций в новый файл с новым именем.

Решение: единое имя файла

AGENTS.md предложил радикально простое решение: один файл, одно имя, один формат — обычный Markdown без какой-либо специальной разметки. Файл AGENTS.md в корне репозитория понятен любому агенту, поддерживающему стандарт. Контент, который раньше дублировался в CLAUDE.md, .cursorrules и copilot-instructions.md, теперь пишется один раз и работает во всех инструментах.

Дополнительное преимущество — предсказуемость. Агент, впервые открывающий незнакомый репозиторий, точно знает, куда смотреть. Ему не нужно искать инструкции по всему дереву каталогов — файл AGENTS.md находится в заранее известном месте. Это особенно важно для монорепозиториев с сотнями подпроектов, где без чётких указаний агент может легко потеряться.

Формат и структура

Главная особенность AGENTS.md — намеренный минимализм. Согласно официальному FAQ сайта agents.md, в формате нет обязательных полей. Это просто стандартный Markdown с произвольными заголовками; агент просто разбирает текст, который ему передают.

Никакого frontmatter

Важно понимать, чего в формате нет. В AGENTS.md нет:

  • YAML/TOML/JSON frontmatter — структурированных полей в начале файла;
  • обязательных полей вроде version, name, description, permissions, env, config;
  • формальной нумерации версий спецификации;
  • схемы данных, которую можно валидировать.

Поля вида version/permissions/tools/env, которые встречаются в некоторых статьях о «спецификации AGENTS.md», на самом деле относятся к другим, смежным форматам: конфигурации Claude Code subagents, файлу opencode.json, персонам GitHub Copilot agents или формату SKILL.md от Anthropic. В сам стандарт AGENTS.md эти поля не входят.

Рекомендуемые разделы

Хотя формат свободный, официальный сайт рекомендует включать в файл определённые разделы, а исследование более чем 2500 репозиториев, опубликованное в блоге GitHub, выделило шесть ключевых областей, которые встречаются в большинстве удачных файлов:

  • Команды — точные исполняемые команды сборки, установки зависимостей и запуска окружения;
  • Тестирование — какие тесты запускать и до какого состояния доводить перед завершением задачи;
  • Структура проекта — карта репозитория, объяснение, что где лежит;
  • Стиль кода — правила форматирования, паттерны, типизация;
  • Git-рабочий процесс — формат коммит-сообщений, правила PR;
  • Границы и запреты — чего агенту трогать нельзя, вопросы безопасности.

Официальный сайт также рекомендует добавлять специфичные для проекта сведения: «грабли» и ловушки, с которыми сталкивались разработчики, особенности работы с большими датасетами, шаги деплоя, правила безопасности. Хороший AGENTS.md отвечает на вопрос: «Что вы сказали бы новому тиммейту в первый день?»

Приоритеты и иерархия

Один из важнейших аспектов стандарта — правила разрешения конфликтов между несколькими файлами AGENTS.md. В монорепозиториях файлов может быть много — в основном репозитории OpenAI их насчитывается 88.

Ближайший файл побеждает

Правило простое: агент читает файл AGENTS.md, ближайший к редактируемому файлу в дереве каталогов. Вложенные файлы в подпроектах имеют приоритет над файлом в корне репозитория, а тот, в свою очередь, — над глобальными инструкциями на уровне пользователя (например, ~/.codex/AGENTS.md или ~/.config/opencode/AGENTS.md).

Порядок приоритетов, от более высокого к более низкому:

  1. Явные указания пользователя в чате — они перекрывают всё, включая содержимое любых файлов;
  2. Ближайший AGENTS.md — файл, находящийся ближе всего к редактируемому файлу в дереве каталогов;
  3. Корневой AGENTS.md — файл в корне репозитория;
  4. Глобальные файлы — инструкции уровня пользователя или машины.

Сборка цепочки инструкций

Разные агенты по-разному собирают цепочку инструкций. OpenAI Codex конкатенирует файлы от корня вниз к текущему каталогу, объединяя их в единый контекст, при этом действует лимит project_doc_max_bytes (по умолчанию 32 КБ) и поддерживается файл AGENTS.override.md, а также список fallback-имён через project_doc_fallback_filenames. opencode читает AGENTS.md снизу вверх от текущего каталога и дополнительно подключает глобальный ~/.config/opencode/AGENTS.md, а при отсутствии AGENTS.md использует CLAUDE.md как запасной вариант. Codex формирует цепочку один раз за сессию, а не перечитывает файлы при каждом действии.

История появления

История AGENTS.md началась внутри компании OpenAI. Инженеры, работавшие над инструментом Codex — ИИ-кодинг-агентом OpenAI, — столкнулись с необходимостью давать агенту предсказуемый источник проектных инструкций. 19 августа 2025 года сотрудник OpenAI Ромен Уэ (romainhuet) создал репозиторий с первым коммитом — так появился формат.

Август 2025: запуск и быстрый рост

В августе 2025 года формат был официально представлен. Ключевым шагом стало объединение усилий нескольких компаний: рабочая группа, созванная OpenAI, включала OpenAI Codex, Amp (Sourcegraph), Jules (Google), Cursor и Factory, позже к ним присоединились RooCode, Kilo Code и другие. Уже к концу августа 2025 года, по данным InfoQ, формат использовался более чем в 20 000 репозиториях. 28 августа 2025 года GitHub Copilot coding agent официально добавил поддержку AGENTS.md — это стало важным сигналом для всей индустрии.

Стремительное распространение объяснялось тремя факторами:

  • простота — файл не требует специального инструментария или схемы;
  • универсальность — один файл работает во всех поддерживающих агентах;
  • открытость — формат не принадлежал ни одной компании.

Декабрь 2025: передача в Linux Foundation

9 декабря 2025 года произошло знаковое событие. OpenAI, Anthropic и Block объявили о создании Agentic AI Foundation (AAIF) — фонда под эгидой Linux Foundation. В фонд были переданы три ключевых актива:

  • AGENTS.md — от OpenAI;
  • Model Context Protocol (MCP) — от Anthropic;
  • goose — ИИ-агент с открытым исходным кодом от Block.

Платиновыми членами-основателями фонда стали Amazon (AWS), Anthropic, Block, Bloomberg, Cloudflare, Google, Microsoft и OpenAI. Цель передачи — нейтральное управление стандартом: ни одна компания не должна контролировать формат, от которого зависит вся индустрия ИИ-разработки. С этого момента сайт agents.md носит подпись «AGENTS.md a Series of LF Projects, LLC».

2026 год: консолидация

В мае 2026 года AAIF объявил о расширении: к фонду присоединились 43 новых члена. К середине 2026 года, по данным поиска GitHub, количество корневых файлов AGENTS.md в открытых репозиториях приблизилось к 100 тысячам — сайт формата показывает счётчик «60k+ проектов» (консервативная оценка, считающая только ненаследуемые, неархивные репозитории).

Управление стандартом: Agentic AI Foundation

Понимание структуры управления важно для оценки долгосрочных перспектив стандарта. AAIF действует как directed fund — направленный фонд под управлением Linux Foundation, крупнейшей некоммерческой организации, курирующей открытые проекты (ядро Linux, Kubernetes, Node.js и сотни других).

Рабочие группы AAIF

Внутри фонда работают тематические рабочие группы:

  • Accuracy & Reliability (точность и надёжность);
  • Agentic Commerce (агентная коммерция);
  • Governance/Risk/Regulatory (управление, риски, регулирование);
  • Identity & Trust (идентичность и доверие);
  • Observability & Traceability (наблюдаемость и трассируемость);
  • Security & Privacy (безопасность и конфиденциальность);
  • Workflows & Process Integration (интеграция рабочих процессов);
  • Taxonomy & Landscape (таксономия и ландшафт).

Почему это важно

Передача стандарта в нейтральный фонд решает фундаментальную проблему доверия. Формат инструкций — это фактически «шлюз» в любой репозиторий: тот, кто контролирует формат, может влиять на поведение агентов по всей индустрии. Под управлением AAIF стандарт защищён от поглощения одной компанией, что особенно важно на фоне конкуренции между OpenAI, Anthropic и Google. Интересно, что при этом Anthropic формально не участвует в рабочей группе AGENTS.md и продолжает продвигать собственный формат CLAUDE.md для своего инструмента Claude Code.

Поддержка в инструментах

Главная сила формата — широта поддержки. По состоянию на середину 2026 года сайт agents.md перечисляет 23 инструмента, читающих AGENTS.md:

Инструмент Разработчик Особенности поддержки
Codex OpenAI Полная поддержка: вложенные файлы, AGENTS.override.md, лимит 32 КБ
Cursor Anysphere Нативная поддержка наряду с .cursor/rules
GitHub Copilot GitHub Поддержка с августа 2025; также читает CLAUDE.md и copilot-instructions.md
Gemini CLI Google Подключается через .gemini/settings.json
Jules Google Соавтор формата, полная поддержка
Amp Sourcegraph Соавтор формата
Factory Factory AI Соавтор формата; поддержка ~/.factory/AGENTS.md
Devin Cognition Нативная поддержка
Windsurf Cognition Нативная поддержка
opencode opencode Читает снизу вверх + глобальный ~/.config/opencode/AGENTS.md
Aider — Через .aider.conf.yml (read: AGENTS.md)
Zed Zed Industries Нативная поддержка
Warp Warp Нативная поддержка
VS Code Microsoft Через Copilot custom agents
Junie JetBrains Нативная поддержка
RooCode — Поддержка; fallback на AGENT.md
Kilo Code — Поддержка; fallback на AGENT.md
goose Block Нативная поддержка (передан в AAIF)
UiPath Autopilot UiPath Поддержка с декабря 2025
Augment Code Augment Добавлен в марте 2026
Ona — Поддержка с сентября 2025
Phoenix — Поддержка с августа 2025
Semgrep Semgrep Поддержка с августа 2025

Claude Code: заметный аутсайдер

Единственный крупный инструмент без нативной поддержки AGENTS.md — Claude Code от Anthropic. Он читает собственный файл CLAUDE.md, и формат AGENTS.md для него не является частью стандартной цепочки контекста. Сообщество разработало обходные пути: 

# Симлинк — самый простой способ
ln -s AGENTS.md CLAUDE.md

# Или импорт первой строкой в CLAUDE.md
echo '@AGENTS.md' > CLAUDE.md

Эта ситуация — главный конфликт экосистемы: с одной стороны, Anthropic входит в AAIF и передала туда MCP, с другой — продолжает держать Claude Code на собственном формате инструкций. Некоторые агенты (opencode, Copilot) используют CLAUDE.md как fallback при отсутствии AGENTS.md, но обратная совместимость не гарантируется.

Как использовать AGENTS.md

Начать использование формата просто — не требуется никаких инструментов или схем. Официальный сайт описывает четыре шага.

Шаг 1: создайте файл в корне

Создайте файл AGENTS.md в корне репозитория. Для монорепозиториев создавайте дополнительные вложенные файлы в подпроектах — агент автоматически найдёт ближайший.

Шаг 2: добавьте базовые разделы

Рекомендуемый минимум:

  • обзор проекта и его структура;
  • команды сборки и установки зависимостей;
  • команды запуска тестов;
  • правила стиля кода;
  • инструкции по тестированию;
  • вопросы безопасности и запреты.

Шаг 3: добавьте специфичные инструкции

Включите то, что знает только ваша команда: формат коммит-сообщений, правила оформления PR, известные «грабли» и ловушки, особенности деплоя, работу с большими датасетами, ограничения окружения.

Шаг 4: обновляйте регулярно

AGENTS.md — это «живая документация» (living documentation). Файл можно и нужно обновлять по мере изменения проекта. Если агент сообщил о проблеме или вы нашли новый нюанс — зафиксируйте его в файле, чтобы проблема не повторилась.

Миграция с других форматов

Если у вас уже есть файлы инструкций для конкретных агентов, миграция тривиальна. Для перехода с AGENT.md (формат RooCode/Kilo Code) официальный FAQ рекомендует: 

mv AGENT.md AGENTS.md && ln -s AGENTS.md AGENT.md

Аналогичный подход работает для любых других имён: переименуйте файл в AGENTS.md и создайте симлинк со старым именем для обратной совместимости с инструментами, которые ещё не обновлены.

Пример файла

Официальный сайт приводит пример AGENTS.md. Вот адаптированная версия, демонстрирующая типичную структуру: 

# AGENTS.md

## Dev environment tips
- Use `pnpm dlx turbo run where <project_name>` to jump to a package instead of scanning with `ls`.
- Run `pnpm install --filter <project_name>` to install dependencies for a specific package.
- Use `pnpm create vite@latest <project_name> -- --template react-ts` for new frontend packages.

## Testing instructions
- Find the CI plan in the .github/workflows folder.
- Run `pnpm turbo run test --filter <project_name>` to run tests for a package.
- Fix any test or type errors until the whole suite is green.
- Add or update tests for the code you change, even if nobody asked.

## PR instructions
- Title format: [<project_name>] <Title>
- Always run `pnpm lint` and `pnpm test` before committing.

Пример из реального проекта

Для иллюстрации практической ценности — фрагмент AGENTS.md из репозитория openai/codex (проект на Rust): 

# Rust/codex-rs

In the codex-rs folder where the rust code lives:
- Crate names are prefixed with `codex-`.
- Never add or modify any code related to `CODEX_SANDBOX_NETWORK_DISABLED_ENV_VAR`.
- You operate in a sandbox where `CODEX_SANDBOX_NETWORK_DISABLED=1` will be set
  whenever you use the `shell` tool.
- ...

## Python Development Best Practices
- This project uses Python 3+. You should not use the `__future__` module.

Обратите внимание на конкретность инструкций: точные имена переменных, явные запреты, чёткие правила. Это и есть главный секрет хорошего AGENTS.md — он содержит информацию, которую агент не может вывести из кода сам.

Лучшие практики написания

В августе 2025 года блог GitHub опубликовал исследование более чем 2500 репозиториев с файлами AGENTS.md, выделив практики, которые действительно работают.

Что работает

  • Точные команды с флагами — вместо «установи зависимости» пишите конкретную команду: pnpm install --filter <package>;
  • Примеры кода вместо описаний — агенту проще скопировать корректный паттерн, чем интерпретировать словесное описание;
  • Явные запреты — «никогда не коммитьте секреты», «не изменяйте файл X» — работают надёжнее общих пожеланий;
  • Конкретный стек с версиями — указание точных версий инструментов исключает догадки;
  • Правила PR и коммитов — агенты, создающие pull request автоматически, нуждаются в чётком формате заголовков и описаний.

Что не работает

  • Пересказ того, что агент и так увидит в коде;
  • Общие фразы без конкретики («пишите хороший код»);
  • Устаревшие инструкции — агенты доверяют файлу и будут следовать устаревшим командам;
  • Слишком длинные файлы — они раздувают контекст и стоимость токенов.

Сравнение с другими форматами

Для полного понимания места AGENTS.md в экосистеме сравним его с основными альтернативами.

Формат Аудитория Владелец Формат файла Совместимость
README.md Люди Любой проект Markdown Не читается агентами как инструкции
AGENTS.md Любые кодинг-агенты AAIF / Linux Foundation Чистый Markdown, без frontmatter Кросс-вендорная (23+ инструмента)
CLAUDE.md Claude Code Anthropic Markdown + опциональный frontmatter Только Claude Code (другие — как fallback)
.cursor/rules/*.mdc Cursor Anysphere Markdown + frontmatter (globs, alwaysApply) Только Cursor
copilot-instructions.md GitHub Copilot GitHub Markdown Copilot (наряду с AGENTS.md)
SKILL.md Любые агенты Anthropic (open standard) Markdown + YAML frontmatter 40+ клиентов через agentskills.io
opencode.json opencode opencode JSON Только opencode (может подключать AGENTS.md)

README.md vs AGENTS.md

Распространённый вопрос: почему нельзя просто писать инструкции в README.md? Ответ: README предназначен для людей и выполняет другие функции — описание проекта, быстрый старт, документация API. Смешение аудиторий в одном файле плохо сказывается на обоих: README раздувается деталями, которые неинтересны людям, а агент не может отличить инструкции для себя от человеческой документации. AGENTS.md дополняет README, а не заменяет его: человеческий файл остаётся кратким, а всё, что нужно агенту, собрано в одном предсказуемом месте.

AGENTS.md vs CLAUDE.md

CLAUDE.md — ближайший родственник AGENTS.md, но с важным отличием: это проприетарный формат одного инструмента. Anthropic не участвует в рабочей группе AGENTS.md, и Claude Code не читает AGENTS.md нативно. Стратегия Anthropic — продвижение собственной экосистемы (CLAUDE.md, Agent Skills, MCP), хотя MCP при этом передан в AAIF. Для мультиинструментальных команд выбор очевиден: AGENTS.md покрывает все агенты, включая тех, кто читает CLAUDE.md как fallback.

Смежные стандарты экосистемы

AGENTS.md — лишь один слой в формирующемся стеке стандартов агентной разработки. Понимание всего стека помогает правильно позиционировать формат.

SKILL.md (Agent Skills)

Стандарт переиспользуемых навыков для агентов, созданный Anthropic и открытый в декабре 2025 года. Навык — это папка с файлом SKILL.md, содержащим YAML-frontmatter (name, description, version, license, tags) и Markdown-инструкции, плюс опциональные каталоги scripts/, references/, assets/. Ключевой принцип — progressive disclosure: метаданные (около 30–50 токенов) всегда в системном промпте, а тело навыка загружается только при активации. К 2026 году SKILL.md поддерживают более 40 клиентов, включая OpenAI Codex, Cursor и даже Claude Code. Отличие от AGENTS.md: файл проекта описывает конкретный репозиторий, навык — переиспользуемое умение (например, «писать миграции баз данных»), применимое в любом проекте.

MCP (Model Context Protocol)

Протокол подключения моделей к внешним инструментам и данным, созданный Anthropic и переданный в AAIF в декабре 2025 года. MCP отвечает на вопрос «как агент взаимодействует с миром» (API, базы данных, файловые системы), в то время как AGENTS.md отвечает на вопрос «что агент должен знать о проекте».

A2A (Agent2Agent)

Протокол взаимодействия агентов между собой от Google (JSON-RPC 2.0 + SSE + Agent Card), переданный в Linux Foundation в июне 2025 года. Поддерживается AWS, Cisco, Microsoft, Salesforce, SAP и ServiceNow. В августе 2025 года ACP от IBM объединился с A2A.

AGNTCY

Стек «интернета агентов» от Cisco Outshift (Agent Directory, OASF, транспорт SLIM), работающий под Linux Foundation с июля 2025 года. Он действует уровнем ниже A2A — каталог агентов, схемы, транспорт — и не конкурирует с MCP или A2A.

Итоговая картина стека:

Слой Стандарт Вопрос, на который отвечает
Контекст проекта AGENTS.md Что агент должен знать о репозитории?
Переиспользуемые навыки SKILL.md Как выполнять типовые задачи?
Инструменты и данные MCP Как агент взаимодействует с внешним миром?
Взаимодействие агентов A2A Как агенты общаются друг с другом?
Каталог и транспорт AGNTCY Как находить агентов и передавать сообщения?

Все эти стандарты, за исключением SKILL.md, в итоге оказались под зонтиком Linux Foundation — индустрия явно движется к консолидации агентных стандартов под нейтральным управлением.

Научные исследования и критика

С ростом популярности AGENTS.md появились и научные работы, оценивающие реальную эффективность формата. Самое заметное исследование — «Evaluating AGENTS.md» от ETH Zurich и LogicStar.ai (arXiv:2602.11988, 2026 год). Учёные проанализировали 138 репозиториев и 5694 pull request.

Ключевые результаты

  • файлы AGENTS.md, написанные людьми, дают прирост успешности задач агента примерно на 4%;
  • файлы, сгенерированные LLM, наоборот, снижают успешность примерно на 3%;
  • файлы в стиле README слегка ухудшают работу агентов (на 2–3%) и повышают расход токенов более чем на 20%;
  • реальную пользу приносят только узкие, невыводимые из кода директивы: команды сборки, известные «грабли», шаги верификации.

Интерпретация результатов

Эти цифры вызвали оживлённую дискуссию на Hacker News. Сторонники формата указывают, что 4% прироста — это уже существенный результат для столь дешёвого решения, а главная ценность AGENTS.md не в метрике успешных задач, а в предотвращении повторения уже исправленных ошибок и в экономии токенов за счёт того, что агент не исследует репозиторий вслепую. Критики отмечают, что польза формата сильно зависит от качества файла: плохо написанный AGENTS.md вреден, нейтральный — бесполезен, а хороший — заметно улучшает работу агента.

Практический вывод из исследования: писать AGENTS.md вручную, узко и конкретно, а не генерировать «водянистые» файлы с помощью LLM, пересказывающие код.

Будущее стандарта

По состоянию на середину 2026 года развитие стандарта продолжается через сообщество: в репозитории agentsmd/agents.md около 170 открытых issues и 79 pull request.

Предложение v1.1

В январе 2026 года был открыт issue #135 с предложением версии 1.1: опциональный YAML-frontmatter с полями description (до 200 символов) и tags. Цель — «прогрессивное раскрытие» в монорепозиториях с десятками вложенных файлов: индексация и поиск без загрузки тел файлов. Часть инструментов (профили Copilot custom agents, частично Codex) уже парсит frontmatter впереди стандарта, однако полагаться на него пока нельзя. По состоянию на август 2026 года предложение остаётся открытым — консервативная позиция мейнтейнеров («просто Markdown») берёт верх.

Открытые вопросы

  • Issue #211 — предложение формализовать документ спецификации реализации AGENTS.md; автор справедливо отмечает: «это не стандарт, если требования не определены». Ответа от мейнтейнеров пока нет;
  • Issue #138 — предложение создать официальный валидатор; мейнтейнеры отвечают: «это стандарт, а не инструмент». Существуют сторонние валидаторы, например @reaatech/agents-markdown-validator на базе Zod;
  • Issue #207 — enterprise-паттерны внедрения и анти-паттерны;
  • Issue #224 — ребрендинг Gemini CLI в Antigravity CLI.

Тренды 2026 года

  • Валидация и инструменты: появление компиляторов и валидаторов, генерирующих AGENTS.md и SKILL.md из единого источника (например, MDA от sno-ai с JSON-схемой);
  • Интеграция с CI: файлы AGENTS.md начинают использоваться не только агентами, но и проверками в pipeline;
  • Расширение AAIF: 43 новых члена в мае 2026 года ускоряют стандартизацию;
  • Конкуренция с SKILL.md: экосистема движется к разделению ролей — контекст проекта (AGENTS.md) и переиспользуемые навыки (SKILL.md).

Итоговая картина 2026 года

К середине 2026 года AGENTS.md стал фактическим стандартом универсального контекста для кодинг-агентов. За неполный год формат прошёл путь от внутренней потребности OpenAI до проекта Linux Foundation с почти сотней тысяч репозиториев-адоптеров. Сильные стороны формата — нейтральность управления, минимализм и кросс-вендорная совместимость. Слабые — отсутствие формальной спецификации, неучастие Anthropic и зависимость пользы от качества ручного написания.

Для команды разработчиков решение простое: файл AGENTS.md в корне репозитория — это практически бесплатная страховка от типовых ошибок агентов, работающая во всех основных инструментах 2026 года. Пишите его вручную, конкретно и узко — и любой агент будет работать с вашим проектом так, будто он уже знаком с командой.

Резюме

AGENTS.md — открытый стандарт «README для агентов»: обычный Markdown-файл в корне репозитория с инструкциями для ИИ-кодинг-агентов. Создан OpenAI в августе 2025 года, с декабря 2025 года управляется Agentic AI Foundation под эгидой Linux Foundation. Поддерживается более чем 20 инструментами, включая Codex, Cursor, GitHub Copilot, opencode и Gemini CLI; Claude Code остаётся заметным аутсайдером с собственным форматом CLAUDE.md.

Ключевые особенности: отсутствие frontmatter и обязательных полей, правило «ближайший файл побеждает», поддержка монорепозиториев через вложенные файлы, приоритет явных указаний пользователя. Формат дополняет README.md и сосуществует со стеком смежных стандартов — SKILL.md (навыки), MCP (инструменты), A2A (взаимодействие агентов).

Научные данные (ETH Zurich, 2026) показывают, что польза формата зависит от качества написания: файлы, созданные людьми, дают до +4% успешности задач, а сгенерированные LLM — около −3%. Развитие формата продолжается: обсуждаются версия 1.1 с опциональным frontmatter, официальный валидатор и формальный документ спецификации.

Ссылки

×
Реклама
Источник — https://wiki.iphoster.net/index.php?title=Agents.md_-_это_readme_для_агентов_-_2026&oldid=17234
Powered by MediaWiki
ИКС