@rt-tools/agent-kit 0.12.0 → 0.13.0

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

@@ -2,7 +2,7 @@
 name: task-flow-archive
 kind: pattern
 rule: task-flow
-description: Паттерн правила task-flow. Брать, когда работа доведена до готовности: разбор папки задачи последним коммитом, переезд в описание прошлого, сверка очереди работ, разбор закрытой работы правилами и то, что делать с его находками. Не брать для вливания договорённости и приведения текстов — это паттерн task-flow-close.
+description: Паттерн правила task-flow. Брать, когда тексты приведены и папка задачи разбирается последним коммитом до открытия заявки: переезд в описание прошлого, сверка очереди работ, разбор закрытой работы правилами и то, что делать с его находками. Не брать для вливания договорённости, открытия заявки и снятия черновика — это паттерн task-flow-close.
 ---
 
 # Разбор папки задачи и разбор работы правилами
@@ -14,7 +14,7 @@ description: Паттерн правила task-flow. Брать, когда р
 ## Когда брать
 
 - Договорённость влита, тексты домена приведены, и папка задачи разбирается последним
-  коммитом ветки.
+  коммитом ветки — до открытия заявки, а не после одобрения.
 - Работа слита человеком, и её разбирают правилами.
 - Разбор вернул находки, и их надо куда-то положить.
 
@@ -55,8 +55,12 @@ cat docs/tasks/<КЛЮЧ>-<номер>-<slug>/grill.md > docs/archive/<ЧТО_Р
 rm -r docs/tasks/<КЛЮЧ>-<номер>-<slug>
 ```
 
-Разбор идёт в том же PR, что и работа: папка, оставленная до мержа, попадает в главную
-ветку и читается там как текущая.
+Разбор идёт последним коммитом ветки, до открытия заявки: открытие с лежащей папкой отбивает
+гард поставки. Прежде уборка стояла после одобрения — считалось, что замысел нужен на диске всё
+время разбора. Но кнопку слияния нажимает человек на хостинге, куда гард не достаёт, и вливает
+он, как только видит зелёное: трижды подряд папка уехала в главную неразобранной. Замысла после
+уборки на диске нет намеренно, и правку по замечаниям гард хода работы пропускает по признаку
+из истории ветки.
 
 ### Работа, разбирающая чужую папку, разбирает две
 
@@ -75,8 +79,8 @@ rm -r docs/tasks/<своя>
 Две записи в архиве, а не одна: работы разные, и решения в них разные. Сверка очереди работ
 после этого не называет ни одной папки — этим и проверяется, что разобраны обе.
 
-**Следующее движение:** разобранная папка уезжает в ветку тем же коммитом, и следом за ним
-сверяется очередь работ.
+**Следующее движение:** разобранная папка уезжает в ветку тем же коммитом, следом сверяется
+очередь работ, и тем же ходом открывается заявка — паттерн `task-flow-close`.
 
 ## Состояние `папка-разобрана`: сверка очереди работ
 
@@ -87,7 +91,7 @@ npm run check:docs    # пути, названные в текстах, суще
 ```
 
 **Следующее движение:** расхождения, названные сверками, чинятся тем же ходом; чинить нечего —
-тот же ход снимает черновик и просит владельца влить, называя номер.
+тот же ход открывает заявку черновиком и называет владельцу номер, паттерн `task-flow-close`.
 
 ## Состояние `влито`: работа разбирается правилами — фоном, следом за PR
 
@@ -156,20 +160,18 @@ npm run check:docs    # пути, названные в текстах, суще
 
 ## Ловушки
 
-- **Папку разбирают до слияния — потом о ней уже никто не вспомнит.** Сверка очереди считает
-  задачу закрытой по слиянию: до него папка среди текущих законна, а после за неё никто не
-  отвечает — работа перешла к следующей задаче, и находка достанется чужому заходу. Три раза
-  подряд папка закрытой задачи так и уехала в главную ветку, в последний раз их набралось
-  пять. Теперь это держит гард поставки: слияние отбивается, пока папка лежит в ветке.
-- **Разбирают последним коммитом, а не перед открытием PR.** Пока идёт ревью, замысел
-  нужен на диске: без него правку по замечаниям не пропустит гард хода работы. Порядок такой:
-  правки по ревью, потом разбор папки, потом слияние.
-- **Разбор папки идёт последним, после того как гейт пуша прошёл целиком.** Гард хода работы
-  не пускает правку кода приложения без замысла на диске, а после разбора замысла нет: чужое
-  замечание линтера, приехавшее мержем из главной ветки, чинить уже нечем, и гейт пуша стоит.
-  Порядок один: мерж главной ветки, все линтеры и проверки зелёные, вливание договорённости,
-  приведение текстов домена, разбор папки. Понадобилась правка кода после разбора — замысел
-  восстанавливается на диске на время правки, и разбор повторяется тем же коммитом.
+- **Папку разбирают до открытия заявки — потом о ней уже никто не вспомнит.** Сверка очереди
+  считает задачу закрытой по слиянию: после него за папку никто не отвечает — работа перешла к
+  следующей задаче, и находка достанется чужому заходу. Три раза подряд папка закрытой задачи
+  так и уехала в главную ветку, в последний раз их набралось пять. Держит это гард поставки:
+  открытие заявки отбивается, пока папка лежит в ветке.
+- **Разбор папки идёт последним коммитом, после того как гейт пуша прошёл целиком.** Порядок
+  один: мерж главной ветки, все линтеры и проверки зелёные, вливание договорённости, приведение
+  текстов домена, разбор папки — и только потом заявка.
+- **После разбора замысла на диске нет, и собирать папку заново не надо.** Правку по замечаниям
+  разбора и починку красного прогона гард хода работы пропускает по признаку из истории ветки:
+  папка, снятая её коммитом, и есть признак отданной работы. Собранная заново папка вернула бы
+  отказ гарда поставки на следующем же вызове.
 - **Если папку просто удалить, первым пропадёт `grill.md`.** Удалить проще, чем разобрать, а
   слова владельца записаны только там, и восстановить их неоткуда. Поэтому гард требует, чтобы
   ветка добавила запись в архив. Что именно перенесли, он не проверяет — это смотрит владелец

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

