No history yet

Иерархия файлов инструкций

Иерархия инструкций

В сложных проектах одного файла AGENTS.md часто недостаточно. Разные части кодовой базы, например, фронтенд и бэкенд, могут требовать совершенно разных инструкций. Для решения этой задачи Codex CLI использует каскадную архитектуру файлов AGENTS.md, позволяя задавать контекст на нескольких уровнях.

Эта система состоит из трех основных уровней:

  • Глобальный (~/.codex/AGENTS.md): Здесь хранятся ваши личные, универсальные предпочтения. Например, стиль комментирования, предпочитаемый язык для скриптов или формат именования переменных, который вы используете во всех своих проектах. Этот файл — ваша личная «шпаргалка» для ИИ-агентов.

  • Проектный (./AGENTS.md): Этот файл находится в корневой директории проекта и задает общие стандарты для всей команды. В нем описывается архитектура, правила работы с API, основной технологический стек и инструкции по запуску тестов. Это «конституция» вашего проекта.

  • Локальный (путь/к/папке/AGENTS.md): Файлы на этом уровне обеспечивают максимальную гранулярность. Они размещаются в поддиректориях и содержат инструкции, специфичные для конкретного модуля или сервиса. Например, в папке src/api/v2 можно указать детали работы с новой версией API, а в src/components/ui — правила для UI-компонентов. Это позволяет Оркестратору автоматически подбирать релевантный контекст в зависимости от того, над какой частью проекта он работает.

Приоритет и переопределение

Codex CLI автоматически обнаруживает и объединяет инструкции из всех AGENTS.md файлов, двигаясь от текущей рабочей директории вверх к корневой папке проекта, а затем к глобальному файлу. При этом инструкции из более глубоко вложенных файлов имеют наивысший приоритет. Если в двух файлах есть противоречащие указания, будет применено то, которое находится «ближе» к месту работы агента.

Представьте, что в глобальном файле указано использовать табы для отступов, а в проектном — пробелы. При работе внутри этого проекта агент будет использовать пробелы.

# Порядок слияния контекста для /home/user/project/frontend/components

1. /home/user/project/frontend/components/AGENTS.md  (наивысший приоритет)
2. /home/user/project/frontend/AGENTS.md
3. /home/user/project/AGENTS.md
4. /home/user/.codex/AGENTS.md                     (самый низкий приоритет)

Иногда требуется не дополнить, а полностью заменить контекст. Для этого существует файл AGENTS.override.md . Если Codex CLI находит этот файл в директории, он использует только его содержимое и немедленно прекращает поиск инструкций на более высоких уровнях. Это полезно для задач, требующих абсолютно чистого и сфокусированного контекста, например, при рефакторинге изолированного модуля или при работе с легаси-кодом, имеющим свои уникальные стандарты.

Такая иерархическая система позволяет создавать гибкие и мощные инструкции для ИИ-агентов. Она обеспечивает их релевантной информацией на каждом этапе работы, от общих стилистических предпочтений до специфических требований конкретного микросервиса, и все это — без необходимости ручного вмешательства.