@rt-tools/agent-kit 0.10.0 → 0.12.0

package/assets/patterns/task-flow-archive.md

@@ -0,0 +1,193 @@
+---
+name: task-flow-archive
+kind: pattern
+rule: task-flow
+description: Паттерн правила task-flow. Брать, когда работа доведена до готовности: разбор папки задачи последним коммитом, переезд в описание прошлого, сверка очереди работ, разбор закрытой работы правилами и то, что делать с его находками. Не брать для вливания договорённости и приведения текстов — это паттерн task-flow-close.
+---
+
+# Разбор папки задачи и разбор работы правилами
+
+Паттерн правила `task-flow`. Что при этом должно быть верно — закон
+`docs/constitution/work-conduct.md`. Что делается до этого — снятие черновика, вливание
+договорённости и приведение текстов — паттерн `task-flow-close`.
+
+## Когда брать
+
+- Договорённость влита, тексты домена приведены, и папка задачи разбирается последним
+  коммитом ветки.
+- Работа слита человеком, и её разбирают правилами.
+- Разбор вернул находки, и их надо куда-то положить.
+
+## Состояние `разбор-кончился`: папка задачи разбирается
+
+Разбор идёт по трём исходам, а не по двум.
+
+**Первым отбирается действующее требование.** Всё, что останется верным и завтра, становится
+статьёй закона, пунктом правила или разделом паттерна — по тому, о чём оно говорит. Признак
+отбора один и записан здесь заранее: перестанет ли текст быть верным, если завтра всё
+переделать. Перестанет — это рассказ о состоявшемся; не перестанет — требование, и место ему в
+слое правил. Закон при этом в ветке не правится — его статья приносится владельцу текстом.
+
+**Вторым отбирается рассказ о состоявшемся переезде.** Он уезжает в описание прошлого и
+называет для каждого перенесённого решения, куда оно ушло: иначе решение, ставшее правилом, и
+решение, потерянное при переносе, выглядят одинаково — записью, на которую никто не ссылается.
+
+**Третьим удаляется остальное.**
+
+Порядок именно такой: начав с переезда, исполнитель увозит вместе с ним и действующее — под
+конец работы это дешевле, чем разбирать.
+
+Целиком в архив не переносится: `docs/archive/` — место для записей о состоявшемся, которые
+кто-то читает, а не свалка ходов работы. Таблица ниже говорит о том, что осталось после
+первого отбора.
+
+| Файл            | Куда                                                                                                               |
+| --------------- | ------------------------------------------------------------------------------------------------------------------ |
+| `grill.md`      | в `docs/archive/` — ответы владельца невосстановимы, и это единственная запись о том, почему задача поставлена так |
+| `progress.md`   | в `docs/archive/`, если в нём есть решения по ходу с причинами; иначе удаляется                                    |
+| `plan.md`       | удаляется — после выкатки на его вопрос отвечает код, а на «как работает» отвечает спек домена                     |
+| находки разбора | переезжают к замыслу эпика — их читает владелец, когда эпик кончится; работа вне эпика показывает их сразу         |
+
+Уезжающее складывается одним файлом с говорящим именем, а не папкой из трёх:
+
+```bash
+cat docs/tasks/<КЛЮЧ>-<номер>-<slug>/grill.md > docs/archive/<ЧТО_РЕШАЛИ>.md
+rm -r docs/tasks/<КЛЮЧ>-<номер>-<slug>
+```
+
+Разбор идёт в том же PR, что и работа: папка, оставленная до мержа, попадает в главную
+ветку и читается там как текущая.
+
+### Работа, разбирающая чужую папку, разбирает две
+
+Своя папка у такой работы есть — она заводится наравне со всеми, исключения из этого нет. Обе
+снимаются последним коммитом, и порядок между ними один: сперва чужая, потом своя. Начав со
+своей, исполнитель теряет замысел на диске, а он ещё нужен — гард отбивает правку без него, а
+правка по замечаниям разбора идёт в ту же ветку.
+
+```bash
+cat docs/tasks/<чужая>/grill.md > docs/archive/<ЧТО_РЕШАЛИ_ТАМ>.md
+rm -r docs/tasks/<чужая>
+cat docs/tasks/<своя>/grill.md > docs/archive/<ЧТО_РЕШАЛИ_ЗДЕСЬ>.md
+rm -r docs/tasks/<своя>
+```
+
+Две записи в архиве, а не одна: работы разные, и решения в них разные. Сверка очереди работ
+после этого не называет ни одной папки — этим и проверяется, что разобраны обе.
+
+**Следующее движение:** разобранная папка уезжает в ветку тем же коммитом, и следом за ним
+сверяется очередь работ.
+
+## Состояние `папка-разобрана`: сверка очереди работ
+
+```bash
+npm run check:board   # папка закрытой задачи среди текущих, брошенные черновики
+npm run check:specs   # договорённость влита, привязки на месте
+npm run check:docs    # пути, названные в текстах, существуют
+```
+
+**Следующее движение:** расхождения, названные сверками, чинятся тем же ходом; чинить нечего —
+тот же ход снимает черновик и просит владельца влить, называя номер.
+
+## Состояние `влито`: работа разбирается правилами — фоном, следом за PR
+
+Шаг о слое правил, а не о продукте: что за эту работу грузилось, что помогло, чего не хватило и
+где текст правила разошёлся с деревом. Знает это только тот заход, который работу вёл, — через
+сутки не знает никто.
+
+Ведёт разбор роль разбора закрытой задачи, если дерево её разложило; не разложившее ведёт его
+само, теми же вопросами. Файлов роль не правит — приносит готовые формулировки, а вставлять их
+решает владелец.
+
+**Запускается разбор в фоне, сразу за открытием PR, и ход на нём не кончается.** Роль ничего не
+спрашивает, пока работает, и быстрее от ожидания не идёт: следующая задача берётся тем же ходом,
+которым запущен разбор.
+
+Порядок один и переставлять его нельзя:
+
+1. **Сводка собирается до запуска** — пока задача ещё в голове. Что делали, что пошло не так,
+   что грузилось и что каждое правило дало, на какие грабли окружения наткнулись. Собранная
+   через две задачи, она пересказывает историю ветки вместо того, что было на самом деле.
+2. **Роль уходит в фон** — инструментом запуска роли, с путём к списку загруженного и сводкой
+   целиком. Ход продолжается следующей задачей.
+3. **Вернувшиеся находки принимают одним ходом** — записать и вернуться к прежнему. Разбор,
+   отложенный «до удобного момента», не случается вовсе: заход кончается раньше.
+
+**Следующее движение:** пока роль разбирает, тот же ход занят следующей задачей; вернувшиеся
+находки принимаются одним ходом — записать и продолжить прежнее.
+
+## Состояние `влито`: находки разбора ложатся в папку задачи и ждут владельца
+
+Ответ роли живёт в переписке и умирает вместе с ней, поэтому он сразу ложится на диск — в папку
+задачи, файлом рядом с ходом работы. Пишет его исполнитель: роль файлов не пишет.
+
+Папка задачи умирает со слиянием, а находки должны пережить весь эпик — владелец читает их
+разом, когда эпик кончился. Поэтому при разборе папки файл находок не удаляется вместе
+с остальным, а **переезжает к замыслу эпика**: там его найдут и после того, как ветка въехала.
+Работа вне эпика показывает находки владельцу сразу, тем же ходом.
+
+**Наружу без слова владельца уезжает только сводка наблюдений.** Она говорит, чем пользовались
+и чем не пользовались ни разу, — это факт, и мнением он не станет. Предложение — другое дело:
+это заготовка правки чужого дерева, и часть заготовок отпадает при первом же чтении. Уехавшая
+без разбора, она становится работой того, кто её не заказывал.
+
+Порядок такой: находки копятся у замысла эпика → эпик кончился → владелец читает их разом и
+говорит, что из них верно → названное им оформляется предложением и уезжает. Чем отправляют —
+скил слоя правил, если дерево его разложило.
+
+У каждой находки называется адрес, и адресов три:
+
+| Куда                       | Что туда идёт                                                            |
+| -------------------------- | ------------------------------------------------------------------------ |
+| слой правил — предложением | то, что верно любому дереву этого класса: статья, пункт правила, паттерн |
+| имена этого дерева         | то, что верно здесь: компаньон правила, профиль, карта гейта             |
+| надстройка над разложенным | то, что здесь звучит иначе, чем в пакете                                 |
+
+Без адреса правка ложится туда, где её видит автор, — то есть в своё дерево, — и общее оседает
+в одном месте, оставаясь неизвестным всем остальным.
+
+**Разбор без правки закрытым не считается.** Из него выходит либо правка слоя правил, либо
+предложение наружу; не вышло ни того ни другого — это жалоба, и она повторится. Предложение, о
+котором владелец сказал вслух, уходит наружу в тот же ход: написанное и не отправленное лежит в
+дереве неотличимо от отправленного.
+
+**Следующее движение:** записанные находки работу не держат — следующая задача уже идёт, а
+владельцу о них говорится, когда кончился эпик.
+
+## Ловушки
+
+- **Папку разбирают до слияния — потом о ней уже никто не вспомнит.** Сверка очереди считает
+  задачу закрытой по слиянию: до него папка среди текущих законна, а после за неё никто не
+  отвечает — работа перешла к следующей задаче, и находка достанется чужому заходу. Три раза
+  подряд папка закрытой задачи так и уехала в главную ветку, в последний раз их набралось
+  пять. Теперь это держит гард поставки: слияние отбивается, пока папка лежит в ветке.
+- **Разбирают последним коммитом, а не перед открытием PR.** Пока идёт ревью, замысел
+  нужен на диске: без него правку по замечаниям не пропустит гард хода работы. Порядок такой:
+  правки по ревью, потом разбор папки, потом слияние.
+- **Разбор папки идёт последним, после того как гейт пуша прошёл целиком.** Гард хода работы
+  не пускает правку кода приложения без замысла на диске, а после разбора замысла нет: чужое
+  замечание линтера, приехавшее мержем из главной ветки, чинить уже нечем, и гейт пуша стоит.
+  Порядок один: мерж главной ветки, все линтеры и проверки зелёные, вливание договорённости,
+  приведение текстов домена, разбор папки. Понадобилась правка кода после разбора — замысел
+  восстанавливается на диске на время правки, и разбор повторяется тем же коммитом.
+- **Если папку просто удалить, первым пропадёт `grill.md`.** Удалить проще, чем разобрать, а
+  слова владельца записаны только там, и восстановить их неоткуда. Поэтому гард требует, чтобы
+  ветка добавила запись в архив. Что именно перенесли, он не проверяет — это смотрит владелец
+  на ревью.
+- **Шаги закрытия с владельцем не согласуются — они перечислены здесь.** Разбор работы
+  правилами входит в закрытие так же, как вливание договорённости и разбор папки; владелец
+  решает не то, запускать ли его, а что делать с находками. Ход, кончившийся таким вопросом,
+  отбивает гард разговора: за ход правила не читались, а ответ стоит в них. Спрашивается только
+  то, чего в правилах нет.
+- **Блок готового кода в паттерне стареет от чужой правки.** Он не привязан ни к чему: сверка
+  спеков читает утверждения правила, а пример под ними не читает вовсе. Два поля, ставших
+  обязательными в чужой работе, сделали пример в соседнем паттерне несобираемым — сам он при
+  этом не изменился ни на знак и в след задачи не попал, потому что ни одного слова той работы
+  в нём нет. Паттерн находится по имени правленого символа, а не по теме работы.
+- **Замысел эпика правят только там, где вписывают «чем кончился».** Границы эпика и
+  порядок задач в нём при этом остаются прежними, а работа их уже нарушила: задача, решившая
+  читать спеки, оставила над собой границу «спеки — вторая очередь», и следующий исполнитель
+  прочитает её как действующую. Границы эпика перечитываются целиком тем же заходом, что и
+  итог работы.
+- **Архив не обновляется после выкатки.** Уехавшее туда описывает день переезда, и правится
+  оно только вместе с признанием, что описывало неверно.

