@rt-tools/agent-kit 0.8.1 → 0.8.3

package/assets/rules/task-flow.md

@@ -22,7 +22,8 @@ description: Правило под «Закон о ведении работы»
 | замысел                                       | `docs/tasks/<ветка>/plan.md` — след задачи и этапы с признаками готовности; после написания не правится                       |
 | ход работы                                    | `docs/tasks/<ветка>/progress.md` — «Где стоим», решения по ходу, записи заходов; единственное место, где отмечается сделанное |
 | договорённость о продукте, записанная до кода | `docs/specs/<домен>/proposed/<фича>/` — спек фичи; переживает мерж и вливается в спек домена                                  |
-| работа шире одной ветки                       | файл в `docs/plans/`, один на линию работ: порядок задач и зависимости между ними                                             |
+| эпик — работа шире одной ветки                | карточка в очереди работ с меткой эпика и замысел эпика рядом с ней: возможность, состав задач и их порядок                   |
+| замысел эпика                                 | запись вне папки задачи — та умирает с мержем, а эпик её переживает; каталог для неё называет компаньон правила               |
 | папка задачи до заведения задачи              | `docs/tasks/_draft-<slug>/` — вне истории, пока номера нет                                                                    |
 | разведка                                      | заход `Explore` или `general-purpose` до первого вопроса владельцу                                                            |
 | разбор замысла ролями                         | `.claude/workflows/plan.js` — нужность, договорённость, критика, замысел                                                      |
@@ -44,40 +45,124 @@ description: Правило под «Закон о ведении работы»
 | 1   | Разведка по дереву — до первого вопроса владельцу        | `task-flow-start`   |
 | 2   | Разбор просьбы с владельцем, шесть обязательных вопросов | `task-flow-start`   |
 | 3   | Конвейер ролей после разбора                             | `task-flow-start`   |
-| 4   | Задача, ветка, папка задачи                              | `task-flow-start`   |
-| 5   | Шапка замысла и сам замысел                              | `task-flow-start`   |
-| 6   | Возвращение к работе новым заходом                       | `task-flow-resume`  |
-| 7   | Этап замысла делается и отмечается в ходе работы         | `task-flow-resume`  |
-| 8   | Заход закрывается передачей                              | `task-flow-handoff` |
-| 9   | Договорённость вливается в спек домена                   | `task-flow-close`   |
-| 10  | Тексты домена приводятся к сделанному                    | `task-flow-close`   |
-| 11  | Папка задачи разбирается                                 | `task-flow-close`   |
-| 12  | Сверка очереди работ                                     | `task-flow-close`   |
-
-Шаги 6–8 повторяются, пока этапы замысла не кончатся: первый заход входит в работу шагом 1 и
-доходит до 7, дальше каждый следующий начинается шагом 6. Шаги 9–12 идут один раз, когда работа
-кончена.
+| 4   | Серия задач объявляется эпиком — карточкой и замыслом    | `task-flow-start`   |
+| 5   | Задача, ветка, папка задачи                              | `task-flow-start`   |
+| 6   | Шапка замысла и сам замысел                              | `task-flow-start`   |
+| 7   | Возвращение к работе новым заходом                       | `task-flow-resume`  |
+| 8   | Этап замысла делается и отмечается в ходе работы         | `task-flow-resume`  |
+| 9   | Заход закрывается передачей                              | `task-flow-handoff` |
+| 10  | Работа отдаётся на разбор: PR открыт, ожидание названо   | `task-flow-close`   |
+| 11  | Следующая задача эпика берётся тем же движением          | `task-flow-resume`  |
+| 12  | Договорённость вливается в спек домена                   | `task-flow-close`   |
+| 13  | Тексты домена приводятся к сделанному                    | `task-flow-close`   |
+| 14  | Папка задачи разбирается                                 | `task-flow-close`   |
+| 15  | Сверка очереди работ                                     | `task-flow-close`   |
+| 16  | Работа разбирается правилами — фоном, следом за PR       | `task-flow-close`   |
+| 17  | Находки разбора принимаются одним ходом и ждут владельца | `task-flow-close`   |
+
+Шаги 7–9 повторяются, пока этапы замысла не кончатся: первый заход входит в работу шагом 1 и
+доходит до 8, дальше каждый следующий начинается шагом 7. Шаг 4 идёт только у работы, из которой
+видно серию задач. Шаги 10–17 идут один раз, когда работа кончена.
+
+Порядок в таблице — тот, в каком шаги случаются, а не тот, в каком о них удобно рассказывать.
+Следующая задача берётся раньше уборки за предыдущей: работа, отданная на разбор, ждёт владельца,
+и заход этим ожиданием не занимают. Список, в котором уборка стоит раньше, читается как
+разрешение сидеть над зелёным PR до ответа.
+
+Три шага идут не в очередь, а рядом с работой: прогон конвейера, разбор владельцем и разбор
+закрытой работы правилами. Ни один из них не спрашивает исполнителя, пока идёт, и ни один не
+ускоряется от того, что его ждут, — поэтому шаг 11 случается раньше, чем кончатся 10 и 16, а
+шаг 17 вклинивается в работу следующей задачи ровно на один ход. Порядок номеров говорит, что
+за чем следует, а не что чего дожидается.
 
 Список показывается владельцу в начале работы, и на нём же отмечается, где стоим: иначе после
 шести вопросов не видно ни того, что будет дальше, ни сколько всего впереди.
 
