@rt-tools/agent-kit 0.8.2 → 0.9.0

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

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

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: Правило под «Закон о поставке» для д
   въехала, и откатывается она целиком.
 - **Работа, которую одним заходом не закрыть, помечена в двух местах, и они сверяются.** Метка
   на доске и строка о заходах с передачей в замысле эпика говорят одно и то же двум читателям:
-  исполнитель открывает карточку раньше, чем линию, а планирует по линии. Одна пометка без
+  исполнитель открывает карточку раньше, чем замысел эпика, а планирует по замыслу. Одна пометка без
   другой лжёт молча, поэтому сверка очереди судит пару в обе стороны. Помечается только то, что
   законно не делится: пометка объёма правом делить не становится.
 - **Слияние в главную ветку выкатывает прод.** Фильтры путей конвейера покрывают документы
@@ -119,6 +168,13 @@ 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: Правило под «Закон о поставке» для д
   откатывается она целиком.
 - **Работа, которую одним заходом не закрыть, помечена в двух местах, и они сверяются.** Метка
   на борде и строка о заходах с передачей в замысле эпика говорят одно и то же двум читателям:
-  исполнитель открывает карточку раньше, чем линию, а планирует по линии. Одна пометка без
+  исполнитель открывает карточку раньше, чем замысел эпика, а планирует по замыслу. Одна пометка без
   другой лжёт молча, поэтому сверка очереди судит пару в обе стороны. Помечается только то, что
   законно не делится: пометка объёма правом делить не становится.
 - **Мерж в главную ветку выкатывает прод.** Исключения по путям покрывают только документы,
@@ -91,6 +126,12 @@ description: Правило под «Закон о поставке» для д
   умолчаниями, которые он разрешает. Умолчание образа задаётся в самом образе.
 - **Образы выкатываются по sha коммита, а не по метке «последний».** Метка в реестре отстаёт
   от главной ветки, и прод молча возвращается к прежней версии, продолжая отвечать.
+- **Убирает за собой и та машина, которая образы собирает.** Отбор у обеих один — своё имя
+  реестра, три последних sha, поднятые контейнеры остаются, — и зовётся он одним сценарием:
+  разойдясь, две чистки начали бы оставлять разное, а заметить это нечем. Отличаются они
+  хвостом: сервер снимает следом висячие слои и кэш сборки, машина сборки оставляет их себе,
+  иначе каждая сборка идёт как первая. Чистка на сборке не ждёт мержа: образ ветки занимает
+  столько же места, в реестр не уезжает вовсе и точкой отката не бывает.
 - **Выкатка убирает за собой старые образы, оставляя три последних sha.** Помеченный sha образ
   висячим не бывает никогда, и чистка висячего его не касается: за полгода они съедают диск
   сервера целиком. Три sha — это глубина отката, и меньше брать нельзя: поломка, замеченная
@@ -107,6 +148,15 @@ description: Правило под «Закон о поставке» для д
 - **PR проверяется до мержа тем же конвейером, что и главная ветка.** Проверки и сборки
   образов идут на событии `pull_request`, выкатка — нет: её держит условие по главной ветке у
   своего задания, а образ PR в реестр не уезжает.
+- **Вершина открытого PR без прогона видна сверкой очереди работ.** Страница PR без прогона
+  выглядит так же, как страница с зелёным: цвета у неё нет ни там, ни там, — и вершину, за
+  которой прогон не встал, замечали только тем, что открывали список прогонов руками. Сверка
+  спрашивает вершину, а не ветку, считает сам факт прогона, а не его цвет, и свежей вершине
+  даёт время: между пушем и прогоном проходят минуты.
+- **Черновик при зелёном прогоне на вершине — расхождение сверки.** У черновика кнопка слияния
+  заблокирована самим хостингом: зелёная страница PR владельцу ничего не разрешает, а список, в
+  котором всё серое, читается как «работа не сделана». Гард снятия черновика сюда не достаёт —
+  он судит один ход и молчит, пока ветка везёт папку своей задачи.
 - **Расхождение прода с главной веткой видно сверкой очереди работ.** Задача уходит из очереди
   мержем, но мерж — ещё не прод: отказавшая выкатка не трогает ни задачу, ни её колонку, и
   заметить её неоткуда. Сверка спрашивает последний прогон главной ветки и судит только
