AGENTS.md в ADSM: практика и наблюдения

14 декабря 2025

В процессе разработки проекта Svyazist я последовательно выстраивал работу с LLM-агентом через файловую структуру и текстовые инструкции. Одним из ключевых элементов этой практики стали файлы AGENTS.md.

Со временем стало понятно, что AGENTS.md работают не как набор команд, а как механизм формирования контекста, в рамках которого агент принимает решения. Их иерархия, размещение и структура начали оказывать заметное влияние на устойчивость работы и повторяемость результатов.

В этой публикации я зафиксировал свой текущий опыт использования AGENTS-файлов: где они действительно помогают, какие ограничения имеют и почему их роль в ADSM следует понимать как архитектурную, а не управляющую напрямую.