+## Ход
+
+Ход работы от просьбы владельца до закрытия: где стоит разбор, что требует гард и куда девается
+папка задачи.
+
+```mermaid
+flowchart TD
+    A[Просьба владельца] --> B[Разведка по дереву — до первого вопроса]
+    B --> C[Разбор просьбы: шесть обязательных вопросов, ответы ложатся на диск]
+    C --> D{Правка задевает код приложения}
+    D -->|Да| E[Пишется договорённость о продукте — до кода]
+    D -->|Нет| F[В замысле стоит причина, по которой её нет]
+    E --> Z{Из разбора вышло несколько задач}
+    F --> Z
+    Z -->|Да| Y[Серия объявляется эпиком: карточкой и замыслом, до первой задачи]
+    Z -->|Нет| G[Задача, ветка, папка задачи по имени ветки]
+    Y --> G
+    G --> H[Замысел с этапами; после записи он не правится]
+    H --> I{Этап сделан}
+    I -->|Да| J[Отметка в ходе работы — единственном месте, где отмечается сделанное]
+    J --> I
+    I -->|Этапы кончились| K[PR открывается; исполнитель называет номер, чего ждёт и что сделает следом]
+    K --> W[Разбор закрытой работы правилами уходит в фон, находки ложатся на диск]
+    W --> L[Пока PR ждёт разбора, берётся следующая задача]
+    L --> M{Разбор и прогон кончились}
+    M -->|Красный прогон или замечания| V[Чинится в той же ветке: замысел на диске ещё нужен]
+    V --> M
+    M -->|Зелено и замечаний нет| T[Договорённость вливается в спек домена, тексты приводятся к сделанному]
+    T --> N[Папка задачи разбирается последним коммитом: разбор просьбы — в описание прошлого, находки — к замыслу эпика, замысел — прочь]
+    N --> S[Сверка очереди работ]
+    S --> O[Черновик снимается, слияние нажимает человек]
+```
+
 ## Как закон применяется здесь
 
 - **Правка кода приложения отбивается, пока на диске нет замысла.** Гард требует папку задачи
   по имени ветки, `plan.md` в ней и названную в его шапке договорённость о продукте.
 - **Влитая договорённость ветку не запирает.** После вливания директории «предложено» на диске
   нет, а замысел на неё ссылается до конца работы: гард отличает влитое от незаведённого по
-  истории ветки и пропускает первое. Иначе последний коммит отчёта закрывал бы дорогу правкам
+  истории ветки и пропускает первое. Иначе последний коммит PR закрывал бы дорогу правкам
   по замечаниям разбора.
 - **Договорённость требуется по путям правки, а не по оценке задачи.** `apps/**` и `libs/**`
   — признак; правила, тексты, обвязка и зависимости под него не подпадают. Обход — строка
   `**Поведение:** не меняется — <причина владельца>` в замысле; пустая причина не
   принимается.