@@ -2,7 +2,7 @@
 name: task-flow-close
 kind: pattern
 rule: task-flow
-description: Паттерн правила task-flow. Брать при доведении работы до готовности — снятие черновика, вливание договорённости в спек домена последним коммитом PR, приведение текстов домена к сделанному. Не брать для разбора папки задачи и разбора работы правилами — это паттерн task-flow-archive; не брать для хода работы — это паттерн task-flow-resume.
+description: Паттерн правила task-flow. Брать при доведении работы до готовности — вливание договорённости в спек домена, приведение текстов домена к сделанному, открытие заявки черновиком и снятие черновика. Не брать для разбора папки задачи и разбора работы правилами — это паттерн task-flow-archive; не брать для хода работы — это паттерн task-flow-resume.
 ---
 
 # Закрытие работы
@@ -12,104 +12,19 @@ description: Паттерн правила task-flow. Брать при дове
 
 ## Когда брать
 
-- Этапы замысла закрыты, проверки зелёные, с PR снимается черновик.
+- Этапы замысла закрыты, набор гейта прогнан целиком.
 - `npm run check:specs` перечислил договорённость в разделе «Пора вливать».
 - Тексты домена приводятся к тому, что работа сделала.
+- Папка задачи разобрана, и заявка открывается черновиком.
+- Прогон на вершине зелёный, и с заявки снимается черновик.
 
-Само открытие PR сюда не относится: он открывается черновиком тем ходом, которым правка
-кода отдаётся владельцу, — то есть до этого паттерна и, как правило, задолго до него. Здесь
-работа доводится до готовности и черновик снимается.
+Разбор самой папки сюда не относится — это паттерн `task-flow-archive`. Он стоит между
+приведением текстов и открытием заявки: заявка открывается уже за убранной работой.
 
-## Состояние `этапы-кончились`: работа отдаётся на разбор
+## Состояние `этапы-кончились`: договорённость вливается в спек домена
 
