@rt-tools/agent-kit 0.12.0 → 0.14.0

package/assets/hooks/rerun-guard.sh

@@ -49,7 +49,7 @@ done
 
 # Вызов перезапуска: слово перезапуска отдельным словом рядом со словом прогона.
 host_cli="${RT_HOST_CLI:-gh}"
-printf '%s' "$cmd" | grep -qE "(^|[;&|(]|&&|\|\|)[[:space:]]*${host_cli}([[:space:]]|$)" || exit 0
+printf '%s' "$cmd" | grep -qE "${RT_CMD_BOUND}${host_cli}([[:space:]]|\$)" || exit 0
 printf '%s' "$cmd" | grep -qE '(^|[[:space:]])(run|workflow)([[:space:]]|$)' || exit 0
 printf '%s' "$cmd" | grep -qE '(^|[[:space:]])rerun([[:space:]]|$)' || exit 0
 

package/assets/hooks/rule-source-guard.sh

@@ -0,0 +1,126 @@
+#!/usr/bin/env bash
+# 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, hooks/deny-tail.sh
+# Гард места правки: слой правил чинится там, где сломано, а не там, где виден.
+#
+# Слой правил правит тот же исполнитель, которым слой правил управляет, и разницы между
+# «исполняю правило» и «правлю правило» в дереве не видно ничем: разложенная копия лежит рядом
+# с обычными файлами и правится так же. Правка доходит до диска и не доходит до места, где
+# промах чинится: в дереве она видна, в пакете её нет, а через месяц раскладка отказывает по
+# правленому файлу целиком — и цену платит тот, кто в этот день правил соседний ресурс.
+#
+# Знал об этом только `sync --check`, и говорил он на следующей раскладке, то есть в чужой
+# ветке и чужим ходом. Гард говорит в минуту правки и называет адрес: источник пакета, если
+# дерево его держит, иначе — надстройку.
+#
+# ЧТО СУДИТСЯ. Файл, который правят, несёт шапку раскладки: `rt-kit v<версия> · <ресурс> ·
+# <дайджест>`. Ресурс из неё и есть адрес: `<источники>/<ресурс>` в дереве пакета,
+# `.claude/rt-kit/overrides/<ресурс>` у потребителя.
+#
+# ОТКАЗ В ПОЛЬЗУ РАБОТЫ: нет `jq`, битый ввод, чужой инструмент, файла нет, шапки в нём нет,
+# не git-репозиторий — правка РАЗРЕШАЕТСЯ. Сломанный гард не имеет права заклинить работу.
+
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
+
+rt_hook_read
+input="$RT_HOOK_INPUT"
+[ -z "$input" ] && exit 0
+command -v jq >/dev/null 2>&1 || exit 0
+
+rt_hooks_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+for profile in "$rt_hooks_dir/../rt-kit/defaults/project.sh" "$rt_hooks_dir/../defaults/project.sh" "${CLAUDE_PROJECT_DIR:-.}/.claude/rt-kit/defaults/project.sh" "${CLAUDE_PROJECT_DIR:-.}/.claude/rt-kit/project.sh"; do
+    # shellcheck disable=SC1090
+    [ -f "$profile" ] && . "$profile" 2>/dev/null
+done
+
+# shellcheck disable=SC1090
+[ -f "$rt_hooks_dir/profile-check.sh" ] && . "$rt_hooks_dir/profile-check.sh"
+command -v rt_needs >/dev/null 2>&1 || rt_needs() { command -v "$1" >/dev/null 2>&1; }
+
+# shellcheck disable=SC1090
+[ -f "$rt_hooks_dir/deny-tail.sh" ] && . "$rt_hooks_dir/deny-tail.sh" 2>/dev/null
+command -v rt_deny_tail >/dev/null 2>&1 || rt_deny_tail() { printf ''; }
+
+deny() {
+    # shellcheck disable=SC1090
+    [ -f "$rt_hooks_dir/observe.sh" ] && . "$rt_hooks_dir/observe.sh" 2>/dev/null
+    command -v rt_note >/dev/null 2>&1 && rt_note guard-deny res=rule-source-guard
+
+    reason="$1 $(rt_deny_tail "$2")"
+    jq -n --arg r "$reason" '{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:$r}}' 2>/dev/null \
+        || printf '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"Гард места правки."}}\n'
+    exit 0
+}
+
+# Цели записи, названные командой прямо. Печатает по одной в строке.
+rt_write_targets() {
+    tr "\"'\`" '   ' \
+        | sed -E 's/>>?/\n>/g' \
+        | sed -nE '
+            s/^>[[:space:]]*([^[:space:]|&;]+).*/\1/p
+            s/(^|.*[[:space:]])tee[[:space:]]+(-a[[:space:]]+)?([^[:space:]|&;]+).*/\3/p
+            s/(^|.*[[:space:]])sed[[:space:]]+-i[[:space:]]+([^[:space:]]+[[:space:]]+)*([^[:space:]|&;]+)$/\3/p
+            s/(^|.*[[:space:]])(cp|mv|install)[[:space:]]+([^[:space:]]+[[:space:]]+)+([^[:space:]|&;]+).*/\4/p
+        ' \
+        | sort -u
+}
+
+tool="$(rt_hook_tool)"
+candidates=""
+case "$tool" in
+    Edit | Write | MultiEdit | mcp__webstorm__create_new_file)
+        candidates="$(printf '%s' "$input" | jq -r '.tool_input.file_path // .tool_input.pathInProject // empty' 2>/dev/null)"
+        ;;
+    Bash | mcp__webstorm__execute_terminal_command | mcp__webstorm__execute_tool)
+        cmd="$(rt_hook_cmd)"
+        [ -z "$cmd" ] && exit 0
+        # Здесь берётся не общий признак записи, а цель, названная в команде прямо:
+        # перенаправление, `tee`, правка на месте, копирование поверх. Общий признак широк
+        # намеренно — в нём и имя интерпретатора, — и запуск разложенной проверки читался бы
+        # как правка её самой. Отбитие на чтении стоит дороже пропуска: гард, мешающий читать,
+        # выключают в первый же день.
+        #
+        # Снятие копии сюда не входит намеренно: снятый файл раскладка кладёт заново, и так
+        # чинят копию, которую переписал форматтер.
+        candidates="$(printf '%s' "$cmd" | rt_write_targets)"
+        ;;
+    *) exit 0 ;;
+esac
+[ -z "$candidates" ] && exit 0
+
+root="${CLAUDE_PROJECT_DIR:-.}"
+
+# Каталог источников пакета в этом дереве. Есть он только у дерева, которое пакет и везёт; у
+# потребителя источника нет вовсе, и адрес правки у него один — надстройка.
+sources=""
+if rt_needs rt_kit_sources_dir rule-source-guard; then
+    sources="$(rt_kit_sources_dir 2>/dev/null)"
+fi
+
+while IFS= read -r candidate; do
+    [ -z "$candidate" ] && continue
+    case "$candidate" in
+        /*) ;;
+        *) candidate="$root/$candidate" ;;
+    esac
+    [ -f "$candidate" ] || continue
+
+    # Шапка стоит в начале файла, но не первой строкой: у сценария её отодвигает `#!`, у
+    # правила — заголовок с именем и родом ресурса. Десяти строк хватает обоим, а читать файл
+    # целиком нельзя: гард стоит на каждой правке.
+    resource="$(head -12 "$candidate" 2>/dev/null | sed -nE 's/.*rt-kit v[^ ]+ · ([^ ]+) · [0-9a-f]+.*/\1/p' | head -1)"
+    [ -z "$resource" ] && continue
+
+    if [ -n "$sources" ] && [ -f "$root/$sources/$resource" ]; then
+        deny "BLOCKED by rule-source-guard: «${candidate#"$root"/}» разложен пакетом, и правка на его месте теряется на следующей раскладке — а до тех пор раскладка отказывает по этому файлу целиком, и цену платит тот, кто в этот день правит соседний ресурс. Ресурс — «${resource}». Правь источник: ${sources}/${resource} — потом собери пакет и разложи." \
+            "правка, верная только этому дереву, идёт в надстройку .claude/rt-kit/overrides/${resource} — она сливается по разделу «## » и раскладку переживает"
+    fi
+
+    deny "BLOCKED by rule-source-guard: «${candidate#"$root"/}» разложен пакетом @rt-tools/agent-kit, и правка на его месте теряется на следующей раскладке. Ресурс — «${resource}». Правь надстройку: .claude/rt-kit/overrides/${resource} — она сливается по разделу «## » и раскладку переживает." \
+        "то, что верно любому дереву, правится в самом пакете и приезжает сюда новой редакцией"
+done <<EOF
+$candidates
+EOF
+
+exit 0

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

