раздел 06

Шпаргалка

Всё главное коротко.

Что
Артефакт - файл с зафиксированным результатом шага: резюме, план, решение, журнал, чек-лист, реестр.
Зачем
Агент читает страницу вместо тома переписки, работу можно передать чату, субагенту, человеку, результат можно проверить глазами.
Как
План перед задачей, файл после каждого этапа, резюме перед закрытием чата. Правило в AGENTS.md / CLAUDE.md, чтобы агент делал сам.

Вид артефакта - когда - имя файла

ВидКогда заводитьИмя файла
Резюме встречиСразу после звонка или встречи2026-09-15-call-romashka.md
План работПеред задачей длиннее часаPLAN.md
Файл решенияВыбрали один вариант из несколькихdecisions.md
Журнал измененийС первого значимого изменения, новые записи сверхуNOTES.md
Чек-листОдну проверку делаете второй разchecklist-kp.md
РеестрСущностей больше пяти и они нужны не разcontacts.md, links.md
Что дальшеПеред закрытием чата, если работа не законченаNEXT-SESSION.md
Резюме чатаПеред закрытием чатаSUMMARY.md

Дата - внутри файла в формате YYYY-MM-DD. В имени - только у резюме встреч и других файлов, которых много и они не заменяют друг друга.

Чек-лист перед закрытием чата

  • SUMMARY.md или NEXT-SESSION.md написан: контекст, решения, открытые вопросы, следующий шаг.
  • Все решения этого чата есть в decisions.md, с «почему» и «что отвергли».
  • В NOTES.md есть запись за сегодня.
  • В PLAN.md отмечено сделанное.
  • Файлы прочитаны глазами, ошибки агента поправлены руками.
  • Нет дублей вроде PLAN-v2.md и SUMMARY-final.md.

Пять промптов-заготовок

Перед началом запиши план в PLAN.md и остановись - я проверю.

После каждого этапа обновляй STATUS.md: сделано / осталось / вопросы ко мне.

Сделай резюме этого чата в SUMMARY.md для следующего чата:
контекст, решения, открытые вопросы, что делать дальше.

Прочитай SUMMARY.md и NOTES.md, продолжай с пункта 2 из «что делать дальше».
Перед изменениями скажи, как понял задачу.

Запиши в decisions.md, что мы сейчас решили: что выбрали, почему,
какие варианты отвергли. Новая запись сверху.

Глоссарий

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

Куда дальше