Что такое AGENTS.md? | Глоссарий GEO

AGENTS.md - это markdown-файл, размещаемый в корне репозитория или сайта; это де-факто стандартный файл инструкций, который сообщает ИИ-агенту о способе сборки проекта, командах тестирования, стиле кода и правилах, которые нужно соблюдать при работе. Его называют "README для агентов", и ведущие агенты для кодинга, включая OpenAI Codex, автоматически считывают его в начале работы.

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

ИИ-агенты для кодинга мощны, но не знают неявных знаний проекта. Какой командой запускать тесты, какие директории трогать нельзя - это приходилось заново объяснять в каждом промпте. AGENTS.md фиксирует этот контекст в одном файле, чтобы агент обращался к нему автоматически. Его совместно спроектировали OpenAI Codex, Amp, Jules (Google), Cursor и Factory, а нативно поддерживают более 20 инструментов, включая GitHub Copilot, Gemini CLI, Devin и Zed. По состоянию на 2026 год его приняли более 60 тысяч проектов с открытым исходным кодом, а в декабре 2025 года он вместе с MCP от Anthropic был передан в Agentic AI Foundation под эгидой Linux Foundation и управляется в рамках нейтрального руководства.

Структура и способ написания

AGENTS.md - это чистый markdown без обязательных полей. Вместо заданной схемы он содержит инструкции на естественном языке, которые агент может прочитать и выполнить. Рекомендуемая структура такова.

Обзор проекта: один-два абзаца о том, что это за кодовая база
Команды сборки и тестирования: установка зависимостей, dev-сервер, запуск тестов
Стиль кода: именование, форматирование, соглашения фреймворка
Безопасность и границы: файлы, которые нельзя трогать, правила обращения с секретами
Правила коммитов и PR: формат сообщений, процедура ревью

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

Отличие от llms.txt

Если llms.txt - это путеводитель, сообщающий ИИ, "какой контент есть", то AGENTS.md - это эксплуатационное руководство, объясняющее, "как здесь работать". Изначально он появился в репозиториях кода, но в последнее время возник и паттерн размещения его в корне сайта (/agents.md), чтобы подсказывать агенту браузинга, как пользоваться сайтом. Вместе с llms.txt и разметкой Schema.org он объединяется в категорию "сигналов, читаемых агентом (agent-readable signals)", и, в отличие от robots.txt, который регулирует разрешение ИИ-краулинга, он регулирует то, "что и как делать разрешённому агенту".

Значение для GEO

По мере того как центр тяжести GEO расширяется от "контента, который ИИ цитирует", к "сайту, на котором ИИ может работать", файлы с явными инструкциями для агентов становятся новым слоем оптимизации. Команде, которая ведёт инструменты разработки или документацию API, верно следующее: чем сильнее AGENTS.md сокращает пробы и ошибки агента, тем выше вероятность, что её продукт будет принят в рабочий процесс агента. Однако AGENTS.md - всего лишь инструкция без принудительной силы, поэтому структурное качество самого контента по-прежнему остаётся базой.

Источники:

Как помогает inblog

Если вы ведёте продуктовый блог или документацию в inblog, помните о разделении ролей сигналов. Пока файлы вроде llms.txt берут на себя описание контента, а AGENTS.md - инструкции по работе, текст блога должен обладать структурой, удобной для цитирования и резюмирования агентом. Чистая разметка и ясная система подзаголовков inblog дают больший эффект, когда сочетаются с этими читаемыми агентом сигналами.