раздел 03

Цикл работы через артефакты

Цикл простой, и в нём пять шагов. Разница с обычной работой в чате - в том, что между шагами всегда файл, а не сообщение.

1
Задача
Вы формулируете, что нужно. Если задача пришла от клиента или коллеги - она тоже становится файлом, brief.md.
2
План-артефакт
Агент пишет PLAN.md и останавливается. Вы читаете, правите, говорите «поехали».
3
Работа
Агент делает по плану. После каждого этапа обновляет статус в файле, а не в чате.
4
Результат-артефакт
Готовое лежит в файле: research.md, draft.md, decisions.md. Плюс запись в NOTES.md.
5
Следующий шаг читает результат
Новый чат, субагент или человек открывает файлы и продолжает. Переписка ему не нужна.

Промпты на каждый переход

Эти четыре промпта закрывают весь цикл. Их можно копировать как есть.

Перед стартом задачи:

Перед началом запиши план в PLAN.md: цель, шаги с чекбоксами, что не делаем.
Остановись после этого - я проверю план, потом продолжим.

Во время работы:

После каждого этапа обновляй STATUS.md в формате:
сделано / осталось / вопросы ко мне.
В чат пиши только короткое «этап N готов, смотри STATUS.md».

Перед закрытием чата:

Сделай резюме этого чата в SUMMARY.md для следующего чата:
1. Контекст - что за задача и для кого.
2. Решения - что решили и почему.
3. Открытые вопросы.
4. Что делать дальше, по пунктам.
Без пересказа переписки, только суть.

Старт нового чата:

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

Остановка после плана - самый ценный момент цикла. Пять минут на чтение PLAN.md экономят час на переделку того, что агент понял по-своему.

Как часто фиксировать

Три момента, в которые файл обязателен.

После каждого законченного шага. Нашли конкурентов - строки в research.md. Выбрали формат - decisions.md. Не «в конце всё запишу»: в конце контекст уже переполнен и половина деталей потеряна.

Перед сменой темы. Работали над КП, вдруг понадобилось починить скрипт. Сначала STATUS.md по КП, потом скрипт. Иначе, вернувшись, вы обнаружите, что агент смешал две задачи.

Перед закрытием чата. Всегда SUMMARY.md или NEXT-SESSION.md. Даже если кажется, что всё помните. Через три дня не будете.

Ориентир по объёму: если чат перевалил за экранов двадцать, а файлов ещё нет - вы опоздали. Лучше фиксировать чаще и короче, чем реже и длиннее.

Кто пишет: вы или агент

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

Правка руками - нормальная часть цикла. Файл после вашей правки становится точнее, чем любое сообщение в чате.

Антипаттерн: один огромный файл на всё

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

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

Второй антипаттерн - переписывать историю. Журнал изменений и файл решений хранят прошлое. Если решение поменялось, добавьте новую запись «отменили, потому что», а не стирайте старую. Иначе через месяц никто не поймёт, почему в КП была другая цена.

Что дальше

Всё это можно каждый раз просить промптами. А можно один раз записать в правила агента, и он будет делать сам. Об этом следующая глава.