@rt-tools/agent-kit 0.8.1 → 0.8.3

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

@@ -2,7 +2,7 @@
 name: task-flow-close
 kind: pattern
 rule: task-flow
-description: Паттерн правила task-flow. Брать при закрытии работы — вливание договорённости в спек домена последним коммитом отчёта, разбор папки задачи, переезд в архив, сверка очереди работ. Не брать для хода работы — это паттерн task-flow-resume.
+description: Паттерн правила task-flow. Брать при закрытии работы — вливание договорённости в спек домена последним коммитом PR, разбор папки задачи, переезд в архив, сверка очереди работ. Не брать для хода работы — это паттерн task-flow-resume.
 ---
 
 # Закрытие работы
@@ -12,12 +12,93 @@ description: Паттерн правила task-flow. Брать при закр
 
 ## Когда брать
 
-- Этапы замысла закрыты, проверки зелёные, отчёт готовится к публикации.
+- Этапы замысла закрыты, проверки зелёные, с PR снимается черновик.
 - `npm run check:specs` перечислил договорённость в разделе «Пора вливать».
 
-## 9. Договорённость вливается в спек домена
+Само открытие PR сюда не относится: он открывается черновиком тем ходом, которым правка
+кода отдаётся владельцу, — то есть до этого паттерна и, как правило, задолго до него. Здесь
+работа доводится до готовности и черновик снимается.
 
