@rt-tools/agent-kit 0.17.0 → 0.19.0

package/assets/pitfalls/task-flow.md

@@ -7,6 +7,20 @@
 
 ## Ловушки
 
+- **Разрешение владельца, оставленное в репозитории, теряется на каждой новой ветке.** Оно
+  записано номером в файл ветки, а следующая ветка отводится от главной и его не несёт: гард
+  отбивает работу, которую владелец разрешил, — и повторяется это ровно столько раз, сколько
+  веток заведут до слияния разрешившего коммита. Отказ гарда при этом называет файл и молчит о
+  том, что запись принадлежит ветке: из его текста это читается как настройка дерева. Пока
+  разрешение живёт в репозитории, номер дописывается заново в каждую новую ветку.
+- **Имя чужого дерева в файлы репозитория не пишется, а путь к образцу — пишется.** Обе вещи
+  живут рядом с передачей захода именно поэтому: там законен полный путь, а в репозитории —
+  только ссылка без имени.
+- **Строка «Ждём владельца» в ходе работы живёт дольше причины, по которой её написали.** Она
+  лежит на диске, приходит в контекст следующим заходом и читается как действующее состояние —
+  поэтому снимается тем же ходом, которым владелец ответил. Иначе ожидание подтверждает себя
+  само: три указания владельца подряд не пересилили одной строки на диске.
+
 - **Папка называется именем ветки, один в один.** Хук запуска ищет её по
   `git branch --show-current`, и папка, названная иначе, не находится ничем: работа идёт с
   пустым контекстом, а владельца просят пересказать то, что уже записано.
@@ -181,3 +195,9 @@
 - **Прогон, поставленный первым шагом закрытия, съедает окно захода.** Он стоит дороже всех
   остальных шагов вместе, и потративший его на прогон упирался в порог заполнения на четырёх
   строках привязки — то есть на работе, которая стоила бы минуты, если бы шла первой.
+- **Разрешение работать вне назначенного эпика принадлежит рабочему дереву, а не ветке.**
+  Записанное в файл репозитория, оно уезжает вместе с веткой: из соседней его не видно, и гард
+  эпика отбивает ровно ту работу, которую владелец разрешил. За один заход это случилось дважды
+  — сперва на отказе конца хода, потом на переводе колонки, и оба раза номер дописывался заново.
+  Место такому разрешению там же, где передача захода: оно не откатывается вместе с правкой и не
+  принадлежит ни одной задаче.

package/assets/pitfalls/testing.md

@@ -7,6 +7,12 @@
 
 ## Ловушки
 
+- **Зелёный тест чистой функции молчит о ряде, которого рабочий путь не порождает.** Функция
+  верна на том, что ей подали, а подаёт ей ввод сам тест: ряд, собранный ради удобства
+  проверки, доказывает поведение на случае, которого в работе не бывает. Так стояли два зелёных
+  теста решения об оповещении, а предохранитель, ради которого решение писали, не сработал ни
+  разу. Форма ввода берётся с той границы, откуда решение зовут, — у процедуры, у службы, у
+  обработчика, — и сверяется с ней, а не выдумывается рядом с проверкой.
 - **Зелёный `nx test <проект>` не значит, что хоть один файл исполнялся.** Либа без своего
   `vitest.config.mts` не запускает ничего — так тесты домена броней не запускались ни разу.
   Либа с конфигом, но без единого `*.spec.ts`, проходит зелёной из-за `passWithNoTests: true`,

package/assets/pitfalls/turn-conduct.md

@@ -45,3 +45,38 @@
 - **Замер, разбитый на уведомления по шагам, съедает ходы вхолостую.** Каждый его шаг назначает
   себе ход, а наполнить ход нечем: дерево под идущей серией трогать нельзя, и остаётся пересказ
   того, что придёт следующей строкой. Одно ожидание, кончающееся вместе с замером, стоит один ход.
