@rt-tools/agent-kit 0.8.2 → 0.8.3

package/assets/commands/skill-curator.md

@@ -6,8 +6,14 @@ argument-hint: '[пусто | <акцент, на что смотреть в п
 Запусти агента `skill-curator` на разбор только что закрытой задачи. Акцент от пользователя:
 `$ARGUMENTS`
 
-Вызывается **после того, как задача сделана и проверена**, до перехода к следующей. Агент ничего
-не правит — приносит готовые формулировки, а решение вставлять их принимает пользователь.
+Вызывается **сразу за открытием PR** — тем же ходом, которым работа отдана на разбор. Агент
+ничего не правит: он приносит готовые формулировки, а решение вставлять их принимает
+пользователь.
+
+**Запуск фоновый, и ход на нём не кончается.** Пока агент работает, берётся следующая задача:
+он ничего не спрашивает и быстрее от ожидания не идёт. Шаги 1 и 2 делаются до запуска — пока
+задача ещё в голове; шаги 4–6 принимают вернувшийся ответ одним ходом и возвращают исполнителя
+к прежней работе.
 
 ## 1. Найди список загруженного
 
@@ -42,50 +48,61 @@ ls -t "${TMPDIR}claude-skill-gate/"*.loaded | head -5
 которой не было» — ровно то, из чего получаются правила. Приглаженная сводка даёт приглаженный
 разбор.
 
-## 3. Запусти агента
+## 3. Запусти агента в фон и вернись к работе
 
 Инструментом `Agent`, `subagent_type: 'skill-curator'`. В промпт — путь к `.loaded` и сводку
 целиком.
 
-## 4. Выгрузи предложения файлом
+Ход на этом не кончается: пока агент работает, берётся следующая задача. Ответ придёт
+уведомлением, и тогда идут шаги 4–6 — один ход, после которого исполнитель возвращается к тому,
+что делал.
+
+## 4. Положи находки в папку задачи
 
-Ответ роли живёт в переписке и умирает вместе с ней, а правки в пакет идут из другого дерева и
-в другой день. Поэтому предложения ложатся на диск — их пишешь ты, не роль: файлов она не
-пишет вовсе.
+Ответ роли живёт в переписке и умирает вместе с ней, поэтому он сразу ложится на диск — рядом с
+ходом работы, в папку задачи. Пишешь его ты, не роль: файлов она не пишет вовсе.
 
 ```bash
-mkdir -p .claude/rt-kit/proposals
-cp .claude/rt-kit/templates/proposal.md .claude/rt-kit/proposals/$(date +%F)-<ветка>.md
+cat > docs/tasks/<ветка>/curator.md    # заголовок блока — «## <адрес> · <ресурс>»
 ```
 
-Дальше — по блоку на предложение, заголовком `## <адрес> · <ресурс>`. Адрес роль уже поставила,
-твоё дело — не потерять его и не переписать текст своими словами.
+Адрес у каждого блока роль уже поставила — «пакет», «компаньон» или «дерево». Твоё дело — не
+потерять его и не переписать текст своими словами.
 
-Файл читает `agent-kit propose`: по заголовку он отбирает то, что уезжает в приём. Блок без
-адреса в заголовке не уедет никуда и останется лежать молча.
+Папка задачи умирает со слиянием, а находки должны пережить весь эпик: владелец читает их
+разом, когда эпик кончился. Поэтому при разборе папки файл находок не удаляется, а переезжает к
+замыслу эпика — паттерн закрытия работы. Работа вне эпика показывает находки владельцу сразу.
 
-## 5. Отправь то, что адресовано пакету
+## 5. Отправь сводку наблюдений — и только её
 
 ```bash
 npx agent-kit propose --dry-run     # что уехало бы
 npx agent-kit propose               # отправить груз в приём
 ```
 
-Груз уезжает при каждом прогоне: сводка наблюдений со снимком надстроек, предложения с адресом
-«пакет» — когда они есть, — и разборы происшествий. Прогон без замечаний тоже говорит, чем
-пользовались, чем не пользовались ни разу и что дерево переопределило. Отправленное предложение
-помечается в том же файле и второй раз не уезжает.
+Груз уезжает при каждом прогоне: сводка наблюдений со снимком надстроек, разборы происшествий и
+предложения, лежащие в каталоге предложений. Сводка — факт: чем пользовались, чем не
+пользовались ни разу, что дерево переопределило. Она уезжает всегда и слова владельца не ждёт.
+
+**Находки разбора в каталог предложений сами не ложатся, и потому не уезжают.** Предложение —
+заготовка правки чужого дерева, и часть заготовок отпадает при первом же чтении; уехавшая без
+разбора, она становится работой того, кто её не заказывал. В каталог предложений переносится
+только то, что владелец назвал верным, — и тогда же уезжает.
 
 Отправка отказывает, если адрес этого дерева нашёлся в сводке или в тексте предложения — путь,
 имя корня, чужой репозиторий. Это не придирка: груз уезжает наружу целиком. Правь текст, а не
 обходи проверку. Разбор происшествия проверкой не накрыт: он по устройству называет файлы
 дерева, где промах случился.
 