-Последним коммитом отчёта, до слияния. Код к этому моменту написан, поэтому привязки
+## 10. Работа отдаётся на разбор
+
+PR открыт черновиком — и с этой минуты работа ждёт владельца, а не машину. Заход на этом не
+кончается: следующая задача эпика берётся тем же движением, паттерн `task-flow-resume`.
+
+**Заход, открывший PR, называет оставшийся шаг в двух местах — разделом в теле PR и словами
+владельцу:** после одобрения ветка получает ещё один коммит — разбор папки, — и только потом
+вливается. Порядок этот записан здесь, а читает его исполнитель; вливает же владелец, и
+молчание он читает как «работа кончена» — видит зелёный PR и мержит его тем же ходом. Промах
+случается ровно в шов между двумя ходами, и стоит он отдельной задачи: после слияния папку
+разбирать уже некому.
+
+### Два сообщения владельцу, и между ними — прогон
+
+Оба обязательны, и порядок между ними один. Ни одно не заменяется другим: первое говорит, что
+работа отдана и чего она ждёт, второе — что она готова.
+
+Сразу после открытия PR:
+
+```
+PR #<номер> открыт черновиком. Жду прогона: пока он идёт, о работе известно только то, что
+она запушена. Как закончится — разберу папку задачи последним коммитом, сниму черновик и
+попрошу тебя влить. Пока жду, беру задачу #<номер следующей>.
+```
+
+Прогон зелёный, папка разобрана и запушена, черновик снят:
+
+```
+PR #<номер> готов к слиянию: прогон зелёный, папка задачи разобрана, за работой убрано,
+черновик снят. Влей его, пожалуйста.
+```
+
+Черновик снимается перед вторым сообщением, а не после него: владелец, прочитав просьбу
+влить, идёт нажимать кнопку — у черновика она заблокирована, и ход возвращается к исполнителю
+ни за чем.
+
+Прогон красный — сообщение то же по форме, но говорит о красном и о том, что с ним делается;
+просьбы влить в нём нет. Просьба звучит один раз и только тогда, когда работа готова целиком:
+сказанная заранее, она перестаёт что-либо значить, и владелец возвращается к прежнему —
+вливать по зелёной странице.
+
+Между двумя сообщениями исполнитель не ждёт: работа отдана на разбор, и тем же движением
+берётся следующая задача. Возвращается он к PR тем ходом, которым читает конец прогона.
+
+### Оставшийся шаг стоит разделом в теле PR
+
+Сказанного вслух мало, и одним этим требование не держится. Реплика живёт до следующей реплики,
+а решение о слиянии принимается на странице PR — там переписки нет вовсе. Поэтому оставшийся
+шаг пишется дважды: разделом в теле PR и словами владельцу. Одно другого не заменяет — тело
+пишется один раз и лежит у самой кнопки, разговор идёт дальше и уносит сказанное с собой.
+
+Раздел стоит последним и говорит ровно одно — что случится с веткой после одобрения:
+
+```markdown
+## Оставшийся шаг
+
+После одобрения ветка получает ещё один коммит — разбор папки задачи, — и только потом
+вливается. До этого коммита вливать рано: папка уедет в главную ветку неразобранной.
+```
+
+Разобрана папка — раздел переписывается тем же вызовом, которым правится тело:
+
+```markdown
+## Оставшийся шаг
+
+Не осталось: папка задачи разобрана коммитом `<sha>`, черновик снят. Можно вливать.
+```
+
+Пустым раздел не оставляется и не удаляется вовсе: отсутствие раздела и «шагов не осталось»
+читаются одинаково, а значат разное. Образец тела PR целиком — в паттерне заведения коммита
+и PR, если дерево его разложило.
+
+Проверить это машиной нечем, и проверки не будет: тело PR не читает ни одна сверка, а хостинг
+не спрашивает ни о чём, кроме заголовка. Требование держится тем же, чем и слова вслух, — тем,
+кто пишет тело. Разница между ними одна, и она вся: реплику владелец прочитает, только если
+вернётся в переписку, а раздел он видит там, куда смотрит, нажимая кнопку.
+
+## 12. Договорённость вливается в спек домена
+
+Последним коммитом PR, до слияния. Код к этому моменту написан, поэтому привязки
 `файл:символ` известны — правило въезжает в спек домена сразу проверяемым.
 
 ```bash
@@ -38,13 +119,13 @@ npm run check:specs   # раздел «Пора вливать» называе
   таблице `docs/specs/README.md`.
 
 Работа шла несколькими задачами — вливание идёт в последней из них. Какая последняя, видно в
-`docs/plans/<линия>.md`; закрытая линия уезжает в `docs/archive/` или удаляется.
+замысле эпика; закрытый эпик уезжает в описание прошлого или удаляется.
 
 ```bash
 npm run check:specs   # после вливания: привязки на месте, сценарии не потерялись
 ```
 
-## 10. Тексты домена приводятся к сделанному
+## 13. Тексты домена приводятся к сделанному
 
 В спек уезжает только то, что записали до кода. Остальные тексты — правила, паттерны, законы
 приложения — после правки никто не перечитывает, и они продолжают описывать старое дерево.
@@ -78,23 +159,42 @@ grep -rn -A3 "Чего из закона здесь нет" <каталог пр
 ```
 
 **Закон в ветке не правится.** Статья закона — договорённость с владельцем, и меняет её он.
-Работа с ней разошлась — пишется готовый текст статьи: в ход работы и в тело отчёта. Файл
+Работа с ней разошлась — пишется готовый текст статьи: в ход работы и в тело PR. Файл
 закона правится после ответа. С законами приложения так же: деньги, локали и доступ — та же
 договорённость, только про это приложение.
 
-Что сделали на этом шаге, пишется в тело отчёта: что перечитали, что изменили, а если ничего
+Что сделали на этом шаге, пишется в тело PR: что перечитали, что изменили, а если ничего
 не изменили — почему. Форма раздела — паттерн `git-workflow-commit`.
 
-## 11. Папка задачи разбирается
+## 14. Папка задачи разбирается
+
+Разбор идёт по трём исходам, а не по двум.
+
+**Первым отбирается действующее требование.** Всё, что останется верным и завтра, становится
+статьёй закона, пунктом правила или разделом паттерна — по тому, о чём оно говорит. Признак
+отбора один и записан здесь заранее: перестанет ли текст быть верным, если завтра всё
+переделать. Перестанет — это рассказ о состоявшемся; не перестанет — требование, и место ему в
+слое правил. Закон при этом в ветке не правится — его статья приносится владельцу текстом.
+
+**Вторым отбирается рассказ о состоявшемся переезде.** Он уезжает в описание прошлого и
+называет для каждого перенесённого решения, куда оно ушло: иначе решение, ставшее правилом, и
+решение, потерянное при переносе, выглядят одинаково — записью, на которую никто не ссылается.
+
+**Третьим удаляется остальное.**
+
+Порядок именно такой: начав с переезда, исполнитель увозит вместе с ним и действующее — под
+конец работы это дешевле, чем разбирать.
 
 Целиком в архив не переносится: `docs/archive/` — место для записей о состоявшемся, которые
