@rt-tools/agent-kit 0.22.0 → 0.24.0

package/assets/rules/autonomous-work.md

@@ -0,0 +1,92 @@
+---
+name: autonomous-work
+kind: rule
+law: autonomous-work
+description: Правило под «Закон об автономном заходе». Брать, когда владелец ушёл и просил работать самостоятельно: череда веток, умолчание вместо вопроса, местная работа без отдачи наружу, список сделанного к утру. Паттерн autonomous-work-run. Ход одной работы — правило task-flow.
+---
+
+# Автономный заход — как это устроено здесь
+
+Правило под закон `docs/constitution/autonomous-work.md`. Закон говорит, что должно быть верно,
+когда владельца нет рядом; здесь — чем это названо в дереве и что меняется в обычном ходе
+работы. Сам ход работы — правило `task-flow`, конец хода — `turn-conduct`, поставка —
+`git-workflow`: автономный заход их не отменяет, а сужает.
+
+## Как это называется здесь
+
+| В законе                      | Здесь                                                                        |
+| ----------------------------- | ---------------------------------------------------------------------------- |
+| автономный заход              | просьба владельца работать без него, названная словами и границей по времени |
+| умолчание вместо вопроса      | строка «Решения» в разборе просьбы: принятое, довод и цена ошибки            |
+| работа, видная снаружи        | пуш ветки, открытие заявки, слияние, публикация пакета, отправка груза       |
+| череда                        | ветка каждой следующей работы заводится от ветки предыдущей                  |
+| список к утру                 | последняя реплика захода: работа, ветка, чем подтверждена, чего ждёт         |
+| отложенная работа             | задача, которой нужно слово владельца: состояние на борде не двигается       |
+
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом: чем объявляется автономный заход, где
+ведётся список к утру и какой ключ у задач череды. Пути живут там, а не здесь: правило
+переносится между репозиториями, а раскладка у каждого дерева своя.
+
+## Ход
+
+```mermaid
+flowchart TD
+    A[Владелец объявил автономный заход] --> B[Берётся задача из очереди работ]
+    B --> C{Нужно слово владельца}
+    C -->|Да| D[Задача откладывается целиком, довод пишется в список к утру]
+    C -->|Нет| E[Ветка заводится от предыдущей работы, а не от главной]
+    E --> F[Папка задачи, разбор просьбы с умолчаниями, замысел]
+    F --> G[Работа этапами; каждый этап кончается коммитом]
+    G --> H{Признак готовности проверяется командой}
+    H -->|Нет команды| D
+    H -->|Есть| I[Прогон; красное чинится в той же ветке]
+    I --> J[Папка задачи разбирается в описание прошлого]
+    J --> K{Ночь не кончилась}
+    K -->|Да| B
+    K -->|Нет| L[Список к утру: что сделано, где лежит, чем подтверждено, чего ждёт]
+    D --> K
+```
+
+## Как закон применяется здесь
+
+- **Ветка следующей работы заводится от предыдущей, а не от главной.** Первая — от главной,
+  каждая следующая — от вершины прошлой: `git checkout -b <ключ>-<номер>-<slug> <прошлая ветка>`.
+  Владелец вливает их по очереди снизу вверх, и заявка каждой стоит на предыдущей.
+- **Наружу за ночь не уходит ничего.** Ни пуша, ни заявки, ни слияния, ни публикации, ни
+  отправки груза в приём: всё это видно другим, а отменяет их человек. Отметки груза,
+  требующие слияния, тоже ждут — они утверждают то, чего в главной ветке ещё нет.
+- **Задача, которой нужно слово владельца, не берётся вовсе.** Её состояние на борде не
+  двигается: взятая и отложенная задача выглядит начатой, а следующий заход её пропускает.
+- **Умолчание записывается там же, где записался бы ответ владельца.** Строкой в разборе
+  просьбы: что принято, почему и что будет стоить ошибка. Молчаливое умолчание неотличимо от
+  знания.
+- **Признак готовности называется командой до начала этапа.** Взгляд исполнителя в автономном
+  заходе не подтверждает ничего: проверить его некому до утра.
+- **Красный прогон чинится в той же ветке, а не откладывается.** Отложенный, он достаётся
+  владельцу вместе с веткой, которую нельзя влить.
+- **Отказ стража — шаг работы, а не конец захода.** Он называет пропущенное; пропущенное
+  делается, и работа идёт дальше. Обход стража остаётся запрещённым и в автономном заходе.
+- **Список к утру пишется по ходу, а не вспоминается в конце.** Каждая закрытая работа
+  дописывает свою строку: ночь длиннее окна, и вспомнить её целиком к утру нечем.
+
+## Чего из закона здесь нет
+
+Границы захода по времени не проверяет ничто: заход кончается тогда, когда кончилась работа или
+владелец сказал слово. Соблюдение запрета на видимое снаружи держится тем же — правилом, а не
+стражем: команда пуша ничем не отличается от той, что делается днём.
+
+## Паттерны
+
+- `autonomous-work-run` — готовый цикл ночи: череда веток, запись умолчания, список к утру,
+  разбор отказа стража.
+
+## Ловушки
+
+- **Ветка, заведённая от главной по привычке, ломает череду.** Заметно это только у владельца и
+  только на втором вливании; чинится перезаведением ветки, пока работа не ушла далеко.
+- **Задача, отложенная без строки в списке, теряется.** Утром её не видно ни на борде, ни в
+  ветках: она выглядит просто не взятой.
+- **Умолчание, записанное в теле коммита, до владельца не доходит.** Он читает список и папку
+  задачи, а не историю ветки.