package/assets/patterns/task-flow-close.md

@@ -2,7 +2,7 @@
 name: task-flow-close
 kind: pattern
 rule: task-flow
-description: Паттерн правила task-flow. Брать при закрытии работы — вливание договорённости в спек домена последним коммитом PR, разбор папки задачи, переезд в архив, сверка очереди работ. Не брать для хода работы — это паттерн task-flow-resume.
+description: Паттерн правила task-flow. Брать при доведении работы до готовности — снятие черновика, вливание договорённости в спек домена последним коммитом PR, приведение текстов домена к сделанному. Не брать для разбора папки задачи и разбора работы правилами — это паттерн task-flow-archive; не брать для хода работы — это паттерн task-flow-resume.
 ---
 
 # Закрытие работы
@@ -14,6 +14,7 @@ description: Паттерн правила task-flow. Брать при закр
 
 - Этапы замысла закрыты, проверки зелёные, с PR снимается черновик.
 - `npm run check:specs` перечислил договорённость в разделе «Пора вливать».
+- Тексты домена приводятся к тому, что работа сделала.
 
 Само открытие PR сюда не относится: он открывается черновиком тем ходом, которым правка
 кода отдаётся владельцу, — то есть до этого паттерна и, как правило, задолго до него. Здесь
@@ -102,6 +103,9 @@ PR #<номер> готов к слиянию: прогон зелёный, па
 кто пишет тело. Разница между ними одна, и она вся: реплику владелец прочитает, только если
 вернётся в переписку, а раздел он видит там, куда смотрит, нажимая кнопку.
 