+- **Отказ гарда разбирается чтением его кода, а не перебором форм вызова.** Второй отказ подряд
+  по одному требованию означает, что перебирается не та ось: адрес меняли, а решала форма
+  команды — вызов там считался по первому слову строки, и все восемь попыток начинались с входа
+  в каталог. Дальше открывается сам гард и профиль, на который он ссылается, целиком, включая
+  ветку, до которой перебор не дошёл. Чтение гарды пропускают всегда, в том числе после порога
+  остановки.
+
+- **Механизм называется сломанным только после того, как прочитан целиком.** Разбор по половине
+  кода звучит тем убедительнее, чем подробнее написан, и владелец принимает его за проверенный.
+  Признак непрочитанного один: имя функции, названное в разборе, но не открытое.
+
+- **Работа не передаётся владельцу словами «сделай сам», пока не прочитан механизм, который её
+  отбивает.** Готовая команда с объяснением «у меня не выйдет» выглядит помощью и ею не
+  работает: она переносит на владельца незакрытое чтение. Длинная череда отказов доводом здесь
+  не бывает — она говорит о том, сколько раз повторили одно движение, а не о том, что механизм
+  неисправен.
+
+- **Неудобство исполнителя решения владельца не пересматривает.** Принятое решение об отправке —
+  открыть заявку, отдать работу, показать сделанное — не отменяется тем, что путь к нему оказался
+  длиннее ожидаемого. Довод «так выйдет дольше» говорит о цене, а платит её не тот, кто решение
+  принимал: цена называется владельцу вместе со сделанным шагом, а не вместо него. Отличить этот
+  случай от законного вопроса просто — законный вопрос про то, чего исполнитель не знает, а этот
+  про то, чего ему не хочется.
+
+- **Страж выхода судит изменение дерева, а не оставшееся действие.** Он спрашивает, сделано ли за
+  ход хоть что-то, — и ход, в котором закрыта половина этапа, а вторая брошена на отбитой
+  команде, ему неотличим от полной работы: коммиты есть, дерево изменилось. Ловится им только ход,
+  кончившийся ничем. Осталось ли в состоянии действие, не зависящее от того, чего ход ждёт,
+  проверяет вниманием тот, кто ведёт ход.
+- **Отбитое разрешение чужим шагом не бывает, и работу оно не останавливает.** Статья о чужом
+  шаге написана про то, что идёт само и кончится без исполнителя: прогон, разбор, слияние.
+  Разрешение, отбитое средой, само не кончится — оно ждёт слова владельца, — и работа, упершаяся
+  в него, встаёт целиком там, где мимо него шло ещё несколько ходов дела. Делается всё, что от
+  разрешения не зависит, а несделанное называется в теле заявки, разделом об оставшемся шаге:
+  он ровно про это и написан.

package/assets/rules/browser-verification.md

@@ -67,6 +67,11 @@ flowchart TD
   идентификатору процесса, а не по имени команды — у обоих экземпляров оно одно.
 - **Браузер водится одним драйвером на закреплённом профиле.** Остальные двери — второй
   драйвер, `open`, `osascript`, запуск бинарника — закреплённый профиль не спрашивают вовсе.
+- **Браузер, поднятый библиотекой изнутри скрипта, — та же дверь, что и запуск бинарника.** В
+  строке команды её не видно вовсе: там стоят имя интерпретатора и путь файла, а вождение лежит
+  внутри самого файла. Поэтому судится содержимое запускаемого файла и код, переданный доводом
+  вместо файла; правило, судившее одну командную строку, обещало больше, чем проверяло, и
+  профиль обошли этой дверью дважды за один заход.
 - **Выбор браузера протухает и требует повторного вызова.** Выбор, сделанный в начале
   сессии, не держится: после паузы следующий вызов открывает вкладку в другом профиле молча.
 - **Профиль не выбирается из списка и не спрашивается у владельца.** Список отдаёт неустойчивые
@@ -185,3 +190,17 @@ flowchart TD
   проверки, не говорит про образ ничего: в составе прода она есть, а ручной прогон того же
   образа идёт без неё. Пути перечисляются до проверки, а не после того, как один из них
   сошёлся.
+- **Признак снимается с вопроса владельца, а не с предмета правки.** Отданная сервером страница
+  отвечает на «собралось ли», и на «видно ли» она не отвечает никогда: показ живёт после
+  гидратации, а картинка — после запроса к чужой службе. Признаки под второй вопрос свои —
+  `naturalWidth` у картинки больше нуля, узел показа появился на поднятой странице, — и снимаются
+  они драйвером, а не запросом к адресу.
+- **Чужой отказ службы диагнозом настройки не бывает.** `403` называет состояние проекта у
+  поставщика и молчит о том, какое значение лежит в настройке дерева; прочитанный как диагноз, он
+  уводит в починку того, что цело, — а само значение читается одной командой на своей стороне.
+  Владельцу оно тем более не заказывается: у захода оно уже есть.
+- **Прежнее поведение читается кодом той версии:** `git show <коммит до правки>:<файл>`. Тело
+  коммита называет, что правка сменила, и молчит о том, что было верно до неё; условие показа, в
+  которое дописано ещё одно обязательное значение, гасит показанное раньше и в самой правке
+  выглядит уточнением. Правка соседней задачи, выкатившаяся тем же днём, входит в проверку прода
+  наравне со своей: ветка отвечает за то, что уехало вместе с ней.

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

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

package/assets/rules/doc-style.md

@@ -150,6 +150,12 @@ flowchart TD
   который сослался. Живой текст называет решение словами, а не адресом записи.
   <!-- rt-when: *.md -->
 
+- **Схема правится тем же изменением, что и текст, который она изображает.** Разойдясь, схема и
+  проза остаются читаемыми обе, и первым это замечает тот, кто пошёл по схеме: она короче, её
+  читают вместо текста, и расхождение уводит работу целиком. Ни одна проверка этого не видит —
+  схема набрана словами и от текста рядом отличима только чтением.
+  <!-- rt-when: *.md -->
+
 ## Чего из закона здесь нет
 
 Ни одна из формулировочных договорённостей не проверяется: одна фраза на правило, простые

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

@@ -131,9 +131,17 @@ flowchart TD
 - **Отставшее состояние находится сверкой очереди, а не глазами.** Сверка судит состояние по
   PR в обе стороны: открытый PR при элементе не в разборе и разбор без открытого PR — оба
   расхождения. Момента, когда задачу берут в работу, ей не видно: ветки на доске нет.