-- **Гард замысла — нижняя граница, а не признак папки задачи.** Он требует её только под правку
-  кода приложения; нужна ли папка работе, которая туда не доходит, решает число заходов, а не
-  путь. Работа в один заход и один коммит целиком помещается в тело отчёта — так закрывается
-  разбор чужой папки. Работа с этапами и передачей папку заводит: между заходами её состояние
-  не держит ничто, кроме хода работы.
+- **Папка задачи заводится под любую работу, без исключений.** Прежде правило судило по числу
+  заходов: работа в один коммит помещалась в тело PR и папки не заводила. Исключение,
+  у которого есть хоть одна законная форма, исполняется как разрешение — за один заход оно
+  дважды стало поводом обойти отказ гарда, вместо того чтобы завести папку и пойти дальше.
+  Заводится она всегда и до первой правки; сколько заходов уйдёт на работу, заранее не знает
+  никто.
+- **Открыв PR, исполнитель называет владельцу три вещи: номер, чего ждёт и что сделает
+  следом.** Ждёт он прогона — до его конца о работе ничего не известно, кроме того, что она
+  запушена. Следом идёт уборка: разбор папки задачи последним коммитом. Сказанное так владелец
+  читает однозначно, а зелёный прогон на странице — нет: он говорит, что не сломано, и молчит
+  о том, что ветка ждёт ещё одного коммита. Трижды подряд PR был влит внутри этого молчания.
+- **Просьба о слиянии — отдельный ход, и раньше уборки её не бывает.** Порядок один: PR открыт
+  черновиком → прогон зелёный → папка задачи разобрана и запушена → черновик снят →
+  исполнитель просит влить, называя номер. До этой просьбы работа не готова, сколько бы зелёного
+  на её странице ни было.
+- **PR открывается черновиком, а не в конце работы.** Пока правка кода не выложена в PR,
+  владелец её не видит вовсе: ветка не приходит ему во входящие и обсуждения не имеет.
+  Открытый PR при этом читается как приглашение влить — поэтому незаконченная работа идёт
+  черновиком, и владельцу не приходится спрашивать, кончилась ли она. Черновик снимается тем
+  ходом, которым исполнитель говорит, что решение готово.
+- **Пока PR ждёт разбора, исполнитель берёт следующую задачу.** Ожидание чужого шага заходом
+  не занимают: работа уходит на разбор, и тем же движением берётся следующая. Готовым к
+  слиянию прежний PR становится не сам — его доводит до готовности исполнитель, вернувшись к
+  нему тем же ходом, которым прочитал конец прогона.
+- **Ход, в котором открыт PR, стережёт гард ожидания, а не память исполнителя.** Он отбивает
+  завершение хода, в котором не было ни одного действия по следующей задаче — заведения задачи,
+  ветки, папки или перевода колонки. Признак берётся из самого хода: спросить хостинг об
+  открытых PR было бы точнее, но сетевой вызов на завершении хода падает вместе со связью и
+  отбивал бы работу вместо промаха. Слова «беру следующую задачу» гард действием не считает —
+  ровно потому, что их и произносят вместо неё.
+- **Конец прогона узнаётся возвратом фоновой команды, а не взглядом на страницу.** Ожидание,
+  запущенное в фоне отдельным ходом, возвращает исполнителя к PR само; до тех пор ход занят
+  следующей задачей. Взгляд на страницу этого не даёт: он либо повторяется вхолостую, либо не
+  повторяется вовсе, и оба исхода со стороны выглядят одинаково — работа не двигается.
+- **Отказ гарда кончает ход.** Другого пути к отбитой правке не ищут: ни командой оболочки, ни
+  соседним инструментом, ни правкой самого гарда. Отбитая правка либо делается после того, как
+  условие отказа выполнено, либо не делается вовсе — и тогда владельцу называется отказ, а не
+  результат. Обход стоит дороже отказа: гард отбивает один файл, а обойдённый гард снимает
+  требование со всего дерева и молчит об этом. Держится это не только памятью — гарды судят и
+  команду оболочки, которая пишет файл.
 - **Ход, в котором владельцу задан вопрос, не заканчивается, пока за этот же ход не читались
   законы и правила.** Чтением считается любой из трёх путей: загрузка правила, чтение файла
   законов или правил, поиск по ним. Отбивает гард разговора — на завершении хода, а не на
@@ -113,24 +198,49 @@ description: Правило под «Закон о ведении работы»
   `npm run task:new` переименовывает черновик и проставляет шапку замысла.
 - **Брошенный разбор виден.** Черновик старше недели перечисляет сверка очереди работ —
   задачи за ним ещё нет, и спросить о нём некого.