@@ -110,6 +110,7 @@ EOF
 
 # Каталог папок задач: у дерева он свой, но имя обычно общее.
 tasks_dir="${RT_TASKS_DIR:-docs/tasks}"
+main_branch="${RT_MAIN_BRANCH:-main}"
 
 # Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть. Файл
 # может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.
@@ -146,6 +147,23 @@ root="$(git rev-parse --show-toplevel 2>/dev/null)"
 dir="$root/$tasks_dir/$branch"
 plan="$dir/plan.md"
 
+# Папка, разобранная коммитом этой ветки, — признак того, что работа отдана. Замысел с диска к
+# этой минуте снят намеренно: уборка стоит до открытия заявки, потому что кнопку слияния
+# нажимает человек на хостинге и закрывающему коммиту места после одобрения не остаётся.
+# Правка после уборки — это правка по замечаниям разбора, и требовать под неё замысла значило
+# бы запирать ветку собственным порядком. Признак берётся из истории ветки, а не с диска:
+# снесённая, но не закоммиченная папка отданной работы не означает.
+folder_archived() {
+    [ -n "$(git ls-tree -d --name-only HEAD -- "$tasks_dir/$branch" 2>/dev/null | head -1)" ] && return 1
+    base="$(git merge-base "$main_branch" HEAD 2>/dev/null)"
+    [ -z "$base" ] && return 1
+    had="$(git ls-tree -d --name-only "$base" -- "$tasks_dir/$branch" 2>/dev/null | head -1)"
+    [ -z "$had" ] && had="$(git log "$base..HEAD" --diff-filter=A --name-only --pretty=format: -- "$tasks_dir/$branch" 2>/dev/null | head -1)"
+    [ -n "$had" ]
+}
+
+folder_archived && exit 0
+
 if [ ! -f "$plan" ]; then
     deny "BLOCKED by task-flow: нет замысла — '${tasks_dir}/${branch}/plan.md'. Собери папку задачи с образца (cp -r ${tasks_dir}/_template ${tasks_dir}/${branch}) и заполни шапку, след задачи и этапы, затем повтори. Правило — скил task-flow."
 fi

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