-PR открыт черновиком — и с этой минуты работа ждёт владельца, а не машину. Заход на этом не
-кончается: следующая задача эпика берётся тем же движением, паттерн `task-flow-resume`.
-
-**Заход, открывший PR, называет оставшийся шаг в двух местах — разделом в теле PR и словами
-владельцу:** после одобрения ветка получает ещё один коммит — разбор папки, — и только потом
-вливается. Порядок этот записан здесь, а читает его исполнитель; вливает же владелец, и
-молчание он читает как «работа кончена» — видит зелёный PR и мержит его тем же ходом. Промах
-случается ровно в шов между двумя ходами, и стоит он отдельной задачи: после слияния папку
-разбирать уже некому.
-
-### Два сообщения владельцу, и между ними — прогон
-
-Оба обязательны, и порядок между ними один. Ни одно не заменяется другим: первое говорит, что
-работа отдана и чего она ждёт, второе — что она готова.
-
-Сразу после открытия PR:
-
-```
-PR #<номер> открыт черновиком. Жду прогона: пока он идёт, о работе известно только то, что
-она запушена. Как закончится — разберу папку задачи последним коммитом, сниму черновик и
-попрошу тебя влить. Следующая задача уже взята: #<номер>, ветка <имя ветки>.
-```
-
-Последняя строка называет взятое, а не намерение взять, и это не оборот речи. Образец, который
-кончается обещанием, исполняется как обещание: заход произносит последнюю строку и на этом
-кончает ход — сообщение при этом выглядит полным, и пустоты за ним не видно ни владельцу, ни
-самому заходу. Образец, который кончается номером заведённой ветки, так исполнить нельзя: пока
-ветки нет, строку писать нечем. Разбор — `2026-08-16-next-task-said-not-taken.md`.
-
-Прогон зелёный, папка разобрана и запушена, черновик снят:
-
-```
-PR #<номер> готов к слиянию: прогон зелёный, папка задачи разобрана, за работой убрано,
-черновик снят. Влей его, пожалуйста.
-```
-
-Черновик снимается перед вторым сообщением, а не после него: владелец, прочитав просьбу
-влить, идёт нажимать кнопку — у черновика она заблокирована, и ход возвращается к исполнителю
-ни за чем.
-
-Прогон красный — сообщение то же по форме, но говорит о красном и о том, что с ним делается;
-просьбы влить в нём нет. Просьба звучит один раз и только тогда, когда работа готова целиком:
-сказанная заранее, она перестаёт что-либо значить, и владелец возвращается к прежнему —
-вливать по зелёной странице.
-
-Между двумя сообщениями исполнитель не ждёт: работа отдана на разбор, и тем же движением
-берётся следующая задача. Возвращается он к PR тем ходом, которым читает конец прогона.
-
-### Оставшийся шаг стоит разделом в теле PR
-
-Сказанного вслух мало, и одним этим требование не держится. Реплика живёт до следующей реплики,
-а решение о слиянии принимается на странице PR — там переписки нет вовсе. Поэтому оставшийся
-шаг пишется дважды: разделом в теле PR и словами владельцу. Одно другого не заменяет — тело
-пишется один раз и лежит у самой кнопки, разговор идёт дальше и уносит сказанное с собой.
-
-Раздел стоит последним и говорит ровно одно — что случится с веткой после одобрения:
-
-```markdown
-## Оставшийся шаг
-
-После одобрения ветка получает ещё один коммит — разбор папки задачи, — и только потом
-вливается. До этого коммита вливать рано: папка уедет в главную ветку неразобранной.
-```
-
-Разобрана папка — раздел переписывается тем же вызовом, которым правится тело:
-
-```markdown
-## Оставшийся шаг
-
-Не осталось: папка задачи разобрана коммитом `<sha>`, черновик снят. Можно вливать.
-```
-
-Пустым раздел не оставляется и не удаляется вовсе: отсутствие раздела и «шагов не осталось»
-читаются одинаково, а значат разное. Образец тела PR целиком — в паттерне заведения коммита
-и PR, если дерево его разложило.
-
-Проверить это машиной нечем, и проверки не будет: тело PR не читает ни одна сверка, а хостинг
-не спрашивает ни о чём, кроме заголовка. Требование держится тем же, чем и слова вслух, — тем,
-кто пишет тело. Разница между ними одна, и она вся: реплику владелец прочитает, только если
-вернётся в переписку, а раздел он видит там, куда смотрит, нажимая кнопку.
-
-**Следующее движение:** тем же ходом берётся следующая задача эпика, а разбор закрытой работы
-уходит в фон. Прогон и владелец идут без исполнителя, и ждать их состоянием работы не бывает.
-
-## Состояние `разбор-кончился`: договорённость вливается в спек домена
-
-Последним коммитом PR, до слияния. Код к этому моменту написан, поэтому привязки
-`файл:символ` известны — правило въезжает в спек домена сразу проверяемым.
+Одним из последних коммитов ветки, до открытия заявки. Код к этому моменту написан, поэтому
+привязки `файл:символ` известны — правило въезжает в спек домена сразу проверяемым.
 
 ```bash
 npm run check:specs   # раздел «Пора вливать» называет готовые директории
@@ -138,7 +53,7 @@ npm run check:specs   # после вливания: привязки на ме
 **Следующее движение:** за влитой договорённостью тем же ходом идут тексты домена — правила,
 паттерны и разделы, которые работа задела.
 
-## Состояние `разбор-кончился`: тексты домена приводятся к сделанному
+## Состояние `этапы-кончились`: тексты домена приводятся к сделанному
 
 В спек уезжает только то, что записали до кода. Остальные тексты — правила, паттерны, законы
 приложения — после правки никто не перечитывает, и они продолжают описывать старое дерево.
@@ -180,7 +95,94 @@ grep -rn -A3 "Чего из закона здесь нет" <каталог пр
 не изменили — почему. Форма раздела — паттерн `git-workflow-pr`.
 
 **Следующее движение:** приведённые тексты коммитятся, и тем же ходом разбирается папка
-задачи — последним коммитом ветки.
+задачи — последним коммитом ветки, паттерн `task-flow-archive`.
+
+## Состояние `папка-разобрана`: работа отдаётся заявкой
+
+Папка разобрана и запушена, за работой убрано — заявка открывается черновиком. С этой минуты
+работа ждёт владельца, а не машину, и заход на этом не кончается: следующая задача берётся тем
+же движением, паттерн `task-flow-resume`.
+
+Состояния на диске уже нет — ход работы уехал вместе с папкой. Это цена того, что уборка стоит
+до заявки: хвост из четырёх шагов — открыть заявку, дождаться прогона, снять черновик, попросить
+влить — держится этим паттерном, а не строкой в файле. Гард признаёт работу отданной по истории
+ветки: папка, снятая её коммитом, и есть признак.
+
+### Два сообщения владельцу, и между ними — прогон
+
+Оба обязательны, и порядок между ними один. Ни одно не заменяется другим: первое говорит, что
+работа отдана и чего она ждёт, второе — что она готова.
+
+Сразу после открытия заявки:
+
+```
+PR #<номер> открыт черновиком, папка задачи уже разобрана — за работой убрано. Жду прогона:
+пока он идёт, о работе известно только то, что она запушена. Как закончится — сниму черновик и
+попрошу тебя влить. Следующая задача уже взята: #<номер>, ветка <имя ветки>.
+```
+
+Последняя строка называет взятое, а не намерение взять, и это не оборот речи. Образец, который
+кончается обещанием, исполняется как обещание: заход произносит последнюю строку и на этом
+кончает ход — сообщение при этом выглядит полным, и пустоты за ним не видно ни владельцу, ни
+самому заходу. Образец, который кончается номером заведённой ветки, так исполнить нельзя: пока
+ветки нет, строку писать нечем. Разбор — `2026-08-16-next-task-said-not-taken.md`.
+
+Прогон зелёный, черновик снят:
+
+```
+PR #<номер> готов к слиянию: прогон зелёный, черновик снят. Влей его, пожалуйста.
+```
+
+Черновик снимается перед вторым сообщением, а не после него: владелец, прочитав просьбу
+влить, идёт нажимать кнопку — у черновика она заблокирована, и ход возвращается к исполнителю
+ни за чем.
+
+Прогон красный — сообщение то же по форме, но говорит о красном и о том, что с ним делается;
+просьбы влить в нём нет. Просьба звучит один раз и только тогда, когда работа готова целиком:
+сказанная заранее, она перестаёт что-либо значить, и владелец возвращается к прежнему —
+вливать по зелёной странице.
+
+Между двумя сообщениями исполнитель не ждёт: работа отдана на разбор, и тем же движением
+берётся следующая задача. Возвращается он к заявке тем ходом, которым читает конец прогона.
+
+### Состояние работы стоит разделом в теле заявки
+
+Сказанного вслух мало, и одним этим требование не держится. Реплика живёт до следующей реплики,
+а решение о слиянии принимается на странице заявки — там переписки нет вовсе. Раздел стоит
+последним и говорит ровно одно: осталось ли что-то до слияния.
+
+```markdown
+## Оставшийся шаг
+
+Папка задачи разобрана коммитом `<sha>` — за работой убрано. Осталось дождаться прогона и снять
+черновик; до этого кнопка слияния заблокирована хостингом.
+```
+
+Черновик снят — раздел переписывается тем же вызовом, которым правится тело:
+
+```markdown
+## Оставшийся шаг
+
+Не осталось: прогон зелёный, черновик снят. Можно вливать.
+```
+
+Пустым раздел не оставляется и не удаляется вовсе: отсутствие раздела и «шагов не осталось»
+читаются одинаково, а значат разное. Образец тела заявки целиком — в паттерне заведения коммита
+и заявки, если дерево его разложило.
+
+Проверить это машиной нечем, и проверки не будет: тело заявки не читает ни одна сверка, а
+хостинг не спрашивает ни о чём, кроме заголовка. Требование держится тем же, чем и слова
+вслух, — тем, кто пишет тело. Разница между ними одна, и она вся: реплику владелец прочитает,
+только если вернётся в переписку, а раздел он видит там, куда смотрит, нажимая кнопку.
+
+### Правка по замечаниям идёт без замысла на диске
+
+Разбор вернул замечания или прогон покраснел — чинится это в той же ветке. Замысла там больше
+нет, и собирать папку заново не надо: гард хода работы пропускает правку по признаку из истории
+ветки. Что именно чинится, берётся из замечания, а не из замысла.
+
+**Следующее движение:** прогон зелёный и замечаний нет — черновик снимается, и владельцу
+говорится, что работа готова.
 
 ## Ловушки
 

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

@@ -91,11 +91,12 @@ git log --oneline origin/main..HEAD
 владельца — то есть ровно тем пересказом, ради отмены которого всё и заведено:
 
 ```markdown