-## 6. Отдай результат владельцу
+## 6. Отдай находки владельцу — по концу эпика
+
+Покажи находки **как есть**: роль пишет готовый текст для вставки, и пересказ его портит. По
+каждой скажи своё — согласен или нет и почему; правило, с которым ты не согласен, вставлять не
+надо.
 
-Покажи предложения агента **как есть**: он пишет готовый текст для вставки, и пересказ его
-портит. По каждому скажи своё — согласен или нет и почему; правило, с которым ты не согласен,
-вставлять не надо.
+Работа в эпике показывает их не сразу: находки копятся у замысла эпика и читаются разом, когда
+эпик кончился, — так владелец видит повторяющееся, а не разрозненные заметки. Названное им
+верным переносится в каталог предложений и уезжает шагом 5.
 
 У каждого предложения агент ставит пометку «пакет», «компаньон» или «дерево»: тексты приезжают
 из `@rt-tools/agent-kit`, и правка разложенного файла на месте теряется на следующем

package/assets/docs/GLOSSARY.md

@@ -13,26 +13,27 @@
 
 ## Слой правил
 
-| Термин                    | Что это                                                                                                                                                     |
-| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Закон                     | Файл в каталоге конституции. Говорит, что должно быть верно, и не знает ни путей, ни имён файлов. Верен для любого приложения этого класса                  |
-| Законы приложения         | Слой законов, верных только для этого приложения: деньги, локали, доступ. Предметность в них законна — она их предмет                                       |
-| Правило                   | Скил с `kind: rule`. Привязывает закон к этому дереву: чем это здесь названо и где лежит                                                                    |
-| Паттерн                   | Скил с `kind: pattern`. Готовый код и порядок действий; стоит при правиле                                                                                   |
-| Компаньон                 | Файл `implementation.md` рядом с правилом: имена и пути этого дерева. Пакет знает приём, но не знает имён — их пишет проект                                 |
-| Спек                      | Описание домена: как он работает. Говорит об установившемся, а не о предстоящем                                                                             |
-| Домен                     | Предмет, у которого свой спек. Выросший домен делится на поддомены, а не на соседние домены                                                                 |
-| Сценарий                  | Наблюдаемое поведение под номером `SC-<ПРЕФИКС>-<НОМЕР>`. Номер стоит в заголовке теста                                                                     |
-| Привязка                  | Строка `` `файл:символ` `` в компаньоне или в спутнике спека — место, где утверждение исполняется                                                           |
-| Спутник                   | Файл рядом со спеком или правилом: компаньон, перечень сценариев                                                                                            |
-| Договорённость о продукте | Как продукт себя поведёт, записанное до кода. Единственное место, где спек говорит о будущем; после выкатки вливается в спек домена, а директория удаляется |
-| Ресурс                    | Единица того, что везёт пакет правил: закон, правило, паттерн, гард, проверка, роль, команда, конвейер, шаблон, умолчание, документ                         |
-| Раскладка                 | Перенос ресурса из пакета в дерево по его роду и настройке слоя                                                                                             |
-| Разложенный файл          | Файл в дереве с шапкой пакета. Правится не на месте, а надстройкой: правка на месте теряется на следующей раскладке                                         |
-| Надстройка                | Файл дерева, который сливается с разложенным по заголовкам разделов                                                                                         |
-| Наблюдение                | Строка о событии слоя правил: правило загружено, гейт отбил, гард отказал. Пишет гард, живёт в дереве, наружу уезжает счётчиками. Журналом не называется    |
-| Сводка                    | Что наблюдения говорят за отрезок дней: чем пользовались, чем ни разу, обо что спотыкались                                                                  |
-| Предложение               | Готовая формулировка правки правил с адресом: пакет, компаньон или дерево. Приносит разбор закрытой задачи, отправляет человек командой                     |
+| Термин                    | Что это                                                                                                                                                          |
+| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Закон                     | Файл в каталоге конституции. Говорит, что должно быть верно, и не знает ни путей, ни имён файлов. Верен для любого приложения этого класса                       |
+| Законы приложения         | Слой законов, верных только для этого приложения: деньги, локали, доступ. Предметность в них законна — она их предмет                                            |
+| Правило                   | Скил с `kind: rule`. Привязывает закон к этому дереву: чем это здесь названо и где лежит                                                                         |
+| Паттерн                   | Скил с `kind: pattern`. Готовый код и порядок действий; стоит при правиле                                                                                        |
+| Компаньон                 | Файл `implementation.md` рядом с правилом: имена и пути этого дерева. Пакет знает приём, но не знает имён — их пишет проект                                      |
+| Спек                      | Описание домена: как он работает. Говорит об установившемся, а не о предстоящем                                                                                  |
+| Домен                     | Предмет, у которого свой спек. Выросший домен делится на поддомены, а не на соседние домены                                                                      |
+| Сценарий                  | Наблюдаемое поведение под номером `SC-<ПРЕФИКС>-<НОМЕР>`. Номер стоит в заголовке теста                                                                          |
+| Привязка                  | Строка `` `файл:символ` `` в компаньоне или в спутнике спека — место, где утверждение исполняется                                                                |
+| Спутник                   | Файл рядом со спеком или правилом: компаньон, перечень сценариев                                                                                                 |
+| Договорённость о продукте | Как продукт себя поведёт, записанное до кода. Единственное место, где спек говорит о будущем; после выкатки вливается в спек домена, а директория удаляется      |
+| Ресурс                    | Единица того, что везёт пакет правил: закон, правило, паттерн, гард, проверка, роль, команда, конвейер, шаблон, умолчание, документ                              |
+| Раскладка                 | Перенос ресурса из пакета в дерево по его роду и настройке слоя                                                                                                  |
+| Разложенный файл          | Файл в дереве с шапкой пакета. Правится не на месте, а надстройкой: правка на месте теряется на следующей раскладке                                              |
+| Надстройка                | Файл дерева, который сливается с разложенным по заголовкам разделов                                                                                              |
+| Наблюдение                | Строка о событии слоя правил: правило загружено, гейт отбил, гард отказал. Пишет гард, живёт в дереве, наружу уезжает счётчиками. Журналом не называется         |
+| Сводка                    | Что наблюдения говорят за отрезок дней: чем пользовались, чем ни разу, обо что спотыкались                                                                       |
+| Предложение               | Готовая формулировка правки правил с адресом: пакет, компаньон или дерево. Приносит разбор закрытой задачи или слово посреди работы, отправляет человек командой |
+| Слово                     | Реплика человека посреди работы о слое правил: что мешает, чего не хватило, что сработало не так. Ложится блоком в файл предложений, а не живёт до конца захода  |
 
 ## Работа
 