+- **Ветка с открытой заявкой отстаёт от главной молча.** Гард судит основание один раз — в
+  минуту открытия; всё, что влилось в главную, пока шёл прогон, зелёный прогон не видит вовсе, и
+  влитая оттуда заявка приносит в главную ветку сочетание, которое не проверял никто. Отставание
+  находит сверка очереди работ: она спрашивает у хранилища, на сколько коммитов ветка каждой
+  открытой заявки позади главной, и называет число.
 - **Задачи, чинящиеся одной правкой, сливаются до слияния ветки.** Вторая закрывается как
-  дубликат, а недостающее из неё дописывается в первую. После слияния слить уже нельзя: ветка
-  въехала, и откатывается она целиком.
+  дубликат, а недостающее из неё дописывается в первую. Закон велит вторую стереть, и это второе
+  объявленное отступление: у рабочего элемента здесь есть родная связь «дубликат», удаление
+  уносит вместе с ним историю правок и вложения, а номер после него не переиспользуется —
+  ссылка на стёртый элемент из чужого коммита ведёт в пустоту. После слияния слить уже нельзя:
+  ветка въехала, и откатывается она целиком.
 - **Работа, которую одним заходом не закрыть, помечена в двух местах, и они сверяются.** Метка
   на доске и строка о заходах с передачей в замысле эпика говорят одно и то же двум читателям:
   исполнитель открывает карточку раньше, чем замысел эпика, а планирует по замыслу. Одна пометка без
@@ -192,6 +200,13 @@ flowchart TD
 
 ## Чего из закона здесь нет
 
+Ключа задач у этого хостинга нет, и форма имени строится из одного номера. Закон требует писать
+номер всюду одинаково — «ключ, дефис, номер», — и это отступление от него, объявленное здесь:
+номер рабочего элемента уникален на весь проект, а родная форма ссылки хостинга — `AB#<номер>` —
+ключа не несёт вовсе, и приписанный к ней он ломает связывание коммита с элементом. Настройки
+`board.taskKey` дерево на этом хостинге не заводит; проверки, которые ищут ключ в заголовке,
+судят здесь номер без него.
+
 Гард поставки стоит на командах агента, поэтому ветку, заведённую руками в редакторе, он не
 видит: имя такой ветки держится памятью. Требование от этого не слабеет — просто отдельной
 проверки под него не заводится: работа опознаётся заголовком рабочего элемента и PR, а это

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

@@ -71,28 +71,25 @@ flowchart TD
 - **Главная ветка влита в ветку задачи до открытия PR.** Гард отбивает открытие, пока вершина
   главной не стала предком текущей, и называет расхождение числом коммитов: иначе ревьювер видит
   свою правку вперемешку с чужой, а проверено всё было от основания, которого уже нет.