-- **PR:** #1396, ждёт разбора · отвечено 3 замечания из 5 · не сделано: разбор папки задачи
+- **PR:** #1396, ждёт разбора · отвечено 3 замечания из 5 · не сделано: снятие черновика
 ```
 
 С открытием PR состояние становится `работа-отдана`, и обязательное действие у него другое —
-следующая задача, а не ожидание разбора.
+следующая задача, а не ожидание разбора. Объявить его на диске к этой минуте уже нечем: ход
+работы уехал вместе с папкой, и хвост работы ведёт паттерн `task-flow-close`.
 
 Решение, принятое по ходу, — вместе с причиной и с тем, что было альтернативой:
 
@@ -121,7 +122,8 @@ git log --oneline origin/main..HEAD
 ```
 
 **Следующее движение:** отмеченный этап тем же ходом сменяется следующим. Этапы кончились —
-тот же ход гонит набор и открывает PR черновиком.
+тот же ход гонит набор, вливает договорённость, приводит тексты и разбирает папку задачи; PR
+открывается за убранной работой.
 
 ## Состояние `работа-отдана`: следующая задача берётся тем же движением
 

package/assets/pitfalls/agent-kit.md

@@ -0,0 +1,80 @@
+# Переносимый слой правил — холодная часть
+
+Ловушки и грабли, на которые уже наступали. Грузится не вместе со скилом, а по требованию: при
+обычной раскладке она не нужна — она нужна тому, кто разбирает отказ сверки или спорит с
+раскладкой.
+
+Скил — `agent-kit`; порядок правки, команды и устройство слоёв стоят там.
+
+## Ловушки
+
+- **Набор, проверяющий гард, читает настройку того дерева, из которого его запустили.** Помощник
+  берёт настройку по каталогу проекта, а его агент выставляет своим — и `cd` в прогонщике этого
+  не перебивает. Набор, не заведший своего одноразового дерева, зеленеет от строки в чужой
+  настройке: шесть сценариев гарда экзамена прошли ровно так, потому что роль была выключена в
+  дереве, где их гоняли. Своё дерево объявляется на каждый сценарий, а не один раз на файл.
+
+- **Надстройка замещает раздел целиком, и пакетные пункты в нём приходится держать копией.**
+  Дописать в раздел одну статью нечем: слияние идёт по заголовку `## `. Дерево, которому нужен
+  один свой пункт, копирует к нему все пакетные — и с этого дня правка любого из них,
+  приехавшая с новой версией, до этого дерева не доходит. Сверка разложенного молчит: она
+  считает расхождением правку на месте, а не замещённый раздел. Признак виден по самим
+  надстройкам — три из трёх прочитанных кончались абзацем о том, что перенос придётся делать
+  руками. Поэтому надстройкой берут раздел, у которого пакетных пунктов немного, а разросшийся
+  замещённый раздел — повод внести своё в пакет, а не держать его копией. Предложение, которым
+  своё вносят, называет эту надстройку строкой «чем закрывается»: иначе приехавшая редакция и
+  надстройка, которую она закрыла, не сопоставляются ничем, и надстройка остаётся замещать уже
+  исправленный раздел.
+
+- **Готовый код пакета не называет имён одного дерева.** Префикс директив кита, ключи подписей
+  и имена сущностей принадлежат тому дереву, где паттерн писали; разложенные в соседнем, они
+  учат звать то, чего там нет вовсе. Имя директивы при этом отличается от имени в примере: по
+  примеру видно, что он пример, а `<префикс>TableRow` из чужого дерева выглядит рабочим кодом
+  и правится только после того, как продовая сборка упадёт. Тринадцать таких имён простояли в
+  четырёх ресурсах пакета, пока их не нашёл потребитель — и не своей сборкой, а надстройкой,
+  которой перекрыл раздел.
+
+- **Правила и паттерны при отвергнутом законе в отказе не перечисляются.** Их снимает каскад, а
+  строка на них становится выводимой: раскладка называет её лишней вместе с законом, из-за
+  которого она перестала снимать. Отказ мерит слой законов, а не число файлов в пакете.
+
+- **Линтер по следам правки судит файл целиком, а не внесённую правку.** Импорт, добавленный
+  отдельным шагом, отбивается как неиспользуемый ещё до того, как появится строка, которая его
+  зовёт, и работа встаёт на половине. Правка делается одним вызовом либо в порядке «сначала
+  использование, потом импорт».
+- **Прогонять сценарии гардов можно, ничего не раскладывая.** Обвязка набора принимает каталог
+  гардов переменной, и пакетную редакцию гоняют по сценариям дерева до установки. Заход,
+  потраченный на диагноз по последствиям, стоил ровно этой строки.
+- **Отбитая правка не всегда про текст гарда.** Гард зовут по пути, и файл без права на
+  запуск отвечает отказом доступа — ненулевым кодом, который читается как «правка отбита».
+  Набор при этом отбивает подряд всё, включая сборку и тесты, и причины не называет.
+- **Правка shell-скрипта заменой по шаблону сверяется `bash -n` сразу.** Замена границ
+  конструкции не видит: `case` теряет свою `esac`, файл остаётся синтаксически неверным, а
+  гард с ошибкой синтаксиса отвечает ненулевым кодом — то есть «правка отбита». Два раза за
+  заход, и оба раза это выглядело дефектом самого гарда.
+- **Гард, подписанный не на то, что объявляет, выглядит работающим.** Событие и образец вызова
+  гард несёт сам, строкой `# rt-hook:`, а зовёт его образец в настройке агента — и эти двое
+  расходятся молча: путь гарда в настройке назван, файл разложен, набор сценариев зелёный.
+  Набор тут ничего не ловит намеренно — он зовёт гард напрямую с подставленным вводом и
+  объявления не читает вовсе. Так гейт правил и разбирал вызовы браузера веткой, которая не
+  исполнялась ни разу. Расхождение находит сверка раскладки: она сравнивает объявленный образец
+  с тем, под которым гард стоит, называет обе стороны и идёт в счёт расхождений. Правится
+  настройка, а верное значение лежит в гарде — тело его разбирает то, что объявлено.
+- **Разложенный файл узнаётся по шапке, а не по каталогу.** Раскладка ложится в те же
+  `tools/`, `.claude/hooks/` и `.claude/skills/`, где лежит своё, поэтому карта гейта,
+  написанная по путям, требует под него доменное правило — а оно уводит править файл на месте.
+  Правка на месте теряется на следующей раскладке, и до тех пор выглядит применённой. Ветка по
+  шапке ставится в карте первой и решает раньше путей.
+- **Настройки проверок сливаются по ключам, а списки — замещаются.** Объект `checks.json`
+  ложится поверх умолчания ключ за ключом на любой глубине: назвав один ключ борды, дерево не
+  теряет соседних. Список приходит целиком — назвав корни исходников, дерево получает ровно
+  названное, а не умолчание вместе со своим: «дописать в список» и «убрать из списка» в этой
+  записи неразличимы.
+- **Утверждение правила переезжает вместе с кодом.** Вынесенное в надстройку перестаёт
+  находиться по прежнему символу, и привязка в спутнике правила врёт молча — сверка спеков
+  ловит это, но только если её позвать.
+- **Признак по подстроке пути судит и то, что лежит вне дерева.** Гарды отдают в профиль
+  абсолютный путь целиком, и образец вида `*/projects/*` совпадает с домашним каталогом агента
+  ровно так же, как с кодом дерева: запись в файл вне репозитория была отбита гардом хода
+  работы с требованием замысла, к ней не относящегося. Путь в профиле сначала приводится к
+  корню дерева, и всё, что вне корня, признака не получает.

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