-кто-то читает, а не свалка ходов работы.
+кто-то читает, а не свалка ходов работы. Таблица ниже говорит о том, что осталось после
+первого отбора.
 
-| Файл          | Куда                                                                                                               |
-| ------------- | ------------------------------------------------------------------------------------------------------------------ |
-| `grill.md`    | в `docs/archive/` — ответы владельца невосстановимы, и это единственная запись о том, почему задача поставлена так |
-| `progress.md` | в `docs/archive/`, если в нём есть решения по ходу с причинами; иначе удаляется                                    |
-| `plan.md`     | удаляется — после выкатки на его вопрос отвечает код, а на «как работает» отвечает спек домена                     |
+| Файл            | Куда                                                                                                               |
+| --------------- | ------------------------------------------------------------------------------------------------------------------ |
+| `grill.md`      | в `docs/archive/` — ответы владельца невосстановимы, и это единственная запись о том, почему задача поставлена так |
+| `progress.md`   | в `docs/archive/`, если в нём есть решения по ходу с причинами; иначе удаляется                                    |
+| `plan.md`       | удаляется — после выкатки на его вопрос отвечает код, а на «как работает» отвечает спек домена                     |
+| находки разбора | переезжают к замыслу эпика — их читает владелец, когда эпик кончится; работа вне эпика показывает их сразу         |
 
 Уезжающее складывается одним файлом с говорящим именем, а не папкой из трёх:
 
@@ -103,10 +203,27 @@ cat docs/tasks/<КЛЮЧ>-<номер>-<slug>/grill.md > docs/archive/<ЧТО_Р
 rm -r docs/tasks/<КЛЮЧ>-<номер>-<slug>
 ```
 
-Разбор идёт в том же отчёте, что и работа: папка, оставленная до мержа, попадает в главную
+Разбор идёт в том же PR, что и работа: папка, оставленная до мержа, попадает в главную
 ветку и читается там как текущая.
 
-## 12. Сверка
+### Работа, разбирающая чужую папку, разбирает две
+
+Своя папка у такой работы есть — она заводится наравне со всеми, исключения из этого нет. Обе
+снимаются последним коммитом, и порядок между ними один: сперва чужая, потом своя. Начав со
+своей, исполнитель теряет замысел на диске, а он ещё нужен — гард отбивает правку без него, а
+правка по замечаниям разбора идёт в ту же ветку.
+
+```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/<своя>
+```
+
+Две записи в архиве, а не одна: работы разные, и решения в них разные. Сверка очереди работ
+после этого не называет ни одной папки — этим и проверяется, что разобраны обе.
+
+## 15. Сверка
 
 ```bash
 npm run check:board   # папка закрытой задачи среди текущих, брошенные черновики
