раздел 03

Как завести у себя

Система артефактов не требует инструментов и настройки. Нужны привычка делать короткое ретро и место, куда складывать выводы. Ниже - пять шагов, которые превращают разовую работу с AI в накопительную.

1
Короткое ретро после задачи
Закончили задачу - спросите себя и агента: что сработало, что нет. Две минуты, пара строк. Не отчёт, а честный разбор.
2
Сразу в артефакт
Вывод из ретро тут же превращаете в правило, навык, запись в память или заметку. Пока свежо - иначе урок забудется.
3
Храните в git
Артефакты живут в репозитории под версионированием. Видно историю, можно откатить, они едут вместе с проектом.
4
Договоритесь с агентом
Правило: читать артефакты в начале работы и обновлять их по ходу. Без этой договорённости файлы просто лежат.
5
Автоматизируйте
Напоминание или хук после задачи, который подталкивает сделать ретро и зафиксировать урок. Чтобы цикл не зависел от памяти.

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

Ретро: что спросить

Ретро - это не церемония. Достаточно двух вопросов после задачи:

- Что сработало? (приём, формулировка, порядок действий - переиспользуем)
- Что пошло не так? (ошибка, недопонимание - фиксируем, чтобы не повторить)

Ответ на первый вопрос часто становится навыком или шаблоном. Ответ на второй - правилом или записью в память.

Почему git

Хранить артефакты в репозитории - не формальность. Версионирование даёт то, чего нет у заметок в голове или в разрозненных файлах.

История
Видно, когда и почему появилось правило. Можно понять контекст спустя месяцы.
Откат
Правило оказалось лишним или вредным - откатываете одним коммитом.
Едет с проектом
Артефакты в репозитории доступны всем, кто работает с кодом, и на любой машине.

Договорённость с агентом

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

Автоматизация

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