Когда я только начал использовать AGENTS.md, казалось, что он нужен только AI.
Со временем оказалось, что это не так.
Главная польза этого файла - не только в том, что AI реже ошибается. Он помогает сохранить рабочий контекст проекта.
Повторение одних и тех же инструкций
Раньше почти каждый новый диалог начинался одинаково. Приходилось объяснять, что это за проект, какой стек используется, какие соглашения приняты и что менять нельзя.
Теперь большая часть этой информации находится в репозитории.
Неожиданные изменения
Без контекста AI часто начинает улучшать проект по-своему.
Например:
- предлагает новые библиотеки
- меняет структуру каталогов
- добавляет лишние уровни абстракции
- нарушает принятые соглашения
Если правила описаны в AGENTS.md, таких предложений становится заметно меньше.
Пример
Иногда вместо небольшой функции AI предлагает выделить отдельный слой абстракции.
Было:
load_config()
Предлагает:
class ConfigProvider:
...
Для конкретного проекта это может быть лишним. Если в AGENTS.md указано, что проект придерживается простых решений, подобных предложений становится меньше.
Возвращение к старым проектам
Самый неожиданный эффект оказался связан не с AI.
Через несколько месяцев любой проект приходится вспоминать заново. Почему выбрали именно этот стек? Какие решения уже приняты? Что считается нормой для этого репозитория?
Ответы на эти вопросы уже находятся в AGENTS.md.
Вывод
Со временем я перестал воспринимать AGENTS.md только как инструкцию для AI.
Для меня он стал краткой памятью проекта.
Он помогает не только AI. Он помогает и мне самому быстрее восстановить контекст.