@@ -114,6 +231,65 @@ npm run check:specs   # договорённость влита, привязк
 npm run check:docs    # пути, названные в текстах, существуют
 ```
 
+## 16. Работа разбирается правилами — фоном, следом за PR
+
+Шаг о слое правил, а не о продукте: что за эту работу грузилось, что помогло, чего не хватило и
+где текст правила разошёлся с деревом. Знает это только тот заход, который работу вёл, — через
+сутки не знает никто.
+
+Ведёт разбор роль разбора закрытой задачи, если дерево её разложило; не разложившее ведёт его
+само, теми же вопросами. Файлов роль не правит — приносит готовые формулировки, а вставлять их
+решает владелец.
+
+**Запускается разбор в фоне, сразу за открытием PR, и ход на нём не кончается.** Роль ничего не
+спрашивает, пока работает, и быстрее от ожидания не идёт: следующая задача берётся тем же ходом,
+которым запущен разбор.
+
+Порядок один и переставлять его нельзя:
+
+1. **Сводка собирается до запуска** — пока задача ещё в голове. Что делали, что пошло не так,
+   что грузилось и что каждое правило дало, на какие грабли окружения наткнулись. Собранная
+   через две задачи, она пересказывает историю ветки вместо того, что было на самом деле.
+2. **Роль уходит в фон** — инструментом запуска роли, с путём к списку загруженного и сводкой
+   целиком. Ход продолжается следующей задачей.
+3. **Вернувшиеся находки принимают одним ходом** — записать и вернуться к прежнему. Разбор,
+   отложенный «до удобного момента», не случается вовсе: заход кончается раньше.
+
+## 17. Находки разбора ложатся в папку задачи и ждут владельца
+
+Ответ роли живёт в переписке и умирает вместе с ней, поэтому он сразу ложится на диск — в папку
+задачи, файлом рядом с ходом работы. Пишет его исполнитель: роль файлов не пишет.
+
+Папка задачи умирает со слиянием, а находки должны пережить весь эпик — владелец читает их
+разом, когда эпик кончился. Поэтому при разборе папки (шаг 14) файл находок не удаляется вместе
+с остальным, а **переезжает к замыслу эпика**: там его найдут и после того, как ветка въехала.
+Работа вне эпика показывает находки владельцу сразу, тем же ходом.
+
+**Наружу без слова владельца уезжает только сводка наблюдений.** Она говорит, чем пользовались
+и чем не пользовались ни разу, — это факт, и мнением он не станет. Предложение — другое дело:
+это заготовка правки чужого дерева, и часть заготовок отпадает при первом же чтении. Уехавшая
+без разбора, она становится работой того, кто её не заказывал.
+
+Порядок такой: находки копятся у замысла эпика → эпик кончился → владелец читает их разом и
+говорит, что из них верно → названное им оформляется предложением и уезжает. Чем отправляют —
+скил слоя правил, если дерево его разложило.
+
+У каждой находки называется адрес, и адресов три:
+
+| Куда                       | Что туда идёт                                                            |
+| -------------------------- | ------------------------------------------------------------------------ |
+| слой правил — предложением | то, что верно любому дереву этого класса: статья, пункт правила, паттерн |
+| имена этого дерева         | то, что верно здесь: компаньон правила, профиль, карта гейта             |
+| надстройка над разложенным | то, что здесь звучит иначе, чем в пакете                                 |
+
+Без адреса правка ложится туда, где её видит автор, — то есть в своё дерево, — и общее оседает
+в одном месте, оставаясь неизвестным всем остальным.
+
+**Разбор без правки закрытым не считается.** Из него выходит либо правка слоя правил, либо
+предложение наружу; не вышло ни того ни другого — это жалоба, и она повторится. Предложение, о
+котором владелец сказал вслух, уходит наружу в тот же ход: написанное и не отправленное лежит в
+дереве неотличимо от отправленного.
+
 ## Ловушки
 
 - **Папку разбирают до слияния — потом о ней уже никто не вспомнит.** Сверка очереди считает
@@ -121,7 +297,7 @@ npm run check:docs    # пути, названные в текстах, суще
   отвечает — работа перешла к следующей задаче, и находка достанется чужому заходу. Три раза
   подряд папка закрытой задачи так и уехала в главную ветку, в последний раз их набралось
   пять. Теперь это держит гард поставки: слияние отбивается, пока папка лежит в ветке.
-- **Разбирают последним коммитом, а не перед открытием отчёта.** Пока идёт ревью, замысел
+- **Разбирают последним коммитом, а не перед открытием PR.** Пока идёт ревью, замысел
   нужен на диске: без него правку по замечаниям не пропустит гард хода работы. Порядок такой:
   правки по ревью, потом разбор папки, потом слияние.
 - **Разбор папки идёт последним, после того как гейт пуша прошёл целиком.** Гард хода работы
@@ -165,10 +341,10 @@ npm run check:docs    # пути, названные в текстах, суще
   в нём нет. Паттерн находится по имени правленого символа, а не по теме работы.
 - **Правило без привязки в спек домена не въезжает.** Кода, который его исполняет, нет —
   значит это намерение, и место ему в открытых вопросах домена, а не в правилах.
-- **Замысел линии работ правят только там, где вписывают «чем кончилась».** Границы линии и
-  порядок задач в ней при этом остаются прежними, а работа их уже нарушила: задача, решившая
+- **Замысел эпика правят только там, где вписывают «чем кончился».** Границы эпика и
+  порядок задач в нём при этом остаются прежними, а работа их уже нарушила: задача, решившая
   читать спеки, оставила над собой границу «спеки — вторая очередь», и следующий исполнитель
-  прочитает её как действующую. Границы линии перечитываются целиком тем же заходом, что и
+  прочитает её как действующую. Границы эпика перечитываются целиком тем же заходом, что и
   итог работы.
 - **Архив не обновляется после выкатки.** Уехавшее туда описывает день переезда, и правится
   оно только вместе с признанием, что описывало неверно.

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

@@ -26,7 +26,7 @@ description: Паттерн правила task-flow. Брать, когда з
 
 Пороги сторожит гард заполнения окна; размер окна он берёт из настройки дерева — из записи
 захода тот не выводится. Место между порогами и есть то, на что заход закрывается: дописать ход
-работы, написать передачу, закоммитить и открыть отчёт, если работа кончена.
+работы, написать передачу, закоммитить и открыть PR, если работа кончена.
 
 ## Точка остановки
 
@@ -41,7 +41,7 @@ description: Паттерн правила task-flow. Брать, когда з
 Незакрытый этап — тоже законная точка, если в ходе работы записано, что именно из него сделано и
 чем это подтверждено. Незаконная точка одна: правка, о которой не записано ничего.
 
-## 8. Заход закрывается передачей
+## 9. Заход закрывается передачей
 
 Уборку этого шага — главную ветку, влитые ветки и запись самой передачи — делает команда
 `next-session`: она проходит его целиком и называет путь к передаче последней строкой. Ниже —
@@ -54,7 +54,7 @@ description: Паттерн правила task-flow. Брать, когда з
 
 ### Коммит
 
-Проверенное коммитится сразу, а не копится до конца задачи. Работа кончена — открывается отчёт:
+Проверенное коммитится сразу, а не копится до конца задачи. Работа кончена — открывается PR:
 паттерн `git-workflow-commit`.
 
 ### Передача
@@ -86,12 +86,35 @@ mkdir -p <каталог передачи>
 - <прочее, чего нет ни в правилах, ни в ходе работы>.
 ```
 
