@rt-tools/agent-kit 0.8.2 → 0.9.0

package/assets/hooks/task-flow-guard.sh

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# rt-hook: PreToolUse Edit|Write|MultiEdit
+# rt-hook: PreToolUse Edit|Write|MultiEdit|Bash|mcp__webstorm__create_new_file|mcp__webstorm__execute_terminal_command|mcp__webstorm__execute_tool
 # Требует: hooks/profile-check.sh
 # PreToolUse guard for Edit|Write|MultiEdit: код не пишется раньше замысла.
 #
@@ -49,9 +49,23 @@ case "$tool" in
     # Второй ярус: та же правка, положенная командой оболочки. Без него отказ гарда обходится
     # сменой не инструмента, а способа записи — перенаправлением, `sed -i`, интерпретатором с
     # heredoc. Разбор — `2026-08-15-guard-denied-shell-wrote-anyway.md`.
-    Bash)
+    #
+    # Терминал среды исполняет ту же командную строку и кладёт её в то же поле: без этих двух
+    # имён гард стоял бы объявленным на них и молча пропускал — состояние хуже необъявленного,
+    # потому что снаружи выглядит закрытым.
+    Bash | mcp__webstorm__execute_terminal_command | mcp__webstorm__execute_tool)
         cmd="$(printf '%s' "$input" | jq -r '.tool_input.command // empty' 2>/dev/null)"
         [ -z "$cmd" ] && exit 0
+        # Универсальный исполнитель прячет настоящую команду во вложенной строке: без её разбора
+        # путь стоит за кавычкой, и до него не дотягивается ни один образец.
+        if [ "$tool" = "mcp__webstorm__execute_tool" ] && command -v perl >/dev/null 2>&1; then
+            inner="$(printf '%s' "$cmd" | perl -0ne '
+                if (/--command(?:=|\s+)(?:"((?:[^"\\]|\\.)*)"|\x27([^\x27]*)\x27|(.+))/s) {
+                    print defined $1 ? $1 : (defined $2 ? $2 : $3);
+                }
+            ' 2>/dev/null)"
+            [ -n "$inner" ] && cmd="$inner"
+        fi
         rt_needs rt_shell_writes task-flow-guard || exit 0
         rt_needs rt_shell_paths task-flow-guard || exit 0
         rt_shell_writes "$cmd" || exit 0

package/assets/hooks/waiting-turn-guard.sh