package/assets/rules/browser-verification.md

@@ -74,11 +74,15 @@ flowchart TD
   профиль обошли этой дверью дважды за один заход.
 - **Выбор браузера протухает и требует повторного вызова.** Выбор, сделанный в начале
   сессии, не держится: после паузы следующий вызов открывает вкладку в другом профиле молча.
+- **Отказ выбора профиля кончает работу с браузером, а не начинает поиск обхода.** Профиля среди
+  подключённых нет — значит, вести некого: состав вкладок, переход и снимок уйдут в тот браузер,
+  который расширение считает активным, и какой это, не знает никто. Состояние называется владельцу
+  словом, и работа через браузер стоит до его ответа.
 - **Профиль не выбирается из списка и не спрашивается у владельца.** Список отдаёт неустойчивые
   имена, которые не опознают ничего, а выбор из него ведёт на профиль без входа.
 - **Ненастроенная стража — повод остановиться, а не разрешение ехать.** Пропуск гарда при
   молчащем помощнике сделан затем, чтобы сломанная обвязка не заводила работу в тупик, и
-  разрешением работать мимо профиля не является. Исполнитель, получивший от помощника пустой
+  разрешением работать мимо профиля не считается. Исполнитель, получивший от помощника пустой
   вывод, называет это владельцу и браузер не водит: вкладка откроется в том профиле, который
   расширение сочло активным, а какой это профиль — не знает никто.
 - **Экран, закрытый входом, проверяется стендом с подменённым ответом входа, а не живой учётной
@@ -86,16 +90,37 @@ flowchart TD
   стенд; признак, которым закрыт экран, приходит подменённым профилем. Просьба к человеку сделать
   шаг проверки — набрать пароль, открыть вкладку, нажать кнопку — означает неверно выбранный
   путь, а не нехватку прав у исполнителя.
+- **Правка числа элементов в контейнере — это правка раскладки.** Стили она не трогает, и потому
+  читается как правка разметки, а проверка сводится к кодам ответа: страницы отвечают на всех
+  локалях, а документ уже вдвое шире вьюпорта. Закрывается она замером — ширина документа против
+  ширины вьюпорта на узком экране, — а не взглядом на снимок: снимок показывает то, что влезло в
+  кадр. Ряд без переноса и без узкой раскладки, выросший с четырёх элементов до восьми, продержал
+  боковую прокрутку на каждой странице сайта сорок четыре минуты прода.
 - **Замер делается на самом длинном значении, а не на образцовом.** Наезд, вылезание за край и
   обрезка без признака видны только там, где содержимое в своё место не влезает; на коротком
   значении всё три выглядят исправными. Значение для замера берётся предельное — то, какое узел
   может получить у настоящего потребителя, а не то, какое стоит в примере.
-- **Готовое из набора, взятое под данные другого размера, меряется, а не разглядывается.**
+- **Готовое из набора, взятое под значения другого размера, меряется, а не разглядывается.**
   Компонент, живший там, где значения короткие, в новом месте получает значение вчетверо
   длиннее — и ведёт себя иначе, оставаясь тем же кодом. Спека этого не видит вовсе: обрезка
   браузером в разметке не отражается, и текст приходит из неё целым.
+- **Прокси стенда подставляет то, по чему приложение узнаёт арендатора запроса.** Дерево, которое
+  держит несколько организаций за одним приложением, узнаёт их по заголовку, а сервер отрисовки
+  кладёт туда свой хост: приложение отвечает отказом на каждый вызов. Снаружи это страница «не
+  найдено» — выглядит как дефект кода, а не стенда. Замер тремя заголовками на одном стенде: свой
+  хост с портом — отказ, свой хост без порта — отказ, имя арендатора — страница. Отличает одно от
+  другого подстановка заголовка, а не чтение кода.
 - **Прод-конфигурация проверяется только за настоящим прокси.** Голый сервер отдачи страниц
   про кэш, перенаправления и заголовки не знает ничего.
+- **Показанное человеку собрано из той работы, о которой идёт речь.** Стенд собирается с ветки
+  этой правки, а не с той, на которой стоит исполнитель: сборка с чужой ветки показывает дерево
+  без правки, и человек читает это как «не сделано». Сказанное о показанном называет ветку, с
+  которой оно собрано. Один такой показ стоил двух ходов: владелец повторил замечание, по
+  которому правка давно сделана, а исполнитель взялся объяснять уже исправленный дефект.
+- **Ветка работы держит вершину главной влитой всё время, а не только перед отдачей.** Отставшая
+  ветка собирается в стенд, на котором нет ни чужих правок, ни своих соседних, и показанное на
+  нём описывает дерево, которого нет ни у кого. Вершина подтягивается, когда о её движении стало
+  известно, а не когда работа кончилась.
 - **Первый заход на публичный экран метится признаком служебного посещения.** Драйвер водит
   обычный браузер, и счётчик посещений не отличает проверку от гостя: `navigator.webdriver` у
   него `false`, строка `User-Agent` — живого браузера. Чем метится заход, сказано в именах