@@ -16,7 +16,7 @@ description: Правило под «Закон о поставке» для д
 
 | В законе                         | Здесь                                                    |
 | -------------------------------- | -------------------------------------------------------- |
-| попадание правки в главную ветку | слияние PR; оно же запускает выкатку — `azure-pipelines.yml`                                                                                                                                                                           |
+| попадание правки в главную ветку | слияние PR; чем запускается выкатка — слиянием или ручным запуском, — называет компаньон рядом                                                                                                                                                                           |
 | образ того коммита               | `IMAGE_TAG=<sha>` в командах `docker compose` на сервере                                                                                                                                                                               |
 | изменение хранилища              | миграция в `prisma/migrations/<метка>_<имя>/`                                                                                                                                                                                          |
 
@@ -54,9 +54,14 @@ flowchart TD
   не поднимает стенда, не снимает кадров и не собирает образов. Признак объявляется переменной
   задания и считается один раз, а не переспрашивается в каждом условии. Пропущенный шаг виден в
   прогоне пропущенным — молча выпавший читается как пройденный.
-- **Слияние в главную ветку выкатывает прод.** Фильтры путей конвейера покрывают документы
-  отдельно, поэтому переменные окружения, секреты и записи имён ставятся до слияния, а не
-  после.
+- **Чем запускается выкатка, называет дерево, а не правило.** У одного дерева прод едет от
+  слияния, у другого — ручным запуском, и сказанное здесь безусловно врёт про второе: правило
+  приходит в контекст каждой сессии, и прочитавший его считает влитое выкаченным. Прод,
+  отставший от главной ветки на сотни коммитов, так и читался поломкой приложения. Строка стоит
+  в компаньоне рядом, вместе со способом спросить, что выкачено на самом деле.
+- **Выкатка идёт от слияния — переменные окружения, секреты и записи имён ставятся до него.**
+  Фильтры путей конвейера покрывают документы отдельно. Дерево с ручным запуском эту статью
+  читает иначе: там граница — сам запуск, и до него ставится то же самое.
 - **Признак режима объявлен в образе, а не только в составе прода.** Значение, заданное
   составом, действует лишь на контейнер, поднятый этим составом; ручной прогон того же образа
   идёт с пустым значением, а пусто здесь означает локалхост — со всеми отладочными