package/assets/hooks/reuse-first-guard.sh

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

package/assets/hooks/skill-gate.sh

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# rt-hook: PreToolUse Edit|Write|MultiEdit|Bash
+# rt-hook: PreToolUse Edit|Write|MultiEdit|Bash|mcp__webstorm__create_new_file|mcp__webstorm__execute_terminal_command|mcp__webstorm__execute_tool
 # Гейт правил: не даёт править файл, пока не загружено правило, под которое он подпадает.
 #
 # Закон и правило, которых никто не открывает, не действуют. Напоминание в подсказке помогает

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,87 @@
+#!/usr/bin/env bash
+# rt-hook: Stop
+# Гард ожидания: ход, в котором открыт PR, не заканчивается, пока в нём не было ни одного
+# действия по следующей задаче. Stop.
+#
+# Зачем именно так. Статья «ожидание прогона работой не занимают» держится памятью исполнителя, и
+# держится плохо: образец сообщения владельцу кончается фразой о следующей задаче, а фраза
+# исполняется как обещание — заход произносит её и кончает ход. Ход, в котором не сделано ничего,
+# ничем себя не выдаёт: ни правкой файла, ни командой, — и промах виден только владельцу, только
+# по тому, что работа не двигается, и только когда он спросит прямо.
+#
+# Признак берётся из хода, а не из сети. Спросить хостинг об открытых PR было бы точнее, но
+# сетевой вызов на завершении хода падает вместе со связью и отбивал бы работу вместо промаха.
+# Поэтому судится пара: в ходе был вызов открытия PR — и в том же ходе было действие по
+# следующей задаче.
+#
+# Что считается действием: заведение задачи, заведение ветки, перевод колонки очереди работ,
+# заведение папки задачи. Набор открыт и пополняется правкой — полнота его открытый вопрос, а не
+# обещание.
+#
+# Чего гард не судит. Ход, в котором 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'
+
+# Первое действие по следующей задаче. Заведение папки стоит здесь наравне с командами: работа
+# по уже заведённому номеру начинается именно с неё.
+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" '
+    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
+    | ($ran | test($opened; "i")) as $opened_pr
+    | ($ran | test($moved; "i")) as $went_on
+    | if $opened_pr and ($went_on | not) then "owe" else "pass" end
+' 2>/dev/null)"
+
+[ "$verdict" = "owe" ] || exit 0
+
+reason="BLOCKED by waiting-turn-guard: в этом ходе открыт PR, а действия по следующей задаче в нём нет ни одного. Ожидание чужого шага заходом не занимают: прогон идёт на стороне и быстрее от взгляда на него не становится.
+
+Сказать «беру следующую задачу» — не то же самое, что взять её: фраза живёт до конца хода, а работа не двигается, и заметить это может только владелец.
+
+Тем же ходом делается первое действие по следующей задаче — заведение задачи, ветки или папки:
+
+    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 не читает ни

package/assets/laws/project-documentation.md

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

package/assets/laws/work-conduct.md

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

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`.