@@ -115,7 +140,14 @@ flowchart TD
   «что тут происходит», а не подтверждает известное число. Вывод «замер снять нечем», сделанный
   на закрытом входе, чаще всего означает, что искали не тем.
 
-Вывод о вёрстке подкрепляется числом: «выглядит нормально» результатом проверки не является.
+- **Замер снимается до показа работы владельцу, а не после его замечания.** Показанное без
+  замера — заявка на проверку, а не проверка: на снимке слипшиеся вплотную карточки читаются как
+  одна с длинным содержимым, обрезанная тень — как её отсутствие, нулевой промежуток — как плотная
+  вёрстка. Каждый такой дефект виден одной командой замера. Числа, снятые с образца заранее,
+  сверяются с реализацией тем же ходом: работа по пересказу образца словами расходится с ним
+  незаметно.
+
+Вывод о вёрстке подкрепляется числом: «выглядит нормально» результатом проверки не бывает.
 Этого не стережёт ничто — как измерять, разобрано в паттерне `browser-verification-measure`.
 
 ## Чего из закона здесь нет

package/assets/rules/deploy-flow.azure.md

@@ -96,6 +96,13 @@ flowchart TD
   тот, кто пушит.** Оно законно несёт след любой недоделанной ветки, и сверка с ним держала бы
   чужую правку. Гейт и выкатка зовут одну и ту же проверку — иначе «сошлось» станет значить в
   двух местах разное.
+- **Пропуск сверки схемы законен, пока ветка не трогала хранилища.** Погашенная база — состояние
+  машины, а не повод отбить пуш документации; но ветка, правившая схему или миграции, без прогона
+  цепочки уезжает в главную вслепую, и падает не она, а выкатка. Проверка в такой ветке отказывает
+  и называет, чем базу поднять.
+- **Упавшая выкатка видна сверкой очереди работ отдельно от отставшего прода.** Слияние — ещё не
+  выкатка: отказавшая оставляет главную ветку впереди сервера, и слияния поверх уедут туда же.
+  Отставание считается по последней успешной выкатке и «не запускали» от «упала» не отличает.
 
 - **Проверка, стоящая в наборе гейта, отказывает, когда не сумела отработать.** «Проверять
   негде» и «проверка сломана» — разные вещи: первое дерево называет само — нет предмета, не задан

package/assets/rules/deploy-flow.github.md

@@ -123,6 +123,13 @@ flowchart TD
   тот, кто пушит.** Оно законно несёт след любой недоделанной ветки, и сверка с ним держала бы
   чужую правку. Гейт и выкатка зовут одну и ту же проверку — иначе «сошлось» станет значить в
   двух местах разное.
+- **Пропуск сверки схемы законен, пока ветка не трогала хранилища.** Погашенная база — состояние
+  машины, а не повод отбить пуш документации; но ветка, правившая схему или миграции, без прогона
+  цепочки уезжает в главную вслепую, и падает не она, а выкатка. Проверка в такой ветке отказывает
+  и называет, чем базу поднять.
+- **Упавшая выкатка видна сверкой очереди работ отдельно от отставшего прода.** Слияние — ещё не
+  выкатка: отказавшая оставляет главную ветку впереди сервера, и слияния поверх уедут туда же.
+  Отставание считается по последней успешной выкатке и «не запускали» от «упала» не отличает.
 
 - **Проверка, стоящая в наборе гейта, отказывает, когда не сумела отработать.** «Проверять
   негде» и «проверка сломана» — разные вещи: первое дерево называет само — нет предмета, не задан

package/assets/rules/deploy-flow.gitlab.md

@@ -98,6 +98,13 @@ flowchart TD
   тот, кто пушит.** Оно законно несёт след любой недоделанной ветки, и сверка с ним держала бы
   чужую правку. Гейт и выкатка зовут одну и ту же проверку — иначе «сошлось» станет значить в
   двух местах разное.
+- **Пропуск сверки схемы законен, пока ветка не трогала хранилища.** Погашенная база — состояние
+  машины, а не повод отбить пуш документации; но ветка, правившая схему или миграции, без прогона
+  цепочки уезжает в главную вслепую, и падает не она, а выкатка. Проверка в такой ветке отказывает
+  и называет, чем базу поднять.
+- **Упавшая выкатка видна сверкой очереди работ отдельно от отставшего прода.** Слияние — ещё не
+  выкатка: отказавшая оставляет главную ветку впереди сервера, и слияния поверх уедут туда же.
+  Отставание считается по последней успешной выкатке и «не запускали» от «упала» не отличает.
 
 - **Проверка, стоящая в наборе гейта, отказывает, когда не сумела отработать.** «Проверять
   негде» и «проверка сломана» — разные вещи: первое дерево называет само — нет предмета, не задан

package/assets/rules/doc-style.md

@@ -107,6 +107,13 @@ flowchart TD
   имена веток и правила линтеров: выглядят адресом, адресом не являются.
   <!-- rt-when: *.md -->
 
+- **Файл, положенный раскладкой, пары не требует.** Автор у него в дереве-потребителе один —
+  пакет, и документ о нём лежит там же. Требование пары читает шапку раскладки: она стоит в
+  каждом разложенном файле и отличает его от написанного здесь надёжнее любого перечня путей.
+  Иначе первая же раскладка требует обход на весь свой объём, а обход, объявленный на сотню
+  файлов, снимает требование и с будущих правок этих файлов вручную.
+  <!-- rt-when: *.md -->
+
 - **Документ едет в том же коммите, что и правка, которую он описывает.** Обход — строка
   `Docs-skip: <причина>` в теле коммита; пустая причина не принимается.
   <!-- rt-when: *.md -->