+- **Волна веток от одной главной проверяется пробным слиянием, а не по одной:** каждая зелена
+  сама по себе, а сталкиваются они тем, чего на отдельной ветке не видно.
 - **Ветка следующей работы отводится от предыдущей, пока череда не прервалась.** `git checkout -b
-  <КЛЮЧ>-<номер>-<slug> <предыдущая ветка>` вместо `origin/main`; от главной — только первая
-  работа череды и та, что предыдущей не касается. Иначе первое же слияние делает расходящимися
-  все остальные разом.
+  <КЛЮЧ>-<номер>-<slug> <предыдущая ветка>` вместо `origin/main`; от главной — только первая работа
+  череды. Иначе первое же слияние делает расходящимися все остальные разом.
 - **У заявки в череде основанием стоит предыдущая ветка, а не главная.** `gh pr create --base
   <предыдущая ветка>` — иначе разбор показывает свою правку вперемешку со всем, что под ней. Базу
   влитой нижней хостинг переносит сам.
-- **Череда вливается снизу вверх, и порядок стоит в теле каждой заявки.** Владелец вливает по
-  списку, а родство веток по списку не видно: строка «стоит на #<номер>» — единственное место,
-  где он это прочтёт.
+- **Череда вливается снизу вверх, и порядок стоит в теле каждой заявки.** Родство веток по
+  списку не видно: строка «стоит на #<номер>» — единственное место, где владелец это прочтёт.
 - **Нижняя ветка череды историю не переписывает — ни `rebase`, ни силовой отправкой.** Хостинг
-  закрывает заявку верхней как слитую при пустой главной. Отставшая нижняя чинится вливанием
-  главной в неё и дальше вверх.
-- **Расхождение внутри череды разбирается тем, кто ветвится.** У него обе правки под рукой и обе
-  свои; у владельца, разбирающего то же при слиянии, нет ни одной.
-- **Несошедшиеся условия поставки называются одним отказом, а не по одному.** Гард копит их все и
-  печатает разом: круг «правь — повтори — упрись в следующее» стоит вызова за вызовом, хотя всё
-  несошедшееся известно на первом.
-- **Условие, известное в начале работы, спрашивается в начале.** Заведение ветки отбивает
-  основание без вершины главной и чужую почту в подписи. На пуше те же проверки остаются вторым
-  рубежом, но стоят дороже: основание чинится вливанием с конфликтом, подпись — переписыванием
-  ветки.
+  закрывает заявку верхней как слитую при пустой главной. Отставшая чинится вливанием главной.
+- **Расхождение внутри череды разбирается тем, кто ветвится.** У него обе правки свои; у
+  владельца, разбирающего то же при слиянии, нет ни одной.
+- **Несошедшиеся условия поставки называются одним отказом.** Гард копит их и печатает разом: всё
+  несошедшееся известно на первом вызове.
+- **Условие, известное в начале работы, спрашивается в начале.** Заведение ветки отбивает основание
+  без вершины главной и чужую почту в подписи. На пуше те же проверки стоят дороже: основание
+  чинится вливанием с конфликтом, подпись — переписыванием ветки.
 - **Судится то основание, которое названо командой, а не вершина рабочей копии.** Ветку заводят и
   от `origin/main` прямо — этой командой основание как раз и берут свежим. Основание, о котором
   дерево ничего не знает, не судится вовсе.
@@ -105,14 +102,14 @@ flowchart TD
   вызове и называет, где ключ задаётся. Умолчания нет намеренно: собранный из пустого значения
   заголовок не совпадает ни с чем, и настоящее расхождение тонет среди ложных строк.
 - **Заведённая задача подтверждается ответом очереди работ, а не выводом команды заведения.**
-  Напечатанный номер значит «вызов прошёл»: команда может завести задачу и не довести её до
-  борды. Спрашивается очередь по номеру, и ответ читается колонкой и исполнителем.
+  Напечатанный номер значит «вызов прошёл»: задачу можно завести и не довести до борды.
+  Спрашивается очередь по номеру, и ответ читается колонкой и исполнителем.
 - **Видимость заведённого проверяется той стороной, которой оно предназначено.** Заявку читает
   человек, задачу — очередь работ, и оба читают не тем токеном, которым заводили: ограниченная
   запись отвечает им «не найдено», а заводившей — успехом.
-- **Отказ читается прежде, чем его обходят вторым способом.** Он бывает единственным ранним
-  признаком ограничения записи, и обход вызовом другого рода уносит признак с собой: расхождение
-  всплывает у владельца. Ограничение от исчерпания отличает ответ о пределах — там ноль.
+- **Отказ читается прежде, чем его обходят вторым способом.** Он бывает ранним признаком
+  ограничения записи, и обход другим вызовом уносит признак с собой: расхождение всплывает у
+  владельца. Ограничение от исчерпания отличает ответ о пределах — там ноль.
 - **Номер ветки и номер в заголовке PR сверяются на месте, а состояние задачи — по борде.**
   Формат читается из текста команды и работает без сети; задача, колонка, исполнитель и разбор —
   только когда есть чем спросить. Нет сети или токена — второй ярус молча пропускается.
@@ -125,34 +122,43 @@ flowchart TD
 - **На борде стоят задачи, а не PR о них.** Карточка PR колонки не имеет, из очереди не уходит и
   остаётся навсегда; заводит её правило борды или рука, и то и другое выключается. Находит такие
   карточки сверка очереди — строкой на каждую.
-- **Отставшая колонка находится сверкой очереди, а не глазами.** Сверка судит колонку по PR в обе
-  стороны: открытый PR при задаче не в разборе и разбор без открытого PR — оба расхождения.
-  Момента, когда задачу берут в работу, ей не видно: ветки на борде нет.
+- **Отставшая колонка находится сверкой очереди, а не глазами.** Она судит колонку по PR в обе
+  стороны: открытый PR при задаче не в разборе и разбор без открытого PR. Момента, когда задачу
+  берут в работу, ей не видно: ветки на борде нет.
+- **Ветка с открытой заявкой отстаёт от главной молча.** Основание гард судит раз, в минуту
+  открытия, а влитого после не видит и прогон. Отставание считает сверка очереди работ.
+- **Связь задачи с эпиком сверка читает в обе стороны.** Односторонняя привязка выглядит целой
+  так же, как двусторонняя: читатель приходит то от замысла эпика, то от карточки. Держалась она
+  подражанием — тело с образца соседней задачи везло строку вместе с формой.
 - **Задачи, чинящиеся одной правкой, сливаются до мержа.** Вторая стирается вместе с номером, а
-  недостающее дописывается в первую. После мержа слить уже нельзя: ветка въехала целиком.
+  недостающее дописывается в первую: после мержа ветка въехала целиком.
 - **Работа, которую одним заходом не закрыть, помечена в двух местах, и они сверяются.** Метка на
   борде и строка о заходах в замысле эпика говорят одно и то же двум читателям. Помечается только
   то, что законно не делится.
 - **Вершина открытого PR без прогона видна сверкой очереди работ.** Страница без прогона выглядит
-  так же, как с зелёным: цвета нет ни там, ни там. Сверка спрашивает вершину, а не ветку, считает
-  сам факт прогона, а не цвет, и свежей вершине даёт время.
-- **Прогон, вытесненный из очереди конвейера, сверка называет отдельной строкой.** Вытесненный
-  выглядит упавшим, хотя ветку не проверял; отличает их число заданий — у него оно ноль.
-- **Готовность отданной работы живёт до следующего слияния в главную.** Влитая соседняя делает
-  свою конфликтующей. После каждого слияния сливаемость своих заявок спрашивается заново — одним
-  вызовом на все.
+  так же, как с зелёным: цвета нет ни там, ни там. Сверка спрашивает вершину, считает сам факт
+  прогона, а не цвет, и свежей вершине даёт время.
+- **Прогон, вытесненный из очереди конвейера, сверка называет отдельной строкой.** Он выглядит
+  упавшим, хотя ветку не проверял; отличает их число заданий — у него ноль.
 - **Черновик при зелёном прогоне на вершине — расхождение сверки.** Зелёная страница черновика
-  владельцу ничего не разрешает: кнопка заблокирована хостингом. Гард закрывает это внутри хода,
-  между ходами заявку находит сверка.
+  владельцу ничего не разрешает: кнопка заблокирована хостингом. Внутри хода это закрывает гард,
+  между ходами — сверка.
 - **Свои черновики судятся все разом, а не тот один, чья ветка сейчас взята.** Каждый черновик
   машинной записи судится двумя признаками — зелёный прогон на его вершине и разобранная папка
   задачи в его ветке; лежащая папка означает идущую работу.
-- **Открытие PR отбивается, пока ветка везёт папку своей задачи.** Уборка стоит до открытия:
-  кнопку слияния нажимает человек там, где гардов нет. Открытие — последняя точка, где отказ ещё
-  виден тому, кто может его выполнить.
+- **Открытие PR отбивается, пока ветка везёт папку своей задачи.** Кнопку слияния нажимает
+  человек там, где гардов нет, и открытие — последняя точка, где отказ ещё виден тому, кто может
+  его выполнить.
+- **Свои открытые заявки перечитываются в трёх местах: перед пушем, при взятии задачи и после
+  каждого известного слияния.** Заявка устаревает без действия автора: влита соседняя работа —
+  остальные в ту же секунду отстали. Приём — `git-workflow-freshness`.
+- **Конфликтующая своя заявка чинится первым действием хода, а новая работа до этого не
+  берётся.** Пока отданное конфликтует, влить его человек не может, и каждая следующая заявка
+  прибавляет к очереди ещё одну, которую придётся догонять. Работой здесь считается заведение
+  задачи, заведение ветки, перевод колонки в работу и открытие заявки; всё, чем конфликт чинится,
+  идёт как прежде.
 - **Конфликтующий открытый PR — расхождение сверки очереди работ.** Конфликт приезжает чужим
-  слиянием, без единого действия автора, и по списку не виден: метку хостинг показывает только
-  внутри самого PR. Непосчитанная сливаемость расхождением не считается.
+  слиянием и по списку не виден: метку хостинг показывает только внутри самого PR.
 - **Документ едет в том же коммите, что и правка.** Обход — строка `Docs-skip: <причина>` в теле
   коммита; пустая причина не принимается.
 - **Заголовок коммита сверяется с форматом на месте.** Разобранный по типу и области заголовок
@@ -165,26 +171,25 @@ flowchart TD
 - **Набор гейта пуша не бывает уже набора конвейера.** Гейт — обещание, что пуш не приедет
   красным. Шаг конвейера, которому в наборе гейта нет ни строки, ни объявленного исключения с
   причиной, отбивает пуш, а не печатается рядом: предупреждение читается как разрешение.
-- **Набор гейта зовёт умолчание пакета, а не перечисляет его строками.** Переписанный строками,
-  он закрывает сегодняшнюю дыру и оставляет завтрашнюю: заведённая пакетом проверка до дерева не
-  доедет, и не хватится её ничто. Отсеивать из умолчания законно, но поимённо и с причиной у
-  каждого рода.
+- **Набор гейта зовёт умолчание пакета, а не перечисляет его строками.** Переписанный строками, он
+  закрывает сегодняшнюю дыру и оставляет завтрашнюю: заведённая пакетом проверка до дерева не
+  доедет. Отсеивать из умолчания законно, но поимённо и с причиной.
 
-- **Причина исключения, называющая задачу, судится на живость этой задачи.** Мёртвый номер в
-  причине делает исключение бессрочным, не сказав об этом ни строкой. Спрашивается тем же
-  ярусом, что состояние задачи у гарда поставки: нет сети или доступа — пропускает молча.
-- **Сверка раскладки стоит в наборе гейта пуша наравне с линтом и сборкой.** Правка мимо
-  источника копится молча и всплывает на чужой работе: раскладка отказывает по правленому файлу
-  целиком. Статьёй выше это не покрывается — сверки нет в конвейере.
+- **Причина исключения, называющая задачу, судится на живость этой задачи.** Мёртвый номер делает
+  исключение бессрочным, не сказав об этом ни строкой. Спрашивается тем же ярусом, что состояние
+  задачи у гарда: нет сети или доступа — пропускает молча.
+- **Сверка раскладки стоит в наборе гейта пуша наравне с линтом и сборкой.** Правка мимо источника
+  копится молча: раскладка отказывает по правленому файлу целиком. Статьёй выше это не покрывается —
+  сверки нет в конвейере.
 - **После вливания главной ветки набор проверок пересматривается по тому, что ветка везёт
   теперь.** Вливание меняет состав правки: проверять по тому, что правил автор, — значит
   проверять половину, а отвечает ветка целиком.
 - **Утверждение о главной ветке делается по удалённой ссылке, а не по локальной.** Локальная
-  протухает в ту минуту, когда её подтянули, и молчит об этом. Сравнение пишется от `origin/main`
-  целиком: смешав удалённую ссылку с локальной в одной команде, промах изнутри выглядит верным.
-- **Правка кода отдаётся человеку открытым PR, а не запушенной веткой.** Ветка ему не
-  показывается, во входящие не приходит и обсуждения не имеет: до открытия PR правки для человека
-  нет. Открывается он тем же ходом, которым исполнитель говорит, что работу отдаёт.
+  протухает в минуту, когда её подтянули, и молчит об этом. Сравнение пишется от `origin/main`
+  целиком: смешанные в одной команде, они дают промах, изнутри выглядящий верным.
+- **Правка кода отдаётся человеку открытым PR, а не запушенной веткой.** Ветка во входящие не
+  приходит и обсуждения не имеет: до открытия PR правки для человека нет. Открывается он тем же
+  ходом, которым исполнитель говорит, что работу отдаёт.
 - **Не готовое к слиянию открывается черновиком — `gh pr create --draft`.** Кнопка слияния у
   черновика заблокирована хостингом, поэтому «выложено на обозрение» и «можно вливать» перестают
   выглядеть одинаково. Черновиком идёт всё, что ждёт прогона, доработки или ответа на вопрос.
@@ -192,13 +197,11 @@ flowchart TD
   готовность: проверки пройдены, доработок не осталось, работа сходится с задачей. Снятие
   черновика и просьба влить — один ход, а не два разных дня.
 - **Черновик не снимается с ветки, которая не сливается.** Зелёный прогон говорит «не сломано»,
-  сливаемость — «кнопку можно нажать», и владельцу нужно второе. Спрашивается у хостинга: поле
-  `mergeable` приходит тем же ответом, что автор и ревьювер. Из локального вливания она не
-  выводится.
+  сливаемость — «кнопку можно нажать», и владельцу нужно второе. Спрашивается у хостинга полем
+  `mergeable`; из локального вливания она не выводится.
 - **Указателю, в который ветки только дописывают строки, объявляется сложение обеих сторон.**
-  Конфликт там не спор: обе допись нужны целиком. Объявление снимает ручное разрешение, но
-  **метку сливаемости не гасит** — она гаснет, когда ветка вобрала главную и это уехало на
-  хостинг.
+  Конфликт там не спор: обе допись нужны целиком. Метку сливаемости объявление **не гасит** — она
+  гаснет, когда ветка вобрала главную и это уехало на хостинг.
 - **Правка, доведённая до коммита, доводится до хостинга тем же ходом.** Владелец видит прежнее
   состояние и читает его как «не сделано ничего», а сделанное лежит там, где его не видит никто.
   Оставшееся в дереве называется причиной — словом владельца, а не списком остатков.
@@ -212,42 +215,37 @@ flowchart TD
   приходит окружением, и в тексте команды её видно только явной подстановкой токена. Ответ
   хостинга об авторе гард спрашивает на снятии черновика: влитую заявку не переоткрыть.
 
-- **Автор PR не может быть его ревьювером.** Запрос разбора на самого себя GitHub принимает и
-  молча не создаёт — разбор при этом выглядит запрошенным. В разборе считаются только запрос и
-  отзыв не от автора.
+- **Автор PR не может быть его ревьювером.** Запрос разбора на себя GitHub принимает и молча не
+  создаёт: разбор выглядит запрошенным. Считаются только запрос и отзыв не от автора.
 - **Вызов клиента хостинга идёт из дерева, а связка команд исхода не проверяет.** Репозиторий
   клиент берёт у текущего каталога и вне дерева отказывает; следующее звено связки увозит на
   хостинг то, что осталось от отказавшего, поэтому тело читается обратно тем же ходом.
-- **Метки, исполнитель и ревьювер PR ставятся вызовами `gh api`, а не `gh pr edit`.** На
-  репозитории со старой бордой `gh pr edit` отвечает отказом про Projects (classic) и до правки
-  не доходит.
-- **Борда правится запросом GraphQL по идентификатору самой борды, а не по имени владельца.**
-- **Почта машинного коммита копируется из компаньона, а не набирается по памяти.** Служебный
-  адрес — `<число>+<логин>@users.noreply.github.com`, и сопоставляется он по числу: коммит с чужим
-  числом уезжает подписанным посторонним. Ту же строку держит профиль дерева, и гард отбивает пуш
-  при расхождении.
-- **Личность машинной записи подтверждается ответом хостинга, а не узнаванием строки.** Знакомый
-  вид строки подтверждением не бывает. Спрашивается токеном самой записи, ответом о себе: логин и
-  число приходят вместе — поиск по числу для ограниченной записи отвечает «не найдено».
-- **Сценарии гардов задают настройки git сами, а не берут их с машины.** Включённая на машине
-  подпись уводит git в агент ключей, а заблокированный агент роняет весь набор — со стороны это
-  выглядит сломанным гардом. Автор, почта и подпись передаются флагами `-c` прямо в команду.
+- **Метки, исполнитель и ревьювер PR ставятся вызовами `gh api`, а не `gh pr edit`.** На старой
+  борде `gh pr edit` отвечает отказом про Projects.
+- **Борда правится запросом GraphQL по идентификатору борды, а не по имени владельца.**
+- **Почта машинного коммита копируется из компаньона, а не набирается по памяти.** Служебный адрес
+  `<число>+<логин>@users.noreply.github.com` сопоставляется по числу: коммит с чужим числом уезжает
+  подписанным посторонним. Ту же строку держит профиль дерева, и гард отбивает пуш.
+- **Личность машинной записи подтверждается ответом хостинга, а не узнаванием строки.** Спрашивают
+  её токеном, ответом о себе: логин и число приходят вместе.
+- **Сценарии гардов задают настройки git сами, а не берут их с машины.** Подпись, включённая на
+  машине, уводит git в агент ключей, а заблокированный агент роняет весь набор: автор, почта и
+  подпись идут флагами `-c` прямо в команде.
 
 - **Каждый коммит вклада ветки подписан машинной записью, и это проверяется набором пуша.** Гард
-  поставки судит только коммит, назвавшийся ею, и подписанный человеком проходит мимо: там, где
-  человек не коммитит вовсе, это промах, а не законный случай.
+  судит только коммит, назвавшийся ею; подписанный человеком проходит мимо, а там, где человек не
+  коммитит вовсе, это промах.
 - **Состояние заявки перечитывается у хостинга сразу после публикации, а не берётся из кода
-  возврата.** Открытие заявки и постановка ревьювера отвечают нулём и тогда, когда сделали не то
-  или не сделали ничего.
+  возврата.** Открытие и постановка ревьювера отвечают нулём и тогда, когда не сделали ничего.
 - **Автор открытой заявки и наличие у неё ревьювера сверяются очередью работ.** До слияния оба
-  промаха не видны ничем: заявка, открытая человеком, ревьювера не получит никогда, и выглядит
-  это как заявка, которой его просто не поставили.
-- **Ревьюверы спрашиваются вызовом REST, а не выборкой клиента.** Её поля собираются запросом
-  GraphQL, а тот требует области чтения организации, которой у машинной записи нет: «сошлось»
-  перестаёт отличаться от «спросить было нечем».
-- **Силовая отправка ветки, стоящей под другой в стопке, закрывает её заявку как слитую.**
-  Хостинг считает заявку слитой, когда вершина её ветки достижима из базы; состояние лживое — в
-  главной ветке правки нет, а задача остаётся открытой.
+  промаха не видны: заявка, открытая человеком, ревьювера не получит никогда, и выглядит это как
+  заявка, которой его просто не поставили.
+- **Ревьюверы спрашиваются вызовом REST, а не выборкой клиента.** Её поля собирает GraphQL, а он
+  требует прав, которых у машинной записи нет: «сошлось» не отличить от «спросить было нечем».
+
+- **Рабочее дерево не опустошается ради прогона инструмента.** Сравнение с прежним состоянием
+  идёт на второй копии: прятанье уводит незакоммиченную работу туда, где её не видит ни состояние
+  дерева, ни сверка.
 
 ## Чего из закона здесь нет
 
@@ -270,3 +268,4 @@ flowchart TD
 - `git-workflow-pr` — открытие PR, черновик и его снятие, тело, ревьювер, метки, состояние.
 - `git-workflow-merge` — главная ветка влита в ветку задачи, конфликт разобран.
 - `git-workflow-stack` — череда веток: ветвление от предыдущей, основание заявки, порядок отдачи.
+- `git-workflow-freshness` — свои открытые заявки: чтение всех разом, отставание против спора.

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

@@ -20,7 +20,8 @@ description: Правило под «Закон о поставке» для д
 | В законе                         | Здесь                                                                                                                                                                                                 |
 | -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | главная ветка                    | `main`                                                                                                                                                                                                |
-| отдельная ветка                  | `<КЛЮЧ>-<номер задачи>-<короткий-slug>`; ключ задач — в `implementation.md`. Имя без номера (`feat/…`, `fix/…`) законно, пока ветка живёт локально: MR с неё не откроется                             |
+| отдельная ветка                  | `<КЛЮЧ>-<номер задачи>-<короткий-slug>`. Имя без номера (`feat/…`, `fix/…`) законно, пока ветка живёт локально: MR с неё не откроется                                                                 |
+| ключ задач                       | короткое слово, которым дерево зовёт свои задачи; задаётся ключом `board.taskKey` в `.claude/rt-kit/checks.json`, а в `implementation.md` называется для читателя                                     |
 | задача                           | issue проекта, заголовок `[<КЛЮЧ>-<номер>] <Что не так>`, исполнитель — учётная запись машинной работы; MR прикрепляется к нему строкой `Closes #<номер>` в описании                                  |
 | очередь работ                    | доска задач проекта — Issue Board. Задача попадает на неё меткой списка, а не самим фактом заведения: доска показывает те issue, чью метку знает                                                      |
 | состояние задачи в очереди работ | список доски, за которым стоит метка: заведённая, взятая в работу, ждущая разбора. Имена меток — в `implementation.md`; закрытая задача уходит из очереди слиянием, а не переносом в последний список |