+**Следующее движение:** тем же ходом берётся следующая задача эпика, а разбор закрытой работы
+уходит в фон. Прогон и владелец идут без исполнителя, и ждать их состоянием работы не бывает.
+
 ## Состояние `разбор-кончился`: договорённость вливается в спек домена
 
 Последним коммитом PR, до слияния. Код к этому моменту написан, поэтому привязки
@@ -131,6 +135,9 @@ npm run check:specs   # раздел «Пора вливать» называе
 npm run check:specs   # после вливания: привязки на месте, сценарии не потерялись
 ```
 
+**Следующее движение:** за влитой договорённостью тем же ходом идут тексты домена — правила,
+паттерны и разделы, которые работа задела.
+
 ## Состояние `разбор-кончился`: тексты домена приводятся к сделанному
 
 В спек уезжает только то, что записали до кода. Остальные тексты — правила, паттерны, законы
@@ -170,148 +177,13 @@ grep -rn -A3 "Чего из закона здесь нет" <каталог пр
 договорённость, только про это приложение.
 
 Что сделали на этом шаге, пишется в тело PR: что перечитали, что изменили, а если ничего
-не изменили — почему. Форма раздела — паттерн `git-workflow-commit`.
-
-## Состояние `разбор-кончился`: папка задачи разбирается
-
-Разбор идёт по трём исходам, а не по двум.
-
-**Первым отбирается действующее требование.** Всё, что останется верным и завтра, становится
-статьёй закона, пунктом правила или разделом паттерна — по тому, о чём оно говорит. Признак
-отбора один и записан здесь заранее: перестанет ли текст быть верным, если завтра всё
-переделать. Перестанет — это рассказ о состоявшемся; не перестанет — требование, и место ему в
-слое правил. Закон при этом в ветке не правится — его статья приносится владельцу текстом.
-
-**Вторым отбирается рассказ о состоявшемся переезде.** Он уезжает в описание прошлого и
-называет для каждого перенесённого решения, куда оно ушло: иначе решение, ставшее правилом, и
-решение, потерянное при переносе, выглядят одинаково — записью, на которую никто не ссылается.
-
-**Третьим удаляется остальное.**
-
-Порядок именно такой: начав с переезда, исполнитель увозит вместе с ним и действующее — под
-конец работы это дешевле, чем разбирать.
-
-Целиком в архив не переносится: `docs/archive/` — место для записей о состоявшемся, которые
-кто-то читает, а не свалка ходов работы. Таблица ниже говорит о том, что осталось после
-первого отбора.
-
-| Файл            | Куда                                                                                                               |
-| --------------- | ------------------------------------------------------------------------------------------------------------------ |
-| `grill.md`      | в `docs/archive/` — ответы владельца невосстановимы, и это единственная запись о том, почему задача поставлена так |
-| `progress.md`   | в `docs/archive/`, если в нём есть решения по ходу с причинами; иначе удаляется                                    |
-| `plan.md`       | удаляется — после выкатки на его вопрос отвечает код, а на «как работает» отвечает спек домена                     |
-| находки разбора | переезжают к замыслу эпика — их читает владелец, когда эпик кончится; работа вне эпика показывает их сразу         |
-
-Уезжающее складывается одним файлом с говорящим именем, а не папкой из трёх:
-
-```bash
-cat docs/tasks/<КЛЮЧ>-<номер>-<slug>/grill.md > docs/archive/<ЧТО_РЕШАЛИ>.md
-rm -r docs/tasks/<КЛЮЧ>-<номер>-<slug>
-```
-
-Разбор идёт в том же PR, что и работа: папка, оставленная до мержа, попадает в главную
-ветку и читается там как текущая.
-
-### Работа, разбирающая чужую папку, разбирает две
-
-Своя папка у такой работы есть — она заводится наравне со всеми, исключения из этого нет. Обе
-снимаются последним коммитом, и порядок между ними один: сперва чужая, потом своя. Начав со
-своей, исполнитель теряет замысел на диске, а он ещё нужен — гард отбивает правку без него, а
-правка по замечаниям разбора идёт в ту же ветку.
-
-```bash
-cat docs/tasks/<чужая>/grill.md > docs/archive/<ЧТО_РЕШАЛИ_ТАМ>.md
-rm -r docs/tasks/<чужая>
-cat docs/tasks/<своя>/grill.md > docs/archive/<ЧТО_РЕШАЛИ_ЗДЕСЬ>.md
-rm -r docs/tasks/<своя>
-```
-
-Две записи в архиве, а не одна: работы разные, и решения в них разные. Сверка очереди работ
-после этого не называет ни одной папки — этим и проверяется, что разобраны обе.
-
-## Состояние `папка-разобрана`: сверка очереди работ
-
-```bash
-npm run check:board   # папка закрытой задачи среди текущих, брошенные черновики
-npm run check:specs   # договорённость влита, привязки на месте
-npm run check:docs    # пути, названные в текстах, существуют
-```
-
-## Состояние `влито`: работа разбирается правилами — фоном, следом за PR
-
-Шаг о слое правил, а не о продукте: что за эту работу грузилось, что помогло, чего не хватило и
-где текст правила разошёлся с деревом. Знает это только тот заход, который работу вёл, — через
-сутки не знает никто.
-
-Ведёт разбор роль разбора закрытой задачи, если дерево её разложило; не разложившее ведёт его
-само, теми же вопросами. Файлов роль не правит — приносит готовые формулировки, а вставлять их
-решает владелец.
-
-**Запускается разбор в фоне, сразу за открытием PR, и ход на нём не кончается.** Роль ничего не
-спрашивает, пока работает, и быстрее от ожидания не идёт: следующая задача берётся тем же ходом,
-которым запущен разбор.
-
-Порядок один и переставлять его нельзя:
-
-1. **Сводка собирается до запуска** — пока задача ещё в голове. Что делали, что пошло не так,
-   что грузилось и что каждое правило дало, на какие грабли окружения наткнулись. Собранная
-   через две задачи, она пересказывает историю ветки вместо того, что было на самом деле.
-2. **Роль уходит в фон** — инструментом запуска роли, с путём к списку загруженного и сводкой
-   целиком. Ход продолжается следующей задачей.
-3. **Вернувшиеся находки принимают одним ходом** — записать и вернуться к прежнему. Разбор,
-   отложенный «до удобного момента», не случается вовсе: заход кончается раньше.
-
-## Состояние `влито`: находки разбора ложатся в папку задачи и ждут владельца
-
-Ответ роли живёт в переписке и умирает вместе с ней, поэтому он сразу ложится на диск — в папку
-задачи, файлом рядом с ходом работы. Пишет его исполнитель: роль файлов не пишет.
-
-Папка задачи умирает со слиянием, а находки должны пережить весь эпик — владелец читает их
-разом, когда эпик кончился. Поэтому при разборе папки файл находок не удаляется вместе
-с остальным, а **переезжает к замыслу эпика**: там его найдут и после того, как ветка въехала.
-Работа вне эпика показывает находки владельцу сразу, тем же ходом.
-
-**Наружу без слова владельца уезжает только сводка наблюдений.** Она говорит, чем пользовались
-и чем не пользовались ни разу, — это факт, и мнением он не станет. Предложение — другое дело:
-это заготовка правки чужого дерева, и часть заготовок отпадает при первом же чтении. Уехавшая
-без разбора, она становится работой того, кто её не заказывал.
-
-Порядок такой: находки копятся у замысла эпика → эпик кончился → владелец читает их разом и
-говорит, что из них верно → названное им оформляется предложением и уезжает. Чем отправляют —
-скил слоя правил, если дерево его разложило.
-
-У каждой находки называется адрес, и адресов три:
-
-| Куда                       | Что туда идёт                                                            |
-| -------------------------- | ------------------------------------------------------------------------ |
-| слой правил — предложением | то, что верно любому дереву этого класса: статья, пункт правила, паттерн |
-| имена этого дерева         | то, что верно здесь: компаньон правила, профиль, карта гейта             |
-| надстройка над разложенным | то, что здесь звучит иначе, чем в пакете                                 |
-
-Без адреса правка ложится туда, где её видит автор, — то есть в своё дерево, — и общее оседает
-в одном месте, оставаясь неизвестным всем остальным.
+не изменили — почему. Форма раздела — паттерн `git-workflow-pr`.
 
-**Разбор без правки закрытым не считается.** Из него выходит либо правка слоя правил, либо
-предложение наружу; не вышло ни того ни другого — это жалоба, и она повторится. Предложение, о
-котором владелец сказал вслух, уходит наружу в тот же ход: написанное и не отправленное лежит в
-дереве неотличимо от отправленного.
+**Следующее движение:** приведённые тексты коммитятся, и тем же ходом разбирается папка
+задачи — последним коммитом ветки.
 
 ## Ловушки
 
-- **Папку разбирают до слияния — потом о ней уже никто не вспомнит.** Сверка очереди считает
-  задачу закрытой по слиянию: до него папка среди текущих законна, а после за неё никто не
-  отвечает — работа перешла к следующей задаче, и находка достанется чужому заходу. Три раза
-  подряд папка закрытой задачи так и уехала в главную ветку, в последний раз их набралось
-  пять. Теперь это держит гард поставки: слияние отбивается, пока папка лежит в ветке.
-- **Разбирают последним коммитом, а не перед открытием PR.** Пока идёт ревью, замысел
-  нужен на диске: без него правку по замечаниям не пропустит гард хода работы. Порядок такой:
-  правки по ревью, потом разбор папки, потом слияние.
-- **Разбор папки идёт последним, после того как гейт пуша прошёл целиком.** Гард хода работы
-  не пускает правку кода приложения без замысла на диске, а после разбора замысла нет: чужое
-  замечание линтера, приехавшее мержем из главной ветки, чинить уже нечем, и гейт пуша стоит.
-  Порядок один: мерж главной ветки, все линтеры и проверки зелёные, вливание договорённости,
-  приведение текстов домена, разбор папки. Понадобилась правка кода после разбора — замысел
-  восстанавливается на диске на время правки, и разбор повторяется тем же коммитом.
 - **Тексты правятся до разбора папки.** Список того, что перечитывать, лежит в замысле, а
   разбор папки его удаляет. После разбора остаётся только память о том, что задевали.
 - **Утверждение правила снимается вместе со строкой привязки.** Связь идёт по тексту
@@ -322,10 +194,6 @@ npm run check:docs    # пути, названные в текстах, суще
   нет вовсе, и по слову из своей темы эта строка находилась — а неправда была в другом.
 - **Сказать «сверено», не открыв файл, нельзя.** Правило читается целиком. Устаревшее
   утверждение стоит в списке среди верных и ничем от них не отличается.
-- **Если папку просто удалить, первым пропадёт `grill.md`.** Удалить проще, чем разобрать, а
-  слова владельца записаны только там, и восстановить их неоткуда. Поэтому гард требует, чтобы
-  ветка добавила запись в архив. Что именно перенесли, он не проверяет — это смотрит владелец
-  на ревью.
 - **Вливание после мержа не делается.** В главной ветке тогда лежит раздел «предложено, но не
   выкачено» с тем, что работает месяц, — беззвучная ложь, тем убедительнее, чем старше.
 - **Номера сценариев при вливании не пересчитываются.** Идентификатор — ключ связи с тестами;
@@ -335,22 +203,5 @@ npm run check:docs    # пути, названные в текстах, суще
   стоявшее другими словами, а строка «этого раздела ещё нет» становится ложью ровно той
   работой, которая её вливает. Сверка спеков в этот раздел не смотрит вовсе. Снимается
   дословный повтор и то, что работа сделала входящим.
-- **Шаги закрытия с владельцем не согласуются — они перечислены здесь.** Разбор работы
-  правилами входит в закрытие так же, как вливание договорённости и разбор папки; владелец
-  решает не то, запускать ли его, а что делать с находками. Ход, кончившийся таким вопросом,
-  отбивает гард разговора: за ход правила не читались, а ответ стоит в них. Спрашивается только
-  то, чего в правилах нет.
-- **Блок готового кода в паттерне стареет от чужой правки.** Он не привязан ни к чему: сверка
-  спеков читает утверждения правила, а пример под ними не читает вовсе. Два поля, ставших
-  обязательными в чужой работе, сделали пример в соседнем паттерне несобираемым — сам он при
-  этом не изменился ни на знак и в след задачи не попал, потому что ни одного слова той работы
-  в нём нет. Паттерн находится по имени правленого символа, а не по теме работы.
 - **Правило без привязки в спек домена не въезжает.** Кода, который его исполняет, нет —
   значит это намерение, и место ему в открытых вопросах домена, а не в правилах.
-- **Замысел эпика правят только там, где вписывают «чем кончился».** Границы эпика и
-  порядок задач в нём при этом остаются прежними, а работа их уже нарушила: задача, решившая
-  читать спеки, оставила над собой границу «спеки — вторая очередь», и следующий исполнитель
-  прочитает её как действующую. Границы эпика перечитываются целиком тем же заходом, что и
-  итог работы.
-- **Архив не обновляется после выкатки.** Уехавшее туда описывает день переезда, и правится
-  оно только вместе с признанием, что описывало неверно.

package/assets/patterns/task-flow-handoff.md

@@ -1,13 +1,13 @@
 ---
 name: task-flow-handoff
 kind: pattern
-rule: task-flow
-description: Паттерн правила task-flow. Брать, когда заход упирается в заполнение окна — выбор точки остановки, запись хода работы, форма передачи и что владелец с ней делает. Не брать для возвращения к работе новым заходом — это паттерн task-flow-resume.
+rule: turn-conduct
+description: Паттерн правила turn-conduct. Брать, когда заход упирается в заполнение окна — выбор точки остановки, запись хода работы, форма передачи и что владелец с ней делает. Не брать для возвращения к работе новым заходом — это паттерн task-flow-resume.
 ---
 
 # Закрытие захода по заполнению окна
 
-Паттерн правила `task-flow`. Что при этом должно быть верно — закон
+Паттерн правила `turn-conduct`. Что при этом должно быть верно — закон
 `docs/constitution/work-conduct.md`.
 
 ## Когда брать
@@ -55,7 +55,7 @@ description: Паттерн правила task-flow. Брать, когда з
 ### Коммит
 
 Проверенное коммитится сразу, а не копится до конца задачи. Работа кончена — открывается PR:
-паттерн `git-workflow-commit`.
+паттерн `git-workflow-pr`.
 
 ### Передача
 
@@ -66,6 +66,24 @@ mkdir -p <каталог передачи>
 # файл — <каталог передачи>/<ветка>.md
 ```
 
