# AGENTS.md: какие правила записать агенту и чем правило отличается от скилла

AGENTS.md для Codex и других агентов: что записать в файл правил, чем правило отличается от скилла, как вести файлы по папкам и не раздуть их сверх лимита.

URL: https://posts.danashkin.ru/guides/agents-md-pravila-dlya-agenta
Обновлено: 2026-10-19

---

Агент забывает. AGENTS.md помнит.

## Коротко

**Главное**

- AGENTS.md - обычный текст с правилами проекта, который Codex и другие агенты читают в начале работы. Это открытый формат без обязательных полей.
- Правило - то, что агент должен соблюдать всегда. Скилл - пошаговая процедура, которую он достаёт по вызову. Знания о тебе самом живут во втором мозге.
- Лучшие строки памятки рождаются из правки, которую ты повторил в чате второй раз.
- Вложенные AGENTS.md по папкам держат корень коротким. Ближняя к работе памятка перекрывает общую.
- Claude Code тоже умеет читать AGENTS.md, так что одна памятка может служить обоим агентам.

## Что такое AGENTS.md и кто его читает?

**Главное**

AGENTS.md - памятка в формате Markdown, которую агент открывает до начала работы и держит в голове всю сессию. Codex собирает такие памятки цепочкой: сначала общую из своей домашней папки, затем от корня проекта до текущей папки. Формат открытый, его понимают Codex, Gemini CLI, Zed и другие агенты.

AGENTS.md создатели формата называют «README для агентов». README пишут для людей: что за проект и как начать. AGENTS.md пишут для агента: как здесь принято работать, что проверять, чего не делать. Обязательных полей нет, заголовки любые, это просто текст.

Codex читает их в определённом порядке. Сначала общую памятку в домашней папке Codex, где лежат твои сквозные привычки. Потом он идёт от корня проекта вниз до папки, в которой ты открыл чат, и в каждой папке берёт по одной. Чем ближе памятка к работе, тем позже она попадает в инструкции и тем сильнее её слово.

На практике это значит простую вещь. Ты один раз записал правило, и оно действует в каждом новом чате этой папки. Объяснять заново не нужно, напоминать тоже.

Разницу между чатом, режимом «Работа» и Codex я разбирал отдельно в материале [чат, «Работа» или Codex](/guides/chat-rabota-ili-codex). Здесь речь только о Codex и других агентах, которые работают с папкой на компьютере.

## Куда класть знание: правило, скилл или второй мозг?

**Главное**

Правило - короткая строка, которая действует всегда: формат сдачи, запрет, порядок проверки. Скилл - процедура из нескольких шагов, агент читает её целиком только когда она нужна. Второй мозг - знания о тебе: кто ты, как думаешь, что для тебя важно. Путаница между ними и раздувает AGENTS.md.

На обучении для отдела дизайна разговор зашёл о линиях на макете. Я сказал: «Это скорее не скилл, это правило». Его место - в AGENTS.md папки с листовками.

Накануне в той же группе тот же вопрос звучал с другой стороны. Агент нашёл ошибки на макетах, и встал вопрос, как закрепить такую проверку надолго.

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

| | Правило в AGENTS.md | Скилл | Второй мозг |
|---|---|---|---|
| Что хранит | Как работать в этой папке | Как пройти процедуру по шагам | Кто ты и как думаешь |
| Когда читается | В начале каждого чата | По вызову или когда агент решит, что он нужен | Когда задача касается тебя лично |
| Размер | Строка-две на правило | Страница и больше | Целая папка заметок |
| Пример | «Шрифты не переводить в кривые» | Проверка макета по чек-листу из 20 пунктов | Тон, ценности, принципы работы |
| Фраза агенту | «Запомни это как правило проекта» | «Сохрани этот путь как скилл» | Создаётся один раз, дальше дополняется |

Справка Codex описывает механику скиллов именно так: агент сначала видит только имя и описание каждого скилла, а полный текст открывает, когда выбрал его под задачу. Поэтому процедура на двадцать шагов в скилле почти ничего не стоит, пока не нужна. В AGENTS.md она съедает место в каждом чате.

[Второй мозг](/concepts/vtoroy-mozg) делается один раз. На второй день обучения я так и объяснил группе: это долгосрочная память агента, а под каждый проект можно завести свою структуру знаний поменьше. Когда задача повторяется и просится в скилл, критерий я разбирал в статье [задача повторилась третий раз](/guides/zadacha-povtorilas-tretiy-raz).