@@ -129,6 +179,13 @@ description: Правило под «Закон о поставке» для д
   отбивает пуш, а не печатается рядом с ним: напечатанное предупреждение исполнитель читает как
   разрешение. Дважды подряд правка, прошедшая гейт целиком, была отбита конвейером — и оба раза
   зелёный гейт был прочитан как «локально всё зелено».
+- **Сверка раскладки стоит в наборе гейта пуша наравне с линтом и сборкой.** Правка, положенная
+  в разложенную копию мимо источника, в день, когда её делают, не ломает ничего: дерево
+  работает, проверки зелёные, а расхождение видно только тому, кто позовёт сверку сам. Копится
+  оно молча и всплывает на чужой работе — раскладка отказывает по правленому файлу целиком и не
+  кладёт ни одного другого, так что цену платит тот, кто правил соседний ресурс. Статьёй выше
+  эта строка не покрывается: сверки нет в конвейере, а значит нет и шага, который она бы
+  закрывала, — в набор она ставится прямо, а не выводится из его полноты.
 - **После вливания главной ветки набор проверок пересматривается по тому, что ветка везёт
   теперь.** Вливание меняет состав правки: проверять по тому, что правил автор, — значит
   проверять половину, а отвечает ветка целиком. Ветка, не тронувшая ни строки показа, прогоняет
@@ -138,10 +195,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`.** На
@@ -223,6 +291,16 @@ description: Правило под «Закон о поставке» для д
   список прогонов ветки смотрится тем же движением, что и пуш — `gh run list --branch <ветка>`.
   Один такой отказ простоял в списке до мержа, и на него никто не посмотрел: выкатка после
   мержа отказала ровно тем же.
+- **Прогон, не вставший на пуш, возвращается повтором события, а не разбором ветки.** Замером
+  проверены обе законные дороги: и открытие PR, и пуш в уже открытый PR прогон заводят —
+  текстовый коммит и учётная запись, которой пушат, тут ни при чём. Пропавшие события пришлись
+  на час, когда хостинг отвечал `429` на загрузке действия и `503` на API, а списком прогонов
+  «не завёлся» от «не создан» не отличить. Поэтому вершину без прогона называет сверка очереди
+  работ, а событие возвращается новым коммитом либо перезакрытием PR.
+- **Красное на шаге подготовки задания — отказ хостинга, а не дефект ветки.** Раннер не смог
+  скачать действие чекаута и получил `429 Too Many Requests`; до кода прогон при этом не дошёл
+  вовсе. Лечится перезапуском прогона, и от красного по существу отличается тем, на каком шаге
+  оно встало: три прогона одного дня упали именно так.
 - **Контекст `runner` в `env` задания отбивает весь файл конвейера.** Там доступны только
   `github`, `needs`, `strategy`, `matrix`, `vars`, `secrets` и `inputs`; `runner` появляется на
   уровне шага, где то же значение приходит переменной окружения. Такой файл не принимается
@@ -233,6 +311,15 @@ description: Правило под «Закон о поставке» для д
   пересечения нет, раннер стоит `online` и не берёт ничего, а задания уходят в облако — по
   состоянию это выглядит настроенным. Владельцу называют выполненное задание с его номером, а
   не строку состояния.
+- **Раннер на своей машине делает прогон общим ресурсом, и стенд у прогонов один.** Порт,
+  имя базы и каталог сборки зашиты в дереве одним значением на всех: два прогона разом
+  поднимают два стенда на один порт, и второй падает целиком. Дороже всего не падение, а его
+  вид — в отчёте оно выглядит десятком красных спек про экраны, то есть дефектом правки,
+  которого нет; три прогона подряд так и упали на трёх ветках, не тронувших кода. Лечится с
+  двух сторон сразу: конвейеру объявляется группа очереди на всё дерево, а имена стенда
+  читаются из окружения с нынешними значениями в умолчании — иначе прогон и гейт пуша, зовущий
+  ту же команду, столкнутся и при очереди. Одной очереди мало, одних имён — тоже: прогоны делят
+  ещё диск, кэш сборщика и демон образов.
 - **Вход в реестр образов из раннера, запущенного службой, отказывает молча.** Служба идёт без
   сеанса пользователя, а клиент реестра уходит в системный помощник хранения ключей и получает
   отказ во взаимодействии — задание падает до сборки. Свой каталог настроек с пустым помощником