@@ -133,9 +134,16 @@ flowchart TD
 - **Отставший список находится сверкой очереди, а не глазами.** Сверка судит список по PR
   в обе стороны: открытый MR при задаче не в разборе и разбор без открытого MR — оба
   расхождения. Момента, когда задачу берут в работу, ей не видно: ветки на доске нет.
-- **Задачи, чинящиеся одной правкой, сливаются до слияния ветки.** Вторая стирается вместе с
-  номером, а недостающее из неё дописывается в первую. После слияния слить уже нельзя: ветка
-  въехала, и откатывается она целиком.
+- **Ветка с открытой заявкой отстаёт от главной молча.** Гард судит основание один раз — в
+  минуту открытия; всё, что влилось в главную, пока шёл прогон, зелёный прогон не видит вовсе, и
+  влитая оттуда заявка приносит в главную ветку сочетание, которое не проверял никто. Отставание
+  находит сверка очереди работ: она спрашивает у хранилища, на сколько коммитов ветка каждой
+  открытой заявки позади главной, и называет число.
+- **Задачи, чинящиеся одной правкой, сливаются до слияния ветки.** Вторая закрывается как
+  дубликат со ссылкой на поглотившую, а недостающее из неё дописывается в первую. Закон велит
+  вторую стереть — здесь это объявленное отступление: стереть задачу хостинг не даёт вовсе, а её
+  номер остаётся в истории, и ссылка из чужого коммита ведёт в закрытую задачу, а не в пустоту.
+  После слияния слить уже нельзя: ветка въехала, и откатывается она целиком.
 - **Работа, которую одним заходом не закрыть, помечена в двух местах, и они сверяются.** Метка
   на доске и строка о заходах с передачей в замысле эпика говорят одно и то же двум читателям:
   исполнитель открывает карточку раньше, чем замысел эпика, а планирует по замыслу. Одна пометка без