@@ -74,6 +74,30 @@ case "$state" in
     работа-отдана | влито) exit 0 ;;
 esac
 
+# То же самое, но объявить это на диске уже нечем: папка задачи разбирается до открытия заявки,
+# и ход работы уезжает вместе с ней. Признак берётся из истории ветки — папка, снятая её
+# коммитом.
+#
+# Отпускать по нему ход нельзя: папка снимается ДО заявки, и между этими двумя движениями работа
+# не отдана никому. Ход, попавший в зазор, прежде выходил отсюда нулём — а до отдачи ему
+# оставался ровно один шаг, и он его не сделал. Признак поэтому только снимает требование
+# состояния: дальше ход судится вторым признаком, как всякий другой. Ход, в котором заявку
+# открыли или прочитали, второй признак пропускает сам — вызов клиента хостинга он считает
+# работой.
+folder_archived() {
+    [ -n "$branch" ] || return 1
+    [ -n "$(git ls-tree -d --name-only HEAD -- "$tasks_dir/$branch" 2>/dev/null | head -1)" ] && return 1
+    main_branch="${RT_MAIN_BRANCH:-main}"
+    base="$(git merge-base "$main_branch" HEAD 2>/dev/null)"
+    [ -z "$base" ] && return 1
+    had="$(git ls-tree -d --name-only "$base" -- "$tasks_dir/$branch" 2>/dev/null | head -1)"
+    [ -z "$had" ] && had="$(git log "$base..HEAD" --diff-filter=A --name-only --pretty=format: -- "$tasks_dir/$branch" 2>/dev/null | head -1)"
+    [ -n "$had" ]
+}
+
+archived=false
+[ -z "$progress" ] && folder_archived && archived=true
+
 # Следующий шаг из хода работы — его страж и называет в отказе: исполнитель, которому сказано
 # только «работа не кончена», перечитывает ту же строку сам.
 next_step=""