@@ -126,6 +133,19 @@ flowchart TD
   строка в шапке дешевле правки всех ссылающихся записей и прошлого не трогает.
   <!-- rt-when: *.md -->
 
+- **Словарь правится там, откуда он собирается, а не там, где читается.** Он уезжает в контекст
+  каждой сессии целиком и оттого читается обычным документом дерева, а собран он раскладкой, как
+  всякий ресурс с шапкой: правка на месте живёт до следующей раскладки и пропадает молча, а до
+  тех пор раскладка отказывает по словарю целиком. Адрес надстройки называет компаньон правила, и
+  вводная, которую печатает хук запуска, выводит его из шапки сама.
+  <!-- rt-when: *.md -->
+
+- **Раздел надстройки замещает одноимённый раздел набора целиком, а не дописывает в него.** Своё
+  слово поэтому кладётся в свой раздел, названный иначе, чем любой из разделов набора: положенное
+  в одноимённый, оно уносит с собой весь пакетный раздел, и потеря видна только тому, кто помнит,
+  что там стояло.
+  <!-- rt-when: *.md -->
+
 - **Словарь работы и язык экрана — два разных словаря.** Слово, которым слой правил зовёт своё
   понятие, для человека за экраном ничего не значит: он не читал ни одного правила и читать не
   будет. Термин словаря в подписи кнопки, колонки или пустого состояния — это внутреннее слово,
@@ -156,6 +176,34 @@ flowchart TD
   схема набрана словами и от текста рядом отличима только чтением.
   <!-- rt-when: *.md -->
 
+## Тексты для человека
+
+- **У текста есть адресат, и слог выбирается по нему, а не по тому, что писалось до него.**
+  Правила, законы и спеки читает тот, кто работает внутри слоя правил; задачу, заявку и ответ в
+  чате — человек снаружи. Текст, написанный сразу после правки спеки, наследует её слог: изнутри
+  он выглядит точным, а для читателя снаружи пуст. Адресат проверяется до первой строки.
+  <!-- rt-when: задача, описание заявки, ответ владельцу -->
+
+Задачу в очереди, описание заявки и ответ в чате читает владелец. Он помнит продукт и не читал
+ни одного правила слоя: слова слоя для него пустые. Форма ответа о состоянии работы — правило
+`status-report`; здесь язык, каким написаны все три текста.
+
+- **Текст для владельца пишется словами продукта, а не словами слоя правил.** Что человек видит,
+  что у него не работает, что с этим сделали. Заявка, прогон, набор, объём правки,
+  договорённость — это слова слоя; в тексте для владельца они заменяются на те, которыми зовёт
+  их он сам. Иначе он читает текст о своей же работе и не узнаёт в нём ни одного экрана.
+  <!-- rt-when: задача, описание заявки, ответ владельцу -->
+
+- **Из задачи видно, что сломалось у человека, а не только где красная проверка.** Задача,
+  описанная именами файлов и номерами проверок, не даёт решить, срочная она или нет: цена
+  промаха видна по тому, чего человек не может сделать.
+  <!-- rt-when: задача, описание заявки, ответ владельцу -->
+
+- **Страдательный залог и метафоры в этих текстах не пишутся.** «Работа отдана» и «красное
+  въехало» звучат весомо и не называют ни действия, ни того, кто его сделал. Владелец решает по
+  ним, что делать дальше, и решать ему не по чему.
+  <!-- rt-when: задача, описание заявки, ответ владельцу -->
+
 ## Чего из закона здесь нет
 
 Ни одна из формулировочных договорённостей не проверяется: одна фраза на правило, простые
@@ -163,6 +211,11 @@ flowchart TD
 оставляет автору: открытый вопрос пишется теми же словами, что и обещание, а дата и номер —
 такие же числа, как то, что пересчитывают.
 
+Ответ владельцу не читает ни одна проверка, а промахи в нём те же, что в тексте дерева:
+выдуманный факт, поданный наравне с проверенным, и оценка чужого решения вместо исполнения.
+Ловит их только владелец — то есть уже прочитав. Правило действует на ответ так же, как на файл;
+разница в том, что за файл отвечает гейт, а за ответ — автор.
+
 На комментарии в коде правило распространяется, но гейтом не требуется: он зовёт его только
 на `.md`. Расширять требование на каждый `.ts` значило бы шуметь на каждой правке, поэтому
 здесь оно держится памятью автора — и цена этого видна: слова из левой колонки словаря живут
@@ -173,6 +226,7 @@ flowchart TD
 
 - `doc-style-write` — как формулировать: примеры «так» и «не так», правила для комментариев.
 - `doc-style-sweep` — разбор документа, накопившего список работ, на действующее и закрытое.
+- `doc-style-human` — форма задачи, описания заявки и ответа владельцу: образцы «так» и «не так».
 - `doc-style-trace` — обратный проход: закрытые задачи против текстов, поиск того, чего не
   написали.
 

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

@@ -168,6 +168,10 @@ flowchart TD
   отбивает пуш, а не печатается рядом с ним: напечатанное предупреждение исполнитель читает как
   разрешение. Дважды подряд правка, прошедшая гейт целиком, была отбита конвейером — и оба раза
   зелёный гейт был прочитан как «локально всё зелено».