package/assets/rules/lists.md

@@ -83,6 +83,11 @@ flowchart TD
 - **Недоступное сейчас действие в меню строки не рисуется вовсе.** Пункт заводится под `@if` по
   полю строки, а не выключенным: выключенный пункт перечисляет владельцу запреты вместо того,
   что он может сделать, и набор их меняется от строки к строке.
+- **Необратимое действие спрашивает подтверждение готовым приёмом, а не своим окном.** Пункт
+  меню несёт признак опасного и пару полей подтверждения — заголовок и текст с последствием, — а
+  окно берёт набор. Правило, молчавшее об этом, стоило владельцу выбора из трёх вариантов, среди
+  которых был свой компонент окна в новой либе: ответ лежал в паттерне, и туда исполнитель не
+  дошёл. Поля названы в паттерне `admin-lists-screen`.
 - **Кнопка меню не показывается, если у строки не осталось доступных действий.** За это
   отвечает вход `[rowHasActions]` — предикат по строке; считать по содержимому меню нельзя,
   спроецированный шаблон известен только после отрисовки.

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

@@ -168,3 +168,7 @@ flowchart TD
   Она работает по имени ключа, и голое значение мимо неё проходит вовсе, — но ключ, который сам
   числится свободным текстом, увозит тело в хранилище отметкой о вычистке целиком. Новая
   обёртка сверяется со списками ключей до того, как её так назвали.
