@rt-tools/agent-kit 0.8.2 → 0.8.3

package/assets/rules/observability.needs-app.md

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

package/assets/rules/permissions.md

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

package/assets/rules/platform-access.md

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

package/assets/rules/reuse-first.md

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

package/assets/rules/seo.md

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

package/assets/rules/shared-code.md

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

package/assets/rules/spec-driven.md

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

package/assets/rules/styling-bem.md

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

package/assets/rules/task-flow.md

@@ -22,7 +22,8 @@ description: Правило под «Закон о ведении работы»
 | замысел                                       | `docs/tasks/<ветка>/plan.md` — след задачи и этапы с признаками готовности; после написания не правится                       |
 | ход работы                                    | `docs/tasks/<ветка>/progress.md` — «Где стоим», решения по ходу, записи заходов; единственное место, где отмечается сделанное |
 | договорённость о продукте, записанная до кода | `docs/specs/<домен>/proposed/<фича>/` — спек фичи; переживает мерж и вливается в спек домена                                  |
-| эпик — работа шире одной ветки                | карточка в очереди работ с меткой эпика и файл замысла рядом: возможность, состав задач и их порядок                          |
+| эпик — работа шире одной ветки                | карточка в очереди работ с меткой эпика и замысел эпика рядом с ней: возможность, состав задач и их порядок                   |
+| замысел эпика                                 | запись вне папки задачи — та умирает с мержем, а эпик её переживает; каталог для неё называет компаньон правила               |
 | папка задачи до заведения задачи              | `docs/tasks/_draft-<slug>/` — вне истории, пока номера нет                                                                    |
 | разведка                                      | заход `Explore` или `general-purpose` до первого вопроса владельцу                                                            |
 | разбор замысла ролями                         | `.claude/workflows/plan.js` — нужность, договорённость, критика, замысел                                                      |
@@ -44,24 +45,72 @@ 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`   |
-| 13  | Следующая задача эпика берётся тем же движением          | `task-flow-resume`  |
-
-Шаги 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[Черновик снимается, слияние нажимает человек]
+```
+
 ## Как закон применяется здесь
 
 - **Правка кода приложения отбивается, пока на диске нет замысла.** Гард требует папку задачи
@@ -86,12 +135,28 @@ description: Правило под «Закон о ведении работы»
   читает однозначно, а зелёный прогон на странице — нет: он говорит, что не сломано, и молчит
   о том, что ветка ждёт ещё одного коммита. Трижды подряд PR был влит внутри этого молчания.
 - **Просьба о слиянии — отдельный ход, и раньше уборки её не бывает.** Порядок один: PR открыт
-  → прогон зелёный → папка задачи разобрана и запушена → исполнитель просит влить, называя
-  номер. До этой просьбы работа не готова, сколько бы зелёного на её странице ни было.
+  черновиком → прогон зелёный → папка задачи разобрана и запушена → черновик снят →
+  исполнитель просит влить, называя номер. До этой просьбы работа не готова, сколько бы зелёного
+  на её странице ни было.
+- **PR открывается черновиком, а не в конце работы.** Пока правка кода не выложена в PR,
+  владелец её не видит вовсе: ветка не приходит ему во входящие и обсуждения не имеет.
+  Открытый PR при этом читается как приглашение влить — поэтому незаконченная работа идёт
+  черновиком, и владельцу не приходится спрашивать, кончилась ли она. Черновик снимается тем
+  ходом, которым исполнитель говорит, что решение готово.
 - **Пока PR ждёт разбора, исполнитель берёт следующую задачу.** Ожидание чужого шага заходом
   не занимают: работа уходит на разбор, и тем же движением берётся следующая. Готовым к
   слиянию прежний PR становится не сам — его доводит до готовности исполнитель, вернувшись к
   нему тем же ходом, которым прочитал конец прогона.