-- **Договорённость вливается в спек домена последним коммитом отчёта.** К этому моменту код
+- **Замысел эпика лежит там, где его найдут без сети и после мержа.** Карточка в очереди работ
+  говорит, что эпик есть, но порядка задач не держит; папка задачи держала бы его ровно до
+  слияния первой из них. Каталог для замысла называет компаньон правила: у пакета своего пути
+  нет, а замысел, положенный каждым заходом заново, теряет решения предыдущих.
+- **Закрытая работа разбирается правилами, и это шаг закрытия, а не отдельная просьба.** Что
+  грузилось, что помогло и чего не хватило, видно только тому заходу, который работу вёл; через
+  сутки этого нет ни у кого. Разбор кончается правкой слоя правил или предложением наружу —
+  разбор, из которого не вышло ни того ни другого, объясняет случившееся и ничего не меняет.
+  Ведёт его роль разбора закрытой задачи, если дерево её разложило; не разложившее ведёт разбор
+  само, и требование от этого не слабеет.
+- **Разбор закрытой работы уходит в фон, а исполнитель берёт следующую задачу.** Роль работает
+  своим ходом и у исполнителя ничего не спрашивает; держать ради неё заход незачем. Сводку для
+  неё собирают до запуска — пока задача ещё в голове, — а вернувшиеся находки принимают одним
+  ходом: записать и продолжить прежнее. Порядок и место записи — паттерн закрытия работы.
+- **Находки разбора ждут владельца, а в пакет уезжает только сводка наблюдений.** Предложение —
+  это заготовка правки чужого дерева, и часть заготовок отпадает при первом же чтении; уехавшая
+  без разбора, она становится работой того, кто её не заказывал. Сводка наблюдений уезжает
+  всегда: она говорит, чем пользовались и чем нет, и мнением не является.
+- **Ожидание прогона работой не занимают.** Прогон идёт на стороне и быстрее от взгляда на него
+  не становится. Пока он идёт, берётся следующая задача, а к прогону возвращаются тем ходом,
+  которым читают его конец. Это верно и для разбора владельцем: оба ожидания — не повод стоять.
+- **Остановка, если она всё-таки случилась, называется владельцу отдельной репликой.** Не
+  строкой в конце отчёта: там она тонет — владелец читает отчёт как рассказ о сделанном.
+  Называются три вещи: что стоит, чего оно ждёт и что владелец может решить — разобрать работу
+  первой или сказать, что прогона можно не ждать. Всё остальное идёт после.
+- **Договорённость вливается в спек домена последним коммитом PR.** К этому моменту код
   написан, привязки известны, и в главной ветке директория `proposed/` не появляется вовсе.
   Готовые к вливанию перечисляет `npm run check:specs`.
 - **Папка закрытой задачи разбирается, а не переносится целиком.** В `docs/archive/` уезжает
   то, что объясняет состоявшееся решение; остальное удаляется. Неразобранную ловит сверка
   очереди работ.
 - **Слияние отбивается, пока ветка везёт папку своей задачи.** Требование стоит на слиянии, а
-  не на открытии отчёта: до слияния папка ещё нужна — правка по замечаниям разбора идёт в ту
-  же ветку, а без замысла на диске её отбивает гард хода работы. На открытии отчёта о лежащей
+  не на открытии PR: до слияния папка ещё нужна — правка по замечаниям разбора идёт в ту
+  же ветку, а без замысла на диске её отбивает гард хода работы. На открытии PR о лежащей
   папке говорится вслух, и только. Судится содержимое ветки, а не рабочее дерево: снесённая,
   но не закоммиченная папка въехала бы вместе с веткой.
 - **Ветка, снёсшая папку, обязана прибавить запись в архив.** Снести дешевле, чем разобрать, и
   первым уходит разбор просьбы — единственная запись слов владельца. Что именно увезено,
   требование не судит: это судит владелец.
-- **Обход — строка `Task-folder-skip: <причина>` в отчёте или в самой команде слияния.**
+- **Обход — строка `Task-folder-skip: <причина>` в PR или в самой команде слияния.**
   Работа, вливаемая частями, папку до конца не разбирает. Чтение из команды работает и без
   сети: единственный сетевой путь отбивал бы оффлайн то самое слияние, причина которого