@@ -78,9 +83,12 @@ flowchart TD
   образов идут на конвейере проверки PR, выкатка — нет: её держит условие по главной ветке у
   своего задания, а образ PR в реестр не уезжает.
 - **Расхождение прода с главной веткой видно сверкой очереди работ.** Рабочий элемент уходит из
-  очереди слиянием, но слияние — ещё не прод: отказавшая выкатка не трогает ни элемент, ни его
-  состояние, и заметить её неоткуда. Сверка спрашивает последний прогон главной ветки и судит
-  только завершённый: идущий ещё может кончиться выкаткой.
+  очереди слиянием, но слияние — ещё не прод: отказавшая или незапущенная выкатка не трогает ни
+  элемент, ни его состояние, и заметить её неоткуда. Сверка спрашивает последнюю успешную выкатку и считает, на сколько от неё ушла главная
+  ветка. Прогон главной ветки для этого не годится: там, где выкатку запускают рукой, слияние
+  прод не двигает вовсе, и прогон о нём не говорит ничего — прод отставал на 476 коммитов, а
+  сверка молчала. Дерево, не назвавшее рабочего потока выкатки, сверки не получает, и она
+  говорит об этом вслух.
 - **Цепочка миграций прогоняется с пустого хранилища до слияния.** Порядок применения
   лексикографический по имени каталога, а метку времени ставит момент создания: миграция из
   ветки, начатой раньше, встаёт перед той, от которой зависит.

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

