раздел 03

Как агент переиспользует

Правильная папка сама по себе ничего не даёт. Шаблон в _templates/kp.md останется невостребованным, если агенту никто не сказал туда смотреть. Переиспользование держится на трёх механизмах: ссылки в файле правил, скиллы для процессов и README в папках.

Механизм 1: ссылки из AGENTS.md / CLAUDE.md

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

## Шаблоны и методологии

- Шаблон КП - `_templates/kp.md`. Любое КП начинать с него, структуру не менять.
- Шаблон счёта - `_templates/invoice.md`, акта - `_templates/act.md`.
- Стиль текстов - `_methods/style.md`. Читать перед любым текстом для людей:
  пост, письмо, лендинг, слайды.
- Как считать цену - `_methods/pricing.md`. Не придумывать цены без него.
- Реквизиты клиента - только из `clients/<имя>/requisites.md`, не из памяти
  и не из старых документов.

Формула каждой строки: что это, где лежит, когда открывать. Без третьей части агент не знает, что строка про КП относится к задаче «сделай предложение для компании».

Проверка работает так: после того как вписали строку, попросите агента сделать соответствующий документ и посмотрите в его ход работы. Он должен открыть шаблон первым действием.

Механизм 2: скиллы для процессов

Шаблон - это структура документа. Но у многих задач есть ещё и процесс: откуда взять данные, что проверить, куда положить результат, кому отправить. Когда процесс повторяется, он превращается в скилл - папку с описанием, которую агент подключает сам, когда задача подходит.

Признаки, что пора делать скилл:

  • Вы третий раз пишете в чате одну и ту же последовательность шагов.
  • Задача требует не один файл, а несколько: шаблон плюс реестр плюс проверка плюс отправка.
  • Шаги легко пропустить: «сверить юрлицо в реестре» или «проверить сумму прописью».
.claude/skills/make-invoice/
└── SKILL.md
    # Когда применять: просят выставить счёт, сделать счёт, переделать счёт
    # Шаги:
    # 1. Уточнить, какому юрлицу - открыть clients/<имя>/requisites.md
    # 2. Взять _templates/invoice.md, заполнить
    # 3. Сумму прописью - проверить
    # 4. PDF - положить в clients/<имя>/docs/ с датой в имени
    # 5. Добавить строку в clients/<имя>/INBOX-LOG.md

Скилл ссылается на шаблон и реестр по путям и не хранит их копии. Про устройство скиллов, описание триггера и отличия между инструментами - в курсе Skills.

Механизм 3: README в каждой папке

Файл правил говорит агенту, куда идти. README на месте говорит, что здесь и как этим пользоваться. Три пункта, не больше:

# _templates

Шаблоны документов. Заполненные документы сюда не класть - они живут у клиента.

| Файл | Для чего | Заметки |
|---|---|---|
| invoice.md | Счёт | Сумма прописью - через num2words |
| act.md | Акт выполненных работ | Дата = дата последнего модуля |
| kp.md | Коммерческое предложение | Цену считать по _methods/pricing.md |

Не трогать: структуру блоков в kp.md. Меняется только через обсуждение.

Формула README: что тут, как пользоваться, что не трогать. Агент открывает его, когда попадает в папку, и понимает контекст без вашего участия.

Промпты-заготовки

Два промпта, которые закрывают большую часть случаев. Первый - когда просите документ, второй - когда агент сделал что-то новое, что стоит сохранить.

Прежде чем делать документ, проверь, есть ли шаблон в _templates/.
Если есть - используй его и не меняй структуру. Если нет - скажи мне,
прежде чем придумывать свою.

Сделал новый шаблон - положи его в _templates/ и добавь строку в README
этой папки: файл, для чего, заметки. Потом добавь ссылку на шаблон в
корневой AGENTS.md / CLAUDE.md в раздел «Шаблоны и методологии».

Со временем оба промпта переезжают из чата в файл правил и становятся постоянными.

Пример: три счёта против одного генератора

Компания просит счёт. Без порядка это выглядит так.

Первый счёт агент делает с нуля: таблица, реквизиты из переписки, сумма. Второй счёт через неделю - другая таблица, реквизиты набраны заново с опечаткой в ИНН. Третий счёт - агент нашёл первый счёт в папке, взял его за основу, но забыл поменять название юрлица. Три документа, три разных вида, одна ошибка в реквизитах и одна подмена клиента.

С порядком: шаблон в _templates/invoice.md, реквизиты в clients/Acme/requisites.md, скилл make-invoice с пятью шагами. Три счёта выглядят одинаково, реквизиты взяты из одного места, каждый лежит в папке своего клиента с датой в имени.

Если агент делает похожие документы по-разному, это не проблема агента. Это отсутствие шаблона, на который он обязан ссылаться.

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

Тест занимает пять минут и повторяется после каждого изменения в правилах.

  1. Попросите агента сделать документ, для которого есть шаблон: «сделай акт для компании Acme за сентябрь».
  2. Смотрите не на результат, а на ход работы: какие файлы он открыл первыми.
  3. Ожидаемое: _templates/act.md, clients/Acme/requisites.md, README нужных папок.
  4. Если вместо этого агент открыл соседний акт другого клиента или ничего не открыл - ссылка в файле правил отсутствует, неточна или без условия «когда открывать».

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