+**Черновик передачи пишет хук, а не рука.** Перед сжатием контекста он кладёт по тому же
+адресу то, что есть на диске: ветку, состояние работы, следующий шаг, незакоммиченное, коммиты
+сверх главной. Сжатие приходит и тогда, когда напомнить некому — ночью или посреди длинного
+хода, — и без хука заход в этот момент терял передачу целиком.
+
+**Читает передачу тоже хук, а не человек.** На запуске он кладёт её в контекст целиком — вместе
+с картой хода, — и вставлять её руками не приходится ни после сжатия, ни после обрыва, ни после
+очистки. Написанная и не прочитанная, передача равна ненаписанной: следующий заход о ней не
+знает и начинает с пустого места, то есть с того же, ради чего её и писали.
+
+Отсюда требование к тексту: передача пишется для машины, которая подаст её без разбора, и для
+захода, который прочтёт её первой строкой. Обращаться в ней к владельцу — «спроси у него, чем
+кончилась проба» — значит писать в пустоту: к моменту чтения владельца в разговоре ещё нет.
+
+Написанное хуком — нижняя граница, а не готовая передача. Исполнитель, закрывающий заход по
+правилу, пишет поверх: он знает то, чего на диске нет, — чем кончилась проба, почему выбран
+этот путь, что владелец сказал по дороге. Файл один, последняя запись побеждает.
+
 Внутри — готовый текст для вставки в новый заход, без обращения к владельцу за подробностями:
 
 ```markdown

package/assets/patterns/task-flow-resume.md

@@ -120,6 +120,9 @@ git log --oneline origin/main..HEAD
 - Доэтапное, не этой работы: сверка очереди перечисляет шесть закрытых задач вне борды.
 ```
 