+Третьим разделом идёт «Эпик» — таблица положения. Работа вне эпика этого раздела не несёт:
+таблица из одной строки повторяет раздел «Работа» и читается как эпик из одной задачи.
+
+```markdown
+### Эпик <номер> — <возможность, названная замыслом>
+
+| №   | Задача                            | Состояние |
+| --- | --------------------------------- | --------- |
+| 1   | <КЛЮЧ>-<номер> — <что делает>     | закрыта   |
+| 2   | **<КЛЮЧ>-<номер> — <что делает>** | в работе  |
+| 3   | <КЛЮЧ>-<номер> — <что делает>     | впереди   |
+```
+
+Три колонки, строка на задачу. Заголовок называет номер эпика и возможность — ту, что записана в
+замысле, а не пересказанную заново. `№` — место по порядку: фактическое у закрытых, назначенное
+замыслом у будущих. `Задача` — номер и что она делает, теми же словами, что в замысле.
+`Состояние` — «закрыта», «в работе» или «впереди»; строка текущей задачи выделяется целиком.
+
+Состав берётся из замысла эпика, а состояние — из очереди работ: замысел о том, что закрыто, не
+знает, а очередь не знает порядка. Задача, дописанная в эпик после планирования, стоит в очереди
+и в таблице, а в замысле её нет — расхождение называется вслух, а не заглаживается.
+
 Разделы фиксированы, и порядок у них тот же:
 
 1. **Работа** — номер задачи, её название, рабочее дерево полным путём, ветка и её состояние.
 2. **Где искать** — что придёт хуком само, а что читается по надобности.
