@rt-tools/agent-kit 0.5.0 → 0.5.2

package/assets/hooks/window-fill-guard.sh

@@ -0,0 +1,157 @@
+#!/usr/bin/env bash
+# rt-hook: PostToolUse .*
+# Требует: hooks/profile-check.sh
+# rt-hook: PreToolUse .*
+# Заполнение окна: заход доводится до логической точки заранее, а не обрывается на середине.
+#
+# Зачем именно так. Место, где исполнитель помнит ход работы, ограничено, и заполнив его, он
+# теряет не последнее действие, а всю картину разом. Изнутри захода этот предел не виден ничем:
+# ни одна проверка дерева его не показывает, а сжатие контекста срабатывает, когда доводить
+# работу до точки уже нечем.
+#
+# Гард стоит на двух событиях сразу — разводить его по двум файлам значило бы держать два
+# разбора одной записи и два места, где правится один порог:
+#   PostToolUse — на первом пороге отдаёт напоминание: пора выбирать точку остановки;
+#   PreToolUse  — на втором отбивает всё, кроме записи хода работы, передачи и команд поставки.
+# Место между порогами и есть то, на что закрывается заход: дописать ход работы, написать
+# передачу, закоммитить проверенное.
+#
+# Размер окна берётся из настройки дерева. Из записи захода он не выводится: модель записана
+# там без пометки о расширенном окне, и заход на широкое окно от захода на узкое неотличим.
+#
+# ОТКАЗ В ПОЛЬЗУ РАБОТЫ: нет размера окна, нет записи захода, нет разборщика, битый разбор —
+# работа РАЗРЕШАЕТСЯ (exit 0). Сломанный гард не имеет права заклинить работу.
+
+input="$(cat 2>/dev/null)"
+[ -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; }
+
+window="${RT_WINDOW_TOKENS:-}"
+case "$window" in
+    '' | *[!0-9]*) exit 0 ;;
+esac
+[ "$window" -gt 0 ] 2>/dev/null || exit 0
+
+warn_pct="${RT_WINDOW_WARN_PCT:-40}"
+stop_pct="${RT_WINDOW_STOP_PCT:-50}"
+tasks_dir="${RT_TASKS_DIR:-docs/tasks}"
+handoff_dir="${RT_HANDOFF_DIR:-.claude/handoff}"
+
+event="$(printf '%s' "$input" | jq -r '.hook_event_name // empty' 2>/dev/null)"
+transcript="$(printf '%s' "$input" | jq -r '.transcript_path // empty' 2>/dev/null)"
+[ -n "$transcript" ] || exit 0
+[ -f "$transcript" ] || exit 0
+
+# Заполнение — это последняя запись ответа с расходом: вход, разовая запись в кэш, прочитанное
+# из кэша и вывод. Сумма по всем записям тут не годится вовсе — прочитанное из кэша повторяется
+# в каждой из них, и сумма выходит в разы больше окна.
+#
+# Хвост в 200 строк: запись захода растёт весь заход, а нужна из неё одна последняя строка.
+fill="$(tail -n 200 "$transcript" 2>/dev/null | jq -s -r '
+    [.[] | select(.type == "assistant") | .message.usage | select(. != null)]
+    | last
+    | if . == null then empty
+      else ((.input_tokens // 0) + (.cache_creation_input_tokens // 0)
+            + (.cache_read_input_tokens // 0) + (.output_tokens // 0))
+      end
+' 2>/dev/null)"
+
+case "$fill" in
+    '' | *[!0-9]*) exit 0 ;;
+esac
+
+pct=$((fill * 100 / window))
+fill_k=$((fill / 1000))
+window_k=$((window / 1000))
+
+# --- первый порог: напоминание, работа не отбивается -------------------------------------
+
+if [ "$event" = "PostToolUse" ]; then
+    [ "$pct" -ge "$warn_pct" ] || exit 0
+
+    # Напоминание повторяется не на каждом вызове, а на каждой следующей ступени в пять
+    # процентов: иначе оно занимает то самое место, которое бережёт.
+    step=$(((pct / 5) * 5))
+    session="$(printf '%s' "$input" | jq -r '.session_id // "unknown"' 2>/dev/null)"
+    mark_dir="${TMPDIR:-/tmp}/claude-window-fill"
+    mark="$mark_dir/$session.step"
+    mkdir -p "$mark_dir" 2>/dev/null
+    last="$(cat "$mark" 2>/dev/null)"
+    case "$last" in
+        '' | *[!0-9]*) last=0 ;;
+    esac
+    [ "$step" -gt "$last" ] || exit 0
+    printf '%s' "$step" > "$mark" 2>/dev/null
+
+    if [ "$pct" -ge "$stop_pct" ]; then
+        text="ЗАПОЛНЕНИЕ ОКНА ${pct}% (${fill_k}k из ${window_k}k) — заход закрывается сейчас. Всё, кроме записи хода работы, передачи и команд поставки, уже отбивается."
+    else
+        text="ЗАПОЛНЕНИЕ ОКНА ${pct}% (${fill_k}k из ${window_k}k). Пора выбирать точку остановки: с ${stop_pct}% останется только закрыть заход. Доведи текущий шаг до состояния, с которого следующий заход продолжит, перепиши «Где стоим» в ходе работы, напиши передачу и отдай владельцу путь к ней — паттерн task-flow-handoff."
+    fi
+
+    jq -n --arg t "$text" \
+        '{hookSpecificOutput:{hookEventName:"PostToolUse",additionalContext:$t}}' 2>/dev/null
+    exit 0
+fi
+
+# --- второй порог: работа отбивается, закрытие захода пропускается ------------------------
+
+[ "$event" = "PreToolUse" ] || exit 0
+[ "$pct" -ge "$stop_pct" ] || exit 0
+
+tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
+path="$(printf '%s' "$input" | jq -r '.tool_input.file_path // empty' 2>/dev/null)"
+cmd="$(printf '%s' "$input" | jq -r '.tool_input.command // empty' 2>/dev/null)"
+
+allowed=0
+case "$tool" in
+    # Разговор с владельцем и чтение того, что правится при закрытии.
+    AskUserQuestion | TodoWrite | Read | SendUserFile)
+        allowed=1
+        ;;
+    Edit | Write | MultiEdit | mcp__webstorm__create_new_file)
+        # Ход работы и передача. Остальное — работа, а её заход уже не начинает.
+        case "$path" in
+            "$tasks_dir"/* | */"$tasks_dir"/* | "$handoff_dir"/* | */"$handoff_dir"/* | */scratchpad/*) allowed=1 ;;
+        esac
+        ;;
+    Bash | mcp__webstorm__execute_terminal_command)
+        # Поставка и сверки: коммит, пуш, отчёт, колонка задачи, состояние дерева. Список
+        # дописывается профилем дерева — клиент хостинга и имена команд у каждого свои.
+        if rt_needs rt_handoff_allowed_cmd window-fill-guard && rt_handoff_allowed_cmd "$cmd"; then
+            allowed=1
+        fi
+        ;;
+esac
+
+[ "$allowed" -eq 1 ] && exit 0
+
+reason="BLOCKED by window-fill-guard: заполнение окна ${pct}% (${fill_k}k из ${window_k}k), порог остановки ${stop_pct}%. Заход дальше не работает — он закрывается.
+
+Что осталось сделать этим заходом:
+1. Перепиши раздел «Где стоим» в ходе работы и добавь запись захода — что сделано, чем подтверждено, что не вышло.
+2. Закоммить проверенное: незакоммиченное не переживёт перерыв.
+3. Напиши передачу в ${handoff_dir}/ и отдай владельцу путь к ней — что в неё входит, говорит паттерн task-flow-handoff.
+
+Пропускаются при этом: правка ${tasks_dir}/**, запись передачи, команды поставки и сверки, чтение файлов и вопрос владельцу."
+
+jq -n --arg r "$reason" \
+    '{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:$r}}' 2>/dev/null \
+    || printf '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"window-fill-guard: окно заполнено, заход закрывается передачей."}}\n'
+
+exit 0

package/assets/laws/code-structure.md

@@ -20,3 +20,13 @@
   причина названа рядом.
 - **Отметка об устаревании — повод убрать, а не повод оставить.** Устаревшее объявление,
   которое молча продолжает работать, переживает того, кто его пометил.
+
+## Открытые вопросы
+
+- **Q-CS-3 — имя файла без обещания рода не судится ничем.** Проверка спрашивает файл, чьё имя
+  род называет; имя из одних слов о содержимом не говорит вовсе, и назвать род обязанным можно
+  только решением о продукте.
+- **Q-CS-4 — одноступенчатое приведение остаётся непроверенным.** Запрещено обходить сверку
+  через промежуточное «неизвестно», а обычное приведение принято: часть его обязательна, и
+  запрет отбивал бы её вместе с остальным. Решение изменит, появится ли требование к причине у
+  каждого оставшегося.

package/assets/laws/delivery.md

@@ -16,7 +16,14 @@
   которая в одну ветку не влезает, делится на задачи до того, как ветка заводится. Признак
   деления — раздельный откат, а не объём: числа файлов, строк или коммитов, за которым работа
   становится двумя задачами, нет. Правка одного рода остаётся одной задачей, сколько бы файлов
-  она ни задела.
+  она ни задела. Объём захода исполнителя признаком деления не является тоже: он говорит, какого
+  размера задачу стоит заводить среди тех, что делятся законно, и не даёт делить то, что
+  откатывается только вместе.
+- **Правка самой поставки проверяется её прогоном, а не рассуждением.** Проверить её иначе
+  нечем: она исполняется только там, где выкатывает, и в среде, которой на месте работы нет — с
+  чужими правами, чужим хранилищем ключей и чужой сетью. «Проверю после слияния» решением
+  исполнителя не бывает: за этими словами стоит выкатка, которой уже не будет, если правка
+  окажется неверной. Отложить проверку может только владелец, и он говорит это словами.
 - **Две задачи, которые чинятся одной правкой, — одна задача.** Вторая стирается вместе со
   своим номером, а то, чего в первой не было, дописывается в неё до этого. Две строки об
   одной работе хуже дыры в нумерации: по ним потом не понять, что сделано, а что нет. Слить

package/assets/laws/project-documentation.md

@@ -19,6 +19,10 @@
   символ ничего не исполняет, а проверка на нём остаётся зелёной.
 - **Путь, названный в документе, существует.** Ссылка на переехавший файл читается как
   действующее указание, и следующий читатель заводит снятое заново.
+- **Указатель каталога перечисляет всё, что в каталоге лежит.** Записи, которой в указателе нет,
+  для читателя не существует: он ищет по указателю, а не обходом каталога, и заводит разбор
+  заново. Это обратная сторона предыдущей статьи — не только путь из текста ведёт в файл, но и
+  файл назван в тексте, по которому его ищут.
 - **Документ, разошедшийся с приложением, правится тогда же, когда замечено расхождение.**
   Отложенная правка не случается: расхождение перестаёт быть заметным на следующий день.
 - **Расхождение чинится в той стороне, которая неправа, и это не всегда документ.**
@@ -43,3 +47,8 @@
   видит, проверки текстов на них не смотрят, и отказ выглядит сделанным ровно до того, как
   читатель наткнётся на снятое слово в заголовке. Читатель при этом заключает, что от слова
   не отказывались вовсе.
+- **Текст, который переносится в чужое дерево, не описывает состояние этого дерева как факт.**
+  О соседней части он говорит условно и называет её по имени: что в дереве стоит, а чего нет,
+  знает само дерево, а не текст, приехавший в него. Утверждение, сказанное безусловно, врёт тем
+  увереннее, что печатает его сам инструмент, — и поправить его дерево не может, если правки на
+  месте у такого текста не предусмотрено.

package/assets/laws/verifiability.md

@@ -47,3 +47,12 @@
   выключают в настройке инструмента, а не обходят в каждом месте.** Обход приходится повторять
   столько раз, сколько таких мест, и ни в одном из них не написано, зачем он: со стороны это
   выглядит ошибкой автора, а не решением.
+- **Польза правила подтверждается наблюдением за тем, как им пользуются, а не мнением о нём.**
+  Правило, которого не открыли ни разу, и правило, на котором держится половина работы, в тексте
+  выглядят одинаково — и правится первым обычно то, о чём вспомнили, а не то, что мешает.
+  Наблюдение ведётся там же, где идёт работа, и переживает отдельный заход: запись, которая
+  умирает вместе с сессией, отвечает только на вопрос «что было минуту назад».
+- **Наблюдение за работой не выносит наружу ничего, кроме того, что общее у всех.** Имя правила,
+  род события и версия одинаковы везде, где стоит слой правил; путь, домен и имя дерева
+  принадлежат одному дереву и в чужом месте не значат ничего, кроме утечки. Держится это
+  проверкой на выносящей стороне, а не памятью того, кто пишет.

package/assets/laws/work-conduct.md

@@ -13,8 +13,24 @@
 - **Пробел закрывается вопросом владельцу, а не догадкой.** Догадка неотличима от знания:
   она попадает в работу молча и обнаруживается только при приёмке, когда переделывать дороже
   всего.
+- **Вопрос, у которого есть очевидный ответ, работу не останавливает.** Исполнитель называет
+  допущение, идёт дальше и записывает его туда же, где идёт работа. Останавливает только тот
+  пробел, при котором любая догадка делает работу опасной или бесполезной. Вопрос, заданный
+  вместо работы, выглядит добросовестно, а стоит владельцу захода.
+- **Остановка называется первой строкой.** Сообщение, которым исполнитель останавливается,
+  начинается с того, чего он ждёт и что будет, если ответа не будет. Замеры, находки и разбор
+  к этому моменту уже записаны в ход работы — в сообщении владельцу они лишние. Чем подробнее
+  отчёт, тем надёжнее вопрос в нём тонет, и владелец переспрашивает, почему работа стоит.
 - **Владельцу не задаётся вопрос, ответ на который уже записан.** Записанное читают до
   разговора, а не вместо ответа: вопрос о том, что уже решено, обесценивает и остальные.
+- **Вопрос владельцу задаётся после того, как ответ искали в дереве.** Что лежит в дереве,
+  исполнитель узнаёт сам: имя, путь, наличие файла и устройство репозитория он берёт командой,
+  а не у владельца. Вопрос, ответ на который дала бы одна команда, стоит владельцу захода и
+  обесценивает заданные рядом.
+- **Утверждение о дереве стоит ровно столько, сколько команда, его показавшая.** Отрицание —
+  «здесь нет», «этого не заводили», «такого файла не бывает» — произносится только как вывод
+  команды. Не проверенное отрицание опаснее вопроса: вопрос владелец поправит, а факт от
+  исполнителя примет на веру, потому что тот в дерево смотрит.
 - **Решение, однажды записанное, действует, пока его не отменили, и читается до того, как
   принимается заново.** Отменённое решение следа в работе не оставляет — по результату не
   видно ни того, что его принимали, ни того, что от него отказались. Принятое заново оно
@@ -33,6 +49,14 @@
 - **Состояние незаконченной работы восстанавливается без участия владельца.** Иначе каждый
   перерыв стоит ему пересказа, а очередь работ показывает начатое и не говорит, что внутри
   него сделано.
+- **Заход исполнителя конечен, и его конец не совпадает с концом работы.** Место, где
+  исполнитель помнит ход работы, ограничено; заполнив его, он теряет не последнее, а всё
+  сразу. Заход, доведённый до логической точки заранее, стоит одной записи; оборванный на
+  середине — целого захода на восстановление.
+- **Прерванная работа передаётся следующему заходу готовым текстом, а не пересказом
+  владельца.** Владелец знает, что работа не кончена, но не знает, где именно она стоит;
+  пересказ он даёт по своей памяти, а не по ходу работы, и следующий заход начинает с чужой
+  картины.
 - **Замысел и ход работы — разные записи.** Замысел — то, с чем сверяют результат при
   приёмке; правленный по ходу, он перестаёт отличаться от отчёта, и приёмке сверять нечего.
 - **Сделанное отмечается в одном месте.** Две записи об одном разъезжаются молча, и после
@@ -41,6 +65,11 @@
   читается как случайное и отменяется следующим заходом, а отменённое возвращается третьим.
 - **Граница работы названа до её начала.** Не названная вслух граница не существует: правка
   расползается на соседнее, и снимать её приходится вручную.
+- **Действия, которые исполнитель не делает сам, названы списком.** Всё, что уходит за
+  пределы рабочего дерева или не откатывается — запись в общий репозиторий, публикация, отчёт,
+  правка общего документа, — делается по слову владельца, и слово это даётся на действие, а не
+  на работу целиком. Не названная списком граница выводится из общих слов: «делай, что нужно
+  по плану» прочитывается как разрешение на всё, что в плане подразумевалось.
 - **Признак закрытия работы назван до её начала и проверяем.** «Работает» признаком не
   является: под ним каждый заход понимает своё, и работа закрывается тогда, когда надоела.
 - **Начатая и брошенная работа видна.** Брошенное на середине выглядит так же, как
@@ -57,3 +86,21 @@
 - **Незаданный вопрос замечает только тот, кто знает, чего хотел.** Вопрос, которого не
   задали, следа не оставляет: работа выглядит понятой ровно до приёмки, и вывести отсутствие
   вопроса не из чего.
+- **Происшествие названо признаком, а не оценкой заднего числа.** Происшествие — заход, в
+  котором исполнитель сделал не то, а слой правил этого не отбил. Дефект в коде происшествием
+  не является: его объясняет договорённость о продукте. Признак записан один раз, а не
+  выводится каждым заходом заново — иначе его назначает тот, кому он мешает.
+- **Происшествие кончается записью, и запись делается в тот же заход.** Через день механизм
+  промаха пересказывается уже приглаженно: остаются выводы, а из выводов правило не выводится.
+  Запись называет механизм промаха по шагам, что было доступно до него, чем ловилось и что из
+  этого ушло в слой правил.
+- **Запись без правки слоя правил закрытой не считается.** Разбор, из которого не вышло ни
+  предложения, ни правки закона, правила или паттерна, — жалоба: он объясняет случившееся и
+  ничего не меняет, а значит повторится.
+- **Закрытая работа оставляет то, что узнала о правилах, там, откуда это возьмёт машина.**
+  Понимание, добытое одной работой, всего дороже соседней — и живёт оно ровно до конца захода,
+  если осталось в разговоре. Записанное свободным пересказом лежит не хуже, но переносить его
+  приходится руками, и переносится оно ровно до первой занятой недели.
+- **У предложенной правки правил назван адрес: сам слой правил, имена этого дерева или его
+  надстройка.** Без адреса правку кладут туда, где она видна автору, — то есть в своё дерево, —
+  и общее оседает в одном месте, оставаясь неизвестным всем остальным.

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

@@ -212,26 +212,30 @@ npm run task:move -- 86 in-review
 Конвейер видит только отправленное, а отправляется оно пушем. Линтеры, юниты и сценарии хуков
 снимает гейт пуша — ниже то, чего он не знает.
 
-1. **В ветке только та правка, за которой её заводили** — `git diff main...HEAD --stat`. Чужой
+1. **Главная ветка влита в эту ветку** — `git fetch origin && git merge origin/main`.
+   Всё, что проверяется ниже, проверяется от этого основания: PR с разошедшейся ветки
+   показывает ревьюверу правку вперемешку с чужой. Порядок и разбор конфликта — паттерн
+   `git-workflow-merge`.
+2. **В ветке только та правка, за которой её заводили** — `git diff main...HEAD --stat`. Чужой
    домен в списке файлов означает, что правка расползлась, и её надо вернуть в свои границы.
-2. **Ни мока, ни подменённого ответа, ни отладочной строки** — `git diff main...HEAD` читается
+3. **Ни мока, ни подменённого ответа, ни отладочной строки** — `git diff main...HEAD` читается
    целиком, а не по именам файлов. На прод они уезжают молча и портят настоящие данные.
-3. **Документ едет тем же коммитом.** Пару называет `docs-guard`, но спек домена и правку его
+4. **Документ едет тем же коммитом.** Пару называет `docs-guard`, но спек домена и правку его
    поведения он не знает — это остаётся за автором.
-4. **Проверки текстов и раскладки зелёные** — те, что дерево завело в `tools/`. Какие именно
+5. **Проверки текстов и раскладки зелёные** — те, что дерево завело в `tools/`. Какие именно
    есть здесь — `implementation.md` правила.
-5. **Все приложения дерева собираются** — `nx build` по каждому. Гейт пуша сборку не гоняет.
-6. **Видимый текст заведён во всех локалях перевода** — тестом полноты словарей, если дерево
+6. **Все приложения дерева собираются** — `nx build` по каждому. Гейт пуша сборку не гоняет.
+7. **Видимый текст заведён во всех локалях перевода** — тестом полноты словарей, если дерево
    переводится.
-7. **Правка вёрстки подтверждена замером**, а не взглядом, и снята при узком экране — паттерн
+8. **Правка вёрстки подтверждена замером**, а не взглядом, и снята при узком экране — паттерн
    `browser-verification-measure`.
-8. **Правка разметки публичного сайта проверена на прод-сборке по всем локалям перевода** —
+9. **Правка разметки публичного сайта проверена на прод-сборке по всем локалям перевода** —
    паттерн `seo-verify`.
-9. **PR привязан к рабочему элементу**, ревьювер и исполнитель стоят.
-10. **Заголовок PR несёт номер элемента и называет работу сделанной:** `[<номер>] <Что
+10. **PR привязан к рабочему элементу**, ревьювер и исполнитель стоят.
+11. **Заголовок PR несёт номер элемента и называет работу сделанной:** `[<номер>] <Что
 сделано>`, тем же номером, что стоит у элемента и в имени ветки.
-11. **Очередь работ сходится** — `npm run check:board`.
-12. **Состояние PR прочитано, а не выведено из кодов возврата.**
+12. **Очередь работ сходится** — `npm run check:board`.
+13. **Состояние PR прочитано, а не выведено из кодов возврата.**
 
 Сразу после публикации элемент переводится в разбор, и сверка очереди прогоняется ещё раз: до
 открытия PR состояние она не судит, а после открытия расхождение видит.

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

@@ -264,30 +264,34 @@ npm run task:move -- 86 in-review
 Проверок на самом PR нет: выкатка запускается пушем в главную ветку, и до мержа никто не
 гоняет ничего. Линтеры, юниты и сценарии хуков снимает гейт пуша — ниже то, чего он не знает.
 
-1. **В ветке только та правка, за которой её заводили** — `git diff main...HEAD --stat`. Чужой
+1. **Главная ветка влита в эту ветку** — `git fetch origin && git merge origin/main`.
+   Всё, что проверяется ниже, проверяется от этого основания: PR с разошедшейся ветки
+   показывает ревьюверу правку вперемешку с чужой. Порядок и разбор конфликта — паттерн
+   `git-workflow-merge`.
+2. **В ветке только та правка, за которой её заводили** — `git diff main...HEAD --stat`. Чужой
    домен в списке файлов означает, что правка расползлась, и её надо вернуть в свои границы.
-2. **Ни мока, ни подменённого ответа, ни отладочной строки** — `git diff main...HEAD` читается
+3. **Ни мока, ни подменённого ответа, ни отладочной строки** — `git diff main...HEAD` читается
    целиком, а не по именам файлов. На прод они уезжают молча и портят настоящие данные.
-3. **Документ едет тем же коммитом.** Пару называет `docs-guard`, но спек домена и правку его
+4. **Документ едет тем же коммитом.** Пару называет `docs-guard`, но спек домена и правку его
    поведения он не знает — это остаётся за автором.
-4. **Проверки текстов и раскладки зелёные** — те, что дерево завело в `tools/`: сверка
+5. **Проверки текстов и раскладки зелёные** — те, что дерево завело в `tools/`: сверка
    сценариев с тестами, путей в документах, раскладки либ, повторов и классов без правила.
    Какие именно есть здесь — `implementation.md` правила.
-5. **Все приложения дерева собираются** — `nx build` по каждому. Гейт пуша сборку не гоняет:
+6. **Все приложения дерева собираются** — `nx build` по каждому. Гейт пуша сборку не гоняет:
    она длиннее всего, что он успевает сделать между командой и пушем.
-6. **Видимый текст заведён во всех локалях перевода** — тестом полноты словарей, если дерево
+7. **Видимый текст заведён во всех локалях перевода** — тестом полноты словарей, если дерево
    переводится.
-7. **Правка вёрстки подтверждена замером**, а не взглядом, и снята при узком экране — паттерн
+8. **Правка вёрстки подтверждена замером**, а не взглядом, и снята при узком экране — паттерн
    `browser-verification-measure`.
-8. **Правка разметки публичного сайта проверена на прод-сборке по всем локалям перевода** — паттерн
+9. **Правка разметки публичного сайта проверена на прод-сборке по всем локалям перевода** — паттерн
    `seo-verify`.
-9. **Тело PR начинается строкой `Closes #<номер>`**, а метки, ревьювер и исполнитель стоят.
-10. **Заголовок PR несёт номер задачи и называет её сделанной:** `[<КЛЮЧ>-<номер>] <Что сделано>`,
+10. **Тело PR начинается строкой `Closes #<номер>`**, а метки, ревьювер и исполнитель стоят.
+11. **Заголовок PR несёт номер задачи и называет её сделанной:** `[<КЛЮЧ>-<номер>] <Что сделано>`,
     тем же номером, что стоит у задачи и в имени ветки. Инфинитив из задачи в него не
     переносится, тип и область коммита — тоже.
-11. **Очередь работ сходится** — `npm run check:board`. Задача на борде, с исполнителем и
+12. **Очередь работ сходится** — `npm run check:board`. Задача на борде, с исполнителем и
     номером в заголовке; PR один на задачу, и закрывает он её целиком.
-12. **Состояние PR прочитано, а не выведено из кодов возврата** — автор `<бот>`,
+13. **Состояние PR прочитано, а не выведено из кодов возврата** — автор `<бот>`,
     ревьювер — владелец, метки те же, что у задачи. Владельцу называют прочитанное.
 
 Сразу после публикации задача переставляется в разбор — `npm run task:move -- <номер>

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

@@ -232,26 +232,30 @@ npm run task:move -- 86 in-review
 Проверок на самом MR нет ровно до тех пор, пока конвейер не запущен, а запускается он пушем.
 Линтеры, юниты и сценарии хуков снимает гейт пуша — ниже то, чего он не знает.
 
-1. **В ветке только та правка, за которой её заводили** — `git diff main...HEAD --stat`. Чужой
+1. **Главная ветка влита в эту ветку** — `git fetch origin && git merge origin/main`.
+   Всё, что проверяется ниже, проверяется от этого основания: MR с разошедшейся ветки
+   показывает ревьюверу правку вперемешку с чужой. Порядок и разбор конфликта — паттерн
+   `git-workflow-merge`.
+2. **В ветке только та правка, за которой её заводили** — `git diff main...HEAD --stat`. Чужой
    домен в списке файлов означает, что правка расползлась, и её надо вернуть в свои границы.
-2. **Ни мока, ни подменённого ответа, ни отладочной строки** — `git diff main...HEAD` читается
+3. **Ни мока, ни подменённого ответа, ни отладочной строки** — `git diff main...HEAD` читается
    целиком, а не по именам файлов. На прод они уезжают молча и портят настоящие данные.
-3. **Документ едет тем же коммитом.** Пару называет `docs-guard`, но спек домена и правку его
+4. **Документ едет тем же коммитом.** Пару называет `docs-guard`, но спек домена и правку его
    поведения он не знает — это остаётся за автором.
-4. **Проверки текстов и раскладки зелёные** — те, что дерево завело в `tools/`. Какие именно
+5. **Проверки текстов и раскладки зелёные** — те, что дерево завело в `tools/`. Какие именно
    есть здесь — `implementation.md` правила.
-5. **Все приложения дерева собираются** — `nx build` по каждому. Гейт пуша сборку не гоняет.
-6. **Видимый текст заведён во всех локалях перевода** — тестом полноты словарей, если дерево
+6. **Все приложения дерева собираются** — `nx build` по каждому. Гейт пуша сборку не гоняет.
+7. **Видимый текст заведён во всех локалях перевода** — тестом полноты словарей, если дерево
    переводится.
-7. **Правка вёрстки подтверждена замером**, а не взглядом, и снята при узком экране — паттерн
+8. **Правка вёрстки подтверждена замером**, а не взглядом, и снята при узком экране — паттерн
    `browser-verification-measure`.
-8. **Правка разметки публичного сайта проверена на прод-сборке по всем локалям перевода** —
+9. **Правка разметки публичного сайта проверена на прод-сборке по всем локалям перевода** —
    паттерн `seo-verify`.
-9. **Описание MR начинается строкой `Closes #<номер>`**, а метки, ревьювер и исполнитель стоят.
-10. **Заголовок MR несёт номер задачи и называет её сделанной:** `[<КЛЮЧ>-<номер>] <Что
+10. **Описание MR начинается строкой `Closes #<номер>`**, а метки, ревьювер и исполнитель стоят.
+11. **Заголовок MR несёт номер задачи и называет её сделанной:** `[<КЛЮЧ>-<номер>] <Что
 сделано>`, тем же номером, что стоит у задачи и в имени ветки.
-11. **Очередь работ сходится** — `npm run check:board`.
-12. **Состояние MR прочитано, а не выведено из кодов возврата.**
+12. **Очередь работ сходится** — `npm run check:board`.
+13. **Состояние MR прочитано, а не выведено из кодов возврата.**
 
 Сразу после публикации задача переставляется в разбор, и сверка очереди прогоняется ещё раз: до
 открытия MR список она не судит, а после открытия расхождение видит.

package/assets/patterns/spec-driven-domain.md

@@ -89,6 +89,18 @@ docs/specs/<домен>/
 `Не покрыто: <причина>`, сценарий с неполным тестом — `Покрытие: частичное — <чего не
 хватает>`.
 
+Номер в идентификаторе живёт так:
+
+| Что случилось           | Что делается с номером                                                                               |
+| ----------------------- | ---------------------------------------------------------------------------------------------------- |
+| сценарий добавили       | берётся следующий свободный — наибольший выданный в домене плюс один, а не дырка в середине          |
+| обещание изменили       | номер тот же, заголовок теста правится тем же коммитом                                               |
+| сценарий удалили        | номер остаётся пустым и новому сценарию не отдаётся; тест удаляется вместе со сценарием              |
+| номера захотелось сжать | не пересчитываются: связь с тестами держит только номер, а прогон остаётся зелёным при обеих правках |
+
+Номер записывается так же, как у соседей в этом же файле: сверка ищет его шаблоном, и номер,
+записанный иначе, не совпадёт ни в спеке, ни в заголовке теста.
+
 ## Порядок работы
 
 1. Задача заводится сценариями: что станет верно, когда работа закончится.
@@ -121,3 +133,10 @@ docs/specs/<домен>/
 - Закон, названный в тексте, но забытый в строке `**Законы:**`: по закону тогда не узнать,
   какие домены на нём стоят.
 - Правка `.proto` без спеков задетых доменов: `docs-guard` отбивает такой коммит.
+- **Выросший домен делится на поддомены, а не на новые домены.** Новый домен пришлось бы
+  заводить в указателе, сверять с кодом отдельно и объяснять, чем он соседу не поддомен;
+  поддомен остаётся в своём домене и наследует его контракт. Соседний домен заводится только
+  тогда, когда предмет живёт своей сущностью.
+- **Границу между доменами проводит владелец, а не автор очередной правки.** Автор видит свою
+  правку, а не то, чем предмет обрастёт: домен, заведённый по ходу дела, через месяц оказывается
+  половиной соседнего, и разводить их приходится вместе с номерами сценариев.

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

@@ -15,7 +15,7 @@ description: Паттерн правила task-flow. Брать при закр
 - Этапы замысла закрыты, проверки зелёные, отчёт готовится к публикации.
 - `npm run check:specs` перечислил договорённость в разделе «Пора вливать».
 
-## 1. Договорённость вливается в спек домена
+## 9. Договорённость вливается в спек домена
 
 Последним коммитом отчёта, до слияния. Код к этому моменту написан, поэтому привязки
 `файл:символ` известны — правило въезжает в спек домена сразу проверяемым.
@@ -44,7 +44,7 @@ npm run check:specs   # раздел «Пора вливать» называе
 npm run check:specs   # после вливания: привязки на месте, сценарии не потерялись
 ```
 
-## 2. Тексты домена приводятся к сделанному
+## 10. Тексты домена приводятся к сделанному
 
 В спек уезжает только то, что записали до кода. Остальные тексты — правила, паттерны, законы
 приложения — после правки никто не перечитывает, и они продолжают описывать старое дерево.
@@ -85,7 +85,7 @@ grep -rn -A3 "Чего из закона здесь нет" <каталог пр
 Что сделали на этом шаге, пишется в тело отчёта: что перечитали, что изменили, а если ничего
 не изменили — почему. Форма раздела — паттерн `git-workflow-commit`.
 
-## 3. Папка задачи разбирается
+## 11. Папка задачи разбирается
 
 Целиком в архив не переносится: `docs/archive/` — место для записей о состоявшемся, которые
 кто-то читает, а не свалка ходов работы.
@@ -106,7 +106,7 @@ rm -r docs/tasks/<КЛЮЧ>-<номер>-<slug>
 Разбор идёт в том же отчёте, что и работа: папка, оставленная до мержа, попадает в главную
 ветку и читается там как текущая.
 
-## 4. Сверка
+## 12. Сверка
 
 ```bash
 npm run check:board   # папка закрытой задачи среди текущих, брошенные черновики