@rt-tools/agent-kit 0.8.1 → 0.8.3

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

@@ -21,7 +21,7 @@ description: Правило под «Закон о поставке» для д
 | задача                           | issue проекта, заголовок `[<КЛЮЧ>-<номер>] <Что не так>`, исполнитель — учётная запись машинной работы; MR прикрепляется к нему строкой `Closes #<номер>` в описании                                  |
 | очередь работ                    | доска задач проекта — Issue Board. Задача попадает на неё меткой списка, а не самим фактом заведения: доска показывает те issue, чью метку знает                                                      |
 | состояние задачи в очереди работ | список доски, за которым стоит метка: заведённая, взятая в работу, ждущая разбора. Имена меток — в `implementation.md`; закрытая задача уходит из очереди слиянием, а не переносом в последний список |
-| отчёт о задаче                   | заголовок MR `[<КЛЮЧ>-<номер>] <Что сделано>` — тот же номер, что у задачи, и её название, переведённое в сделанное; тип и область коммита сюда не идут                                               |
+| PR о задаче                      | заголовок MR `[<КЛЮЧ>-<номер>] <Что сделано>` — тот же номер, что у задачи, и её название, переведённое в сделанное; тип и область коммита сюда не идут                                               |
 | обсуждение правки                | разбор MR: ревьювер — владелец проекта, исполнитель — учётная запись машинной работы, метки — те же, что у задачи                                                                                     |
 | попадание правки в главную ветку | слияние MR; оно же запускает выкатку — `.gitlab-ci.yml`                                                                                                                                               |
 | образ того коммита               | `IMAGE_TAG=<sha>` в командах `docker compose` на сервере                                                                                                                                              |
@@ -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,23 @@ description: Правило под «Закон о поставке» для д
   вершина главной ветки не стала предком текущей, и называет расхождение числом коммитов. MR с
   разошедшейся ветки показывает ревьюверу свою правку вперемешку с чужой, а всё, что автор
   проверил до публикации, он проверил от основания, которого в главной ветке уже нет.
+- **Правка кода отдаётся человеку открытым MR, а не запушенной веткой.** Ветка в списке ветвей
+  ему не показывается, в дела не приходит и обсуждения не имеет: до открытия MR правки для
+  человека нет. Открывается он тем же ходом, которым исполнитель говорит, что работу отдаёт, и
+  в ответе называется номером.
+- **Не готовое к слиянию открывается черновиком — `glab mr create --draft`.** Кнопка слияния у
+  черновика заблокирована самим хостингом, поэтому состояние «выложено на обозрение» и
+  состояние «можно вливать» перестают выглядеть одинаково. Черновиком идёт всё, что ждёт
+  прогона конвейера, доработки или ответа на вопрос; вопрос задаётся в самом MR. Признак
+  черновика здесь — приставка `Draft:` в заголовке, и правится он вместе с ним.
+- **Черновик снимается отдельным вызовом — `glab mr update <номер> --ready`.** Им исполнитель
+  отвечает за готовность: проверки пройдены, доработок не осталось, работа сходится с задачей.
+  Снятие черновика и просьба влить — один ход, а не два разных дня.
+- **Заведённая задача подтверждается ответом очереди работ, а не выводом команды заведения.**
+  Команда отвечает за свои вызовы: она может завести задачу и не довести её до доски, и её
+  собственный разбор ошибок этот случай называет. Напечатанный номер значит «вызов прошёл», а не
+  «задача видна тому, кто по ней работает». Спрашивается очередь — по номеру, одним вызовом, — и
+  ответ читается присутствием задачи на доске, её списком и исполнителем.
 - **Номер ветки и номер в заголовке MR сверяются на месте, а состояние задачи — по доске.**
   Формат читается из текста команды и работает без сети; существование задачи, её метка
   списка, исполнитель и то, что она ещё открыта, — только когда есть чем спросить. Нет сети
@@ -56,15 +97,27 @@ description: Правило под «Закон о поставке» для д
   переставляется во взятые в работу, MR открыт — в ждущие разбора; делает это команда
   перевода, а не набор вызовов по памяти. Перевод идёт сразу за шагом, который его вызвал:
   очередь работ читают между шагами, а не после них.
-- **Отставший список находится сверкой очереди, а не глазами.** Сверка судит список по отчёту
+- **На доске стоят задачи, а не MR о них.** Доска показывает, что сделано и что осталось; MR
+  отвечает на другой вопрос — как именно сделано, — и открывается из задачи, где связь с ним
+  стоит сама. Карточка MR живёт своей жизнью: метки списка у неё нет, из очереди она не уходит и
+  остаётся в ней после слияния навсегда. Здесь она заводится проще, чем где-либо: доска
+  собирается по меткам, и метка списка, поставленная на MR, тут же делает его карточкой.
+  Находит такие сверка очереди — строкой на каждую.
+- **Конвейер судит по составу правки, а не гоняет всё подряд.** Шаги, которым нечего проверять,
+  пропускаются по признаку, посчитанному от главной ветки: ветка, не тронувшая ни строки кода,
+  не поднимает стенда, не снимает кадров и не собирает образов. Правила `rules:changes` считают
+  это сами, но по путям, а не по составу правки — совпадение пути ещё не значит, что задета
+  сборка, поэтому признак объявляется явно и один раз. Пропущенный шаг виден в прогоне
+  пропущенным — молча выпавший читается как пройденный.
+- **Отставший список находится сверкой очереди, а не глазами.** Сверка судит список по PR
   в обе стороны: открытый MR при задаче не в разборе и разбор без открытого MR — оба
   расхождения. Момента, когда задачу берут в работу, ей не видно: ветки на доске нет.
 - **Задачи, чинящиеся одной правкой, сливаются до слияния ветки.** Вторая стирается вместе с
   номером, а недостающее из неё дописывается в первую. После слияния слить уже нельзя: ветка
   въехала, и откатывается она целиком.
 - **Работа, которую одним заходом не закрыть, помечена в двух местах, и они сверяются.** Метка