-  написана в отчёте. Пустая причина обходом не считается, а сам обход снимает отказ, но не
+  написана в PR. Пустая причина обходом не считается, а сам обход снимает отказ, но не
   гасит строку сверки очереди — иначе он через месяц становится рабочим путём.
 
 ## Чего из закона здесь нет
@@ -171,7 +281,7 @@ description: Правило под «Закон о ведении работы»
 Что именно перенесли в архив, не проверяется. Гард видит, что папка уезжает в главную ветку и
 что ветка что-то в архив добавила, но не может судить, то ли это и стоило ли переносить именно
 это. Сверять содержимое машине нечем — смотрит владелец на ревью. Отсюда же и обход: если
-работа вливается частями, папку до конца не разбирают, а причина остаётся в отчёте.
+работа вливается частями, папку до конца не разбирают, а причина остаётся в PR.
 
 ## Паттерны
 
@@ -207,16 +317,21 @@ description: Правило под «Закон о ведении работы»
   задаче так ушли две правки подряд: сначала подняли общее число у соседнего узла, потом
   перенесли узел в другое место разметки. Обе владелец отверг, а нужный способ назвал сам.
   Спрашивают до правки, а не показывают замер после.
-- **Линия работ по теме читается до того, как решается раскладка.** Файл линии держит решения,
+- **Эпик по теме читается до того, как решается раскладка.** Замысел эпика держит решения,
   которые пережили десяток задач, и разведка по коду их не находит: снятое решение следа в
-  дереве не оставляет. Домен, заведённый генератором и снесённый через полчаса, стоял в линии
-  прямым запретом — но линию открыли уже после того, как он был заведён во второй раз.
-- **Работа, которая разбирает папку задачи, своей папки не заводит.** Иначе она снимает одну и
-  оставляет вторую, сверка очереди краснеет на неё, и следующая работа повторяет то же — круг
-  не кончается. Так и вышло: разбор папки закрытой работы завёл себе папку, и на неё тут же
-  пришлось заводить третью задачу. Замысел на диске требует гард, и требует он его только под
-  правку кода приложения; разбор папок туда не доходит, а понимание такой работы целиком
-  помещается в тело отчёта.
+  дереве не оставляет. Домен, заведённый генератором и снесённый через полчаса, стоял в замысле
+  прямым запретом — но замысел открыли уже после того, как он был заведён во второй раз.
+- **Работа, которая разбирает чужую папку задачи, разбирает и свою — одним коммитом.** Свою
+  папку она заводит наравне со всеми: исключения из этого требования нет. Круг, которым
+  исключение оправдывали, закрывается не отказом от папки, а порядком разбора: последний
+  коммит снимает обе, и после работы неубранного не остаётся. Однажды такой разбор оставил
+  свою папку, и на неё пришлось заводить третью задачу — лечится это порядком, а не правом
+  работать без замысла на диске. Как разобрать две папки — паттерн `task-flow-close`.
 - **Слово для нового понятия берётся из `docs/GLOSSARY.md` или заводится там же.** Третий файл
   папки задачи называется `progress.md`, а не `journal.md`, ровно поэтому: журнал в этом
   дереве один, и он другой.
+- **Черновик папки задачи называется тем же коротким именем, что и будущая ветка.** Команда
+  заведения ищет черновик по нему и, не найдя, молча собирает папку с образца: работа при этом
+  идёт дальше, а разбор просьбы остаётся лежать в брошенном каталоге, и следующий заход
+  расспрашивает владельца заново. Имя черновику дают словами просьбы, а ветке — терминологией
+  договорённости; те же слова, да не те же.

package/assets/rules/testing.md

@@ -28,6 +28,37 @@ description: Правило под «Закон о проверяемости».
 переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
 же дереве, которое держит код иначе.
 
