17 сентября я выступал в нашей кировской библиотеке им. Герцена с докладом про ИИ в разработке.

И одним из тезисов, на котором я делал акцент - важность создания качественного AGENTS.md. Это файл с инструкциями для агента, который обычно лежит в корне репозитория.

Сам я не сразу пришёл к понимаю важности этого файла. Но по мере работы с агентом, по мере того, как из раза в раз приходилось повторять для него одни и те же инструкции, я понял, что устал это делать, и нужно важные для меня требования зафиксировать в некотором соглашении. Так я создал и начал заполнять AGENTS.md. Сначала это было банально требование писать короткое тире и прямые кавычки вместо ёлочек. Потом постепенно я расширял набор своих "хотелок" от агента и включил в файл другие важные требования. Например, вот что интересного хранится в моём AGENTS.md
на данный момент:
* разделение разработки на 2 части: реализация и Senior Review, которые выполняются отдельными коммитами;
* Senior Review сопровождается стадией, которую я назвал Code Pruning, по аналогии с усечением деревьев решений в ML. На этой стадии устраняются дублирования, неиспользуемые конструкции, лишние проверки;
* требования к языку: простой, инженерный, без англицизмов;
* если агент при реализации видит, что выходит за лимит плана, обязательно согласует со мной изменение объёма;
* изменения небольшие и логически связанные, как правило не более 300 строк кода, чтобы можно было проверить вручную.

Я постарался сделать файл универсальным, чтобы переиспользовать в разных проектах. Теперь он хранится в отдельном git-репозитории и разворачивается в нужные проекты специальным скриптом с подменой ссылок на актуальные контексты.