-  на доске и строка о заходах с передачей в линии работ говорят одно и то же двум читателям:
-  исполнитель открывает карточку раньше, чем линию, а планирует по линии. Одна пометка без
+  на доске и строка о заходах с передачей в замысле эпика говорят одно и то же двум читателям:
+  исполнитель открывает карточку раньше, чем замысел эпика, а планирует по замыслу. Одна пометка без
   другой лжёт молча, поэтому сверка очереди судит пару в обе стороны. Помечается только то, что
   законно не делится: пометка объёма правом делить не становится.
 - **Слияние в главную ветку выкатывает прод.** Правила `only`/`rules` конвейера покрывают
@@ -88,9 +141,9 @@ description: Правило под «Закон о поставке» для д
   там кончается. Прогон команд задания на своей машине его не покрывает: он проверяет команды,
   а не файл конвейера, — верность самого файла читается только по списку конвейеров после
   пуша, и синтаксис отдельно судит проверка `.gitlab-ci.yml` в проекте.
-- **Отчёт проверяется до слияния тем же конвейером, что и главная ветка.** Проверки и сборки
+- **PR проверяется до слияния тем же конвейером, что и главная ветка.** Проверки и сборки
   образов идут на конвейере запроса слияния, выкатка — нет: её держит правило по главной ветке
-  у своего задания, а образ отчёта в реестр не уезжает.
+  у своего задания, а образ PR в реестр не уезжает.
 - **Расхождение прода с главной веткой видно сверкой очереди работ.** Задача уходит из очереди
   слиянием, но слияние — ещё не прод: отказавшая выкатка не трогает ни задачу, ни её список, и
   заметить её неоткуда. Сверка спрашивает последний конвейер главной ветки и судит только
@@ -144,7 +197,7 @@ description: Правило под «Закон о поставке» для д
 
 Гард поставки стоит на командах агента, поэтому ветку, заведённую руками в редакторе, он не
 видит: имя такой ветки держится памятью. Требование от этого не слабеет — просто отдельной
-проверки под него не заводится: работа опознаётся заголовком задачи и отчёта, а это сверяется
+проверки под него не заводится: работа опознаётся заголовком задачи и PR, а это сверяется
 у всех. Сверка очереди имя ветки не судит вовсе: у открытого MR его не переименовать.
 
 Взятие задачи в работу не стережёт ничто: доска ветки не видит, а гард поставки её видит, но
@@ -188,7 +241,7 @@ description: Правило под «Закон о поставке» для д
 - **Учётная запись для пуша и автор MR выбираются отдельно.** Если пушить пришлось из-под другой
   записи, на следующий вызов это не переносится: MR открывают токеном учётной записи машинной
   работы, и от того, чьей записью он открыт, зависит, кого можно назначить ревьювером. Однажды
-  смена записи ради пуша утекла в публикацию — отчёт вышел от владельца.
+  смена записи ради пуша утекла в публикацию — PR вышел от владельца.
 - **Невалидный файл конвейера виден отказом сразу после пуша, а не упавшим заданием.** Конвейер
   на такой файл не заводится вовсе: в списке стоит запись об ошибке разбора, а внутри нет ни
   задания, ни лога. Поэтому список конвейеров ветки смотрится тем же движением, что и пуш —

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
+```
+
 ## Как закон применяется здесь
 
 - **Пункт объявляется один раз и служит источником и меню, и гейтинга маршрутов.** Второе

package/assets/rules/{observability.md → 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
+```
+
 ## Как закон применяется здесь
 
 - **Набор разделов спека задан заранее, и отсутствие раздела — отказ.** «Не применимо» —
@@ -113,6 +138,10 @@ description: Правило под «Закон о документации пр
   паттерны, и поиск по имени правила таких не видит: сверка ищет их полем, человек — разделом
   «Паттерны» самого правила. Счёт паттернов, собранный приставками, выходит меньше настоящего, а
   число потом уезжает в деление работы.
+- **Решение из спека уходит в слой, а не в описание прошлого.** Что сверяется у спека, машина
+  знает; куда девается принятое решение — не знает и не узнает: отличить действующее требование
+  от рассказа о состоявшемся может только тот, кто спросит «останется ли это верным завтра».
+  Держится это шагом разбора закрытой работы и признаком отбора, записанным там заранее.
 - **Якорь сверяется по сырому тексту файла, и комментарий засчитывается наравне с кодом.**
   Существование символа проверка ищет словом по всему файлу, не вычищая комментарии, а живость
   считает только у объявленного в коде. Имя, стоящее в одном лишь пояснении, проходит мимо обеих
@@ -132,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-*`, а не пишется значением на месте.** Составные