@@ -0,0 +1,116 @@
+#!/usr/bin/env bash
+# rt-hook: Stop
+# Гард ожидания: ход, сообщающий владельцу о чужом шаге, не заканчивается, пока в нём не было ни
+# одного действия по следующей задаче. Stop.
+#
+# Зачем именно так. Статья «ожидание прогона работой не занимают» держится памятью исполнителя, и
+# держится плохо: образец сообщения владельцу кончается фразой о следующей задаче, а фраза
+# исполняется как обещание — заход произносит её и кончает ход. Ход, в котором не сделано ничего,
+# ничем себя не выдаёт: ни правкой файла, ни командой, — и промах виден только владельцу, только
+# по тому, что работа не двигается, и только когда он спросит прямо.
+#
+# Чужой шаг узнаётся по двум признакам, и оба берутся из хода, а не из сети. Первый — открытие
+# PR: работа отдана, и дальше её двигает владелец. Второй — прочитанный красный прогон: чинить
+# его надо, но ход, в котором его прочитали и не сделали ничего, — та же пустота. Само чтение
+# прогона признаком не является: конец прогона читают и затем, чтобы пойти чинить; значит
+# красный ответ, а он лежит в выводе команды — там же, в записи хода.
+#
+# Спросить хостинг было бы точнее, но сетевой вызов на завершении хода падает вместе со связью и
+# отбивал бы работу вместо промаха.
+#
+# Что считается действием: заведение задачи, заведение ветки, перевод колонки очереди работ,
+# заведение папки задачи. Набор открыт и пополняется правкой — полнота его открытый вопрос, а не
+# обещание.
+#
+# Чего гард не судит. Ход, в котором о чужом шаге не сказано ничего, — здесь он молчит: пустой
+# ход неотличим от хода, которому нечего было делать. Это известная его граница. Зелёный прогон
+# он тоже не судит: за ним идёт своя работа — уборка и снятие черновика, — а не чужой шаг.
+#
+# ОТКАЗ В ПОЛЬЗУ РАБОТЫ: при любой ошибке, нехватке `jq`, отсутствии записи хода и повторном
+# заходе ход РАЗРЕШАЕТСЯ (exit 0). Сломанный гард не имеет права заклинить разговор.
+
+input="$(cat 2>/dev/null)"
+[ -z "$input" ] && exit 0
+
+command -v jq >/dev/null 2>&1 || exit 0
+
+# Повторный заход по тому же ходу не судится: гард сказал своё один раз и отпускает.
+active="$(printf '%s' "$input" | jq -r '.stop_hook_active // false' 2>/dev/null)"
+[ "$active" = "true" ] && exit 0
+
+transcript="$(printf '%s' "$input" | jq -r '.transcript_path // empty' 2>/dev/null)"
+[ -z "$transcript" ] && exit 0
+[ -f "$transcript" ] || exit 0
+
+# Открытие PR у каждого хостинга своё, и гард переносится между ними целиком: набор называет все
+# три формы, а не ту, что стоит в этом дереве. Правка тела PR сюда не входит — она не открывает
+# ничего.
+opened_re='gh[^|;&]*pr[[:space:]]+create|api[^|;&]*-X[[:space:]]+POST[^|;&]*/pulls|glab[^|;&]*mr[[:space:]]+create|az[[:space:]]+repos[[:space:]]+pr[[:space:]]+create'
+
+# Чтение прогона — второй случай чужого шага. Сам по себе он ничего не значит: конец прогона
+# читают и затем, чтобы пойти чинить. Значит красный ответ, а он лежит не в команде, а в её
+# выводе — там же, в записи хода, и сети для этого не нужно.
+read_re='run[[:space:]]+(list|view|watch)|pipelines[[:space:]]+runs'
+red_re='completed[[:space:]]+failure|"conclusion"[[:space:]]*:[[:space:]]*"failure"|conclusion:[[:space:]]*failure|completed with .failure.|run[[:space:]]+failed'
+
+# Первое действие по следующей задаче. Заведение папки стоит здесь наравне с командами: работа
+# по уже заведённому номеру начинается именно с неё. Правка кода в ветке того же PR действием
+# по следующей задаче не считается — она чинит прежнюю, а не двигает работу дальше.
+moved_re='task:new|task:move|checkout[[:space:]]+-b|docs/tasks/'
+
+# Ход — это всё, что записано после последнего настоящего ввода владельца. Ответ инструмента
+# приходит той же ролью, поэтому строки с `tool_result` вводом не считаются.
+#
+# Хвост в 400 строк: запись хода растёт всю сессию, а судится только последний ход.
+verdict="$(tail -n 400 "$transcript" 2>/dev/null | jq -s -r \
+    --arg opened "$opened_re" --arg moved "$moved_re" --arg read "$read_re" --arg red "$red_re" '
+    def is_input:
+        .type == "user"
+        and (((.message.content // []) | if type == "array"
+                then ([.[] | select(.type == "tool_result")] | length)
+                else 0 end) == 0);
+
+    (map(is_input) | rindex(true)) as $i
+    | (if $i == null then [] else .[$i:] end) as $turn
+    | [$turn[] | select(.type == "assistant") | (.message.content // [])[] | select(.type == "tool_use")] as $uses
+    | ($uses | map((.input.command // "")) | join("\n")) as $ran
+    # Ответ инструмента берётся текстом, а не в записи JSON: у той таб и кавычка уезжают
+    # экранированными, и образец по ним не попадает вовсе. Приходит он и строкой, и списком
+    # блоков — обе формы сводятся к одному тексту.
+    | ([$turn[] | select(.type == "user") | .message.content // [] | select(type == "array") | .[]
+          | select(.type == "tool_result") | .content
+          | if type == "string" then .
+            elif type == "array" then (map(if type == "object" then (.text // "") else tostring end) | join("\n"))
+            else tostring end] | join("\n")) as $out
+    | ($ran | test($opened; "i")) as $opened_pr
+    | (($ran | test($read; "i")) and ($out | test($red; "i"))) as $red_run
+    | ($ran | test($moved; "i")) as $went_on
+    | if $went_on then "pass"
+      elif $opened_pr then "owe:pr"
+      elif $red_run then "owe:run"
+      else "pass" end
+' 2>/dev/null)"
+
+case "$verdict" in
+    owe:pr) said="в этом ходе открыт PR" ;;
+    owe:run) said="в этом ходе прочитан красный прогон" ;;
+    *) exit 0 ;;
+esac
+
+reason="BLOCKED by waiting-turn-guard: ${said}, а действия по следующей задаче в нём нет ни одного. Ожидание чужого шага заходом не занимают: прогон, разбор и слияние идут на стороне и быстрее от взгляда не становятся.
+
+Сказать «беру следующую задачу» — не то же самое, что взять её: фраза живёт до конца хода, а работа не двигается, и заметить это может только владелец.
+
+Тем же ходом делается первое действие по следующей задаче — заведение задачи, ветки или папки:
+
+    npm run task:new -- --title '<Что не так>' --slug <slug>
+    git checkout -b <КЛЮЧ>-<номер>-<slug>
+
+Конец прогона узнаётся возвратом фоновой команды, а не взглядом на страницу.
+
+Гард судит один ход: следующий заход не отбивается."
+
+jq -n --arg r "$reason" '{decision:"block",reason:$r}' 2>/dev/null \
+    || printf '{"decision":"block","reason":"waiting-turn-guard: PR открыт — тем же ходом берётся следующая задача."}\n'
+
+exit 0

package/assets/laws/delivery.md

@@ -10,6 +10,18 @@
   очередь не попала, никто не видит, и работа за ней не планировалась.
 - **Правка попадает в главную ветку только через отдельную ветку.** Прямая запись в главную
   лишает правку и обсуждения, и возможности откатить её одним движением.
+- **В очереди работ стоят задачи, а не PR о них.** У задачи и её PR один номер и одна судьба,
+  поэтому вторая карточка о той же работе ничего не добавляет — она удваивает очередь и врёт о
+  её длине. Читают очередь затем, чтобы увидеть, что сделано и что осталось; PR отвечает на
+  другой вопрос — как именно сделано, — и попадают в него из карточки задачи, где связь с ним
+  и так стоит. Карточка PR при этом живёт своей жизнью: закрывается позже задачи, висит в
+  очереди после слияния и остаётся в ней навсегда, потому что колонки под неё нет.
+- **Проверка не гоняет того, что правка не может сломать.** Набор, одинаковый для любой правки,
+  выглядит строгим, а работает наоборот: прогон, который длится вдесятеро дольше нужного, учат
+  не ждать, а обходить. Состав набора выводится из состава правки — из того, что она задела, а
+  не из того, кем она названа; правка, не тронувшая ни строки кода, не собирает образов и не
+  снимает кадров. Пропущенное при этом называется пропущенным: молча выпавший шаг читается как
+  пройденный.
 - **У задачи одна ветка, у ветки одна задача.** Откат снимает всё, что въехало этой веткой,
   разом: две задачи в ней откатятся только вместе, а задача, въехавшая двумя ветками, после
   отката одной останется наполовину сделанной — и в очереди работ этого не видно. Работа,
@@ -71,6 +83,22 @@
   иначе «сошлось» значит в этих двух местах разное.
 - **Документ едет вместе с правкой, которую он описывает.** Ни сборка, ни проверки текстов
   не читают, поэтому расхождение копится молча и потом выглядит действующей справкой.
+- **Работа, меняющая код, кончается открытым PR.** PR — единственное место, где человек видит
+  правку целиком, отвечает на неё и вливает её; коммит в ветке и запушенная ветка этого места
+  не заменяют. Пока PR не открыт, работа сделанной не считается, сколько бы её ни было в
+  истории ветки: разбор по ней невозможен, а человек о ней не знает. Открывается PR тем же
+  ходом, которым исполнитель говорит, что работу отдаёт, — а не следующим заходом и не по
+  напоминанию.
+- **PR, не готовый к слиянию, помечается черновиком.** Открытый PR читается как приглашение
+  влить, и человек нажимает слияние, не спрашивая, кончилась ли работа. Черновик разводит два
+  состояния, которые иначе выглядят одинаково: правка выложена на обозрение — и правка готова
+  поехать в главную ветку. Помечается им всё, что ждёт прогона, доработки или ответа на
+  вопрос; вопрос при этом задаётся в самом PR, а не остаётся в голове исполнителя.
+- **Снятие черновика — отдельный ход, и им исполнитель отвечает за готовность.** Черновик
+  снимается тогда, когда проверки пройдены, доработок не осталось и работа сходится с тем,
+  ради чего заводилась задача. Пока он стоит, молчание исполнителя значит «ещё не готово», и
+  человек ничего не должен переспрашивать; после снятия оно значит «можно вливать», и цена
+  ошибки здесь — правка в главной ветке.
 - **PR о сделанном остаётся верным до самого слияния.** Он описывает дерево на день, когда
   его написали, а разбора ждёт днями: за это время главная ветка вливается в ветку, и
   утверждение PR о соседних файлах становится неправдой молча — тел PR не читает ни
@@ -81,6 +109,13 @@
   человека и только про названный PR; молчание разрешением не бывает, а слово, сказанное об
   одном PR, на следующий не переносится. Иначе разбор проходит тот, кого разбирают, и
   очередь PR выглядит разобранной, не будучи ею.
+- **Требование, стоящее перед необратимым шагом, стоит там, где этот шаг совершают.** Гард на
+  машине исполнителя судит его команды и молчит о том же действии, совершённом кнопкой у
+  хостинга: обход выходит не намеренным, а незамеченным — нажавший не знает, что чего-то не
+  хватало. Требование либо переносится туда, где нажимают, либо объявляется тому, кто нажимает,
+  до нажатия. Иначе оно держится не собой, а тем, что необратимый шаг каждый раз делает тот же
+  человек: папка закрытой задачи так и уехала в главную ветку вместе со своей договорённостью, и
+  вынимать её пришлось отдельной задачей.
 - **Слияние в главную ветку ещё не означает, что правка доехала.** Отказ выкатки не трогает ни
   задачу, ни очередь работ, поэтому расхождение главной ветки с тем, что работает, обязано быть
   видно там, где очередь читают. Иначе следующие работы вливаются поверх поломки, которую не

package/assets/laws/project-documentation.md

@@ -77,3 +77,21 @@
 - **Работа, которая переносит решения, называет для каждого, куда оно ушло.** Иначе по
   описанию прошлого не отличить решение, ставшее правилом, от решения, потерянного при
   переносе: оба выглядят одинаково — записью, на которую никто не ссылается.
+- **Текст, раздаваемый наружу, судится не слабее своей копии у потребителя.** Требование,
+  стоящее к копии и не стоящее к источнику, находит промах у того, кто его не делал и починить
+  не может: до потребителя промах доезжает целым, а краснеет уже там.
+- **Редакция текста, которую это дерево не выбрало, судится наравне с выбранной.**
+  Непрочитанная редакция расходится с прочитанной молча, и узнаёт об этом первый, кто её
+  выберет, — то есть тот, у кого нет ни истории расхождения, ни повода его искать.
+- **Набор обязательных разделов объявлен отдельно, и образец ему не хозяин.** Образец —
+  черновик для того, кто заводит текст, и стареет он первым. Набор, выведенный из образца, либо
+  объявляет расхождением весь корпус разом, либо не замечает ничего.
+- **Требование, которого никто не формулировал, молчит, а не отказывает.** Отказ на предмете
+  без объявленного требования гасят списком исключений, а список исключений через месяц
+  становится рабочим путём — и гасит вместе с шумом то, ради чего проверка заводилась.
+- **Два текста об одном либо говорят одно, либо один из них неправ.** Согласие текстов между
+  собой не следует ни из целостности ссылок, ни из полноты разделов: оба проходят любую такую
+  проверку, а исполнитель берёт тот, который прочитал раньше. Ищется это чтением — считать
+  здесь нечего.
+- **Изображение правится тем же изменением, что и текст, который оно изображает.** Разойдясь,
+  схема и проза остаются читаемыми обе, и первым это замечает тот, кто пошёл по схеме.

package/assets/laws/work-conduct.md

@@ -13,6 +13,15 @@
 - **Пробел закрывается вопросом владельцу, а не догадкой.** Догадка неотличима от знания:
   она попадает в работу молча и обнаруживается только при приёмке, когда переделывать дороже
   всего.
+- **Работа, объявленная сборкой по образцу, начинается с чтения самого образца.** Пересказ
+  образца образцом не является: по нему собирается понимание того, кто пересказывал, и
+  расхождение всплывает на приёмке целой работой, а не строкой. Читается та часть образца,
+  которую работа повторяет, и читается целиком — об устройстве чужого дерева по одному его
+  файлу не судят.
+- **Образец, названный однажды, доступен каждому заходу работы.** Где он лежит, записано
+  там, где заход найдёт это без владельца. Иначе второй заход собирает по памяти первого,
+  третий — по пересказу второго, и к четвёртому от образца не остаётся ничего, кроме слова
+  «образец».
 - **Вопрос, у которого есть очевидный ответ, работу не останавливает.** Исполнитель называет
   допущение, идёт дальше и записывает его туда же, где идёт работа. Останавливает только тот
   пробел, при котором любая догадка делает работу опасной или бесполезной. Вопрос, заданный
@@ -136,6 +145,22 @@
 - **Работа, отданная на разбор, освобождает исполнителя, а не останавливает его.** Отданное на
   разбор ждёт владельца, а не машину: следующая задача эпика берётся тем же движением, которым
   предыдущая ушла на разбор.
+- **Ожидание машины работой не занимают.** Проверка, идущая на стороне, не спрашивает
+  исполнителя ни о чём и не идёт быстрее оттого, что он на неё смотрит. Пока она идёт, работа
+  продолжается: берётся следующая задача, а к проверке возвращаются тем ходом, которым читают
+  её конец. Заход, проведённый в ожидании, стоит ровно столько же, сколько заход, в котором
+  сделана задача, — и не даёт ничего.
+- **Ожидание, которое всё-таки останавливает работу, называется владельцу отдельно и прямо.**
+  Есть случаи, где дальше и вправду не пройти: следующая задача стоит на неразобранной, или
+  правка ждёт решения, которого нет ни у кого, кроме владельца. Тогда исполнитель говорит три
+  вещи — что именно стоит, чего оно ждёт и что владелец может с этим сделать: разобрать работу
+  первой или снять ожидание своим словом. Сказанное вперемешку с отчётом о сделанном не
+  читается: остановка называется отдельно от всего остального.
+- **Разбор закрытой работы идёт своим ходом и работу не задерживает.** Он смотрит на то, что
+  видно только заходу, который работу вёл, поэтому пропустить его нельзя; но и держать ради
+  него следующую задачу незачем — он ничего не спрашивает у исполнителя, пока идёт. Его находки
+  записываются туда, где их найдут после слияния работы, и показываются владельцу целиком, а не
+  уезжают наружу сами: что из них станет правкой, решает он.
 - **Отдав работу на разбор, исполнитель называет, чего ждёт и что сделает следом.** Владелец
   видит не голову исполнителя, а страницу работы: зелёная проверка и доступное действие
   читаются как «всё кончено». Названное вслух ожидание — единственное, что отличает «жду

package/assets/patterns/admin-lists-screen.md

@@ -2,7 +2,7 @@
 name: admin-lists-screen
 kind: pattern
 rule: lists
-description: Паттерн правила lists. Брать при сборке или правке списочного экрана админки — готовый порядок блоков, разметка <префикс>-table, клик по строке, меню строки с vmTableRowActionsRowType, сортируемый заголовок, слоты тулбара, тост отказа.
+description: Паттерн правила lists. Брать при сборке или правке списочного экрана админки — готовый порядок блоков, разметка <префикс>-table, клик по строке, меню строки с колонкой действий и предикатом строки, сортируемый заголовок, слоты тулбара, тост отказа.
 ---
 
 # Собрать списочный экран
@@ -25,7 +25,7 @@ description: Паттерн правила lists. Брать при сборке
     <header rtElem="header">
         <!-- div rtElem="header-main" c h1 rtElem="title" + p rtElem="hint" -->
         <<префикс>-toolbar>
-        <!-- vmToolbarLeft / vmToolbarRight -->
+        <!-- <префикс>ToolbarLeft / <префикс>ToolbarRight -->
         <div rtElem="scroll">
             <!-- overflow-x: auto -->
             <<префикс>-table rtElem="table">
@@ -42,9 +42,9 @@ description: Паттерн правила lists. Брать при сборке
 ## Таблица
 
 ```html
-<<префикс>-table #rowsTable="vmTable" rtElem="table" clickable [ariaLabel]="'bookingsTableAria' | transloco" [emptyMessage]="'bookingsEmpty'
-| transloco" [tableId]="tableId" [dataSource]="rows()" [columnsConfig]="columnsConfig()" [rowHasActions]="hasRowActions"
-[loading]="loading()">
+<<префикс>-table #rowsTable="<префикс>Table" rtElem="table" clickable [ariaLabel]="'recordsTableAria' | transloco"
+[emptyMessage]="'recordsEmpty' | transloco" [tableId]="tableId" [dataSource]="rows()" [columnsConfig]="columnsConfig()"
+[rowHasActions]="hasRowActions" [loading]="loading()">
 ```
 
 - `tableId` — ключ, под которым хранится выбор столбцов; он же уходит в асайд настроек.
@@ -57,8 +57,8 @@ description: Паттерн правила lists. Брать при сборке
 <tr
     *cdkRowDef="let row; columns: rowsTable.displayedColumns()"
     cdk-row
-    qa-dataid="bookings-row"
-    vmTableRow
+    qa-dataid="records-row"
+    <префикс>TableRow
     (activated)="openAside(row)"></tr>
 ```
 
@@ -67,13 +67,24 @@ description: Паттерн правила lists. Брать при сборке
 ## Меню строки
 
 ```html
-<ng-template vmTableRowActions let-row [vmTableRowActionsRowType]="rows()"></ng-template>
+<<префикс>-table … [showRowActions]="true" [rowHasActions]="hasRowActions" [loading]="loading()">
+    <ng-template <префикс>TableRowActions let-row [<префикс>TableRowActionsRowType]="rows()"></ng-template>
 ```
 
 ```typescript
-protected readonly hasRowActions = (row: IBooking.State): boolean => row.canConfirm || row.canReject;
+protected readonly hasRowActions: I<Префикс>Table.RowActionsPredicate<IRecord.Row> = recordRowHasActions;
 ```
 
+Входа два, и они не заменяют друг друга. `showRowActions` заводит саму колонку действий — по
+умолчанию он опущен, и без него таблица рисует одни объявленные столбцы: ни шаблон действий, ни
+предикат колонки не добавляют. `rowHasActions` решает, показывать ли кнопку у конкретной
+строки, и колонки не заводит вовсе. Экран ролей так и вышел с четырьмя столбцами и
+недостижимыми действиями: сборка, линт и юниты на правилах строки при этом зелёные, а нашёл
+это прогон сквозной спеки.
+
+Ячейка действий скрыта, пока указатель не на строке, — сквозная спека наводит на строку до
+нажатия.
+
 Доступность действия лежит полем строки (`canConfirm`, `canReject`), а не вызовом метода
 компонента. Действие, которого записи нельзя сделать, из меню убирается целиком. Необратимое
 несёт `danger`, `confirmTitle` и `confirmMessage` с последствием — не «Вы уверены?», а что
@@ -82,7 +93,7 @@ protected readonly hasRowActions = (row: IBooking.State): boolean => row.canConf
 ## Сортируемый заголовок
 
 ```html
-<th *cdkHeaderCellDef cdk-header-cell vmSortHeader="checkIn">{{ 'bookingsCheckIn' | transloco }}</th>
+<th *cdkHeaderCellDef cdk-header-cell <префикс>SortHeader="createdAt">{{ 'recordsCreatedAt' | transloco }}</th>
 ```
 
 Колонка помечается `sortable: true` в `columnsConfig`. Заголовок переключает сортировку по
@@ -95,8 +106,8 @@ protected readonly hasRowActions = (row: IBooking.State): boolean => row.canConf
 
 ## Тулбар
 
-Тулбар поделён на две части слотами: `vmToolbarLeft` — то, что меняет выборку,
-`vmToolbarRight` — действия над списком. Своей раскладки внутри тулбара экран не заводит.
+Тулбар поделён на две части слотами: `<префикс>ToolbarLeft` — то, что меняет выборку,
+`<префикс>ToolbarRight` — действия над списком. Своей раскладки внутри тулбара экран не заводит.
 
 Левый слот — фильтры и поиск. Правый — иконки `<префикс>-icon-button variant="primary"` с парой
 `tooltip` + `ariaLabel` одного текста: обновление (`sync`), настройки столбцов (`sliders-v`),
@@ -105,7 +116,7 @@ protected readonly hasRowActions = (row: IBooking.State): boolean => row.canConf
 ## Отказ загрузки
 
 ```typescript
-this.#notifications.error(this.#transloco.translate(this.#store.errorKey() ?? 'bookingsLoadFailed'));
+this.#notifications.error(this.#transloco.translate(this.#store.errorKey() ?? 'recordsLoadFailed'));
 ```
 
 Ключ читается сразу после запроса, а не подпиской на сигнал стора: стор делят список и панель
@@ -118,7 +129,7 @@ this.#notifications.error(this.#transloco.translate(this.#store.errorKey() ?? 'b
 npx nx build admin
 ```
 
-Продовая сборка обязательна: без `[vmTableRowActionsRowType]` тип `let-row` выводится как
+Продовая сборка обязательна: без `[<префикс>TableRowActionsRowType]` тип `let-row` выводится как
 `unknown`, и падает только она — юниты и дев-сервер проходят.
 
 ## Частые промахи

package/assets/patterns/admin-nav-item.md

@@ -65,7 +65,7 @@ description: Паттерн правила navigation. Брать при зав
 - Обход одного верхнего ряда при поиске владельца адреса: разделы обходятся вместе с пунктами
   их панелей, иначе вложенный экран остаётся без гейтинга.
 - Подсказка у доступного пункта: она дословно повторяет подпись рядом и не добавляет ничего.
-- `vmPopoverTrigger` не поставлен явно: директива попапа по умолчанию открывается нажатием, и
+- `<префикс>PopoverTrigger` не поставлен явно: директива попапа по умолчанию открывается нажатием, и
   два соседних элемента одного ряда ведут себя по-разному.
 - Переезд адреса без правки сквозных спек: они ходят по адресам, и прогон станет красным.
 - Иконка, подобранная «похожая»: отсутствующая добавляется в спрайт и в `<префикс>-icon-names.ts`.

package/assets/patterns/component-structure-new.md

@@ -77,7 +77,7 @@ export class ComponentNameComponent {
 ## `qa-dataid` — на каждый интерактивный элемент
 
 ```html
-<button vmButton qa-dataid="calendar-retry-prices" type="button" (click)="retryPrices.emit()">Повторить</button>
+<button <префикс>Button qa-dataid="calendar-retry-prices" type="button" (click)="retryPrices.emit()">Повторить</button>
 <div rtElem="grid" qa-dataid="admin-calendar-grid"></div>
 ```
 

package/assets/patterns/entity-aside.md

@@ -132,5 +132,7 @@ constructor() {
   обводку фокуса у края прокрутки.
 - Панель, остающаяся открытой после успеха, не сбросила нетронутость (`markAsPristine`) —
   вопрос о правках задаётся сразу после записи.
-- Отключённые поля ввода вместо данных: запись, которую только смотрят, показывается через
-  `<dl>`, `<префикс>-detail-list`, `<префикс>-info-item`.
+- Отключённые поля ввода вместо данных: запись, которую только смотрят, показывается готовым
+  списком свойств кита — `<префикс>-detail-list`, `<префикс>-info-item`. Своя разметка на `<dl>`
+  идёт последней и только как разовое отступление: она и есть отход от общего вида, а решает
+  его владелец, — перечень, ставящий её первой, учит обходить готовое раньше, чем спросить.

package/assets/patterns/git-workflow-commit.azure.md

@@ -2,7 +2,7 @@
 name: git-workflow-commit
 kind: pattern
 rule: git-workflow
-description: Паттерн правила git-workflow для дерева в Azure DevOps. Брать на заведение рабочего элемента, ветки, коммит, пуш и создание PR — заведение элемента со всеми шагами, перевод по состояниям, слияние двух задач в одну, сверка очереди работ, работа от учётной записи машинной работы, формат заголовка, привязка PR к элементу, ревьювер, исполнитель и метки, чеклист проверок до публикации, обход требования документа. Не брать для миграций и перезапуска прода — это паттерны git-workflow-migration и git-workflow-restart.
+description: Паттерн правила git-workflow для дерева в Azure DevOps. Брать на заведение рабочего элемента, ветки, коммит, пуш и создание PR — заведение элемента со всеми шагами, перевод по состояниям, слияние двух задач в одну, сверка очереди работ, работа от учётной записи машинной работы, формат заголовка, привязка PR к элементу, ревьювер, исполнитель и метки, образец тела PR с разделом об оставшемся шаге, чеклист проверок до публикации, обход требования документа. Не брать для миграций и перезапуска прода — это паттерны git-workflow-migration и git-workflow-restart.
 ---
 
 # Ветка, коммит и PR
@@ -169,6 +169,35 @@ PR       [86] Письмо владельцу с незаполненным ад
 Тип и область — `fix(site):`, `docs(common):` — в заголовок PR не идут: это формат заголовка
 коммита, и там его сверяет `commitlint`.
 
+## Не готовое к слиянию открывается черновиком
+
+Правка кода отдаётся человеку открытым PR: запушенная ветка ему не показывается нигде. Открытый
+PR при этом читается как приглашение влить, поэтому у незаконченной работы он открывается
+черновиком — завершение у черновика хостинг блокирует сам:
+
+```bash
+AZURE_DEVOPS_EXT_PAT="$TOKEN" az repos pr create --draft true --title '[<КЛЮЧ>-86] …' \
+    --description "$(cat тело.md)"
+```
+
+Конвейер проверок у черновика по умолчанию не запускается: молчание прогона за зелёный прогон
+не принимается, и набор гоняется на своей машине либо запуском вручную.
+
+Черновиком идёт всё, что ждёт прогона конвейера, доработки или ответа на вопрос. Вопрос
+задаётся в самом PR, а не остаётся в голове исполнителя: человек читает PR, а не переписку
+захода.
+
+Снимается черновик отдельным вызовом, и это тот самый ход, которым исполнитель говорит, что
+решение готово:
+
+```bash
+AZURE_DEVOPS_EXT_PAT="$TOKEN" az repos pr update --id 86 --draft false
+```
+
+До снятия молчание исполнителя значит «ещё не готово», после — «можно вливать». Снятие
+черновика и просьба влить идут одним ходом: снятый черновик, о котором человеку не сказали,
+ждёт разбора ровно так же, как не снятый.
+
 ## PR привязывается к элементу при создании
 
 Привязка задаётся флагом, а не правкой после: у токена может не быть права править чужой
@@ -197,6 +226,46 @@ az repos pr update --id 205 --description "$(cat тело.md)"
 Правка описания переписывает его целиком. Тело перечитывается всякий раз, когда в ветку что-то
 влилось после публикации: PR утверждает про дерево, а дерево с тех пор изменилось.
 
+## Образец тела PR
+
+Четыре раздела, и порядок между ними один: строка связи, что сделано, чем подтверждено,
+оставшийся шаг. Раздел, которому нечего сказать, пишется словами — пустой заголовок и снятый
+заголовок читаются одинаково, а значат разное.
+
+```markdown
+Закрывает рабочий элемент 86.
+
+## Что сделано
+
+- <правка, названная тем, что она меняет для читателя, а не тем, какие файлы задела>
+
+## Чем подтверждено
+
+- <проверка>: <её вывод одной строкой>
+- Не гонялось: <что в набор не вошло и почему>
+
+## Оставшийся шаг
+
+После одобрения ветка получает ещё один коммит — разбор папки задачи, — и только потом
+вливается. До этого коммита вливать рано: папка уедет в главную ветку неразобранной.
+```
+
+Раздел «Оставшийся шаг» стоит последним и переписывается тем же вызовом, что и остальное тело,
+— в тот ход, которым папка разбирается и снимается черновик:
+
+```markdown
+## Оставшийся шаг
+
+Не осталось: папка задачи разобрана коммитом `<sha>`, черновик снят. Можно вливать.
+```
+
+Стоит он там потому, что решение о слиянии принимается на этой странице, а не в переписке:
+сказанное владельцу вслух живёт до следующей реплики, а тело лежит у самой кнопки. Одно другого
+не отменяет — порядок обоих сообщений владельцу описывает паттерн закрытия работы.
+
+Проверить тело машиной нечем: ни одна сверка его не читает, а хостинг спрашивает только про
+заголовок. Держится образец тем, кто пишет тело, — как и слова вслух.
+
 ## Состояние PR читается, а не додумывается
 
 Команды правки отвечают нулевым кодом и тогда, когда ничего не сделали. Поэтому после них PR
@@ -244,7 +313,10 @@ npm run task:move -- 86 in-review
    `browser-verification-measure`.
 9. **Правка разметки публичного сайта проверена на прод-сборке по всем локалям перевода** —
    паттерн `seo-verify`.
-10. **PR привязан к рабочему элементу**, ревьювер и исполнитель стоят.
+10. **PR привязан к рабочему элементу**, ревьювер и исполнитель стоят, а тело собрано по
+    образцу — разделы «Что сделано», «Чем подтверждено» и «Оставшийся шаг». Раздел оставшегося
+    шага к этому моменту говорит, что шагов не осталось: черновик снимается после разбора
+    папки, а не до него.
 11. **Заголовок PR несёт номер элемента и называет работу сделанной:** `[<номер>] <Что
 сделано>`, тем же номером, что стоит у элемента и в имени ветки.
 12. **Очередь работ сходится** — `npm run check:board`.