-3. **Сделано и следующий шаг** — одной строкой каждое; подробности уже в ходе работы.
-4. **Что учесть** — особенности этого захода, которых нет ни в правилах, ни в ходе работы:
+3. **Эпик** — таблица положения; у работы вне эпика раздела нет.
+4. **Сделано и следующий шаг** — одной строкой каждое; подробности уже в ходе работы.
+5. **Что учесть** — особенности этого захода, которых нет ни в правилах, ни в ходе работы:
    поднятые стенды, отставшие зависимости, чужие процессы на портах, незакрытые вопросы к
    владельцу.
 

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

@@ -34,7 +34,7 @@ description: Паттерн правила task-flow. Брать при возв
   ней проверяется деревом — сборкой, тестами, чтением файла, — а не вопросом.
 - **Не править замысел.** С ним сверяют результат; пересмотр идёт записью в ходе работы.
 
-## 6. Возвращение к работе новым заходом
+## 7. Возвращение к работе новым заходом
 
 Сверить «Где стоим» с деревом. Запись описывает день, когда её сделали:
 
@@ -46,7 +46,7 @@ git log --oneline origin/main..HEAD
 Разошлось — «Где стоим» правится сразу, до работы: следующий заход поверит записи, а не
 дереву.
 
-## 7. Этап делается и отмечается в ходе работы
+## 8. Этап делается и отмечается в ходе работы
 
 Раздел «Где стоим» **перезаписывается**, а не дописывается — это первое, что читает следующий
 заход, и единственное, что переживает обрезку по объёму:
@@ -59,16 +59,16 @@ git log --oneline origin/main..HEAD
 - **Следующий шаг:** сценарии обоих хуков, затем подключение в настройках
 - **Незакоммиченное:** всё, ветка пока без коммитов
 - **Ждём владельца:** нет
-- **Отчёт:** ещё не открыт
+- **PR:** ещё не открыт
 ```
 
-Строка про отчёт обязательна с той минуты, как этапы кончились: между открытием отчёта и
+Строка про PR обязательна с той минуты, как этапы кончились: между открытием PR и
 слиянием проходит день и больше, и заход обрывается там чаще всего. Без неё следующий заход
-читает «этап последний, всё зелено» и об открытом отчёте узнаёт только из истории ветки или у
+читает «этап последний, всё зелено» и об открытом PR узнаёт только из истории ветки или у
 владельца — то есть ровно тем пересказом, ради отмены которого всё и заведено:
 
 ```markdown
-- **Отчёт:** #1396, ждёт разбора · отвечено 3 замечания из 5 · не сделано: разбор папки задачи
+- **PR:** #1396, ждёт разбора · отвечено 3 замечания из 5 · не сделано: разбор папки задачи
 ```
 
 Решение, принятое по ходу, — вместе с причиной и с тем, что было альтернативой:
@@ -94,12 +94,30 @@ git log --oneline origin/main..HEAD
 - Доэтапное, не этой работы: сверка очереди перечисляет шесть закрытых задач вне борды.
 ```
 
