Большинство статей про AGENTS.md отвечают на два вопроса: что это такое и что в него положить. Для меня интереснее другой вопрос: почему этот файл вообще появился?
Ответ, как мне кажется, лежит не в AI, а в документации.
Документация перестала быть только для людей
Долгое время инженерная документация существовала почти исключительно для команды. Её читали разработчики, администраторы и новые сотрудники. Сегодня появился ещё один потребитель - AI. Чтобы работать предсказуемо, ему нужен тот же контекст, который раньше создавался только для людей.
Из-за этого меняется не формат документации, а её роль.
Каждый документ хранит свой контекст
В хорошем проекте документы не должны дублировать друг друга. Каждый из них отвечает на свой вопрос.
README объясняет, что это за проект. ADR фиксируют причины архитектурных решений. CHANGELOG показывает историю изменений. Техническая документация описывает детали реализации.
AGENTS.md отвечает на другой вопрос:
Как работать с этим проектом?
Именно поэтому он не должен превращаться в ещё один README или краткую архитектурную документацию.
Документация становится частью процесса
Когда инженерные соглашения существуют только в голове команды, они постепенно теряются. Когда они описаны в документации, ими начинают пользоваться люди. Когда документация хранится рядом с кодом и обновляется вместе с ним, ей могут пользоваться и инструменты.
В этот момент документация перестаёт быть приложением к проекту. Она становится частью процесса разработки.
AGENTS.md - только один из примеров
Я не думаю, что будущее DocOps связано с каким-то одним форматом.
Сегодня эту роль выполняет AGENTS.md. Завтра может появиться другой файл или новый стандарт.
Важно не название.
Важно сделать инженерный контекст явным, поддерживаемым и пригодным для повторного использования.
Вывод
Для меня AGENTS.md - не просто инструкция для AI.
Это ещё один инженерный артефакт проекта. Такой же, как README, ADR или CHANGELOG, но с другой зоной ответственности.
Документация больше не существует только для людей. Она становится способом передавать инженерный контекст всем участникам процесса - и людям, и инструментам.
Именно поэтому я считаю AGENTS.md частью DocOps, а не просто ещё одним файлом в репозитории.