раздел 04

Правила для агента

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

Файл называется AGENTS.md / CLAUDE.md - в Claude Code тот же файл называется CLAUDE.md, в других агентах в IDE - AGENTS.md. Что это за файл и как он устроен, разобрано в курсе AGENTS.md. Здесь - только тот блок, который отвечает за артефакты.

Что должно быть в правиле

Правило работает, если отвечает на пять вопросов. Расплывчатое «веди заметки» агент трактует как хочет, и в половине случаев - никак.

Когда. В какие моменты агент обязан писать файл: перед началом задачи, после этапа, перед закрытием чата. Чем конкретнее триггер, тем надёжнее срабатывает.

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

В каком формате. Markdown, заголовки, чекбоксы для плана, дата в формате YYYY-MM-DD. Если хотите единый вид резюме - дайте шаблон прямо в правиле.

Как называть. Фиксированные имена для служебных файлов (PLAN.md, NOTES.md, NEXT-SESSION.md), понятные имена для рабочих.

Чего не делать. Не плодить дубли (PLAN-v2.md, PLAN-final.md), не переписывать историю в журнале, не сваливать всё в один файл.

Готовый блок правил

Вставьте в AGENTS.md / CLAUDE.md проекта целиком и подстройте под себя.

## Артефакты
- Перед задачей длиннее одного шага пиши PLAN.md: цель, шаги с чекбоксами,
  что не делаем. После плана остановись и жди подтверждения.
- После каждого законченного этапа обновляй PLAN.md (галочки) и NOTES.md.
- NOTES.md - журнал проекта. Новые записи сверху, формат:
  ## YYYY-MM-DD / ### Добавлено | Изменено | Исправлено / пункты.
  Старые записи не редактировать и не удалять.
- Выбор из нескольких вариантов фиксируй в decisions.md:
  что решили, почему, что отвергли. Новая запись сверху.
- Перед завершением работы пиши NEXT-SESSION.md: где остановились,
  следующие шаги, что не трогать.
- Один файл - один вид артефакта. Не создавай PLAN-v2.md и подобные дубли,
  обновляй существующий файл.
- Артефакты - в Markdown, дата внутри файла, не в имени.

Это тринадцать строк. Они отнимают у агента немного контекста при каждом старте, но экономят гораздо больше на том, что он перестаёт читать переписку.

Как проверить, что правило работает

Правило написано - это ещё ничего не значит. Агент может его не заметить, понять по-своему или проигнорировать под давлением длинной задачи. Проверка занимает десять минут.

Дайте агенту небольшую задачу на три-четыре шага в новом чате. Например: «собери список из пяти статей по теме X с короткими аннотациями». Ничего про файлы не говорите.

Смотрите, что произошло. Появился PLAN.md до начала поиска? Агент остановился и дождался подтверждения? После работы есть запись в NOTES.md с сегодняшней датой? Есть NEXT-SESSION.md или он решил, что задача закрыта и файл не нужен?

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

Агент пишет план, но не останавливается и сразу делает

Замените «остановись» на «после плана напиши: жду подтверждения - и не выполняй шаги, пока я не отвечу». Явный текст стоп-сообщения работает надёжнее, чем глагол.

Агент создаёт NOTES.md заново вместо обновления

Добавьте: «если NOTES.md уже есть, добавь запись в начало, файл не пересоздавай». Агенты иногда не проверяют существование файла, если их не попросить.

Записи в журнале слишком длинные

Ограничьте: «3-7 строк на запись, без пересказа процесса». Иначе агент складывает в журнал ту же переписку, от которой вы уходили.

Правило работает в одном проекте, в другом нет

Проверьте, что AGENTS.md / CLAUDE.md лежит в корне того проекта, где вы работаете. Правила из соседней папки агент не видит.

Память агента - тоже артефакт, но особый

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

Разница в том, кто им управляет и что там лежит. Память агент ведёт сам, и туда попадают долгие вещи: предпочтения, договорённости, факты о вас. Артефакты проекта - PLAN.md, decisions.md - ведутся по вашим правилам и относятся к конкретной работе. Не стоит складывать план задачи в память агента и наоборот, хранить «Павел любит короткие ответы» в NOTES.md проекта.