+- **Итоговый набор перед пушем читается разбором состояния, а не сборкой в уме.** Он собирается
+  из умолчания пакета и надстройки дерева, и прочитать сборку было нечем: раздел «набор перед
+  пушем» печатает его целиком, по команде на строку, а рядом называет то, что умолчание печатало,
+  а в набор не попало. Дерево, писавшее надстройку вслепую, дописывало в неё повтор.
 - **Причина исключения, называющая задачу, судится на живость этой задачи.** Отсрочка со сроком
   и отсрочка без срока выглядят одинаково, пока номер никто не спросил; мёртвый номер в причине
   делает исключение бессрочным, не сказав об этом ни строкой. Спрашивается тем же ярусом, что
@@ -189,6 +193,10 @@ flowchart TD
   сломана, она описывает вчерашний день. Сравнение веток пишется от `origin/main` целиком —
   смешав в одной команде удалённую ссылку для одной стороны и локальную для другой, промах
   изнутри выглядит правильным.
+- **Удалённую ссылку берут не только слова, но и действия.** Основание новой ветки, счёт влитого
+  и подтягивание главной судятся по ней же: локальная — снимок последнего подтягивания, и работа,
+  начатая от неё, стартует от основания, которого в главной уже нет. Влитая ветка при ней числится
+  невлитой, и уборка кончается списком невлитого, которого нет.
 - **Рабочий элемент привязывается к PR при создании, а не после.** `az repos pr create`
   принимает `--work-items`; привязка второй командой обходится молча, когда у токена нет права
   править чужой элемент, и PR остаётся ни с чем не связанным.

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

@@ -69,15 +69,15 @@ flowchart TD
   за которой в очереди работ ничего не стоит. Заводится задача, и работа переносится в ветку с
   её номером.
 - **Главная ветка влита в ветку задачи до открытия PR.** Гард отбивает открытие, пока вершина
-  главной не стала предком текущей, и называет расхождение числом коммитов: иначе ревьювер видит
-  свою правку вперемешку с чужой, а проверено всё было от основания, которого уже нет.
+  главной не стала предком текущей: иначе ревьювер видит свою правку вперемешку с чужой, а
+  проверено всё было от основания, которого уже нет.
 - **Волна веток от одной главной проверяется пробным слиянием, а не по одной:** каждая зелена
-  сама по себе, а сталкиваются они тем, чего на отдельной ветке не видно.
+  сама по себе, а сталкиваются тем, чего на отдельной ветке не видно.
 - **Ветка следующей работы отводится от предыдущей, пока череда не прервалась.** `git checkout -b
-  <КЛЮЧ>-<номер>-<slug> <предыдущая ветка>` вместо `origin/main`; от главной — только первая работа
-  череды. Иначе первое же слияние делает расходящимися все остальные разом.
+  <КЛЮЧ>-<номер>-<slug> <предыдущая ветка>` вместо `origin/main`; от главной — первая работа
+  череды. Иначе первое слияние разводит все остальные разом.
 - **У заявки в череде основанием стоит предыдущая ветка, а не главная.** `gh pr create --base
-  <предыдущая ветка>` — иначе разбор показывает свою правку вперемешку со всем, что под ней. Базу
+  <предыдущая ветка>` — иначе разбор показывает правку вперемешку со всем, что под ней. Базу
   влитой нижней хостинг переносит сам.
 - **Череда вливается снизу вверх, и порядок стоит в теле каждой заявки.** Родство веток по
   списку не видно: строка «стоит на #<номер>» — единственное место, где владелец это прочтёт.
@@ -87,9 +87,9 @@ flowchart TD
   владельца, разбирающего то же при слиянии, нет ни одной.
 - **Несошедшиеся условия поставки называются одним отказом.** Гард копит их и печатает разом: всё
   несошедшееся известно на первом вызове.
-- **Условие, известное в начале работы, спрашивается в начале.** Заведение ветки отбивает основание
-  без вершины главной и чужую почту в подписи. На пуше те же проверки стоят дороже: основание
-  чинится вливанием с конфликтом, подпись — переписыванием ветки.
+- **Условие, известное в начале работы, спрашивается в начале.** Заведение ветки отбивает
+  основание без вершины главной и чужую почту в подписи; на пуше то же чинится вливанием с
+  конфликтом и переписыванием ветки.
 - **Судится то основание, которое названо командой, а не вершина рабочей копии.** Ветку заводят и
   от `origin/main` прямо — этой командой основание как раз и берут свежим. Основание, о котором
   дерево ничего не знает, не судится вовсе.
@@ -99,11 +99,10 @@ flowchart TD
   заголовок задачи, из него достаётся номер ветки, по нему же сверка читает заголовок PR. Форма
   ветки в профиле дерева пишется той же парой `<КЛЮЧ>-<номер>`.
 - **Незаданный ключ отбивает работу с очередью на месте.** Модуль борды отказывает при первом же
-  вызове и называет, где ключ задаётся. Умолчания нет намеренно: собранный из пустого значения
-  заголовок не совпадает ни с чем, и настоящее расхождение тонет среди ложных строк.
+  вызове и называет, где ключ задаётся. Умолчания нет намеренно: заголовок из пустого значения
+  не совпадает ни с чем, и настоящее расхождение тонет среди ложных строк.
 - **Заведённая задача подтверждается ответом очереди работ, а не выводом команды заведения.**
   Напечатанный номер значит «вызов прошёл»: задачу можно завести и не довести до борды.