Готовые сценарии, которые OpenAI выложила для Codex (финансовый отчёт, презентация, письмо после встречи), я разбирал [в посте канала](https://t.me/ai_anashkin/890). Каждый из них - пример скилла: пошаговая процедура, которую одной строкой правила не заменишь.

## Когда правка становится правилом?

**Главное**

Когда ты поправил агента одним и тем же образом второй раз. Первая правка - случайность, вторая - закономерность, которую агент не запомнит сам. Сказанное в чате живёт до конца чата, записанное в AGENTS.md работает в каждом следующем. Записать правило проще всего руками самого агента.

На обучении я сказал группе фразу, которую повторяю почти всем: «Если ты ему в чате это даёшь, он конечно же это потом забудет, а если он это запишет в Markdown-формат, то он это будет всегда читать». Чат - краткосрочная память. Новый чат начинается с чистого листа, и всё, что ты объяснял вчера, для него не существовало.

Правки в работе с визуалом обычно выглядят так. Ты делаешь скриншот, кидаешь агенту в чат и просишь повернуть текст, который стоит под другим углом, чем изделие. Один раз это правка. Если через день ты пишешь то же самое про другой макет, пора превращать правку в правило.

1. **Заметь повтор**

   Ты второй раз пишешь агенту одно и то же замечание: про формат, про шрифты, про порядок файлов, про то, что спрашивать перед действием.

2. **Попроси агента записать правило**

   «Запиши в AGENTS.md этой папки правило: ... Сформулируй коротко, одной строкой, так, чтобы его можно было проверить».

3. **Прочитай, что он записал**

   Агент склонен расписать абзац. Попроси сжать до строки и убрать объяснения, которые не меняют поведение.

4. **Проверь новым чатом**

   Открой новый чат в той же папке и дай похожую задачу без напоминания. Правило сработало - оставляешь. Не сработало - переформулируй.

Тот же цикл «ошибка - новая строка» для Claude Code я описывал в материале [про память агента](/guides/chto-pisat-v-claude-md). Механика у Codex та же, меняются только имя памятки и агент, который её читает.

## Что записать в AGENTS.md, если ты не программист?

**Главное**

Карту папки и правила сдачи результата. Где лежат исходники, куда класть готовое, в каких форматах сдавать, что делать при противоречии в задании. Подробные гайдлайны - отдельным файлом, а в AGENTS.md одна строка со ссылкой на него.

Примеры AGENTS.md в интернете почти все про код: команды сборки, тесты, стиль. Человеку, который ведёт в папке макеты, отчёты или тексты, они не помогают. Его правила другие, и на обучении для дизайнеров я показывал, какие.

Первый шаг я давал группе одной фразой: «Создай в корне этой папки файл agents.md, короткая карта проекта», и дописать своими словами, какие правила важны именно здесь. Дальше памятка растёт из правок. Для папки с листовками она может выглядеть так:

```markdown
# Листовки к новинкам

Что здесь: макеты листовок по образцу и брифу.
Исходники - в brief/, готовые макеты - в out/.

## Правила
- Каждый макет сдавать в трёх видах: AI в слоях, векторный PDF и PNG.
- Шрифты не переводить в кривые.
- Перед любым макетом открыть guidelines.md: кегли, толщина линий, отступы.
- Бриф противоречит образцу - не выбирать самому, выписать противоречие и спросить.
```

Каждая строка здесь собрана из того, что происходило на занятии. Требование сдавать макеты в слоях дизайнеры дописывали в задания прямо на занятии, потому что плоская картинка им не годится. Строка про противоречия появилась после того, как агент сам нашёл в техническом задании противоречия и остановился с вопросом, а не выбрал сам.

Отдельный момент - гайдлайны. Толщину линий, шрифты и отступы лучше держать отдельным документом, а в AGENTS.md оставить ссылку: «при изготовлении листовок обязательно смотри туда». Тогда агент всегда читает их перед макетом, а сам AGENTS.md остаётся коротким.

## Вложенные AGENTS.md: своя памятка на каждую папку

**Главное**

Общие правила - в корневой памятке, правила конкретного проекта - в AGENTS.md его папки. Codex читает цепочку от корня до папки, где открыт чат, и ближняя памятка перекрывает дальнюю. Так у каждого проекта свои правила, а корень не раздувается.

Сайт формата приводит пример: в главном репозитории OpenAI на момент написания их страницы было 88 файлов AGENTS.md. Каждая часть проекта несёт свои правила. Агент читает ближайшую к работе памятку, и при конфликте побеждает именно она.

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

Как делить правила между уровнями, решается одним вопросом. Правило верно во всех твоих папках - оно в корне или в общем файле Codex в домашней папке. Верно только здесь - оно в AGENTS.md этой папки.

**Проверка, какие инструкции агент прочитал**

Спроси агента в новом чате: «перечисли инструкции, которые ты загрузил, в каком порядке». Так видно, дошла ли до него вложенная памятка. Для точной проверки справка Codex описывает другой способ: журнал загрузки, который включается параметром `-c log_dir`.

## Как не раздуть AGENTS.md?

**Главное**

У Codex есть жёсткий предел: по умолчанию из всей цепочки AGENTS.md он берёт не больше 32 КБ. Всё, что за пределом, до агента просто не доходит. Держи в памятке оглавление и правила, детали выноси в отдельные файлы и во вложенные AGENTS.md, процедуры - в скиллы.

На обучении я описывал AGENTS.md как оглавление книги. Это не огромный документ на тысячу строк со всем, что тебе нравится и не нравится. Это короткие пункты: что лежит в папке, для чего, где искать подробности.

Признаюсь честно: моя собственная корневая памятка этот принцип нарушила. Когда я сверял её со справкой Codex для этой статьи, оказалось, что она весит около 48 КБ при лимите по умолчанию в 32 КБ. Значит, хвост Codex не видит, пока я не подниму лимит в настройках или не разрежу её по папкам. Справка предлагает оба пути, я бы выбрал второй: короткий корень и подробности по папкам.

Что помогает держать AGENTS.md в форме:

- **Ссылка вместо содержания.** Гайдлайны, регламенты, справочники - отдельными документами, в AGENTS.md строка «перед X открой Y».
- **Процедуры - в скиллы.** Всё, что расписывается по шагам, живёт отдельным скиллом.
- **Знания о себе - во второй мозг.** Тон, ценности и привычки не относятся к правилам конкретной папки.
- **Чистка раз в месяц.** Устаревшие и противоречащие друг другу строки хуже, чем их отсутствие: агент не знает, какой из спорящих строк верить.

Последний пункт удобно делать руками агента. Когда в первый день у группы появились вопросы, зачем агент создал в папке второго мозга столько файлов, я сказал: «А вы не у меня спросите, а у агента спросите. Это он же делал, не я». С правилами так же: попроси его найти строки, которые повторяют друг друга или спорят между собой, и объяснить, зачем нужна каждая.

## AGENTS.md и CLAUDE.md в одной папке

**Главное**

Claude Code по умолчанию читает AGENTS.md, если в папке и выше нет его собственной памятки CLAUDE.md. Если она есть, AGENTS.md он пропускает. Чтобы держать один источник правил на двух агентов, в CLAUDE.md ставят строку импорта @AGENTS.md и ниже дописывают то, что нужно только Claude.

Многие работают с двумя агентами сразу: Codex в приложении ChatGPT и Claude Code. Документация Claude Code описывает три варианта.

| Что лежит в папке | Что прочитает Claude Code |
|---|---|
| Только AGENTS.md | AGENTS.md |
| AGENTS.md и CLAUDE.md без импорта | Только CLAUDE.md |
| CLAUDE.md со строкой `@AGENTS.md` | Оба: AGENTS.md подключается через импорт |

У меня в корне рабочей папки исторически лежат две памятки-близнеца, по одной на каждого агента. Это работает, но удваивает работу: каждое новое правило надо вносить дважды, и рано или поздно близнецы расходятся. Новичку я советую одну памятку с правилами и импорт.

Как устроена память Claude Code по уровням, я разбирал в материале [что писать в CLAUDE.md](/guides/chto-pisat-v-claude-md). Почему вообще всё решают документы в папке, а не формулировка запроса, - в разборе про [контекст-инжиниринг](/guides/kontekst-inzhiniring).

## Частые вопросы

**Главное**

Спрашивают, обязательно ли имя AGENTS.md, можно ли писать правила по-русски, кто должен составлять файл и что победит, если правило в файле расходится с просьбой в чате.

### Частые вопросы

**Обязательно ли называть файл именно AGENTS.md?**

Для Codex это имя по умолчанию. Другие имена он прочитает, только если добавить их в список запасных имён в настройках, так что CODEX.md сам по себе он пропустит. У Claude Code своё основное имя, а AGENTS.md он берёт, когда своего рядом нет.

**Можно ли писать AGENTS.md на русском?**

Да. Это обычный Markdown без обязательных полей и разделов, агент читает текст как есть. Мои памятки целиком на русском, технические термины и имена файлов оставляю как есть.

**Кто должен составлять памятку: я или агент?**

Удобнее вместе. Попроси агента создать AGENTS.md с картой папки, а правила диктуй сам, своими словами, по мере того как замечаешь повторяющиеся правки. Перед сохранением прочитай, что он записал.

**Что победит, если правило в файле расходится с просьбой в чате?**

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

## Главный вывод

**Главное**

AGENTS.md - место, куда оседают твои повторённые правки, а не описание проекта на десять страниц. Правило живёт в файле, процедура - в скилле, знания о тебе - во втором мозге. Короткий корень плюс свои памятки в папках надёжнее одного большого документа: большой упрётся в лимит Codex.

Начни с малого. Открой папку, в которой работаешь с агентом чаще всего, и вспомни замечание, которое ты писал ему больше одного раза. Попроси записать его одной строкой в AGENTS.md и проверь новым чатом.

Если хочешь, чтобы так работала вся команда, а не только ты, - это следующий шаг, его я разбирал в статье про [второй мозг команды](/guides/vtoroy-mozg-ne-odnogo-a-komandy).

Какое замечание ты пишешь своему агенту чаще всего: про формат результата или про то, чего ему нельзя делать?

### Источники

- [AGENTS.md - открытый формат файла инструкций для агентов](https://agents.md/)
- [Custom instructions with AGENTS.md - как Codex собирает файлы правил, ChatGPT Learn](https://learn.chatgpt.com/docs/agent-configuration/agents-md)
- [Build skills - скиллы в ChatGPT и Codex, ChatGPT Learn](https://learn.chatgpt.com/docs/build-skills)
- [How Claude remembers your project - CLAUDE.md и AGENTS.md в Claude Code, Claude Code Docs](https://code.claude.com/docs/en/memory)