раздел 01

Как агент это читает

Файл инструкций - это не магия. Агент просто находит его по имени и подставляет содержимое в начало работы. Имя у каждого инструмента своё: Claude Code ищет CLAUDE.md, Codex и Cursor - AGENTS.md (подробно - в разделе 03). Важно понимать три вещи: где он лежит, как разные файлы складываются между собой и когда они читаются.

Где он лежит

1
Корень репозитория
Самое частое место. AGENTS.md (Codex, Cursor) и CLAUDE.md (Claude Code) в корне проекта - правила для всего репозитория.
2
Вложенные папки
Можно положить файл в подпапку (например, в frontend/ или packages/api/). Правила оттуда действуют для этой части проекта и уточняют общие.
3
Глобальный в домашней директории
Личные правила для всех проектов: ~/.claude/CLAUDE.md в Claude Code, ~/.codex/AGENTS.md в Codex, ~/.gemini/GEMINI.md в Gemini CLI. В Cursor это настройка Settings -> Rules -> User Rules.

Иерархия и перекрытие

Файлы складываются от общего к частному. Чем ближе файл к конкретному коду, тем он важнее: более конкретные правила перекрывают общие.

1
Глобальный
Домашняя директория. Ваши личные привычки для всех проектов: язык общения, общий стиль.
2
Корень репо
Правила конкретного проекта: стек, команды, архитектура. Перекрывают глобальные.
3
Вложенная папка
Уточнения для части проекта. Самые конкретные - перекрывают всё остальное.

Например, в глобальном файле вы написали стиль кода в целом, в корне репо - команды сборки именно этого проекта, а в папке frontend/ - что там используется свой линтер. Агент учтёт всё, и при конфликте победит более конкретное правило.

Когда читается

Агент подхватывает файл в начале сессии, до того как берётся за задачу. Дальше он держит правила в контексте всю работу - это часть того, что у него «в памяти» по ходу диалога.

Это занимает место в контексте

Содержимое файла попадает в контекстное окно агента и расходует его так же, как любой другой текст. Если написать туда полотно на сто строк, оно будет постоянно отъедать контекст и место для самой задачи. Поэтому файл держат коротким и по делу - как именно устроено контекстное окно, разбирается в гайде контекстное окно.