раздел 01

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

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

Где он лежит

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

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

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

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

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

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

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

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

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