+- **Ход, в котором открыт PR, стережёт гард ожидания, а не память исполнителя.** Он отбивает
+  завершение хода, в котором не было ни одного действия по следующей задаче — заведения задачи,
+  ветки, папки или перевода колонки. Признак берётся из самого хода: спросить хостинг об
+  открытых PR было бы точнее, но сетевой вызов на завершении хода падает вместе со связью и
+  отбивал бы работу вместо промаха. Слова «беру следующую задачу» гард действием не считает —
+  ровно потому, что их и произносят вместо неё.
+- **Конец прогона узнаётся возвратом фоновой команды, а не взглядом на страницу.** Ожидание,
+  запущенное в фоне отдельным ходом, возвращает исполнителя к PR само; до тех пор ход занят
+  следующей задачей. Взгляд на страницу этого не даёт: он либо повторяется вхолостую, либо не
+  повторяется вовсе, и оба исхода со стороны выглядят одинаково — работа не двигается.
 - **Отказ гарда кончает ход.** Другого пути к отбитой правке не ищут: ни командой оболочки, ни
   соседним инструментом, ни правкой самого гарда. Отбитая правка либо делается после того, как
   условие отказа выполнено, либо не делается вовсе — и тогда владельцу называется отказ, а не
@@ -133,6 +198,31 @@ description: Правило под «Закон о ведении работы»
   `npm run task:new` переименовывает черновик и проставляет шапку замысла.
 - **Брошенный разбор виден.** Черновик старше недели перечисляет сверка очереди работ —
   задачи за ним ещё нет, и спросить о нём некого.
+- **Замысел эпика лежит там, где его найдут без сети и после мержа.** Карточка в очереди работ
+  говорит, что эпик есть, но порядка задач не держит; папка задачи держала бы его ровно до
+  слияния первой из них. Каталог для замысла называет компаньон правила: у пакета своего пути
+  нет, а замысел, положенный каждым заходом заново, теряет решения предыдущих.
+- **Закрытая работа разбирается правилами, и это шаг закрытия, а не отдельная просьба.** Что
+  грузилось, что помогло и чего не хватило, видно только тому заходу, который работу вёл; через
+  сутки этого нет ни у кого. Разбор кончается правкой слоя правил или предложением наружу —
+  разбор, из которого не вышло ни того ни другого, объясняет случившееся и ничего не меняет.
+  Ведёт его роль разбора закрытой задачи, если дерево её разложило; не разложившее ведёт разбор
+  само, и требование от этого не слабеет.
+- **Разбор закрытой работы уходит в фон, а исполнитель берёт следующую задачу.** Роль работает
+  своим ходом и у исполнителя ничего не спрашивает; держать ради неё заход незачем. Сводку для
+  неё собирают до запуска — пока задача ещё в голове, — а вернувшиеся находки принимают одним
+  ходом: записать и продолжить прежнее. Порядок и место записи — паттерн закрытия работы.
+- **Находки разбора ждут владельца, а в пакет уезжает только сводка наблюдений.** Предложение —
+  это заготовка правки чужого дерева, и часть заготовок отпадает при первом же чтении; уехавшая
+  без разбора, она становится работой того, кто её не заказывал. Сводка наблюдений уезжает
+  всегда: она говорит, чем пользовались и чем нет, и мнением не является.
+- **Ожидание прогона работой не занимают.** Прогон идёт на стороне и быстрее от взгляда на него
+  не становится. Пока он идёт, берётся следующая задача, а к прогону возвращаются тем ходом,
+  которым читают его конец. Это верно и для разбора владельцем: оба ожидания — не повод стоять.
+- **Остановка, если она всё-таки случилась, называется владельцу отдельной репликой.** Не
+  строкой в конце отчёта: там она тонет — владелец читает отчёт как рассказ о сделанном.
+  Называются три вещи: что стоит, чего оно ждёт и что владелец может решить — разобрать работу
+  первой или сказать, что прогона можно не ждать. Всё остальное идёт после.
 - **Договорённость вливается в спек домена последним коммитом PR.** К этому моменту код
   написан, привязки известны, и в главной ветке директория `proposed/` не появляется вовсе.
   Готовые к вливанию перечисляет `npm run check:specs`.

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
+```
+
 ## Как закон применяется здесь
 
 - **Идентификатор сценария стоит в начале заголовка теста, через тире.** Один сценарий

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
+```
+
 ## Как закон применяется здесь
 
 - **Род объявления виден по префиксу имени, и это держат три правила линтера.** У интерфейса,

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