+## 11. Следующая задача эпика берётся тем же движением
+
+Задача закрыта, PR открыт и ждёт владельца — заход на этом не кончается. Отданное на разбор
+ждёт человека, а не машину: пока эпик не кончился, следующая его задача берётся сразу, тем же
+движением, которым предыдущая ушла на разбор.
+
+Берётся, а не выбирается: порядок назначен на планировании и лежит в замысле эпика. Выбор,
+предложенный владельцу при назначенном порядке, — просьба назначить его заново.
+
+```bash
+# что назначено следующим — читается в замысле эпика, а не спрашивается
+# состояние задач — в очереди работ: замысел о закрытом не знает
+```
+
+Останавливает заход только предел заполнения окна — тогда идёт передача, паттерн
+`task-flow-handoff`. Эпик кончился — заход закрывается тем же порядком, и владельцу называется,
+что кончился именно эпик, а не одна его задача.
+
 ## Ловушки
 
 - **Заход, кончившийся ничем, тоже записывается.** Иначе следующий пойдёт той же дорогой:
   «пробовали так — не вышло, потому что» стоит одной строки и экономит целый заход.
 - **Незакоммиченное называется явно.** Работа живёт в дереве неделями; строка «что лежит
-  несохранённым и почему» — единственное, по чему это видно, пока отчёта нет.
+  несохранённым и почему» — единственное, по чему это видно, пока PR нет.
 - **Подтверждение — вывод команды или замер, а не пересказ.** «Проверил, работает» через
   заход неотличимо от «казалось, что работает».
 - **Число из передачи пересчитывается до того, как на нём что-то делят.** Передача описывает

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