+## Ход
+
+Ход заведения проверки: что проверяется вызовом, что — сквозным путём и как сценарий связан со
+своим тестом.
+
+```mermaid
+flowchart TD
+    A[Нужна проверка] --> B{Что обещает сценарий}
+    B -->|Человек видит и делает| C[Закрывается сквозным тестом тем же путём, что и пользователь]
+    B -->|Значение, состояние, отказ| D[Закрывается вызовом]
+    D --> E{Решение зашито в компонент или сервис}
+    E -->|Да| F[Выносится в чистую функцию и проверяется вызовом]
+    E -->|Нет| G[Проверяется как есть]
+    F --> H[Момент времени принимается параметром, а не читается с часов машины]
+    G --> H
+    C --> I{Тест погашен переменной окружения}
+    I -->|Да| J[Покрытием не считается: это долг, а отметка при живом тесте — отказ]
+    I -->|Нет| K[В заголовке теста стоит номер сценария]
+    H --> K
+    K --> P{Сценарий с таким номером есть в спеках}
+    P -->|Нет| Q[Проверка краснеет: тест ссылается на несуществующий сценарий]
+    P -->|Да| R{Тест идёт тем же путём, что и пользователь}
+    R -->|Нет| S[Помечается частичным покрытием: в сводку идёт долгом]
+    R -->|Да| L{Сценарий остался без теста}
+    L -->|Да| M[Несёт отметку с причиной: пустая не принимается]
+    L -->|Нет| N[Готово]
+    S --> N
+    M --> N
+    J --> N
+```
+
 ## Как закон применяется здесь
 
 - **Идентификатор сценария стоит в начале заголовка теста, через тире.** Один сценарий
@@ -60,6 +91,10 @@ description: Правило под «Закон о проверяемости».
   Сводная цель запускается руками, и проверка, которая живёт только в ней, отвечает тому, кто
   её вспомнил: молчание такой проверки читается как её зелёный ответ. Три проверки простояли
   вне гейта, объявляя в собственных списках известного, что падают на новом.
+- **Проверка, приехавшая раскладкой, приезжает и со своим местом.** Место — это имя команды,
+  которой её зовут, и строка набора, в котором она стоит. Проверка без места узнаётся только по
+  тому, что раскладка положила новый файл, и статья выше на неё не действует: вставать ей некуда.
+  Так приехала проверка длины — той же редакцией, что и статья о её обязательном месте.
 - **Спека, необратимо меняющая данные стенда, выключена по умолчанию.** `BASE_URL` уводит
   прогон одной переменной, и без выключателя такая спека правила бы данные чужого стенда.
 - **Спеки, которым нужен nginx перед приложением, просыпаются вместе с `BASE_URL`.** Голый
@@ -78,6 +113,10 @@ description: Правило под «Закон о проверяемости».
   принятое остаётся навсегда, долг накоплен к заведению проверки и только сокращается, — либо
   столько ключей, сколько у записей родов. Причина обязательна: снятая проверка без причины
   через месяц неотличима от недосмотра.
+- **Строка в список известного не заводится под красную проверку.** Список набран к дню
+  заведения проверки и с тех пор только сокращается: дописанная строка гасит сигнал, а не
+  причину, и в истории выглядит так же, как починка. Место, где проверка права по букве и не
+  права по существу, разбирает владелец, а до его ответа верна проверка.
 - **Тест, утверждающий отсутствие, зелен и тогда, когда ищет не то.** Совпадения нет ни у
   верного текста, ни у опечатки в образце, ни у переименованного ключа — отличить их по цвету
   прогона нечем. Отрицательное утверждение поэтому идёт в паре с положительным: сначала
@@ -136,3 +175,14 @@ description: Правило под «Закон о проверяемости».
   стенда. Обещанное поведение остаётся сценарием в `scenarios.md`: если списать его во второе
   место, копии разойдутся молча — `npm run check:specs` этого не увидит.
 - `npx nx serve` проверкой не является: это шаг из правила `browser-verification`, а не тест.
+- **Кадр, зависящий от загрузки машины, проверяет машину, а не вёрстку.** Ожидание отсчётом
+  времени этим и кончается: на свободной машине набор зелен целиком, на занятой падает, и какой
+  именно кадр не успел — дело случая. Лечится ожиданием события, а не удлинением отсчёта: шрифты
+  подняты, картинки нарисованы, движение остановлено, положение узла не менялось два кадра
+  подряд. Пока ожидание идёт по времени, «проверено снимками» означает «машина была свободна», и
+  перезапуск, давший зелёное, этого не отменяет, а прячет. Восемь кадров расходились с эталоном
+  на 0,15–0,74 % в задании конвейера и проходили на той же машине вне его.
+- **Стенд, поднятый предыдущим шагом, останавливается перед съёмкой.** Оставленный работать, он
+  соревнуется за машину с тем, что снимают, и делает исход прогона зависящим от того, чем занят
+  сосед. Нагрузка, которую задание создаёт себе само — соседняя витрина, только что законченная
+  сборка, — ничем не отличается от чужой.

