Комментарии 5
Вот у меня отдельный AGENTS.md на каждый важный для проекта каталог (112 строк для корневого). Я уже про это писал. Агенты (codex как минимум) читают все AGENTS.md от корня проекта к рабочему (для агента) каталогу. Правила для агентов можно (и нужно!) "размазывать" по всему проекту.
А почему только для Codex? Разве другие агенты не работают с "распределённым AGENTS.md" таким же образом? Лично я в основном работаю именно с Codex'ом. Немного работал с opencode, но там я визуально не контролировал, что агент считывал всю иерархию AGENT.md до целевого каталога (с Codex'ом я это проверял). Думал, что все агенты действуют по такому же принципу - считывают все AGENTS.md от корня проекта и до рабочего каталога. Это не так?
UPDATE:
Проверил opencode. На промпт "Сколько файлов AGENTS.md участвует в формировании инструкций для этого каталога. Перечисли все." Получил такой ответ:
Четыре файла AGENTS.md образуют иерархию инструкций:
/home/alex/work/flancer32/alarisa/AGENTS.md — корневой уровень продукта; предписывает консультироваться с ctx/ и ctx/docs/.
/home/alex/work/flancer32/alarisa/ctx/AGENTS.md — корень когнитивного контекста; направляет читать docs/.
/home/alex/work/flancer32/alarisa/ctx/docs/AGENTS.md — уровень проектной документации; перечисляет product/ как один из разделов.
/home/alex/work/flancer32/alarisa/ctx/docs/product/AGENTS.md — уровень документации продукта; содержит прямые правила для работы с файлами в этом каталоге.
"Этот каталог" бы указан ранее.
Похоже, что opencode тоже видит файлы AGENTS.md в иерархии. Что логично, по такому же принципу работают конфигурационные файлы .htaccess для apache.
UPDATE2:
Это для Copilot'а:

Copilot также перечислил все AGENTS.md, лежащие в иерархии на пути к целевому каталогу. Каждый AGENTS.md содержит инструкции для своего уровня и в совокупности собираются в единый пул инструкций для рабочего каталога.
Согласен, «только Codex» лишнее, с урока осталось.
На скрине у вас как раз то, о чём я в статье: в AGENTS.md смысл, границы, роли, инварианты. Workflow и методологию туда не кладут. Четыре файла по дереву норм. Оркестрация и гейты в rules.
Opencode и Copilot склеивают иерархию. Я не про количество файлов, а про то, что в AGENTS.md не должно оказаться workflow. На скрине у вас это уже прописано.
Расскажу, как это устроено у меня, чтобы было понятнее.
Я работаю в Cursor. AGENTS.md использую только как карту: в монорепе свой файл на каждый проект внутри, в обычном репо один на весь проект. Больше туда ничего не пишу.
Все правила работы агента лежат в .cursor/rules, скиллы в .agents. Работал бы я в Claude Code папка называлась бы .claude, а смысл остался бы тем же.
Поэтому пример из статьи не привязан к Cursor. Его можно переписать под Claude, Codex или Copilot инструкции из дерева они собирают одинаково. Единственное, чего я не советую: строить мультиагентную оркестрацию внутри AGENTS.md. Роли, гейты и цепочка шагов, это отдельный слой правил, а не карта проекта.

Конвейер из 10 агентов без строчки кода: три промпта, 40 минут и прогон при зале