-  Спрашивается очередь по номеру, и ответ читается колонкой и исполнителем.
 - **Видимость заведённого проверяется той стороной, которой оно предназначено.** Заявку читает
   человек, задачу — очередь работ, и оба читают не тем токеном, которым заводили: ограниченная
   запись отвечает им «не найдено», а заводившей — успехом.
@@ -120,16 +119,14 @@ flowchart TD
   невзятая, хотя работа сделана и выложена. На заведении ветки колонка не спрашивается — там её
   ещё не двигали. Имя первой колонки дерево называет само; не названо — колонка не судится.
 - **На борде стоят задачи, а не PR о них.** Карточка PR колонки не имеет, из очереди не уходит и
-  остаётся навсегда; заводит её правило борды или рука, и то и другое выключается. Находит такие
-  карточки сверка очереди — строкой на каждую.
+  остаётся навсегда. Находит такие карточки сверка очереди — строкой на каждую.
 - **Отставшая колонка находится сверкой очереди, а не глазами.** Она судит колонку по PR в обе
   стороны: открытый PR при задаче не в разборе и разбор без открытого PR. Момента, когда задачу
   берут в работу, ей не видно: ветки на борде нет.
 - **Ветка с открытой заявкой отстаёт от главной молча.** Основание гард судит раз, в минуту
   открытия, а влитого после не видит и прогон. Отставание считает сверка очереди работ.
 - **Связь задачи с эпиком сверка читает в обе стороны.** Односторонняя привязка выглядит целой
-  так же, как двусторонняя: читатель приходит то от замысла эпика, то от карточки. Держалась она
-  подражанием — тело с образца соседней задачи везло строку вместе с формой.
+  так же, как двусторонняя: читатель приходит то от замысла эпика, то от карточки.
 - **Задачи, чинящиеся одной правкой, сливаются до мержа.** Вторая стирается вместе с номером, а
   недостающее дописывается в первую: после мержа ветка въехала целиком.
 - **Работа, которую одним заходом не закрыть, помечена в двух местах, и они сверяются.** Метка на
@@ -138,25 +135,25 @@ flowchart TD
 - **Вершина открытого PR без прогона видна сверкой очереди работ.** Страница без прогона выглядит
   так же, как с зелёным: цвета нет ни там, ни там. Сверка спрашивает вершину, считает сам факт
   прогона, а не цвет, и свежей вершине даёт время.
+- **Заявка, чья база — не главная ветка, проверяется тем же набором, что и заявка в главную.**
+  Условие запуска конвейера читает базу, и заявка в соседнюю ветку не поднимает его вовсе: пустое
+  поле проверок читается как ожидание очереди. Спрашивается это до открытия первой заявки стопки,
+  и заявка без прогона на вершине не сливается — приём в паттерне `git-workflow-stack`.
 - **Прогон, вытесненный из очереди конвейера, сверка называет отдельной строкой.** Он выглядит
   упавшим, хотя ветку не проверял; отличает их число заданий — у него ноль.
-- **Черновик при зелёном прогоне на вершине — расхождение сверки.** Зелёная страница черновика
-  владельцу ничего не разрешает: кнопка заблокирована хостингом. Внутри хода это закрывает гард,
-  между ходами — сверка.
-- **Свои черновики судятся все разом, а не тот один, чья ветка сейчас взята.** Каждый черновик
-  машинной записи судится двумя признаками — зелёный прогон на его вершине и разобранная папка
-  задачи в его ветке; лежащая папка означает идущую работу.
+- **Черновик при зелёном прогоне на вершине — расхождение сверки.** Зелёная страница ничего не
+  разрешает: кнопка заблокирована хостингом. В ходе это закрывает гард, между ходами — сверка.
+- **Свои черновики судятся все разом, а не тот один, чья ветка взята.** Признака два — зелёный
+  прогон на вершине и разобранная папка задачи в ветке; лежащая папка означает идущую работу.
 - **Открытие PR отбивается, пока ветка везёт папку своей задачи.** Кнопку слияния нажимает
-  человек там, где гардов нет, и открытие — последняя точка, где отказ ещё виден тому, кто может
-  его выполнить.
+  человек там, где гардов нет: открытие — последняя точка, где отказ ещё виден исполнителю.
 - **Свои открытые заявки перечитываются в трёх местах: перед пушем, при взятии задачи и после
   каждого известного слияния.** Заявка устаревает без действия автора: влита соседняя работа —
   остальные в ту же секунду отстали. Приём — `git-workflow-freshness`.
 - **Конфликтующая своя заявка чинится первым действием хода, а новая работа до этого не
-  берётся.** Пока отданное конфликтует, влить его человек не может, и каждая следующая заявка
-  прибавляет к очереди ещё одну, которую придётся догонять. Работой здесь считается заведение
-  задачи, заведение ветки, перевод колонки в работу и открытие заявки; всё, чем конфликт чинится,
-  идёт как прежде.
+  берётся.** Пока отданное конфликтует, влить его человек не может. Работой здесь считается
+  заведение задачи, заведение ветки, перевод колонки в работу и открытие заявки; всё, чем
+  конфликт чинится, идёт как прежде.
 - **Конфликтующий открытый PR — расхождение сверки очереди работ.** Конфликт приезжает чужим
   слиянием и по списку не виден: метку хостинг показывает только внутри самого PR.
 - **Документ едет в том же коммите, что и правка.** Обход — строка `Docs-skip: <причина>` в теле
@@ -168,30 +165,30 @@ flowchart TD
 - **Сборка входит в набор наравне с линтом и юнитами.** Линтер типов не читает, а юниты читают
   только импортированное тестом: ошибка типов в непокрытом коде доживает до сборки образа, то
   есть до мержа.
-- **На машине, где раннеров несколько, любой путь от домашнего каталога общий.** Умолчание
-  готового шага опасно именно тем, что оно общее: соседнее задание переписывает его под свою
-  версию, пока наше стоит между шагами. Каталог установки, имя контейнера и имя сборщика
-  называются поэтому по проекту и постоянно, а временный каталог решением не бывает — в нём
-  живёт хранилище пакетов.
-- **Набор гейта пуша не бывает уже набора конвейера.** Гейт — обещание, что пуш не приедет
-  красным. Шаг конвейера, которому в наборе гейта нет ни строки, ни объявленного исключения с
-  причиной, отбивает пуш, а не печатается рядом: предупреждение читается как разрешение.
-- **Набор гейта зовёт умолчание пакета, а не перечисляет его строками.** Переписанный строками, он
-  закрывает сегодняшнюю дыру и оставляет завтрашнюю: заведённая пакетом проверка до дерева не
-  доедет. Отсеивать из умолчания законно, но поимённо и с причиной.
-
+- **На машине, где раннеров несколько, любой путь от домашнего каталога общий.** Соседнее задание
+  переписывает умолчание готового шага под свою версию, пока наше стоит между шагами. Каталог
+  установки, имя контейнера и имя сборщика называются поэтому по проекту и постоянно, а временный
+  каталог решением не бывает — в нём живёт хранилище пакетов.
+- **Набор гейта пуша не бывает уже набора конвейера.** Шаг конвейера, которому в наборе нет ни
+  строки, ни объявленного исключения с причиной, отбивает пуш, а не печатается рядом:
+  предупреждение читается как разрешение.
+- **Набор гейта зовёт умолчание пакета, а не перечисляет его строками.** Переписанный строками,
+  он оставляет завтрашнюю дыру: заведённая пакетом проверка до дерева не доедет. Отсеивать из
+  умолчания законно, но поимённо и с причиной.
+- **Итоговый набор перед пушем читается разбором состояния, а не сборкой в уме.** Раздел «набор
+  перед пушем» печатает его целиком и называет рядом то, что умолчание печатало, а в набор не
+  попало: дерево, писавшее надстройку вслепую, дописывало в неё повтор.
 - **Причина исключения, называющая задачу, судится на живость этой задачи.** Мёртвый номер делает
-  исключение бессрочным, не сказав об этом ни строкой. Спрашивается тем же ярусом, что состояние
-  задачи у гарда: нет сети или доступа — пропускает молча.
-- **Сверка раскладки стоит в наборе гейта пуша наравне с линтом и сборкой.** Правка мимо источника
-  копится молча: раскладка отказывает по правленому файлу целиком. Статьёй выше это не покрывается —
-  сверки нет в конвейере.
+  исключение бессрочным молча. Спрашивается тем же ярусом, что состояние задачи у гарда.
+- **Сверка раскладки стоит в наборе гейта пуша наравне с линтом и сборкой.** Правка мимо
+  источника копится молча, а сверки нет в конвейере.
 - **После вливания главной ветки набор проверок пересматривается по тому, что ветка везёт
-  теперь.** Вливание меняет состав правки: проверять по тому, что правил автор, — значит
-  проверять половину, а отвечает ветка целиком.
-- **Утверждение о главной ветке делается по удалённой ссылке, а не по локальной.** Локальная
-  протухает в минуту, когда её подтянули, и молчит об этом. Сравнение пишется от `origin/main`
-  целиком: смешанные в одной команде, они дают промах, изнутри выглядящий верным.
+  теперь.** Проверять по тому, что правил автор, — значит проверять половину: отвечает ветка
+  целиком.
+- **Главная ветка берётся удалённой ссылкой — и в словах, и в действиях.** Локальная — снимок
+  вчерашнего дня, и молчит она об этом. От `origin/main` идут и сравнение, и основание новой
+  ветки, и счёт влитого: при локальной влитая ветка числится невлитой, а уборка кончается
+  списком невлитого, которого нет.
 - **Правка кода отдаётся человеку открытым PR, а не запушенной веткой.** Ветка во входящие не
   приходит и обсуждения не имеет: до открытия PR правки для человека нет. Открывается он тем же
   ходом, которым исполнитель говорит, что работу отдаёт.
@@ -221,31 +218,29 @@ flowchart TD
   хостинга об авторе гард спрашивает на снятии черновика: влитую заявку не переоткрыть.
 
 - **Автор PR не может быть его ревьювером.** Запрос разбора на себя GitHub принимает и молча не
-  создаёт: разбор выглядит запрошенным. Считаются только запрос и отзыв не от автора.
+  создаёт. Считаются только запрос и отзыв не от автора.
 - **Вызов клиента хостинга идёт из дерева, а связка команд исхода не проверяет.** Вне дерева