package/assets/rules/translations.md

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

package/assets/rules/typescript-conventions.md

@@ -25,6 +25,27 @@ description: Правило под «Закон об устройстве код
 переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
 же дереве, которое держит код иначе.
 
+## Ход
+
+Ход объявления символа: чем задаётся имя, откуда берётся тип и что делается со снятым
+объявлением.
+
+```mermaid
+flowchart TD
+    A[Объявляется символ] --> B[Род виден по префиксу имени, а суффикс файла обещает, что в нём лежит]
+    B --> C{Тип уже объявлен где-то}
+    C -->|Да| D[Берётся из того пакета, где объявлен: своя копия разойдётся с оригиналом молча]
+    C -->|Нет| E[Объявляется здесь]
+    D --> F{Значение приходит не в том виде}
+    E --> F
+    F -->|Да| G[Приведение идёт названным способом; двухступенчатое запрещено]
+    F -->|Нет| H{Объявление снимается}
+    G --> H
+    H -->|Да| I[Отметка об устаревании ставится вместе с обходом всех потребителей]
+    H -->|Нет| J[Файл держится в пределах длины, сложность спрашивается у плагина, а не вспоминается]
+    I --> J
+```
+
 ## Как закон применяется здесь
 
 - **Род объявления виден по префиксу имени, и это держат три правила линтера.** У интерфейса,
@@ -69,6 +90,18 @@ description: Правило под «Закон об устройстве код
 
 ## Ловушки
 
+- **Пределы сложности функции спрашивают у плагина, а не вспоминают.** Там, где дерево подняло
+  правила `sonarjs` разом, до отказа, числа ветвлений и вложенности приходят умолчаниями
+  плагина и своей строкой в конфиге не записаны: они меняются вместе с его версией, а выглядят
+  как договорённость дерева. За одну задачу их спрашивали трижды, каждый раз заново, и дважды
+  называли по памяти — оба раза мимо.
+
+    ```bash
+    node -e 'const s = require("eslint-plugin-sonarjs");
+        for (const n of ["cyclomatic-complexity", "cognitive-complexity", "nested-control-flow"])
+            console.log(n, JSON.stringify(s.rules[n].meta.defaultOptions));'
+    ```
+
 - Приведение через `as Type` в маппере запрещено, но не стережётся ничем: оно принимает любое
   значение и компилируется. Вместо него — `this.typeCast`.
 - Неиспользуемый параметр убирается, а не переименовывается: подчёркивание перед именем прячет

package/assets/samples/specs/_template/spec.md

@@ -0,0 +1,83 @@
+# <Домен>
+
+**Статус:** действует · **Ревизия:** <дата> · **Префикс сценариев:** `SC-<ПРЕФИКС>`
+**Зависимости:** <домены, без которых этот не работает, или «нет»>
+**Законы:** `<закон>`, `<закон>`
+**Процедуры:** <либы, чьи процедуры домен обслуживает, или «нет»>
+
+Разделы ниже обязательны все: отсутствие раздела — отказ, а «не применимо» — законный ответ.
+Договорённость о продукте, которая пишется до кода, лежит в `proposed/<фича>/` этого же домена
+и вливается сюда последним коммитом PR — с прежними номерами сценариев.
+
+## Зачем
+
+<Что домен решает и чего стоит его отсутствие. Не пересказ реализации.>
+
+## Терминология
+
+| Термин   | Что это    |
+| -------- | ---------- |
+| <термин> | <значение> |
+
+### Как это называется в интерфейсе
+
+| В договорённости | На экране |
+| ---------------- | --------- |
+| <термин>         | <подпись> |
+
+## Правила
+
+- **<утверждение о продукте>.** <Довод: что случится, если этого не держать.> Каждое
+  утверждение получает строку привязки `файл:символ` в `implementation.md` рядом.
+
+## Что не входит
+
+- <соседняя область и куда за ней идти>
+
+## Контракт
+
+<Процедуры домена таблицей: имя, что принимает, что отдаёт. Нет процедур — «не применимо».>
+
+### Коды отказов
+
+| Код   | Когда               |
+| ----- | ------------------- |
+| <код> | <при чём бросается> |
+
+## Данные
+
+<Записи хранилища, которыми домен владеет. Нет своих — «не применимо».>
+
+## Экраны и состояния
+
+<Экраны домена и состояния каждого: пусто, загрузка, отказ, готово. Нет экранов — «не применимо».>
+
+## Сквозные требования
+
+### Локали
+
+<Что переводится и где лежат ключи.>
+
+### SEO
+
+<Заголовки, адреса, разметка. Не применимо — так и пишется.>
+
+### Мобильная раскладка
+
+<Что меняется на узком экране.>
+
+### Мультиобъектность
+
+<Что у домена своё на каждый объект владения.>
+
+## Решения
+
+- **<решение>** — <довод>. Отвергнуто: <альтернатива и почему>.
+
+## Открытые вопросы
+
+- `Q-<номер>` — <вопрос и допущение, с которым идёт работа>.
+
+## История изменений
+
+- <дата> — <что изменилось>.