@@ -73,6 +73,10 @@ Agent(subagent_type: "Explore", prompt: "<тема просьбы>: что по
 <Вопрос>
 ```
 
+Под вопросом идёт таблица положения эпика — та же, что в передаче. Под, а не над: остановка
+называется первой строкой, и положение эпика — то, из чего владелец решает, а не то, о чём его
+спрашивают. Работа вне эпика таблицы не несёт.
+
 Замеры, находки ролей и список решений к этому моменту уже записаны в ход работы, и в
 сообщении владельцу они лишние. Отчёт, в конце которого стоит вопрос, выглядит добросовестно
 ровно настолько, насколько надёжно вопрос в нём тонет: владелец трижды переспрашивал, почему
@@ -103,7 +107,34 @@ Workflow(name: "plan", args: "docs/tasks/_draft-<slug>")
 «не входит». Находка критика, расходящаяся с ответом владельца, относится владельцу — она не
 исполняется молча и не считается закрытой правкой текста.
 
-### 4. Задача, ветка, папка
+### 4. Серия задач объявляется эпиком
+
+Разбор кончился одной задачей — шаг пропускается. Вышло несколько, и порядок между ними
+значим — эпик объявляется здесь, до первой из них, и дважды: карточкой в очереди работ с меткой
+эпика и замыслом эпика рядом с ней.
+
+Замысел эпика называет три вещи, и ни одна не выводится из остальных:
+
+```markdown
+# <Возможность, которая разрабатывается>
+
+Одной фразой: что у владельца появится, когда эпик кончится.
+
+| №   | Задача       | Почему здесь             |
+| --- | ------------ | ------------------------ |
+| 1   | <что делает> | <на чём стоят следующие> |
+| 2   | <что делает> | <что из первой ей нужно> |
+```
+
+Состав без порядка порядком не является: две задачи, у которых он держался пониманием, ушли в
+работу наоборот, и вторая переделывалась под первую. Назначенный здесь порядок держится до конца
+эпика; пересмотр — решение владельца, и записывается он в ход работы той задачи, которая его
+вызвала.
+
+Лежит замысел вне папки задачи: та умирает с мержем первой же задачи. Каталог для него называет
+компаньон правила — у пакета своего пути нет.
+
+### 5. Задача, ветка, папка
 
 ```bash
 npm run task:new -- --title '<Что не так>' --slug <slug> --label documentation --label area:tooling < тело.md
@@ -131,7 +162,7 @@ cp docs/tasks/_template/plan.md docs/tasks/<КЛЮЧ>-<номер>-<slug>/plan.m
 cp docs/tasks/_template/progress.md docs/tasks/<КЛЮЧ>-<номер>-<slug>/progress.md
 ```
 
-### 5. Шапка замысла
+### 6. Шапка замысла
 
 Её читает гард:
 
@@ -155,13 +186,13 @@ cp docs/tasks/_template/progress.md docs/tasks/<КЛЮЧ>-<номер>-<slug>/pr
   заведённая заранее задача после разбивки закрывается и остаётся мусором в очереди работ.
 - **Разбор пишется на диск сразу, а не копится в переписке.** Сессия обрывается, и разбор,
   прожитый в разговоре, восстанавливается только пересказом владельца.
-- **Из одного разбора вышло несколько задач — общее уезжает в `docs/plans/<линия>.md`.**
-  Папка задачи умирает с мержем, а порядок задач и зависимости между ними должны его
-  пережить.
+- **Из одного разбора вышло несколько задач — общее уезжает в замысел эпика.** Папка задачи
+  умирает с мержем, а порядок задач и зависимости между ними должны его пережить. Каталог для
+  замысла называет компаньон правила.
 - **Задача заводится командой, а не четырьмя вызовами подряд.** Борда к репозиторию не
   привязана, и задача попадает на неё только явным добавлением.
 - **Slug ветки берётся из терминологии договорённости, а не из слов просьбы.** Договорённость
   пишется раньше ветки и как раз там отказывается от слова владельца: спек завёл своё имя
   предмету и прямо сказал, каким словом его не называть, — а ветка и папка задачи остались с
-  отвергнутым. Заголовок задачи и отчёта поправить можно, имя ветки после открытия отчёта —
+  отвергнутым. Заголовок задачи и PR поправить можно, имя ветки после открытия PR —
   уже нет.

package/assets/rules/angular-patterns.md

@@ -31,6 +31,28 @@ description: Правило под «Закон о фронтовом прило
 переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
 же дереве, которое держит код иначе.
 
+## Ход
+
+Ход правки класса приложения: с чего исполнитель начинает, где развилка между производным
+значением и действием, и чем кончается каждая ветка.
+
+```mermaid
+flowchart TD
+    A[Правится класс приложения] --> B{Что заводится}
+    B -->|Значение, выводимое из другого| C[computed: следит за сигналами, а не зовёт сервис]
+    B -->|Действие пользователя| D[Источник действия с суффиксом Source]
+    B -->|Состояние списка| E[Наследуется общая основа списочного стора]
+    D --> F[Подписка объявлена один раз при заведении, а не в методе]
+    F --> G{Прежний запрос ещё идёт}
+    G -->|Ответ нужен последний| H[Поток переключается]
+    G -->|Нужны все| I[Поток склеивается по очереди]
+    H --> J[Подписка гасится вместе с владельцем]
+    I --> J
+    C --> K[Готово]
+    E --> K
+    J --> K
+```
+
 ## Как закон применяется здесь
 
 - **Подписка объявляется один раз, а не в методе действия.** Метод толкает значение в

package/assets/rules/api-layer.md

@@ -30,6 +30,31 @@ description: Правило под «Закон о фронтовом прило
 переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
 же дереве, которое держит код иначе.
 
+## Ход
+
+Ход похода домена за данными: пара классов, границы типов между ними и развилка между списком
+и одиночной записью.
+
+```mermaid
+flowchart TD
+    A[Домену нужны данные] --> B{Что за домен}
+    B -->|Своя сущность| C[Заводится своя пара: фасад и сервис]
+    B -->|Чужая сущность| D[Зовётся её пара, своя не заводится]
+    C --> E{Что читается}
+    E -->|Список| F[Один вход: выборка целиком]
+    E -->|Одна запись| G[Вход — её признак]
+    F --> H[Ответ кладётся в общий конвертер целиком]
+    H --> I[В ответе стоит применённая выборка, а не запрошенная]
+    G --> J[Фасад отдаёт контракт, сервис переводит в состояние домена]
+    I --> J
+    J --> K{Данные приходят разом}
+    K -->|Да| L[Пара отдаёт поток]
+    K -->|Нет, живой срез| M[Серверный стрим — объявленное исключение]
+    L --> N[Готово]
+    M --> N
+    D --> N
+```
+
 ## Как закон применяется здесь
 
 - **Домен ходит за данными парой классов: фасад зовёт процедуру, сервис переводит модели.**