+**Следующее движение:** отмеченный этап тем же ходом сменяется следующим. Этапы кончились —
+тот же ход гонит набор и открывает PR черновиком.
+
 ## Состояние `работа-отдана`: следующая задача берётся тем же движением
 
 Задача закрыта, PR открыт и ждёт владельца — заход на этом не кончается. Отданное на разбор
@@ -138,6 +141,9 @@ git log --oneline origin/main..HEAD
 `task-flow-handoff`. Эпик кончился — заход закрывается тем же порядком, и владельцу называется,
 что кончился именно эпик, а не одна его задача.
 
+**Следующее движение:** по следующей задаче делается действие — заведена задача, ветка или
+папка. Ход кончается после него, а не после слов о нём.
+
 ## Ловушки
 
 - **Заход, кончившийся ничем, тоже записывается.** Иначе следующий пойдёт той же дорогой:

package/assets/patterns/task-flow-start.md

@@ -40,6 +40,9 @@ Agent(subagent_type: "Explore", prompt: "<тема просьбы>: что по
 считается сделанным, разведка исполняется как настроение: прочитанный переданный текст сходит
 за неё, и по текущему дереву не запускается ни одной команды.
 
+**Следующее движение:** находки ложатся в разбор, и тем же ходом владельцу уходит первый из
+шести вопросов. Разведка кончилась — состояние осталось прежним, ход тоже.
+
 ### Состояние `просьба-не-разобрана`: разбор с владельцем
 
 Ведёт главный агент: субагент до владельца не достучится. Команда — `/grill-me`, один вопрос
@@ -89,6 +92,9 @@ mkdir -p docs/tasks/_draft-<slug>
 cp docs/tasks/_template/grill.md docs/tasks/_draft-<slug>/grill.md
 ```
 
+**Следующее движение:** ответ владельца дописывается в разбор, и следом уходит следующий
+вопрос. Ответы кончились — тем же ходом работа идёт в конвейер ролей.
+
 ### Состояние `разбор-закрыт`: конвейер после разбора
 
 Вопросов больше не будет — дальше роли:
@@ -107,6 +113,9 @@ Workflow(name: "plan", args: "docs/tasks/_draft-<slug>")
 «не входит». Находка критика, расходящаяся с ответом владельца, относится владельцу — она не
 исполняется молча и не считается закрытой правкой текста.
 
+**Следующее движение:** сверенная с разбором договорённость коммитится, и тем же ходом
+заводятся задача, ветка и папка — а вышла из разбора серия, сперва объявляется эпик.
+
 ### Состояние `договорённость-записана`: серия задач объявляется эпиком
 
 Разбор кончился одной задачей — шаг пропускается. Вышло несколько, и порядок между ними
@@ -134,6 +143,9 @@ Workflow(name: "plan", args: "docs/tasks/_draft-<slug>")
 Лежит замысел вне папки задачи: та умирает с мержем первой же задачи. Каталог для него называет
 компаньон правила — у пакета своего пути нет.
 
+**Следующее движение:** объявленный эпик коммитится, и тем же ходом берётся первая его
+задача — заведением задачи, ветки и папки.
+
 ### Состояние `договорённость-записана`: задача, ветка, папка
 
 ```bash
@@ -171,6 +183,9 @@ cp docs/tasks/_template/progress.md docs/tasks/<КЛЮЧ>-<номер>-<slug>/pr
 Пока не объявлено состояние, в котором код правится, гард отбивает правку и называет
 обязательное действие того состояния, которое стоит в строке.
 
+**Следующее движение:** объявив состояние, тот же ход берётся за замысел — начиная с его
+шапки. Заведённая папка ходом не кончается: в ней ещё нет ни одного написанного файла.
+
 ### Состояние `задача-взята`: шапка замысла
 
 Её читает гард:
@@ -189,6 +204,32 @@ cp docs/tasks/_template/progress.md docs/tasks/<КЛЮЧ>-<номер>-<slug>/pr
 
 Пустая причина не принимается.
 
+**Следующее движение:** под шапкой пишутся след задачи и этапы, замысел коммитится, и тем же
+ходом начинается первый этап.
+
+### Состояние `замысел-записан`: первый этап начинается тем же ходом
+
+Замысел закоммичен — работа переходит в первый этап сразу, не отдавая хода. Строка состояния
+перезаписывается на `этап-идёт`, и дальше работу ведёт паттерн возвращения.
+
+```markdown
+- **Состояние:** `этап-идёт`
+- **Этап:** 1 из 3 — <название первого этапа из замысла>
+```
+
+Ход на этой границе не кончается. Написанный замысел выглядит законченным куском: этапы
+разложены, файл закоммичен, отчитаться есть чем — и отчёт встаёт ровно на то место, которое
+должна была занять работа. Владелец читает такой отчёт как сделанное, а сделано ничего. Так
+и вышло 21 августа: заход кончился строкой «следующий шаг — такой-то» при заполнении окна около
+двух процентов.
+
+Кончают ход четыре вещи, и они те же, что у остальных состояний: предел заполнения окна, отказ
+гарда, вопрос владельцу и отданная работа, по которой начата следующая. Дочитанный до конца
+паттерн к ним не относится — текст кончился, работа нет.
+
+**Следующее движение:** первый этап делается тем же ходом, а закрытым он объявляется после
+того, как прошла его команда из строки «Чем проверяется».
+
 ## Ловушки
 
 - **Номер не бывает первым.** До конца разбора неизвестно даже, сколько задач из него выйдет: