@rt-tools/agent-kit 0.14.0 → 0.16.0

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

@@ -2,7 +2,7 @@
 name: git-workflow
 kind: rule
 law: delivery
-description: Правило под «Закон о поставке» для дерева на GitHub. Брать на заведение задачи, ветки, коммит, пуш, создание PR, мерж, а также на правку схемы хранилища, её миграций и вызовы миграций. Называет задачу на борде как начало работы, колонку задачи как ход работы, соответствие задачи и ветки один к одному, имя ветки, формат коммита, учётную запись машинной работы, обязательный состав PR, гарды поставки и сверку очереди работ. Готовый код — в паттернах git-workflow-commit, git-workflow-pr, git-workflow-merge. Выкатка, образы и миграции — правило deploy-flow.
+description: Правило под «Закон о поставке» для дерева на GitHub. Брать на заведение задачи, ветки, коммит, пуш, открытие PR и мерж. Называет соответствие задачи и ветки один к одному, имена, машинную учётную запись и гарды поставки. Паттерны: git-workflow-commit, -pr, -merge. Выкатка — правило deploy-flow.
 ---
 
 # Поставка — как это устроено здесь
@@ -62,206 +62,179 @@ flowchart TD
 
 ## Как закон применяется здесь
 
-- **Коммит в главную ветку отбивается гардом.** Гард ищет вызов коммита в любом месте команды
-  и смотрит текущую ветку на момент запуска, поэтому составная «создать ветку и сразу
-  коммитить» отклоняется целиком: ветки в момент разбора ещё нет.
-- **Ветка без номера задачи PR не открывает.** Гард поставки отбивает `gh pr create` с такой
-  ветки: локально она законна, но правка из неё — это выкатка, за которой в очереди работ
-  ничего не стоит. Заводится задача, и работа переносится в ветку с её номером.
-- **Главная ветка влита в ветку задачи до открытия PR.** Гард поставки отбивает открытие, пока
-  вершина главной ветки не стала предком текущей, и называет расхождение числом коммитов. PR с
-  разошедшейся ветки показывает ревьюверу свою правку вперемешку с чужой, а всё, что автор
-  проверил до публикации, он проверил от основания, которого в главной ветке уже нет.
-- **Несошедшиеся условия поставки называются одним отказом, а не по одному.** Гард копит их все
-  и печатает разом. Отбитый по первому промаху исполнитель правит основание, повторяет вызов,
-  упирается в заголовок, правит заголовок, упирается в задачу — и каждый круг стоит ещё одного
-  вызова, хотя всё несошедшееся было известно уже на первом.
+- **Коммит в главную ветку отбивается гардом.** Гард ищет вызов коммита в любом месте команды и
+  смотрит текущую ветку на момент запуска: составная «создать ветку и сразу коммитить»
+  отклоняется целиком — ветки в момент разбора ещё нет.
+- **Ветка без номера задачи PR не открывает.** Локально она законна, но правка из неё — выкатка,
+  за которой в очереди работ ничего не стоит. Заводится задача, и работа переносится в ветку с
+  её номером.
+- **Главная ветка влита в ветку задачи до открытия PR.** Гард отбивает открытие, пока вершина
+  главной не стала предком текущей, и называет расхождение числом коммитов: иначе ревьювер видит
+  свою правку вперемешку с чужой, а проверено всё было от основания, которого уже нет.
+- **Несошедшиеся условия поставки называются одним отказом, а не по одному.** Гард копит их все и
+  печатает разом: круг «правь — повтори — упрись в следующее» стоит вызова за вызовом, хотя всё
+  несошедшееся известно на первом.
 - **Условие, известное в начале работы, спрашивается в начале.** Заведение ветки отбивает
-  основание, в котором нет вершины главной ветки, и рабочую копию, подписывающую коммиты не той
-  почтой, что объявило дерево. На пуше и на открытии PR те же проверки остаются вторым рубежом,
-  но там они стоят дороже: основание чинится вливанием с разбором конфликта, подпись —
-  переписыванием всей ветки.
-- **Судится то основание, которое названо командой, а не вершина рабочей копии.** Ветку заводят
-  и от `origin/main` прямо — этой командой основание как раз и берут свежим, — и гард, читающий
-  только текущую вершину, отбивал бы её наравне с веткой от вчерашнего дерева. Основание, о
-  котором дерево ничего не знает, не судится вовсе.
-- **Ветка без номера задачи условий поставки не получает.** Локальная ветка под пробу законна, и
-  требовать от неё свежего основания значило бы отбивать работу, которая в главную не поедет:
-  PR с такой ветки не откроется.
-- **Ключ задач задаётся один раз, и все три формы имени выводятся из него.** Заголовок задачи,
-  имя ветки и заголовок PR строит один и тот же ключ: команда заведения задачи собирает по
-  нему заголовок, гард поставки достаёт по нему номер из имени ветки, сверка очереди — из
-  заголовка. Форма ветки в профиле дерева пишется той же парой `<КЛЮЧ>-<номер>`, а не своей
-  похожей: разойдясь, они не отказывают, а перестают узнавать номер, и проверка, искавшая
-  работу без задачи, пропускает всё подряд.
-- **Незаданный ключ отбивает работу с очередью на месте.** Модуль борды отказывает при первом
-  же вызове и называет, где ключ задаётся. Умолчания у ключа нет намеренно: собранный из
-  пустого значения заголовок `[-317]` не совпадает ни с чем, и сверка очереди помечает
-  неправильно названной каждую задачу — настоящее расхождение тонет среди этих строк.
+  основание без вершины главной и рабочую копию с чужой почтой в подписи. На пуше и на открытии
+  PR те же проверки остаются вторым рубежом, но стоят дороже: основание чинится вливанием с
+  конфликтом, подпись — переписыванием всей ветки.
+- **Судится то основание, которое названо командой, а не вершина рабочей копии.** Ветку заводят и
+  от `origin/main` прямо — этой командой основание как раз и берут свежим. Основание, о котором
+  дерево ничего не знает, не судится вовсе.
+- **Ветка без номера задачи условий поставки не получает.** Локальная ветка под пробу законна, а
+  требовать от неё свежего основания значило бы отбивать работу, которая в главную не поедет.
+- **Ключ задач задаётся один раз, и все три формы имени выводятся из него.** По нему собирается
+  заголовок задачи, из него достаётся номер ветки, по нему же сверка читает заголовок PR. Форма
+  ветки в профиле дерева пишется той же парой `<КЛЮЧ>-<номер>`: разойдясь, они не отказывают, а
+  перестают узнавать номер — проверка, искавшая работу без задачи, пропускает всё подряд.
+- **Незаданный ключ отбивает работу с очередью на месте.** Модуль борды отказывает при первом же
+  вызове и называет, где ключ задаётся. Умолчания нет намеренно: собранный из пустого значения
+  заголовок не совпадает ни с чем, и настоящее расхождение тонет среди ложных строк.
 - **Заведённая задача подтверждается ответом очереди работ, а не выводом команды заведения.**
-  Команда отвечает за свои вызовы: она может завести задачу и не довести её до борды, и её
-  собственный разбор ошибок этот случай называет. Напечатанный номер значит «вызов прошёл», а не
-  «задача видна тому, кто по ней работает». Спрашивается очередь — по номеру, одним вызовом, — и
-  ответ читается присутствием задачи на борде, её колонкой и исполнителем.
+  Напечатанный номер значит «вызов прошёл», а не «задача видна тому, кто по ней работает»:
+  команда может завести задачу и не довести её до борды. Спрашивается очередь — по номеру, одним
+  вызовом, — и ответ читается колонкой и исполнителем.
 - **Номер ветки и номер в заголовке PR сверяются на месте, а состояние задачи — по борде.**
-  Формат читается из текста команды и работает без сети; существование задачи, её присутствие
-  на борде, её колонка, исполнитель, то, что она ещё открыта, и разбор у PR — только когда есть
-  чем спросить. Нет сети или нет токена — второй ярус молча пропускается: проверка, падающая в
-  самолёте, перестаёт что-либо значить.
-- **Колонка задачи двигается тем же движением, что и работа.** Ветка заведена — задача
-  переставляется во взятые в работу, PR открыт — в ждущие разбора; делает это команда
-  перевода, а не набор вызовов GraphQL по памяти. Перевод идёт сразу за шагом, который его
-  вызвал: очередь работ читают между шагами, а не после них.
-- **Задача, оставшаяся в первой колонке, PR не открывает.** Гард поставки называет её колонку и
-  команду перевода: по очереди работ такая задача читается как невзятая, хотя работа по ней
-  сделана и выложена. На заведении ветки колонка не спрашивается — там её ещё не двигали, и
-  требование отбивало бы первую же команду работы вместе с той, которая его и снимает. Имя
-  первой колонки дерево называет само; не названо — колонка не судится вовсе.
+  Формат читается из текста команды и работает без сети; существование задачи, колонка,
+  исполнитель и разбор — только когда есть чем спросить. Нет сети или токена — второй ярус молча
+  пропускается: проверка, падающая в самолёте, перестаёт что-либо значить.
+- **Колонка задачи двигается тем же движением, что и работа.** Ветка заведена — задача во взятых
+  в работу, PR открыт — в ждущих разбора; делает это команда перевода, а не вызовы GraphQL по
+  памяти. Перевод идёт сразу за шагом: очередь читают между шагами, а не после них.
+- **Задача, оставшаяся в первой колонке, PR не открывает.** По очереди работ она читается как
+  невзятая, хотя работа сделана и выложена. На заведении ветки колонка не спрашивается — там её
+  ещё не двигали. Имя первой колонки дерево называет само; не названо — колонка не судится.
 - **На борде стоят задачи, а не PR о них.** Борда показывает, что сделано и что осталось; PR
-  отвечает на другой вопрос — как именно сделано, — и открывается из карточки задачи, где связь
-  с ним заполняется сама полем «Linked pull requests». Карточка PR живёт своей жизнью: колонки
-  под неё нет, из очереди она не уходит и остаётся в ней после слияния навсегда. Заводится она
-  либо встроенным правилом борды, либо рукой; и то и другое выключается, а накопившееся
-  снимается. Находит их сверка очереди — строкой на каждую.
-- **Отставшая колонка находится сверкой очереди, а не глазами.** Сверка судит колонку по
-  PR в обе стороны: открытый PR при задаче не в разборе и разбор без открытого PR — оба
-  расхождения. Момента, когда задачу берут в работу, ей не видно: ветки на борде нет.
-- **Задачи, чинящиеся одной правкой, сливаются до мержа.** Вторая стирается вместе с номером,
-  а недостающее из неё дописывается в первую. После мержа слить уже нельзя: ветка въехала, и
-  откатывается она целиком.
-- **Работа, которую одним заходом не закрыть, помечена в двух местах, и они сверяются.** Метка
-  на борде и строка о заходах с передачей в замысле эпика говорят одно и то же двум читателям:
-  исполнитель открывает карточку раньше, чем замысел эпика, а планирует по замыслу. Одна пометка без
-  другой лжёт молча, поэтому сверка очереди судит пару в обе стороны. Помечается только то, что
-  законно не делится: пометка объёма правом делить не становится.
-- **Вершина открытого PR без прогона видна сверкой очереди работ.** Страница PR без прогона
-  выглядит так же, как страница с зелёным: цвета у неё нет ни там, ни там, — и вершину, за
-  которой прогон не встал, замечали только тем, что открывали список прогонов руками. Сверка
-  спрашивает вершину, а не ветку, считает сам факт прогона, а не его цвет, и свежей вершине
-  даёт время: между пушем и прогоном проходят минуты.
-- **Прогон, вытесненный из очереди конвейера, сверка называет отдельной строкой.** Ждущего
-  прогона группа очереди не бережёт: следующий встающий вытесняет прежний, и тот выглядит
-  упавшим, хотя ветку не проверял ни строчкой. Отличает их число заданий — у вытесненного оно
-  ноль; строка называет обе команды по порядку, сперва чтение прогона.
+  отвечает на другой вопрос и связывается с карточкой сам. Карточка PR колонки не имеет, из
+  очереди не уходит и остаётся навсегда — заводится она правилом борды или рукой, и то и другое
+  выключается. Находит их сверка очереди — строкой на каждую.
+- **Отставшая колонка находится сверкой очереди, а не глазами.** Сверка судит колонку по PR в обе
+  стороны: открытый PR при задаче не в разборе и разбор без открытого PR — оба расхождения.
+  Момента, когда задачу берут в работу, ей не видно: ветки на борде нет.
+- **Задачи, чинящиеся одной правкой, сливаются до мержа.** Вторая стирается вместе с номером, а
+  недостающее дописывается в первую. После мержа слить уже нельзя: ветка въехала целиком.
+- **Работа, которую одним заходом не закрыть, помечена в двух местах, и они сверяются.** Метка на
+  борде и строка о заходах в замысле эпика говорят одно и то же двум читателям, и одна без другой
+  лжёт молча. Помечается только то, что законно не делится: пометка объёма правом делить не
+  становится.
+- **Вершина открытого PR без прогона видна сверкой очереди работ.** Страница без прогона выглядит
+  так же, как с зелёным: цвета нет ни там, ни там. Сверка спрашивает вершину, а не ветку, считает
+  сам факт прогона, а не цвет, и свежей вершине даёт время.
+- **Прогон, вытесненный из очереди конвейера, сверка называет отдельной строкой.** Следующий
+  встающий вытесняет ждущего, и тот выглядит упавшим, хотя ветку не проверял ни строчкой.
+  Отличает их число заданий — у вытесненного оно ноль.
 - **Черновик при зелёном прогоне на вершине — расхождение сверки.** У черновика кнопка слияния
-  заблокирована самим хостингом: зелёная страница PR владельцу ничего не разрешает, а список, в
-  котором всё серое, читается как «работа не сделана». Гард снятия черновика сюда не достаёт —
-  он судит один ход, а PR стоит в очереди днями.
-- **Открытие PR отбивается, пока ветка везёт папку своей задачи.** Уборка стоит до открытия, а
-  не после одобрения: кнопку слияния нажимает человек на странице хостинга, где гардов нет
-  вовсе, и вливает он, как только видит зелёное. Отказ на слиянии остаётся вторым рубежом — он
-  ловит слияние, идущее командой, — но первым спрашивается открытие: это последняя точка, где
-  отказ ещё виден тому, кто может его выполнить.
-- **Конфликтующий открытый PR — расхождение сверки очереди работ.** Конфликт приезжает в
-  отданный PR чужим слиянием, без единого действия автора: основание, проверенное на открытии,
-  устаревает в ту минуту, когда владелец влил соседнюю работу. Гард снятия черновика сюда не
-  достаёт — он судит один ход, а PR стоит в очереди днями, и по списку конфликт не виден вовсе:
-  метку хостинг показывает только внутри самого PR. Непосчитанная сливаемость расхождением не
-  считается: хостинг считает её заново после каждой правки главной ветки, и строка на
-  «ещё не посчитано» краснела бы на каждой свежей вершине.
-- **Документ едет в том же коммите, что и правка.** Обход — строка `Docs-skip: <причина>` в
-  теле коммита; пустая причина не принимается.
-- **Заголовок коммита сверяется с форматом на месте.** Разобранный по типу и области
-  заголовок читается списком, а свободный текст — только целиком.
-- **Перед пушем прогоняются все линтеры, а не один.** Линтер кода обычно не читает файлы
-  стилей вовсе, и правила оформления без второго прогона не проверяет ничто.
+  заблокирована хостингом: зелёная страница PR владельцу ничего не разрешает, а список, в котором
+  всё серое, читается как «работа не сделана». Гард закрывает это внутри хода; между ходами —
+  ночью, в чужой сессии, после закрытого разговора — заявку находит сверка.
+- **Свои черновики судятся все разом, а не тот один, чья ветка сейчас взята.** Проверка по
+  текущей ветке меняет предмет суждения вместе с переключением и молчит там, где работа брошена:
+  прогон по оставленной заявке доходит, черновик стоит, главная уходит вперёд. Спрашиваются все
+  открытые черновики машинной записи, и каждый судится двумя признаками — зелёный прогон на его
+  вершине и разобранная папка задачи в его ветке; лежащая папка означает идущую работу. Дерево,
+  не назвавшее машинной записи, этого не получает.
+- **Открытие PR отбивается, пока ветка везёт папку своей задачи.** Уборка стоит до открытия:
+  кнопку слияния нажимает человек там, где гардов нет, и вливает он, как только видит зелёное.
+  Отказ на слиянии остаётся вторым рубежом, но первым спрашивается открытие — это последняя
+  точка, где отказ ещё виден тому, кто может его выполнить.
+- **Конфликтующий открытый PR — расхождение сверки очереди работ.** Конфликт приезжает в отданный
+  PR чужим слиянием, без единого действия автора, и по списку не виден вовсе: метку хостинг
+  показывает только внутри самого PR. Непосчитанная сливаемость расхождением не считается —
+  хостинг считает её заново после каждой правки главной.
+- **Документ едет в том же коммите, что и правка.** Обход — строка `Docs-skip: <причина>` в теле
+  коммита; пустая причина не принимается.
+- **Заголовок коммита сверяется с форматом на месте.** Разобранный по типу и области заголовок
+  читается списком, а свободный текст — только целиком.
+- **Перед пушем прогоняются все линтеры, а не один.** Линтер кода обычно не читает файлы стилей
+  вовсе, и правила оформления без второго прогона не проверяет ничто.
 - **Сборка входит в набор наравне с линтом и юнитами.** Линтер типов не читает, а юниты читают
-  только то, что импортировано тестом: ошибка типов в непокрытом коде доживает до сборки
-  образа, то есть до мержа. Четыре мержа подряд так и уехали в главную ветку, ломая выкатку.
+  только импортированное тестом: ошибка типов в непокрытом коде доживает до сборки образа, то
+  есть до мержа.
 - **Набор гейта пуша не бывает уже набора конвейера.** Гейт — обещание, что пуш не приедет
-  красным; набор, из которого выкинуты сборка и снимки, обещает то, чего не проверяет. Шаг
-  конвейера, которому в наборе гейта нет ни строки, ни объявленного исключения с причиной,
-  отбивает пуш, а не печатается рядом с ним: напечатанное предупреждение исполнитель читает как
-  разрешение. Дважды подряд правка, прошедшая гейт целиком, была отбита конвейером — и оба раза
-  зелёный гейт был прочитан как «локально всё зелено».
-- **Сверка раскладки стоит в наборе гейта пуша наравне с линтом и сборкой.** Правка, положенная
-  в разложенную копию мимо источника, в день, когда её делают, не ломает ничего: дерево
-  работает, проверки зелёные, а расхождение видно только тому, кто позовёт сверку сам. Копится
-  оно молча и всплывает на чужой работе — раскладка отказывает по правленому файлу целиком и не
-  кладёт ни одного другого, так что цену платит тот, кто правил соседний ресурс. Статьёй выше
-  эта строка не покрывается: сверки нет в конвейере, а значит нет и шага, который она бы
-  закрывала, — в набор она ставится прямо, а не выводится из его полноты.
+  красным; набор без сборки и снимков обещает то, чего не проверяет. Шаг конвейера, которому в
+  наборе гейта нет ни строки, ни объявленного исключения с причиной, отбивает пуш, а не
+  печатается рядом с ним: напечатанное предупреждение исполнитель читает как разрешение.
+- **Сверка раскладки стоит в наборе гейта пуша наравне с линтом и сборкой.** Правка мимо
+  источника в день, когда её делают, не ломает ничего и копится молча, а всплывает на чужой
+  работе: раскладка отказывает по правленому файлу целиком. Статьёй выше это не покрывается —
+  сверки нет в конвейере, значит нет и шага, который она бы закрывала.
 - **После вливания главной ветки набор проверок пересматривается по тому, что ветка везёт
   теперь.** Вливание меняет состав правки: проверять по тому, что правил автор, — значит
-  проверять половину, а отвечает ветка целиком. Ветка, не тронувшая ни строки показа, прогоняет
-  снимки витрин с того момента, как вливание принесло чужую правку оформления.
+  проверять половину, а отвечает ветка целиком.
 - **Утверждение о главной ветке делается по удалённой ссылке, а не по локальной.** Локальная
-  протухает в ту минуту, когда её подтянули в последний раз, и молчит об этом: она не пуста и не
-  сломана, она описывает вчерашний день. Сравнение веток пишется от `origin/main` целиком —
-  смешав в одной команде удалённую ссылку для одной стороны и локальную для другой, промах
-  изнутри выглядит правильным.
-- **Правка кода отдаётся человеку открытым PR, а не запушенной веткой.** Ветка в списке ветвей
-  ему не показывается, во входящие не приходит и обсуждения не имеет: до открытия PR правки
-  для человека нет. Открывается он тем же ходом, которым исполнитель говорит, что работу
-  отдаёт, и в ответе называется номером.
+  протухает в ту минуту, когда её подтянули, и молчит об этом. Сравнение пишется от `origin/main`
+  целиком: смешав удалённую ссылку с локальной в одной команде, промах изнутри выглядит верным.
+- **Правка кода отдаётся человеку открытым PR, а не запушенной веткой.** Ветка ему не
+  показывается, во входящие не приходит и обсуждения не имеет: до открытия PR правки для человека
+  нет. Открывается он тем же ходом, которым исполнитель говорит, что работу отдаёт.
 - **Не готовое к слиянию открывается черновиком — `gh pr create --draft`.** Кнопка слияния у
-  черновика заблокирована самим хостингом, поэтому состояние «выложено на обозрение» и
-  состояние «можно вливать» перестают выглядеть одинаково. Черновиком идёт всё, что ждёт
-  прогона конвейера, доработки или ответа на вопрос; вопрос задаётся в самом PR.
+  черновика заблокирована хостингом, поэтому «выложено на обозрение» и «можно вливать» перестают
+  выглядеть одинаково. Черновиком идёт всё, что ждёт прогона, доработки или ответа на вопрос.
 - **Черновик снимается отдельным вызовом — `gh pr ready <номер>`.** Им исполнитель отвечает за
   готовность: проверки пройдены, доработок не осталось, работа сходится с задачей. Снятие
   черновика и просьба влить — один ход, а не два разных дня.
-- **Черновик не снимается с ветки, которая не сливается.** Зелёный прогон говорит «не
-  сломано», сливаемость — «кнопку можно нажать», и владельцу нужно второе: снятый черновик он
-  читает как приглашение влить и идёт нажимать. Спрашивается это у хостинга тем же вызовом, что
-  автор и ревьювер, — `mergeable` приходит в том же ответе; выводить сливаемость из того, что
-  вливание прошло локально, нельзя: между локальным вливанием и взглядом владельца главная
-  ветка успевает уйти вперёд. За один заход так было снято три черновика подряд, и все три
-  заявки владелец увидел конфликтующими. Держится это гардом поставки, а не памятью: статья
-  стояла здесь и до того, и промах повторился в тот же день. Дерево, чей помощник очереди работ
-  о сливаемости не говорит вовсе, работает как прежде — поля нет, требования нет.
+- **Черновик не снимается с ветки, которая не сливается.** Зелёный прогон говорит «не сломано»,
+  сливаемость — «кнопку можно нажать», и владельцу нужно второе. Спрашивается у хостинга тем же
+  вызовом, что автор и ревьювер: `mergeable` приходит в том же ответе. Выводить её из локального
+  вливания нельзя — между ним и взглядом владельца главная уходит вперёд. Дерево, чей помощник
+  очереди о сливаемости не говорит, работает как прежде: поля нет, требования нет.
 - **Указателю, в который ветки только дописывают строки, объявляется сложение обеих сторон.**
-  Конфликт там не спор: обе допись нужны целиком, а зовёт он человека при каждом слиянии в
-  главную ветку — за один заход одна и та же строка разрешалась шесть раз в шести ветках.
-  Объявление снимает ручное разрешение: слияние проходит само. **Метку сливаемости на странице
-  заявки оно при этом не снимает** — хостинг считает её своим приёмом и настройки слияния не
-  читает. Гаснет метка только после того, как ветка вобрала главную и это уехало на хостинг.
-  Обещать по этому объявлению «конфликтов больше не будет» нельзя: не будет ручной работы, а
-  вливать главную в открытые ветки после каждого слияния придётся по-прежнему.
-- **Разрешённый конфликт, оставшийся незапушенным, хуже неразрешённого.** Владелец видит
-  прежнее состояние и читает его как «не сделано ничего», а сделанное лежит в рабочем дереве
-  исполнителя, где его не видит никто. Ветка, в которой разрешён конфликт, пушится тем же
-  ходом — либо конфликт не разрешается вовсе.
-- **Черновик не снимается, пока у PR нет разбора.** Гард поставки смотрит запрошенного ревьювера
-  и оставленный отзыв: снятый черновик читается как «можно вливать», а вливать некому. Раньше
-  этого хода спросить негде — до открытия PR ревьювера нет вовсе. Судится и вызов без номера:
-  без него клиент берёт PR текущей ветки, и требование снималось бы одним пробелом. Возврат PR
-  в черновик — `gh pr ready --undo` — требования не получает: он делает то же, чего гард и
-  добивается.
-- **Мерж PR нажимает человек, а не исполнитель работы.** Кнопка и вызов слияния равны: запрет
-  на них один. Исполнитель сливает свой PR только тогда, когда человек сказал это прямо и про
-  этот PR; сказанное об одном PR на следующий не переносится, а молчание разрешением не
-  бывает. Работа кончается PR, с которого снят черновик, и в ответе называется его номер.
-- **Личность вызова, открывающего заявку, стережёт гард поставки, а не память исполнителя.**
-  Она приходит окружением, и из текста команды видна только явной подстановкой токена — её гард
-  и требует, называя переменную и готовую строку; дерево, не назвавшее машинной записи,
-  требования не получает. Ответ хостинга об авторе он спрашивает позже, на снятии черновика:
-  это последний ход, где промах ещё исправим — влитую заявку не переоткрыть, а автора у неё не
-  сменить. Прежде обе стороны держались статьёй и разбором происшествия, и промах повторился на
-  третий день.
+  Конфликт там не спор: обе допись нужны целиком, а человека он зовёт при каждом слиянии.
+  Объявление снимает ручное разрешение, но **метку сливаемости не гасит**: хостинг считает её
+  своим приёмом и настроек слияния не читает — гаснет она, когда ветка вобрала главную и это
+  уехало на хостинг.
+- **Правка, доведённая до коммита, доводится до хостинга тем же ходом.** Владелец видит прежнее
+  состояние и читает его как «не сделано ничего», а сделанное лежит там, где его не видит никто.
+  Оставшееся в дереве называется причиной — словом владельца, а не списком остатков.
+- **Черновик не снимается, пока у PR нет разбора.** Гард смотрит запрошенного ревьювера и
+  оставленный отзыв: снятый черновик читается как «можно вливать», а вливать некому. Раньше этого
+  хода спросить негде. Судится и вызов без номера — без него клиент берёт PR текущей ветки, и
+  требование снималось бы одним пробелом.
+- **Мерж PR нажимает человек, а не исполнитель работы.** Кнопка и вызов слияния равны: запрет на
+  них один. Исполнитель сливает свой PR только тогда, когда человек сказал это прямо и про этот
+  PR; сказанное об одном на следующий не переносится, а молчание разрешением не бывает.
+- **Личность вызова, открывающего заявку, стережёт гард поставки, а не память исполнителя.** Она
+  приходит окружением и из текста команды видна только явной подстановкой токена — её гард и
+  требует; дерево, не назвавшее машинной записи, требования не получает. Ответ хостинга об авторе
+  он спрашивает на снятии черновика: это последний ход, где промах исправим — влитую заявку не
+  переоткрыть, а автора у неё не сменить.
 
 - **Автор PR не может быть его ревьювером.** Запрос разбора на самого себя GitHub принимает и
-  молча не создаёт — разбор при этом выглядит запрошенным. Поэтому в разборе считаются только
-  запрос и отзыв не от автора: гард снятия черновика читает состояние PR именно так.
+  молча не создаёт — разбор при этом выглядит запрошенным. В разборе считаются только запрос и
+  отзыв не от автора.
+- **Вызов клиента хостинга идёт из дерева, а связка команд исхода не проверяет.** Репозиторий
+  клиент берёт у текущего каталога и вне дерева отказывает; следующее звено связки увозит на
+  хостинг то, что осталось от отказавшего, поэтому тело читается обратно тем же ходом.
 - **Метки, исполнитель и ревьювер PR ставятся вызовами `gh api`, а не `gh pr edit`.** На
-  репозитории со старой бордой `gh pr edit` отвечает отказом про Projects (classic) и до
-  правки не доходит вовсе.
-- **Борда правится запросом GraphQL по идентификатору проекта.** `gh project` с `--owner`
-  отвечает `unknown owner type`, когда владелец борды — не та учётная запись, под которой
-  идёт вызов.
+  репозитории со старой бордой `gh pr edit` отвечает отказом про Projects (classic) и до правки
+  не доходит.
+- **Борда правится запросом GraphQL по идентификатору самой борды, а не по имени владельца.**
 - **Почта машинного коммита копируется из компаньона, а не набирается по памяти.** Служебный
-  адрес GitHub — `<число>+<логин>@users.noreply.github.com`, и сопоставляется он по числу: логин
-  рядом с ним не сверяет никто. Коммит с чужим числом уезжает подписанным посторонним человеком,
-  а изнутри промах не виден — имя учётной записи в истории то самое. Ту же строку держит профиль
-  дерева, и гард поставки отбивает пуш при расхождении.
+  адрес — `<число>+<логин>@users.noreply.github.com`, и сопоставляется он по числу: логин рядом с
+  ним не сверяет никто. Коммит с чужим числом уезжает подписанным посторонним, а изнутри промах
+  не виден. Ту же строку держит профиль дерева, и гард отбивает пуш при расхождении.
 - **Личность машинной записи подтверждается ответом хостинга, а не узнаванием строки.** Знакомый
-  вид строки подтверждением не бывает — промах выглядел знакомо. Спрашивается токеном самой
-  записи, ответом о себе: логин и число приходят вместе. Поиск по числу для ограниченной записи
-  отвечает «не найдено» и её собственным токеном, поэтому годится только ответ о себе.
-- **Сценарии гардов задают настройки git сами, а не берут их с машины.** Коммит во временном
-  репозитории сценария наследует общий конфиг: если включена подпись, git идёт в агент ключей,
-  а заблокированный агент роняет весь набор — со стороны это выглядит сломанным гардом. Автор,
-  почта и подпись передаются флагами `-c` прямо в команду.
+  вид строки подтверждением не бывает. Спрашивается токеном самой записи, ответом о себе: логин и
+  число приходят вместе — поиск по числу для ограниченной записи отвечает «не найдено».
+- **Сценарии гардов задают настройки git сами, а не берут их с машины.** Включённая на машине
+  подпись уводит git в агент ключей, а заблокированный агент роняет весь набор — со стороны это
+  выглядит сломанным гардом. Автор, почта и подпись передаются флагами `-c` прямо в команду.
+
+- **Каждый коммит вклада ветки подписан машинной записью, и это проверяется набором пуша.** Гард
+  поставки судит только коммит, назвавшийся ею, и подписанный человеком проходит мимо: там, где
+  человек не коммитит вовсе, это промах, а не законный случай.
+- **Состояние заявки перечитывается у хостинга сразу после публикации, а не берётся из кода
+  возврата.** Открытие заявки и постановка ревьювера отвечают нулём и тогда, когда сделали не то
+  или не сделали ничего.
+- **Автор открытой заявки и наличие у неё ревьювера сверяются очередью работ.** До слияния оба
+  промаха не видны ничем: заявка, открытая человеком, ревьювера не получит никогда, и выглядит
+  это как заявка, которой его просто не поставили.
+- **Ревьюверы спрашиваются вызовом REST, а не выборкой клиента.** Её поля собираются запросом
+  GraphQL, а тот требует области чтения организации, которой у машинной записи нет: «сошлось»
+  перестаёт отличаться от «спросить было нечем».
+- **Силовая отправка ветки, стоящей под другой в стопке, закрывает её заявку как слитую.**
+  Хостинг считает заявку слитой, когда вершина её ветки достижима из базы; состояние лживое — в
+  главной ветке правки нет, а задача остаётся открытой.
 
 ## Чего из закона здесь нет
 

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

@@ -2,7 +2,7 @@
 name: git-workflow
 kind: rule
 law: delivery
-description: Правило под «Закон о поставке» для дерева на GitLab. Брать на заведение задачи, ветки, коммит, пуш, создание MR, слияние, а также на правку схемы хранилища, её миграций и вызовы миграций. Называет задачу на борде как начало работы, колонку задачи как ход работы, соответствие задачи и ветки один к одному, имя ветки, формат коммита, учётную запись машинной работы, обязательный состав MR, гарды поставки и сверку очереди работ. Готовый код — в паттернах git-workflow-commit, git-workflow-pr, git-workflow-merge. Выкатка, образы и миграции — правило deploy-flow.
+description: Правило под «Закон о поставке» для дерева на GitLab. Брать на заведение задачи, ветки, коммит, пуш, открытие MR и слияние. Называет соответствие задачи и ветки один к одному, имена, машинную учётную запись и гарды поставки. Паттерны: git-workflow-commit, -pr, -merge. Выкатка — правило deploy-flow.
 ---
 
 # Поставка — как это устроено здесь

package/assets/rules/lib-layers.md

@@ -2,7 +2,7 @@
 name: lib-layers
 kind: rule
 law: lib-imports
-description: Правило под «Закон об импортах между либами». Брать при правке project.json, tsconfig.base.json, eslint/boundaries/**, любого src/index.ts и проверок раскладки, а также когда решается, где живёт общий символ. Называет семьи, слои, теги и границы этого дерева. Готовый порядок действий — в паттернах lib-layers-new и lib-layers-move.
+description: Правило под «Закон об импортах между либами». Брать при правке манифестов проектов, путей сборки, границ линтера, любого барреля и проверок раскладки, а также когда решается, где живёт общий символ. Паттерны: lib-layers-new, lib-layers-move.
 ---
 
 # Импорты между либами — как это устроено здесь

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

@@ -2,7 +2,7 @@
 name: observability
 kind: rule
 law: observability
-description: Правило под «Закон о наблюдаемости». Брать при правке логгера, контекста запроса, домена отказов и домена оповещений, при заведении новой строки лога и когда решается, что владелец узнает об отказе. Называет уровни, номер обращения, вычистку секретов, сводку старта и то, что уходит наружу при отказе. Готовый код — в паттерне observability-record.
+description: Правило под «Закон о наблюдаемости». Брать при правке логгера, контекста запроса, домена отказов и оповещений, при заведении новой строки лога и когда решается, что владелец узнает об отказе. Паттерн observability-record.
 ---
 
 # Наблюдаемость — как это устроено здесь

package/assets/rules/platform-access.md

@@ -2,7 +2,7 @@
 name: platform-access
 kind: rule
 law: frontend-application
-description: Правило под «Закон о фронтовом приложении». Брать, когда правка задевает глобальный объект или среду исполнения — window, globalThis, PLATFORM_ID, isPlatformBrowser, document.defaultView, localStorage, IntersectionObserver. Называет токены DI, приведение типа и подводные камни отдачи страницы сервером. Не действует под libs/api и apps/api. Готовый код — в паттерне platform-access-di.
+description: Правило под «Закон о фронтовом приложении». Брать, когда правка задевает глобальный объект или среду исполнения — window, globalThis, PLATFORM_ID, localStorage. Называет токены DI и подводные камни отдачи страницы сервером. Под libs/api и apps/api не действует. Паттерн platform-access-di.
 ---
 
 # Окружение браузера — как это устроено здесь

package/assets/rules/reuse-first.md

@@ -2,7 +2,7 @@
 name: reuse-first
 kind: rule
 law: reuse-first
-description: Правило под «Закон о единообразии приложения». Брать перед заведением любого нового экрана, компонента, поля, стора, сервиса, маппера или процедуры — на что опираться, что уже готово в ките и базовых классах, по каким признакам видно, что готовое обошли. Что делать, когда готового не хватило, — в паттерне reuse-first-extend.
+description: Правило под «Закон о единообразии приложения». Брать перед заведением любого нового экрана, компонента, поля, стора, сервиса, маппера или процедуры: на что опираться и по каким признакам видно, что готовое обошли. Паттерн reuse-first-extend.
 ---
 
 # Единообразие — как это устроено здесь

package/assets/rules/seo.md

@@ -2,7 +2,7 @@
 name: seo
 kind: rule
 law: search-visibility
-description: Правило под «Закон о видимости в поиске». Брать при любой правке, доходящей до разметки публичного сайта — шаблоны страниц, meta/title/description, JSON-LD, canonical, hreflang, маршруты сайта, sitemap, robots, nginx. Называет локали перевода, где что лежит и чего у нас нет. Готовый код — в паттернах seo-page и seo-verify.
+description: Правило под «Закон о видимости в поиске». Брать при любой правке, доходящей до разметки публичного сайта: шаблоны страниц, мета-теги, микроразметка, канонический адрес, языковые версии, карта сайта. Паттерны: seo-page, seo-verify.
 ---
 
 # Видимость в поиске — как это устроено здесь
@@ -116,8 +116,9 @@ flowchart TD
 
 ## Чего из закона здесь нет
 
-Листинга объектов нет — корень локали отдаёт единственный объект. Появится листинг —
-канонический адрес корня пересматривается; это `Q-SV-1` в законе.
+Что отдаёт корень локали — единственную запись или список, — правило не утверждает: это
+состояние дерева, и живёт оно в компаньоне рядом. Развилка от этого не исчезает: там, где
+список появляется, канонический адрес корня пересматривается; это `Q-SV-1` в законе.
 
 ## Паттерны
 

package/assets/rules/shared-code.md

@@ -2,7 +2,7 @@
 name: shared-code
 kind: rule
 law: shared-code
-description: Правило под «Закон об общем коде приложений». Брать, когда значение должно одинаково пониматься сайтом, админкой и бэкендом — предел выборки, набор операторов условия, направление порядка, длина поля, форма запроса и ответа списка. Называет, что берётся из @rt-tools/utils, что из @<область>/common/util и что ловит check:dupes. Готовый код — в паттерне shared-code-new.
+description: Правило под «Закон об общем коде приложений». Брать, когда значение должно одинаково пониматься сайтом, админкой и бэкендом: предел выборки, набор операторов условия, длина поля, форма запроса и ответа списка. Паттерн shared-code-new.
 ---
 
 # Общий код — как это устроено здесь