-  клиент отказывает, а следующее звено связки увозит на хостинг остаток отказавшего: тело
-  читается обратно тем же ходом.
-- **Метки, исполнитель и ревьювер PR ставятся вызовами `gh api`, а не `gh pr edit`:** на старой
-  борде тот отвечает отказом про Projects.
+  клиент отказывает, а следующее звено увозит на хостинг остаток отказавшего.
+- **Метки, исполнитель и ревьювер PR ставятся вызовами `gh api`, а не `gh pr edit`:** тот
+  отвечает отказом про Projects.
 - **Борда правится запросом GraphQL по идентификатору борды, а не по имени владельца.**
 - **Почта машинного коммита копируется из компаньона, а не набирается по памяти.** Адрес
-  `<число>+<логин>@users.noreply.github.com` сходится по числу: с чужим числом коммит уезжает
-  подписанным посторонним. Ту же строку держит профиль дерева, и гард отбивает пуш.
+  `<число>+<логин>@users.noreply.github.com` сходится по числу: с чужим коммит уезжает подписанным
+  посторонним. Ту же строку держит профиль дерева, и гард отбивает пуш.
 - **Личность машинной записи подтверждается ответом хостинга, а не узнаванием строки:** её
   спрашивают токеном, и логин с числом приходят вместе.
 - **Сценарии гардов задают настройки git сами, а не берут их с машины.** Подпись с машины уводит
-  git в агент ключей, а заблокированный агент роняет весь набор: автор, почта и подпись идут
-  флагами `-c` прямо в команде.
+  git в агент ключей, а заблокированный агент роняет набор: автор, почта и подпись идут флагами
+  `-c` в команде.
 
 - **Каждый коммит вклада ветки подписан машинной записью, и это проверяется набором пуша.** Гард
-  судит только коммит, назвавшийся ею: подписанный человеком проходит мимо.
+  судит коммит, назвавшийся ею; подписанный человеком проходит мимо.
 - **Состояние заявки перечитывается у хостинга сразу после публикации.** Открытие и постановка
   ревьювера отвечают нулём и тогда, когда не сделали ничего.
 - **Автор открытой заявки и наличие у неё ревьювера сверяются очередью работ.** До слияния оба
-  промаха не видны: заявка, открытая человеком, ревьювера не получит никогда — и выглядит как
-  заявка, которой его не поставили.
+  промаха не видны: открытая человеком заявка ревьювера не получит никогда.
 - **Ревьюверы спрашиваются вызовом REST, а не выборкой клиента.** Её поля собирает GraphQL, прав
-  на который у машинной записи нет: «сошлось» не отличить от «спросить было нечем».
+  на который у записи нет: «сошлось» неотличимо от «спросить было нечем».
 
 - **Рабочее дерево не опустошается ради прогона инструмента.** Сравнение идёт на второй копии:
   прятанье уводит незакоммиченную работу туда, где её не видит ни состояние дерева, ни сверка.
@@ -272,3 +267,4 @@ flowchart TD
 - `git-workflow-merge` — главная ветка влита в ветку задачи, конфликт разобран.
 - `git-workflow-stack` — череда веток: ветвление от предыдущей, основание заявки, порядок отдачи.
 - `git-workflow-freshness` — свои открытые заявки: чтение всех разом, отставание против спора.
+- `git-workflow-pr-ready` — доведение отданного: снятый черновик, разбор красного, волна по череде.

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

@@ -170,6 +170,10 @@ flowchart TD
   отбивает пуш, а не печатается рядом с ним: напечатанное предупреждение исполнитель читает как
   разрешение. Дважды подряд правка, прошедшая гейт целиком, была отбита конвейером — и оба раза
   зелёный гейт был прочитан как «локально всё зелено».
+- **Итоговый набор перед пушем читается разбором состояния, а не сборкой в уме.** Он собирается
+  из умолчания пакета и надстройки дерева, и прочитать сборку было нечем: раздел «набор перед
+  пушем» печатает его целиком, по команде на строку, а рядом называет то, что умолчание печатало,
+  а в набор не попало. Дерево, писавшее надстройку вслепую, дописывало в неё повтор.
 - **Причина исключения, называющая задачу, судится на живость этой задачи.** Отсрочка со сроком
   и отсрочка без срока выглядят одинаково, пока номер никто не спросил; мёртвый номер в причине
   делает исключение бессрочным, не сказав об этом ни строкой. Спрашивается тем же ярусом, что
@@ -191,6 +195,10 @@ flowchart TD
   сломана, она описывает вчерашний день. Сравнение веток пишется от `origin/main` целиком —
   смешав в одной команде удалённую ссылку для одной стороны и локальную для другой, промах
   изнутри выглядит правильным.
+- **Удалённую ссылку берут не только слова, но и действия.** Основание новой ветки, счёт влитого
+  и подтягивание главной судятся по ней же: локальная — снимок последнего подтягивания, и работа,
+  начатая от неё, стартует от основания, которого в главной уже нет. Влитая ветка при ней числится
+  невлитой, и уборка кончается списком невлитого, которого нет.
 - **Слияние по кнопке «Merge when pipeline succeeds» не заменяет проверок до пуша.** Конвейер
   видит только то, что уже отправлено, а отправленная красная ветка занимает очередь работ и
   выглядит готовой к разбору.