@rt-tools/agent-kit 0.8.2 → 0.8.3

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
+```
+
 ## Как закон применяется здесь
 
 - **Домен ходит за данными парой классов: фасад зовёт процедуру, сервис переводит модели.**

package/assets/rules/browser-verification.md

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

package/assets/rules/component-structure.md

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

package/assets/rules/dependencies.md

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

package/assets/rules/doc-style.md

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

package/assets/rules/entity-conventions.needs-admin.md

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

package/assets/rules/entity-models.md

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

package/assets/rules/git-workflow.azure.md

@@ -35,6 +35,30 @@ description: Правило под «Закон о поставке» для д
 переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
 же дереве, которое держит код иначе.
 
+## Ход
+
+Ход работы от задачи до слияния: где стоит гард, что двигает колонку очереди работ и чем
+работа кончается.
+
+```mermaid
+flowchart TD
+    A[Работа начинается] --> B[Задача заводится командой и встаёт в очередь работ]
+    B --> C[Ветка называется номером задачи; колонка двигается тем же движением]
+    C --> D{Правка готова}
+    D -->|Нет| C
+    D -->|Да| E[Главная ветка влита, набор гейта прогнан целиком]
+    E --> F{Ветка несёт номер задачи}
+    F -->|Нет| G[Гард поставки отбивает открытие: за правкой ничего не стоит в очереди]
+    F -->|Да| H[PR открывается; не готовое к слиянию идёт черновиком]
+    H --> I[Колонка задачи переходит в разбор, исполнитель берёт следующую задачу]
+    I --> J{Прогон и разбор кончились}
+    J -->|Прогон красный| K[Чинится в той же ветке]
+    K --> J
+    J -->|Зелено| L[Папка задачи разбирается последним коммитом, черновик снимается]
+    L --> M[Слияние нажимает человек: исполнитель просит и называет номер]
+    G --> B
+```
+
 ## Как закон применяется здесь
 
 - **Коммит в главную ветку отбивается гардом.** Гард ищет вызов коммита в любом месте команды
@@ -48,6 +72,20 @@ description: Правило под «Закон о поставке» для д
   открытие, пока вершина главной ветки не стала предком текущей, и называет расхождение числом
   коммитов. PR с разошедшейся ветки показывает ревьюверу свою правку вперемешку с чужой, а всё,
   что автор проверил до публикации, он проверил от основания, которого в главной ветке уже нет.
+- **Правка кода отдаётся человеку открытым PR, а не запушенной веткой.** Ветка в списке ветвей
+  ему не показывается, в его дела не приходит и обсуждения не имеет: до открытия PR правки для
+  человека нет. Открывается он тем же ходом, которым исполнитель говорит, что работу отдаёт, и
+  в ответе называется номером.
+- **Не готовое к слиянию открывается черновиком — `az repos pr create --draft true`.** Кнопка
+  завершения у черновика заблокирована самим хостингом, поэтому состояние «выложено на
+  обозрение» и состояние «можно вливать» перестают выглядеть одинаково. Черновиком идёт всё,
+  что ждёт прогона конвейера, доработки или ответа на вопрос; вопрос задаётся в самом PR.
+  Конвейер проверок черновика по умолчанию не запускает — до снятия черновика он молчит, и это
+  молчание за зелёный прогон не принимается.
+- **Черновик снимается отдельным вызовом — `az repos pr update --id <номер> --draft false`.**
+  Им исполнитель отвечает за готовность: проверки пройдены, доработок не осталось, работа
+  сходится с рабочим элементом. Снятие черновика и просьба влить — один ход, а не два разных
+  дня.
 - **Заведённый рабочий элемент подтверждается ответом очереди работ, а не выводом команды
   заведения.** Команда отвечает за свои вызовы: она может завести элемент и не довести его до
   доски, и её собственный разбор ошибок этот случай называет. Напечатанный номер значит «вызов
@@ -62,6 +100,17 @@ description: Правило под «Закон о поставке» для д
   элемент переводится в `Active`, PR открыт — в `Resolved`; делает это команда перевода, а не
   набор вызовов по памяти. Перевод идёт сразу за шагом, который его вызвал: очередь работ
   читают между шагами, а не после них.
+- **На доске стоят рабочие элементы, а не PR о них.** Доска показывает, что сделано и что
+  осталось; PR отвечает на другой вопрос — как именно сделано, — и открывается из элемента, где
+  связь с ним стоит сама. Здесь эта связь ставится при создании PR, поэтому отдельная карточка
+  не нужна вовсе, а заведённая живёт своей жизнью: состояния под неё нет, из очереди она не
+  уходит и остаётся в ней после слияния навсегда. Находит такие сверка очереди — строкой на
+  каждую.
+- **Конвейер судит по составу правки, а не гоняет всё подряд.** Шаги, которым нечего проверять,
+  пропускаются по признаку, посчитанному от главной ветки: ветка, не тронувшая ни строки кода,
+  не поднимает стенда, не снимает кадров и не собирает образов. Признак объявляется переменной
+  задания и считается один раз, а не переспрашивается в каждом условии. Пропущенный шаг виден в
+  прогоне пропущенным — молча выпавший читается как пройденный.
 - **Отставшее состояние находится сверкой очереди, а не глазами.** Сверка судит состояние по
   PR в обе стороны: открытый PR при элементе не в разборе и разбор без открытого PR — оба
   расхождения. Момента, когда задачу берут в работу, ей не видно: ветки на доске нет.
@@ -70,7 +119,7 @@ description: Правило под «Закон о поставке» для д
   въехала, и откатывается она целиком.
 - **Работа, которую одним заходом не закрыть, помечена в двух местах, и они сверяются.** Метка
   на доске и строка о заходах с передачей в замысле эпика говорят одно и то же двум читателям:
-  исполнитель открывает карточку раньше, чем линию, а планирует по линии. Одна пометка без
+  исполнитель открывает карточку раньше, чем замысел эпика, а планирует по замыслу. Одна пометка без
   другой лжёт молча, поэтому сверка очереди судит пару в обе стороны. Помечается только то, что
   законно не делится: пометка объёма правом делить не становится.
 - **Слияние в главную ветку выкатывает прод.** Фильтры путей конвейера покрывают документы

package/assets/rules/git-workflow.github.md

@@ -36,6 +36,30 @@ description: Правило под «Закон о поставке» для д
 переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
 же дереве, которое держит код иначе.
 
+## Ход
+
+Ход работы от задачи до слияния: где стоит гард, что двигает колонку очереди работ и чем
+работа кончается.
+
+```mermaid
+flowchart TD
+    A[Работа начинается] --> B[Задача заводится командой и встаёт в очередь работ]
+    B --> C[Ветка называется номером задачи; колонка двигается тем же движением]
+    C --> D{Правка готова}
+    D -->|Нет| C
+    D -->|Да| E[Главная ветка влита, набор гейта прогнан целиком]
+    E --> F{Ветка несёт номер задачи}
+    F -->|Нет| G[Гард поставки отбивает открытие: за правкой ничего не стоит в очереди]
+    F -->|Да| H[PR открывается; не готовое к слиянию идёт черновиком]
+    H --> I[Колонка задачи переходит в разбор, исполнитель берёт следующую задачу]
+    I --> J{Прогон и разбор кончились}
+    J -->|Прогон красный| K[Чинится в той же ветке]
+    K --> J
+    J -->|Зелено| L[Папка задачи разбирается последним коммитом, черновик снимается]
+    L --> M[Слияние нажимает человек: исполнитель просит и называет номер]
+    G --> B
+```
+
 ## Как закон применяется здесь
 
 - **Коммит в главную ветку отбивается гардом.** Гард ищет вызов коммита в любом месте команды
@@ -72,6 +96,17 @@ description: Правило под «Закон о поставке» для д
   переставляется во взятые в работу, PR открыт — в ждущие разбора; делает это команда
   перевода, а не набор вызовов GraphQL по памяти. Перевод идёт сразу за шагом, который его
   вызвал: очередь работ читают между шагами, а не после них.
+- **На борде стоят задачи, а не PR о них.** Борда показывает, что сделано и что осталось; PR
+  отвечает на другой вопрос — как именно сделано, — и открывается из карточки задачи, где связь
+  с ним заполняется сама полем «Linked pull requests». Карточка PR живёт своей жизнью: колонки
+  под неё нет, из очереди она не уходит и остаётся в ней после слияния навсегда. Заводится она
+  либо встроенным правилом борды, либо рукой; и то и другое выключается, а накопившееся
+  снимается. Находит их сверка очереди — строкой на каждую.
+- **Конвейер судит по составу правки, а не гоняет всё подряд.** Шаги, которым нечего проверять,
+  пропускаются по признаку, посчитанному от главной ветки: ветка, не тронувшая ни строки кода,
+  не поднимает стенда, не снимает кадров и не собирает образов. Признак считается один раз и
+  объявляется выводом шага, а не переспрашивается в каждом условии. Пропущенный шаг виден в
+  прогоне пропущенным — молча выпавший читается как пройденный.
 - **Отставшая колонка находится сверкой очереди, а не глазами.** Сверка судит колонку по
   PR в обе стороны: открытый PR при задаче не в разборе и разбор без открытого PR — оба
   расхождения. Момента, когда задачу берут в работу, ей не видно: ветки на борде нет.
@@ -80,7 +115,7 @@ description: Правило под «Закон о поставке» для д
   откатывается она целиком.
 - **Работа, которую одним заходом не закрыть, помечена в двух местах, и они сверяются.** Метка
   на борде и строка о заходах с передачей в замысле эпика говорят одно и то же двум читателям:
-  исполнитель открывает карточку раньше, чем линию, а планирует по линии. Одна пометка без
+  исполнитель открывает карточку раньше, чем замысел эпика, а планирует по замыслу. Одна пометка без
   другой лжёт молча, поэтому сверка очереди судит пару в обе стороны. Помечается только то, что
   законно не делится: пометка объёма правом делить не становится.
 - **Мерж в главную ветку выкатывает прод.** Исключения по путям покрывают только документы,
@@ -138,10 +173,21 @@ description: Правило под «Закон о поставке» для д
   сломана, она описывает вчерашний день. Сравнение веток пишется от `origin/main` целиком —
   смешав в одной команде удалённую ссылку для одной стороны и локальную для другой, промах
   изнутри выглядит правильным.
+- **Правка кода отдаётся человеку открытым PR, а не запушенной веткой.** Ветка в списке ветвей
+  ему не показывается, во входящие не приходит и обсуждения не имеет: до открытия PR правки
+  для человека нет. Открывается он тем же ходом, которым исполнитель говорит, что работу
+  отдаёт, и в ответе называется номером.
+- **Не готовое к слиянию открывается черновиком — `gh pr create --draft`.** Кнопка слияния у
+  черновика заблокирована самим хостингом, поэтому состояние «выложено на обозрение» и
+  состояние «можно вливать» перестают выглядеть одинаково. Черновиком идёт всё, что ждёт
+  прогона конвейера, доработки или ответа на вопрос; вопрос задаётся в самом PR.
+- **Черновик снимается отдельным вызовом — `gh pr ready <номер>`.** Им исполнитель отвечает за
+  готовность: проверки пройдены, доработок не осталось, работа сходится с задачей. Снятие
+  черновика и просьба влить — один ход, а не два разных дня.
 - **Мерж PR нажимает человек, а не исполнитель работы.** Кнопка и вызов слияния равны: запрет
   на них один. Исполнитель сливает свой PR только тогда, когда человек сказал это прямо и про
   этот PR; сказанное об одном PR на следующий не переносится, а молчание разрешением не
-  бывает. Работа кончается открытым и зелёным PR, и в ответе называется его номер.
+  бывает. Работа кончается PR, с которого снят черновик, и в ответе называется его номер.
 - **Автор PR не может быть его ревьювером.** Запрос разбора на самого себя GitHub принимает и
   молча не создаёт — разбор при этом выглядит запрошенным.
 - **Метки, исполнитель и ревьювер PR ставятся вызовами `gh api`, а не `gh pr edit`.** На

package/assets/rules/git-workflow.gitlab.md

@@ -35,6 +35,30 @@ description: Правило под «Закон о поставке» для д
 переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
 же дереве, которое держит код иначе.
 
+## Ход
+
+Ход работы от задачи до слияния: где стоит гард, что двигает колонку очереди работ и чем
+работа кончается.
+
+```mermaid
+flowchart TD
+    A[Работа начинается] --> B[Задача заводится командой и встаёт в очередь работ]
+    B --> C[Ветка называется номером задачи; колонка двигается тем же движением]
+    C --> D{Правка готова}
+    D -->|Нет| C
+    D -->|Да| E[Главная ветка влита, набор гейта прогнан целиком]
+    E --> F{Ветка несёт номер задачи}
+    F -->|Нет| G[Гард поставки отбивает открытие: за правкой ничего не стоит в очереди]
+    F -->|Да| H[PR открывается; не готовое к слиянию идёт черновиком]
+    H --> I[Колонка задачи переходит в разбор, исполнитель берёт следующую задачу]
+    I --> J{Прогон и разбор кончились}
+    J -->|Прогон красный| K[Чинится в той же ветке]
+    K --> J
+    J -->|Зелено| L[Папка задачи разбирается последним коммитом, черновик снимается]
+    L --> M[Слияние нажимает человек: исполнитель просит и называет номер]
+    G --> B
+```
+
 ## Как закон применяется здесь
 
 - **Коммит в главную ветку отбивается гардом.** Гард ищет вызов коммита в любом месте команды
@@ -47,6 +71,18 @@ description: Правило под «Закон о поставке» для д
   вершина главной ветки не стала предком текущей, и называет расхождение числом коммитов. MR с
   разошедшейся ветки показывает ревьюверу свою правку вперемешку с чужой, а всё, что автор
   проверил до публикации, он проверил от основания, которого в главной ветке уже нет.
+- **Правка кода отдаётся человеку открытым MR, а не запушенной веткой.** Ветка в списке ветвей
+  ему не показывается, в дела не приходит и обсуждения не имеет: до открытия MR правки для
+  человека нет. Открывается он тем же ходом, которым исполнитель говорит, что работу отдаёт, и
+  в ответе называется номером.
+- **Не готовое к слиянию открывается черновиком — `glab mr create --draft`.** Кнопка слияния у
+  черновика заблокирована самим хостингом, поэтому состояние «выложено на обозрение» и
+  состояние «можно вливать» перестают выглядеть одинаково. Черновиком идёт всё, что ждёт
+  прогона конвейера, доработки или ответа на вопрос; вопрос задаётся в самом MR. Признак
+  черновика здесь — приставка `Draft:` в заголовке, и правится он вместе с ним.
+- **Черновик снимается отдельным вызовом — `glab mr update <номер> --ready`.** Им исполнитель
+  отвечает за готовность: проверки пройдены, доработок не осталось, работа сходится с задачей.
+  Снятие черновика и просьба влить — один ход, а не два разных дня.
 - **Заведённая задача подтверждается ответом очереди работ, а не выводом команды заведения.**
   Команда отвечает за свои вызовы: она может завести задачу и не довести её до доски, и её
   собственный разбор ошибок этот случай называет. Напечатанный номер значит «вызов прошёл», а не
@@ -61,6 +97,18 @@ description: Правило под «Закон о поставке» для д
   переставляется во взятые в работу, MR открыт — в ждущие разбора; делает это команда
   перевода, а не набор вызовов по памяти. Перевод идёт сразу за шагом, который его вызвал:
   очередь работ читают между шагами, а не после них.
+- **На доске стоят задачи, а не MR о них.** Доска показывает, что сделано и что осталось; MR
+  отвечает на другой вопрос — как именно сделано, — и открывается из задачи, где связь с ним
+  стоит сама. Карточка MR живёт своей жизнью: метки списка у неё нет, из очереди она не уходит и
+  остаётся в ней после слияния навсегда. Здесь она заводится проще, чем где-либо: доска
+  собирается по меткам, и метка списка, поставленная на MR, тут же делает его карточкой.
+  Находит такие сверка очереди — строкой на каждую.
+- **Конвейер судит по составу правки, а не гоняет всё подряд.** Шаги, которым нечего проверять,
+  пропускаются по признаку, посчитанному от главной ветки: ветка, не тронувшая ни строки кода,
+  не поднимает стенда, не снимает кадров и не собирает образов. Правила `rules:changes` считают
+  это сами, но по путям, а не по составу правки — совпадение пути ещё не значит, что задета
+  сборка, поэтому признак объявляется явно и один раз. Пропущенный шаг виден в прогоне
+  пропущенным — молча выпавший читается как пройденный.
 - **Отставший список находится сверкой очереди, а не глазами.** Сверка судит список по PR
   в обе стороны: открытый MR при задаче не в разборе и разбор без открытого MR — оба
   расхождения. Момента, когда задачу берут в работу, ей не видно: ветки на доске нет.
@@ -69,7 +117,7 @@ description: Правило под «Закон о поставке» для д
   въехала, и откатывается она целиком.
 - **Работа, которую одним заходом не закрыть, помечена в двух местах, и они сверяются.** Метка
   на доске и строка о заходах с передачей в замысле эпика говорят одно и то же двум читателям:
-  исполнитель открывает карточку раньше, чем линию, а планирует по линии. Одна пометка без
+  исполнитель открывает карточку раньше, чем замысел эпика, а планирует по замыслу. Одна пометка без
   другой лжёт молча, поэтому сверка очереди судит пару в обе стороны. Помечается только то, что
   законно не делится: пометка объёма правом делить не становится.
 - **Слияние в главную ветку выкатывает прод.** Правила `only`/`rules` конвейера покрывают

package/assets/rules/lib-layers.md

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

package/assets/rules/lists.md

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

package/assets/rules/navigation.md

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