Как стандартизировать контекст для кодящих агентов

Зоопарк AI-тулинга растет, и некоторые плагины норовят притащить свой формат для файла агентских правил: CLAUDE.md, .clinerules и так далее. А ведь хочется пробовать разных агентов и бесшовно переключаться между ними. Писать и поддерживать правила под каждый инструмент — плохая идея, поскольку поддержание этих файлов в актуальном состоянии — это тоже приличный кусок работы.
Что делать?
1. AGENTS.md — единый стандарт Отказываемся от вендор-специфичных названий. AGENTS.md — универсальное решение. Тот же Kimi Code читает его отлично, а для Codex это вообще нативный формат.
2. Иерархия вместо свалки в корне Эти файлы можно и нужно раскидывать по папкам (модулям). Агенту нужен локальный контекст конкретного bounded-context, с которым он работает прямо сейчас, а не простыня обо всем проекте сразу.
3. Точка входа для упрямых плагинов (своеобразный symlink)
Если ваш инструмент строго требует свой собственный файл, создаем его в корне репозитория с одной-единственной инструкцией: «Всегда читай AGENTS.md в той директории, с которой сейчас работаешь».
4. Контроль контекста агента
Как понять, что агент реально прочитал ваш локальный AGENTS.md? Вот тут и нужны Context markers из прошлого поста. Без них вы не узнаете, считал ли агент инструкции.
Не нужно плодить сущности. AGENTS.md, разложенный по нужным папкам — это база для разработки с агентами. 👾
Кстати знали, что, формат AGENTS.md описан на одноименном сайте?