Что это
AGENTS.md — простой открытый формат (обычный Markdown), который кладут в корень репозитория, чтобы дать кодинг-агентам контекст проекта: как собирать, как тестировать, какие конвенции, чего не делать. Дополняет README: то, что нужно агенту, но захламило бы доку для людей.
Откуда пошло
- Каждый агент завёл свой файл правил (
CLAUDE.md,.cursorrules,.github/copilot-instructions.md) — получился зоопарк. - Август 2025 — OpenAI, Google, Cursor, Factory и Sourcegraph формализовали единый
AGENTS.md. - GitHub Copilot стал обрабатывать его на стороне сервера; формат перешёл под стюардство Agentic AI Foundation (Linux Foundation).
Почему взлетело
- Один файл вместо N форматов под каждый инструмент — меньше дублирования, переносимость между агентами.
- Резко повышает качество работы агента: он сразу знает команды тестов и конвенции, а не угадывает.
- Быстрый buy-in (используют 60k+ проектов) сделал его де-факто стандартом за месяцы.
Как применить сейчас
- Положи
AGENTS.mdв корень: команды сборки/тестов, стиль, структура, «красные линии» (что не трогать). - Держи его коротким и актуальным — устаревшие правила хуже отсутствия правил.
- Для специфики Claude Code можно держать
CLAUDE.md, но базовые правила выноси в общий формат.
На что обратить внимание
- Слишком длинный файл «теряет силу» — агент перестаёт следовать; пиши только всегда-истинное.
- Это контекст, а не песочница: правила в файле не заменяют технических ограничений прав/хуков.
- Если правила противоречат друг другу — поведение агента непредсказуемо; держи их непротиворечивыми.