Агенты договорились о едином файле инструкций: AGENTS.md

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

Зачем агенту файл с правилами

Языковая модель не знает вашего проекта. Какие команды запускать для тестов, какой стиль кода принят, что трогать нельзя, куда складывать временные файлы — всё это приходится объяснять заново в каждом разговоре.

Решение придумали простое: положить правила в файл в корне репозитория. Агент читает его при старте и работает уже с этим знанием. Так появились CLAUDE.md у одного инструмента, свои файлы у других, и довольно быстро у команд, использующих несколько агентов, в репозитории завелось по три-четыре почти одинаковых файла.

Что изменилось

AGENTS.md — попытка свести это к одному. Формат ничем не примечателен: обычный текст в разметке Markdown, где человеческим языком описано, как устроен проект и чего от агента ждут.

Теперь Claude Code читает его, когда своего файла в проекте нет. Поведение переключается в настройках в разделе с инструкциями проекта. На корпоративных развёртываниях через Bedrock, Vertex и Foundry возможность пока не доступна.

Приоритет сохранён разумно: если CLAUDE.md в проекте есть, он и работает. Общий файл подхватывается только как запасной вариант, так что ничего не ломается у тех, кто уже всё настроил.

Почему это важнее, чем кажется

Стандарты в этой отрасли обычно рождаются через боль. Сначала каждый делает по-своему, потом пользователи начинают держать по файлу на инструмент, и в какой-то момент проще договориться, чем поддерживать зоопарк.

Похожая история уже была с протоколом подключения внешних инструментов: его придумала одна компания, а через год поддержали почти все. Теперь тот же путь проходят инструкции проекта.

Практический выигрыш прямой. Один файл вместо нескольких, меньше рассинхронизации между ними, и проект спокойно переезжает между инструментами. Для команды, где один разработчик сидит на одном агенте, а второй на другом, это снимает мелкое, но ежедневное трение.

Что написать в таком файле

Работает то же правило, что и с любым промптом: конкретика вместо общих слов.

• Какие команды запускают сборку, тесты и линтер.
• Что в проекте нельзя трогать и почему.
• Стиль кода и язык комментариев.
• Куда складывать временные файлы.
• Как устроены окружения и что считается опасным действием.

Чего писать не стоит: длинных рассуждений о философии проекта и дублирования того, что и так видно в коде. Файл читается при каждом запуске, и каждая лишняя строка в нём оплачивается токенами.

Что дальше почитать

• MCP: что это и как подключить — как отрасль уже договорилась про внешние инструменты.
• Из чего состоит кодинг-агент — что в обвязке агента реально влияет на результат.
• Нейросеть для кода — с чего начать, если пишете код с нейросетью.