package/assets/samples/tasks/_template/grill.md

@@ -0,0 +1,28 @@
+# Разбор просьбы
+
+## Просьба владельца
+
+> <дословно, без пересказа>
+
+## Что уже есть в дереве
+
+<Находки разведки: спеки по теме, законы и правила, которые работа задевает, готовый образец
+рядом. Заполняется до первого вопроса владельцу.>
+
+## Что уже сказано в правилах
+
+<Что нашлось в законах и правилах по теме вопроса. Владельцу не задаётся то, ответ на что уже
+записан.>
+
+## Вопросы и ответы
+
+**<вопрос>**
+<ответ владельца его словами>
+
+## Решения
+
+- **<решение>** — <довод>. Отвергнуто: <что и почему>.
+
+## Что осталось невыясненным
+
+- <вопрос, который не задавали, и почему он не блокирует работу>

package/assets/samples/tasks/_template/plan.md

@@ -0,0 +1,39 @@
+# Замысел
+
+**Задача:** <КЛЮЧ>-<номер> · **Ветка:** <ветка>
+**Драфт:** `<путь к договорённости о продукте>`
+**Поведение:** меняется
+
+Работа, не задевающая код приложения, договорённости не требует — тогда вместо строки драфта
+стоит `**Поведение:** не меняется — <причина владельца>`; пустая причина не принимается.
+
+После написания этот файл не правится. Пересмотр этапа идёт в `progress.md` решением по ходу.
+
+## След задачи
+
+<Что работа задевает. Заполняется разведкой до разбора и подтверждается владельцем. По этой же
+таблице на закрытии смотрят, что из спеков, правил и паттернов устарело: названное здесь
+читают дважды — до работы и после неё.>
+
+| Что     | Где                               |
+| ------- | --------------------------------- |
+| Спеки   | <домены, которых работа касается> |
+| Законы  | <законы по её следу>              |
+| Правила | <правила и их компаньоны>         |
+| Код     | <либы и приложения>               |
+
+## Что считается сделанным
+
+- <утверждение, которое можно проверить>
+
+## Этапы
+
+### 1. <название>
+
+- **Что делается:** <одной фразой>
+- **Признак готовности:** <что должно стать верным>
+- **Чем проверяется:** <команда или приём>
+
+## Чего эта работа не делает
+
+- <соседняя работа, которую сюда не тащим, и куда она заведена>

package/assets/samples/tasks/_template/progress.md

@@ -0,0 +1,23 @@
+# Ход работы
+
+## Где стоим
+
+Перезаписывается каждым заходом, а не дописывается.
+
+- **Этап:** <номер> из <всего> — <название>
+- **Сделано:** <коротко>
+- **Следующий шаг:** <что делается первым в новом заходе>
+- **Незакоммиченное:** <что лежит в дереве вне индекса>
+- **Ждём владельца:** <чего именно, или «нет»>
+- **PR:** <номер и состояние, или «ещё не открыт»>
+
+## Решения по ходу
+
+- **<решение>** — <довод>. Затронутый этап замысла: <номер>.
+
+## Заходы
+
+### <дата>
+
+- <что сделано, числами: файлов, коммитов, что зелёное>
+- <на чём споткнулись и чем поймали>