+- **Предохранитель повтора, чей ключ собран из того, чем меряют время, не срабатывает никогда.**
+  При равенстве такта разбора и ширины ведёрка каждый разбор видит пустой замок и шлёт заново.
+  Со стороны это выглядит работающим: предохранитель объявлен, привязка сходится, письма уходят
+  каждый час. Ключ берётся от предмета оповещения, а не от отрезка времени, которым его считают.

package/assets/rules/reuse-first.md

@@ -53,6 +53,12 @@ flowchart TD
   опирается, названо в именах дерева.
 - **Работа начинается с чтения готового, а не с чистого файла.** Сначала находится опора —
   компонент кита, базовый класс, образец в соседнем домене, — потом пишется своё поверх неё.
+- **Значение интеграции берётся тем же путём, что и соседнее значение той же интеграции.**
+  Половина интеграции, сделанная как положено, — готовый образец, и стоит он не в чужом домене,
+  а строкой выше: рядом с зашитым в код идентификатором карты жил её же ключ, приходящий
+  внедрением. Расхождение соседей — это вопрос «почему один параметр сделан, а второй нет», а не
+  выбор между тремя способами починить второй. Не ловится оно ничем: значение синтаксически
+  исправно, линт и сборка зелены, а сверка повторов пару констант под свои признаки не берёт.
 - **Свой примитив и своя основа заводятся только с явного одобрения владельца.** Спрашивается
   это до того, как написан первый файл.
 - **Панель правки записи наследует общую основу, а не собирается своей разметкой.** Тогда она