@@ -177,7 +201,15 @@ fi
 
 [ "$worked" = "true" ] && exit 0
 
-if [ -z "$state" ]; then
+if [ "$archived" = "true" ]; then
+    reason="BLOCKED by turn-exit-guard: папка задачи снята коммитом ветки, а за этот ход не сделано ничего — ни правки, ни команды, меняющей дерево.
+
+Снятая папка означает середину отдачи, а не её конец: убирают её ДО того, как открыта заявка, и между этими двумя движениями работу не видит никто, кроме того, кто её сделал. Состояние работы с этой минуты объявить нечем, поэтому ход судится по второму признаку — была ли за него работа.
+
+Оставшийся шаг один: открыть заявку черновиком. Заявка уже открыта — возьми следующую задачу: ожидание чужого прогона работой не является и ходом не кончается.
+
+Страж судит один ход: следующий заход не отбивается."
+elif [ -z "$state" ]; then
     reason="BLOCKED by turn-exit-guard: за этот ход не сделано ничего — ни правки, ни команды, меняющей дерево. Папки задачи у этой работы нет, и состояние взять неоткуда, но ход это не кончает.
 
 Ход кончается четырьмя способами, и других нет: вопрос владельцу, ответа на который в правилах нет; отказ гарда; заполненное окно захода; отданная работа с начатой следующей. Названная и не запущенная команда выходом не является: строка «сейчас запущу» — объявление намерения, а оно прямо названо ложным концом хода.

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

@@ -63,12 +63,19 @@ red_re='completed[[:space:]]+failure|"conclusion"[[:space:]]*:[[:space:]]*"failu
 # по следующей задаче не считается — она чинит прежнюю, а не двигает работу дальше.
 moved_re='task:new|task:move|checkout[[:space:]]+-b|docs/tasks/'
 
+# Чем ход показывает, что отданную работу он довёл до конца, а не бросил черновиком. Снятие
+# черновика — очевидный случай; чтение прогона — тот, где снимать ещё нечего, но исполнитель
+# посмотрел, а не сказал «жду». Две готовые заявки простояли черновиками именно потому, что
+# следующая задача была взята вместо этого, а не сверх этого.
+ready_re='pr[[:space:]]+ready|run[[:space:]]+(list|view|watch)|pr[[:space:]]+checks|check-runs|check:board|board\.mjs'
+
 # Ход — это всё, что записано после последнего настоящего ввода владельца. Ответ инструмента
 # приходит той же ролью, поэтому строки с `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" '