@@ -16,7 +16,7 @@ description: Правило под «Закон о поставке» для д
 
 | В законе                         | Здесь                                                    |
 | -------------------------------- | -------------------------------------------------------- |
-| попадание правки в главную ветку | мерж PR; он же запускает выкатку — `.github/workflows/deploy.yml`                                                                                                                               |
+| попадание правки в главную ветку | мерж PR; чем запускается выкатка — слиянием или ручным запуском, — называет компаньон рядом                                                                                                                               |
 | образ того коммита               | `IMAGE_TAG=<sha>` в командах `docker compose` на сервере                                                                                                                                        |
 | изменение хранилища              | миграция в `prisma/migrations/<метка>_<имя>/`                                                                                                                                                   |
 
@@ -54,8 +54,14 @@ flowchart TD
   не поднимает стенда, не снимает кадров и не собирает образов. Признак считается один раз и
   объявляется выводом шага, а не переспрашивается в каждом условии. Пропущенный шаг виден в
   прогоне пропущенным — молча выпавший читается как пройденный.
-- **Мерж в главную ветку выкатывает прод.** Исключения по путям покрывают только документы,
-  поэтому переменные окружения, секреты и записи имён ставятся до мержа, а не после.
+- **Чем запускается выкатка, называет дерево, а не правило.** У одного дерева прод едет от
+  мержа, у другого — ручным запуском, и сказанное здесь безусловно врёт про второе: правило
+  приходит в контекст каждой сессии, и прочитавший его считает влитое выкаченным. Прод,
+  отставший от главной ветки на сотни коммитов, так и читался поломкой приложения. Строка стоит
+  в компаньоне рядом, вместе со способом спросить, что выкачено на самом деле.
+- **Выкатка идёт от мержа — переменные окружения, секреты и записи имён ставятся до него.**
+  Исключения по путям покрывают только документы. Дерево с ручным запуском эту статью читает
+  иначе: там граница — сам запуск, и до него ставится то же самое.
 - **Признак режима объявлен в образе, а не только в составе прода.** Значение, заданное
   составом, действует лишь на контейнер, поднятый этим составом; ручной прогон того же образа
   идёт с пустым значением, а пусто здесь означает локалхост — со всеми отладочными
@@ -85,9 +91,12 @@ flowchart TD
   образов идут на событии `pull_request`, выкатка — нет: её держит условие по главной ветке у
   своего задания, а образ PR в реестр не уезжает.
 - **Расхождение прода с главной веткой видно сверкой очереди работ.** Задача уходит из очереди
-  мержем, но мерж — ещё не прод: отказавшая выкатка не трогает ни задачу, ни её колонку, и
-  заметить её неоткуда. Сверка спрашивает последний прогон главной ветки и судит только
-  завершённый: идущий ещё может кончиться выкаткой.
+  мержем, но мерж — ещё не прод: отказавшая или незапущенная выкатка не трогает ни задачу, ни её
+  колонку, и заметить её неоткуда. Сверка спрашивает последнюю успешную выкатку и считает, на сколько от неё ушла главная
+  ветка. Прогон главной ветки для этого не годится: там, где выкатку запускают рукой, слияние
+  прод не двигает вовсе, и прогон о нём не говорит ничего — прод отставал на 476 коммитов, а
+  сверка молчала. Дерево, не назвавшее рабочего потока выкатки, сверки не получает, и она
+  говорит об этом вслух.
 - **Цепочка миграций прогоняется с пустого хранилища до мержа.** Порядок применения
   лексикографический по имени каталога, а метку времени ставит момент создания: миграция из
   ветки, начатой раньше, встаёт перед той, от которой зависит.

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