+    --arg opened "$opened_re" --arg moved "$moved_re" --arg read "$read_re" --arg red "$red_re" \
+    --arg ready "$ready_re" '
     def is_input:
         .type == "user"
         and (((.message.content // []) | if type == "array"
@@ -90,12 +97,41 @@ verdict="$(tail -n 400 "$transcript" 2>/dev/null | jq -s -r \
     | ($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"
+    | ($ran | test($ready; "i")) as $checked
+    | if $opened_pr and ($went_on | not) then "owe:pr"
+      elif $opened_pr and ($checked | not) then "owe:draft"
+      elif $went_on then "pass"
       elif $red_run then "owe:run"
       else "pass" end
 ' 2>/dev/null)"
 
+# Черновик, оставленный при взятой следующей задаче, — отдельный отказ: там требование не про
+# следующую задачу, а про доведение отданной.
+if [ "$verdict" = "owe:draft" ]; then
+    reason="BLOCKED by waiting-turn-guard: в этом ходе открыт PR, следующая задача взята, а состояние отданной работы не спрошено ни одной командой.
+
+Черновик читается владельцем как «работа не кончена»: кнопка слияния у него заблокирована самим хостингом, и по списку заявок готовое от недоделанного не отличить — серое и там и там. Довести отданное до снятого черновика обязан тот, кто его отдал.
+
+Спроси прогон на вершине этим же ходом — `gh run list`, `gh pr checks` или сверку очереди работ — и сними черновик, когда он зелёный, а ветка сливается. Прогон ещё идёт — так и скажи владельцу, назвав его вывод.
+
+Следующая задача берётся сверх этого, а не вместо: обе готовые заявки простояли черновиками ровно на такой подмене.
+
+Гард судит один ход: следующий заход не отбивается."
+
+    # shellcheck disable=SC1090
+    [ -f "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" ] \
+        && . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" 2>/dev/null
+    command -v rt_deny_tail >/dev/null 2>&1 || rt_deny_tail() { :; }
+    deny_tail_text="$(rt_deny_tail "")"
+    [ -n "$deny_tail_text" ] && reason="${reason}
+
+${deny_tail_text}"
+
+    jq -n --arg r "$reason" '{decision:"block",reason:$r}' 2>/dev/null \
+        || printf '{"decision":"block","reason":"waiting-turn-guard: отданная работа осталась черновиком — спроси прогон и сними черновик."}\n'
+    exit 0
+fi
+
 case "$verdict" in
     owe:pr) said="в этом ходе открыт PR" ;;
     owe:run) said="в этом ходе прочитан красный прогон" ;;

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

@@ -114,17 +114,17 @@ az repos pr update --id 205 --description "$(cat тело.md)"
 
 ## Оставшийся шаг
 
-После одобрения ветка получает ещё один коммит — разбор папки задачи, — и только потом
-вливается. До этого коммита вливать рано: папка уедет в главную ветку неразобранной.
+Папка задачи разобрана коммитом `<sha>` — за работой убрано. Осталось дождаться прогона и снять
+черновик; до этого кнопка слияния заблокирована хостингом.
 ```
 
 Раздел «Оставшийся шаг» стоит последним и переписывается тем же вызовом, что и остальное тело,
-— в тот ход, которым папка разбирается и снимается черновик:
+— в тот ход, которым снимается черновик:
 
 ```markdown
 ## Оставшийся шаг
 
-Не осталось: папка задачи разобрана коммитом `<sha>`, черновик снят. Можно вливать.
+Не осталось: прогон зелёный, черновик снят. Можно вливать.
 ```
 
 Стоит он там потому, что решение о слиянии принимается на этой странице, а не в переписке:

package/assets/patterns/git-workflow-pr.github.md

@@ -141,17 +141,17 @@ Closes #86
 
 ## Оставшийся шаг
 
-После одобрения ветка получает ещё один коммит — разбор папки задачи, — и только потом
-вливается. До этого коммита вливать рано: папка уедет в главную ветку неразобранной.
+Папка задачи разобрана коммитом `<sha>` — за работой убрано. Осталось дождаться прогона и снять
+черновик; до этого кнопка слияния заблокирована хостингом.
 ```
 
 Раздел «Оставшийся шаг» стоит последним и переписывается тем же вызовом, что и остальное тело,
-— в тот ход, которым папка разбирается и снимается черновик:
+— в тот ход, которым снимается черновик:
 
 ```markdown
 ## Оставшийся шаг
 
-Не осталось: папка задачи разобрана коммитом `<sha>`, черновик снят. Можно вливать.
+Не осталось: прогон зелёный, черновик снят. Можно вливать.
 ```
 
 Стоит он там потому, что решение о слиянии принимается на этой странице, а не в переписке:

package/assets/patterns/git-workflow-pr.gitlab.md

@@ -125,17 +125,17 @@ Closes #86
 
 ## Оставшийся шаг
 
-После одобрения ветка получает ещё один коммит — разбор папки задачи, — и только потом
-вливается. До этого коммита вливать рано: папка уедет в главную ветку неразобранной.
+Папка задачи разобрана коммитом `<sha>` — за работой убрано. Осталось дождаться прогона и снять
+черновик; до этого кнопка слияния заблокирована хостингом.
 ```
 
 Раздел «Оставшийся шаг» стоит последним и переписывается тем же вызовом, что и остальное
-описание, — в тот ход, которым папка разбирается и снимается черновик:
+описание, — в тот ход, которым снимается черновик:
 
 ```markdown
 ## Оставшийся шаг
 
-Не осталось: папка задачи разобрана коммитом `<sha>`, черновик снят. Можно вливать.
+Не осталось: прогон зелёный, черновик снят. Можно вливать.
 ```
 
 Стоит он там потому, что решение о слиянии принимается на этой странице, а не в переписке:

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`.** Удалить проще, чем разобрать, а
   слова владельца записаны только там, и восстановить их неоткуда. Поэтому гард требует, чтобы
   ветка добавила запись в архив. Что именно перенесли, он не проверяет — это смотрит владелец