@@ -16,7 +16,7 @@ description: Правило под «Закон о поставке» для д
 
 | В законе                         | Здесь                                                    |
 | -------------------------------- | -------------------------------------------------------- |
-| попадание правки в главную ветку | слияние MR; оно же запускает выкатку — `.gitlab-ci.yml`                                                                                                                                               |
+| попадание правки в главную ветку | слияние MR; чем запускается выкатка — слиянием или ручным запуском, — называет компаньон рядом                                                                                                                                               |
 | образ того коммита               | `IMAGE_TAG=<sha>` в командах `docker compose` на сервере                                                                                                                                              |
 | изменение хранилища              | миграция в `prisma/migrations/<метка>_<имя>/`                                                                                                                                                         |
 
@@ -55,9 +55,14 @@ flowchart TD
   это сами, но по путям, а не по составу правки — совпадение пути ещё не значит, что задета
   сборка, поэтому признак объявляется явно и один раз. Пропущенный шаг виден в прогоне
   пропущенным — молча выпавший читается как пройденный.
-- **Слияние в главную ветку выкатывает прод.** Правила `only`/`rules` конвейера покрывают
-  документы отдельно, поэтому переменные окружения, секреты и записи имён ставятся до слияния,
-  а не после.
+- **Чем запускается выкатка, называет дерево, а не правило.** У одного дерева прод едет от
+  слияния, у другого — ручным запуском, и сказанное здесь безусловно врёт про второе: правило
+  приходит в контекст каждой сессии, и прочитавший его считает влитое выкаченным. Прод,
+  отставший от главной ветки на сотни коммитов, так и читался поломкой приложения. Строка стоит
+  в компаньоне рядом, вместе со способом спросить, что выкачено на самом деле.
+- **Выкатка идёт от слияния — переменные окружения, секреты и записи имён ставятся до него.**
+  Правила `only`/`rules` конвейера покрывают документы отдельно. Дерево с ручным запуском эту
+  статью читает иначе: там граница — сам запуск, и до него ставится то же самое.
 - **Признак режима объявлен в образе, а не только в составе прода.** Значение, заданное
   составом, действует лишь на контейнер, поднятый этим составом; ручной прогон того же образа
   идёт с пустым значением, а пусто здесь означает локалхост — со всеми отладочными
@@ -80,9 +85,12 @@ flowchart TD
   образов идут на конвейере запроса слияния, выкатка — нет: её держит правило по главной ветке
   у своего задания, а образ PR в реестр не уезжает.
 - **Расхождение прода с главной веткой видно сверкой очереди работ.** Задача уходит из очереди
-  слиянием, но слияние — ещё не прод: отказавшая выкатка не трогает ни задачу, ни её список, и
-  заметить её неоткуда. Сверка спрашивает последний конвейер главной ветки и судит только
-  завершённый: идущий ещё может кончиться выкаткой.
+  слиянием, но слияние — ещё не прод: отказавшая или незапущенная выкатка не трогает ни задачу,
+  ни её список, и заметить её неоткуда. Сверка спрашивает последнюю успешную выкатку и считает, на сколько от неё ушла главная
+  ветка. Прогон главной ветки для этого не годится: там, где выкатку запускают рукой, слияние
+  прод не двигает вовсе, и прогон о нём не говорит ничего — прод отставал на 476 коммитов, а
+  сверка молчала. Дерево, не назвавшее рабочего потока выкатки, сверки не получает, и она
+  говорит об этом вслух.
 - **Цепочка миграций прогоняется с пустого хранилища до слияния.** Порядок применения
   лексикографический по имени каталога, а метку времени ставит момент создания: миграция из
   ветки, начатой раньше, встаёт перед той, от которой зависит.

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

@@ -142,7 +142,12 @@ flowchart TD
 - **Черновик при зелёном прогоне на вершине — расхождение сверки.** У черновика кнопка слияния
   заблокирована самим хостингом: зелёная страница PR владельцу ничего не разрешает, а список, в
   котором всё серое, читается как «работа не сделана». Гард снятия черновика сюда не достаёт —
-  он судит один ход и молчит, пока ветка везёт папку своей задачи.
+  он судит один ход, а PR стоит в очереди днями.
+- **Открытие PR отбивается, пока ветка везёт папку своей задачи.** Уборка стоит до открытия, а
+  не после одобрения: кнопку слияния нажимает человек на странице хостинга, где гардов нет
+  вовсе, и вливает он, как только видит зелёное. Отказ на слиянии остаётся вторым рубежом — он
+  ловит слияние, идущее командой, — но первым спрашивается открытие: это последняя точка, где
+  отказ ещё виден тому, кто может его выполнить.
 - **Конфликтующий открытый PR — расхождение сверки очереди работ.** Конфликт приезжает в
   отданный PR чужим слиянием, без единого действия автора: основание, проверенное на открытии,
   устаревает в ту минуту, когда владелец влил соседнюю работу. Гард снятия черновика сюда не