@rt-tools/agent-kit 0.11.0 → 0.12.0

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

@@ -22,16 +22,21 @@
 #   5. Передача захода написана — окно кончилось.
 #   6. Владелец сказал остановиться.
 #
-# Чего страж не судит. Заход вне ветки задачи и работу без папки: состояние там объявлять
-# негде, и отбивать было бы не за что. Это его известная граница.
+# Работа без ветки и без папки задачи судится вторым признаком. Состояния у неё нет, и первый
+# признак взять неоткуда, — но ход, в котором не было ни одной правки дерева, не кончается и
+# здесь: просьба владельца «разложи», «обнови», «посмотри» живёт без задачи и без ветки, и
+# защищена она была меньше всего. Отпускают такой ход те же четыре вещи: вопрос, отказ гарда,
+# написанная передача и слово владельца об остановке.
 #
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: при любой ошибке, нехватке `jq`, отсутствии записи хода, папки задачи
 # или строки состояния ход РАЗРЕШАЕТСЯ (exit 0). Сломанный страж не имеет права заклинить
 # разговор.
 
 . "$(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
 
-input="$(cat 2>/dev/null)"
+rt_hook_read
+input="$RT_HOOK_INPUT"
 [ -z "$input" ] && exit 0
 command -v jq >/dev/null 2>&1 || exit 0
 
@@ -43,22 +48,25 @@ transcript="$(printf '%s' "$input" | jq -r '.transcript_path // empty' 2>/dev/nu
 [ -z "$transcript" ] && exit 0
 [ -f "$transcript" ] || exit 0
 
-workdir="$(printf '%s' "$input" | jq -r '.cwd // empty' 2>/dev/null)"
+workdir="$(rt_hook_cwd)"
 [ -z "$workdir" ] && workdir="${CLAUDE_PROJECT_DIR:-.}"
 cd "$workdir" 2>/dev/null || exit 0
 git rev-parse --is-inside-work-tree >/dev/null 2>&1 || exit 0
 
-branch="$(git branch --show-current 2>/dev/null)"
-[ -z "$branch" ] && exit 0
-
 root="$(git rev-parse --show-toplevel 2>/dev/null)"
 [ -z "$root" ] && exit 0
-tasks_dir="${RT_TASKS_DIR:-docs/tasks}"
-progress="$root/$tasks_dir/$branch/progress.md"
-[ -f "$progress" ] || exit 0
 
-state="$(sed -n 's/^[[:space:]]*[-*][[:space:]]*\*\*Состояние:\*\*[[:space:]]*`\([^`]*\)`.*/\1/p' "$progress" 2>/dev/null | head -1)"
-[ -z "$state" ] && exit 0
+# Ветка, папка задачи и строка состояния берутся, пока они есть. Пусто — ход судится вторым
+# признаком, а не отпускается: отсюда раньше уходили нулём, и работа по слову владельца
+# кончалась объявлением намерения молча.
+branch="$(git branch --show-current 2>/dev/null)"
+tasks_dir="${RT_TASKS_DIR:-docs/tasks}"
+progress=""
+state=""
+if [ -n "$branch" ] && [ -f "$root/$tasks_dir/$branch/progress.md" ]; then
+    progress="$root/$tasks_dir/$branch/progress.md"
+    state="$(sed -n 's/^[[:space:]]*[-*][[:space:]]*\*\*Состояние:\*\*[[:space:]]*`\([^`]*\)`.*/\1/p' "$progress" 2>/dev/null | head -1)"
+fi
 
 # Работа, дошедшая до этих двух состояний, чужого шага уже дождалась: дальше её двигает
 # владелец, и ход, закрытый здесь, ничего не роняет.
@@ -68,7 +76,8 @@ esac
 
 # Следующий шаг из хода работы — его страж и называет в отказе: исполнитель, которому сказано
 # только «работа не кончена», перечитывает ту же строку сам.
-next_step="$(sed -n 's/^[[:space:]]*[-*][[:space:]]*\*\*Следующий шаг:\*\*[[:space:]]*\(.*\)/\1/p' "$progress" 2>/dev/null | head -1)"
+next_step=""
+[ -n "$progress" ] && next_step="$(sed -n 's/^[[:space:]]*[-*][[:space:]]*\*\*Следующий шаг:\*\*[[:space:]]*\(.*\)/\1/p' "$progress" 2>/dev/null | head -1)"
 [ -z "$next_step" ] && next_step="что стоит в разделе «Где стоим» хода работы"
 
 # Команда, меняющая дерево или его состояние. Чтение и поиск сюда не входят намеренно: ими и
@@ -119,10 +128,14 @@ commands="$(printf '%s' "$verdict" | jq -r '.ran // ""' 2>/dev/null)"
 # Страж сравнивает номер этапа с тем, что лежит в истории ветки, и на выросшем номере требует
 # команды из строки «Чем проверяется» — она стоит в замысле обратными кавычками. Приём, записанный
 # прозой, страж не читает: подтвердить его выводом нечем, и это его известная граница.
-stage_now="$(sed -n 's/^[[:space:]]*[-*][[:space:]]*\*\*Этап:\*\*[[:space:]]*\([0-9][0-9]*\).*/\1/p' "$progress" 2>/dev/null | head -1)"
-stage_was="$(git -C "$root" show "HEAD:$tasks_dir/$branch/progress.md" 2>/dev/null | sed -n 's/^[[:space:]]*[-*][[:space:]]*\*\*Этап:\*\*[[:space:]]*\([0-9][0-9]*\).*/\1/p' | head -1)"
+stage_now=""
+stage_was=""
+if [ -n "$progress" ]; then
+    stage_now="$(sed -n 's/^[[:space:]]*[-*][[:space:]]*\*\*Этап:\*\*[[:space:]]*\([0-9][0-9]*\).*/\1/p' "$progress" 2>/dev/null | head -1)"
+    stage_was="$(git -C "$root" show "HEAD:$tasks_dir/$branch/progress.md" 2>/dev/null | sed -n 's/^[[:space:]]*[-*][[:space:]]*\*\*Этап:\*\*[[:space:]]*\([0-9][0-9]*\).*/\1/p' | head -1)"
+fi
 
-if [ -n "$stage_now" ] && [ -n "$stage_was" ] && [ "$stage_now" -gt "$stage_was" ] 2>/dev/null; then
+if [ -n "$progress" ] && [ -n "$stage_now" ] && [ -n "$stage_was" ] && [ "$stage_now" -gt "$stage_was" ] 2>/dev/null; then
     plan="$root/$tasks_dir/$branch/plan.md"
     # Контракт закрытого этапа, а не начатого: подтверждается то, что объявлено сделанным.
     contract="$(awk -v n="$stage_was" '
@@ -164,7 +177,18 @@ fi
 
 [ "$worked" = "true" ] && exit 0
 
-reason="BLOCKED by turn-exit-guard: работа в состоянии '${state}', а за этот ход по ней не сделано ничего — ни правки, ни команды, меняющей дерево.
+if [ -z "$state" ]; then
+    reason="BLOCKED by turn-exit-guard: за этот ход не сделано ничего — ни правки, ни команды, меняющей дерево. Папки задачи у этой работы нет, и состояние взять неоткуда, но ход это не кончает.
+
+Ход кончается четырьмя способами, и других нет: вопрос владельцу, ответа на который в правилах нет; отказ гарда; заполненное окно захода; отданная работа с начатой следующей. Названная и не запущенная команда выходом не является: строка «сейчас запущу» — объявление намерения, а оно прямо названо ложным концом хода.
+
+Работа по слову владельца — «разложи», «обнови», «посмотри» — идёт без задачи и без ветки, и остановить её нечем, кроме этого признака.
+
+Запусти названное этим же ходом. Владелец сказал остановиться — так и напиши: страж читает его слово, а не пересказ.
+
+Страж судит один ход: следующий заход не отбивается."
+else
+    reason="BLOCKED by turn-exit-guard: работа в состоянии '${state}', а за этот ход по ней не сделано ничего — ни правки, ни команды, меняющей дерево.
 
 Ход кончается четырьмя способами, и других нет: вопрос владельцу, ответа на который в правилах нет; отказ гарда; заполненное окно захода; отданная работа с начатой следующей. Отчёт о сделанном выходом не является — он выглядит работой лучше всякой другой, и пустоты за ним не видно.
 
@@ -173,6 +197,7 @@ reason="BLOCKED by turn-exit-guard: работа в состоянии '${state}
 Сделай его этим же ходом. Владелец сказал остановиться — так и напиши: страж читает его слово, а не пересказ.
 
 Страж судит один ход: следующий заход не отбивается."
+fi
 
 # Общий хвост отказа: два законных хода. Файл может быть не разложен — тогда хвоста нет,
 # а причина отказа остаётся прежней.

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

@@ -31,8 +31,10 @@
 # заходе ход РАЗРЕШАЕТСЯ (exit 0). Сломанный гард не имеет права заклинить разговор.
 
 . "$(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
 
-input="$(cat 2>/dev/null)"
+rt_hook_read
+input="$RT_HOOK_INPUT"
 [ -z "$input" ] && exit 0
 
 command -v jq >/dev/null 2>&1 || exit 0

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

@@ -30,8 +30,10 @@
 # работа РАЗРЕШАЕТСЯ (exit 0). Сломанный гард не имеет права заклинить работу.
 
 . "$(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
 
-input="$(cat 2>/dev/null)"
+rt_hook_read
+input="$RT_HOOK_INPUT"
 [ -z "$input" ] && exit 0
 
 command -v jq >/dev/null 2>&1 || exit 0
@@ -144,9 +146,9 @@ 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)"
+tool="$(rt_hook_tool)"
+path="$(rt_hook_file)"
+cmd="$(rt_hook_cmd)"
 
 allowed=0
 case "$tool" in

package/assets/laws/work-conduct.md

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

package/assets/patterns/dependencies-upgrade.md

@@ -2,7 +2,7 @@
 name: dependencies-upgrade
 kind: pattern
 rule: dependencies
-description: Паттерн правила dependencies. Брать при подъёме версий пакетов — выбор верхней границы по peer-диапазонам, порядок проверок, граница переформатирования после обновления форматтера, разбор новых правил линтера. Не брать для ветки, коммита и PR — это паттерн git-workflow-commit.
+description: Паттерн правила dependencies. Брать при подъёме версий пакетов — выбор верхней границы по peer-диапазонам, порядок проверок, граница переформатирования после обновления форматтера, разбор новых правил линтера. Не брать для ветки и коммита — это паттерн git-workflow-commit, для PR — git-workflow-pr.
 ---
 
 # Подъём версий

package/assets/patterns/doc-style-write.md

@@ -19,7 +19,7 @@ description: Паттерн правила doc-style. Брать при напи
 
 Само правило укладывается в одно предложение. Следом — не больше двух предложений о том, что
 сломается иначе, и только если из самой фразы это не видно. Обоснование, у которого была
-альтернатива, идёт в «Ловушки» правила, а не в сам закон: разросшийся буллет читают по
+альтернатива, идёт в ловушки — холодную часть правила, — а не в сам закон: разросшийся буллет читают по
 диагонали, а закон говорит, что верно, — не почему когда-то выбрали так.
 
 ```
@@ -41,8 +41,8 @@ description: Паттерн правила doc-style. Брать при напи
 Место исполнения меняется при первом же рефакторинге, и документ, который его называет,
 устаревает молча. Для него заведён отдельный файл — `implementation.md` рядом.
 
-Исключение — «Ловушки» правила: там устройство кода называется прямо, потому что ловушка и
-есть место, где на него наступают.
+Исключение — ловушки в холодной части правила: там устройство кода называется прямо, потому
+что ловушка и есть место, где на него наступают.
 
 ## Без утверждений о будущем
 

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

@@ -2,10 +2,10 @@
 name: git-workflow-commit
 kind: pattern
 rule: git-workflow
-description: Паттерн правила git-workflow для дерева в Azure DevOps. Брать на заведение рабочего элемента, ветки, коммит, пуш и создание PR — заведение элемента со всеми шагами, перевод по состояниям, слияние двух задач в одну, сверка очереди работ, работа от учётной записи машинной работы, формат заголовка, привязка PR к элементу, ревьювер, исполнитель и метки, образец тела PR с разделом об оставшемся шаге, чеклист проверок до публикации, обход требования документа. Не брать для миграций и перезапуска прода — это паттерны git-workflow-migration и git-workflow-restart.
+description: Паттерн правила git-workflow. Брать на заведение рабочего элемента, ветки, коммит и пуш — заведение элемента с областью и итерацией, перевод состояния, слияние двух задач в одну, работа от учётной записи машинной работы, обход требования документа. Не брать на открытие PR — это паттерн git-workflow-pr; не брать для миграций и перезапуска прода — это паттерны git-workflow-migration и git-workflow-restart.
 ---
 
-# Ветка, коммит и PR
+# Задача, ветка и коммит
 
 Паттерн правила `git-workflow`. Что при этом должно быть верно — закон
 `docs/constitution/delivery.md`.
@@ -15,7 +15,6 @@ description: Паттерн правила git-workflow для дерева в A
 - Заводится рабочий элемент, с которого начинается правка.
 - Заводится ветка под него.
 - Готовится коммит или пуш.
-- Открывается PR.
 - Работа перешла на следующий шаг, и элемент переводится в другое состояние.
 
 ## Сначала рабочий элемент, потом ветка
@@ -150,212 +149,13 @@ GIT_COMMITTER_NAME="<бот>" GIT_COMMITTER_EMAIL="<почта бота>" \
 Docs-skip: правка только в тестах хука, зеркала у него нет
 ```
 
-## Номер элемента стоит в его заголовке и в заголовке PR
-
-Форма одна на оба — `[<номер>] <текст>`. Номер стоит в самом заголовке, а не только в теле: в
-списке PR тела не видно. Тот же номер несёт и имя ветки, поэтому элемент, ветка и PR читаются
-как одно.
-
-Элемент говорит, что не так; PR тем же номером отчитывается, что сделано:
-
-```
-элемент  [86] Пустой адрес владельца — письма не уходят молча
-PR       [86] Письмо владельцу с незаполненным адресом попадает в логи
-```
-
-Инфинитив в заголовок PR не переносится: «исправить» становится «исправлено», «вернуть» —
-«возвращено», «добавить» — «добавлено».
-
-Тип и область — `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 привязывается к элементу при создании
-
-Привязка задаётся флагом, а не правкой после: у токена может не быть права править чужой
-элемент, и вторая команда обойдётся молча, оставив PR ни с чем не связанным.
-
-```bash
-AZURE_DEVOPS_EXT_PAT="$TOKEN" az repos pr create \
-    --title '[86] Письмо владельцу с незаполненным адресом попадает в логи' \
-    --source-branch 86-mail-owner-silence --target-branch main \
-    --work-items 86 --reviewers <владелец> --delete-source-branch true \
-    --description 'Закрывает рабочий элемент 86.'
-```
-
-Ревьювер — всегда владелец: без запроса разбора PR не показывается ему в очереди. Один PR
-закрывает элемент целиком — половину задачи одним PR не выкатывают: у задачи одна ветка, и
-работа, которая в неё не влезает, делится на задачи до того, как ветка заводится.
-
-У уже открытого PR то же ставится правкой:
-
-```bash
-az repos pr work-item add --id 205 --work-items 86
-az repos pr reviewer add --id 205 --reviewers <владелец>
-az repos pr update --id 205 --description "$(cat тело.md)"
-```
-
-Правка описания переписывает его целиком. Тело перечитывается всякий раз, когда в ветку что-то
-влилось после публикации: PR утверждает про дерево, а дерево с тех пор изменилось.
-
-## Образец тела PR
-
-Четыре раздела, и порядок между ними один: строка связи, что сделано, чем подтверждено,
-оставшийся шаг. Раздел, которому нечего сказать, пишется словами — пустой заголовок и снятый
-заголовок читаются одинаково, а значат разное.
-
-```markdown
-Закрывает рабочий элемент 86.
-
-## Что сделано
-
-- <правка, названная тем, что она меняет для читателя, а не тем, какие файлы задела>
-
-## Чем подтверждено
-
-- <проверка>: <её вывод одной строкой>
-- Не гонялось: <что в набор не вошло и почему>
-
-## Оставшийся шаг
-
-После одобрения ветка получает ещё один коммит — разбор папки задачи, — и только потом
-вливается. До этого коммита вливать рано: папка уедет в главную ветку неразобранной.
-```
-
-Раздел «Оставшийся шаг» стоит последним и переписывается тем же вызовом, что и остальное тело,
-— в тот ход, которым папка разбирается и снимается черновик:
-
-```markdown
-## Оставшийся шаг
-
-Не осталось: папка задачи разобрана коммитом `<sha>`, черновик снят. Можно вливать.
-```
-
-Стоит он там потому, что решение о слиянии принимается на этой странице, а не в переписке:
-сказанное владельцу вслух живёт до следующей реплики, а тело лежит у самой кнопки. Одно другого
-не отменяет — порядок обоих сообщений владельцу описывает паттерн закрытия работы.
-
-Проверить тело машиной нечем: ни одна сверка его не читает, а хостинг спрашивает только про
-заголовок. Держится образец тем, кто пишет тело, — как и слова вслух.
-
-## Состояние PR читается, а не додумывается
-
-Команды правки отвечают нулевым кодом и тогда, когда ничего не сделали. Поэтому после них PR
-перечитывают:
-
-```bash
-az repos pr show --id 205 \
-    --query '{author: createdBy.uniqueName, reviewers: reviewers[].uniqueName, work: workItemRefs[].id}'
-```
-
-Владельцу называют то, что прочитали, а не то, что заказывали.
-
-Перечитывают его и по времени, а не только после вызовов, которые молча ничего не сделали:
-состояние PR читается перед тем, как что-либо о нём сказать. Между «прогон зелёный» и следующей
-фразой владелец успевает влить PR, и всё сказанное о нём после этого — про вчерашний день. Так
-владельцу и было предложено влить то, что он влил часом раньше.
-
-Открытый PR означает, что элемент ждёт разбора, — состояние переставляется тем же движением:
-
-```bash
-npm run task:move -- 86 in-review
-```
-
-## Что проверяется до публикации PR
-
-Конвейер видит только отправленное, а отправляется оно пушем. Линтеры, юниты и сценарии хуков
-снимает гейт пуша — ниже то, чего он не знает.
-
-1. **Главная ветка влита в эту ветку** — `git fetch origin && git merge origin/main`.
-   Всё, что проверяется ниже, проверяется от этого основания: PR с разошедшейся ветки
-   показывает ревьюверу правку вперемешку с чужой. Порядок и разбор конфликта — паттерн
-   `git-workflow-merge`.
-2. **В ветке только та правка, за которой её заводили** — `git diff main...HEAD --stat`. Чужой
-   домен в списке файлов означает, что правка расползлась, и её надо вернуть в свои границы.
-3. **Ни мока, ни подменённого ответа, ни отладочной строки** — `git diff main...HEAD` читается
-   целиком, а не по именам файлов. На прод они уезжают молча и портят настоящие данные.
-4. **Документ едет тем же коммитом.** Пару называет `docs-guard`, но спек домена и правку его
-   поведения он не знает — это остаётся за автором.
-5. **Проверки текстов и раскладки зелёные** — те, что дерево завело в `tools/`. Какие именно
-   есть здесь — `implementation.md` правила.
-6. **Все приложения дерева собираются** — `nx build` по каждому. Гейт пуша сборку не гоняет.
-7. **Видимый текст заведён во всех локалях перевода** — тестом полноты словарей, если дерево
-   переводится.
-8. **Правка вёрстки подтверждена замером**, а не взглядом, и снята при узком экране — паттерн
-   `browser-verification-measure`.
-9. **Правка разметки публичного сайта проверена на прод-сборке по всем локалям перевода** —
-   паттерн `seo-verify`.
-10. **PR привязан к рабочему элементу**, ревьювер и исполнитель стоят, а тело собрано по
-    образцу — разделы «Что сделано», «Чем подтверждено» и «Оставшийся шаг». Раздел оставшегося
-    шага к этому моменту говорит, что шагов не осталось: черновик снимается после разбора
-    папки, а не до него.
-11. **Заголовок PR несёт номер элемента и называет работу сделанной:** `[<номер>] <Что
-сделано>`, тем же номером, что стоит у элемента и в имени ветки.
-12. **Очередь работ сходится** — `npm run check:board`.
-13. **Состояние PR прочитано, а не выведено из кодов возврата.**
-14. **Набор взят из файла конвейера, а не собран по памяти.** Гейт пуша заведомо уже: он стоит
-    между командой и пушем, и всё, что дольше секунд, из него вынесено. Что гоняет конвейер,
-    написано в его файле — этот список и повторяется локально; зелёный гейт полнотой набора не
-    является.
-15. **Набор пересмотрен после вливания главной ветки.** Он выбирается по тому, что ветка везёт
-    теперь, а не по тому, что правил автор. Ветка, не тронувшая ни строки показа, прогоняет
-    снимки витрин: с момента вливания их гоняет конвейер на её коде, и красное придёт на её
-    PR.
-
-Сразу после публикации элемент переводится в разбор, и сверка очереди прогоняется ещё раз: до
-открытия PR состояние она не судит, а после открытия расхождение видит.
-
-Сделанное рассуждением и сделанное замером в теле PR разводятся прямо: непроверенное,
-названное проверенным, ревьювер принимает за проверенное.
-
-**Раздел «Чем подтверждено» называет и то, что не гонялось.** Список одного прогнанного
-неотличим от полного набора, и ревьювер по нему решает, что можно не перепроверять. Цена ошибки
-здесь не красный конвейер, а доверие к разделу: однажды прочитанный как полнота, дальше он
-перепроверяется весь.
-
 ## Частые промахи
 
 - Область и итерация не заданы: элемент заведён, но на доску команды не попал.
 - Состояние взято не из процесса проекта: перевод отвечает отказом на каждой задаче, и это
   читается как сломанная команда, а не как неверное имя состояния.
-- PR открыт без `--work-items`: связи нет, и по очереди работ не видно, за чем эта правка.
-- `AB#<номер>` в коммите принят за привязку PR: он связывает коммит, а очередь читает связь PR.
 - `git add` с несколькими путями не добавляет ничего, если хоть один путь не существует:
   команда обрывается на первом промахе целиком. Следующий `git commit --amend` при этом уносит
   в коммит всё, что осталось в индексе. Состав коммита читается `git show --stat` сразу после
   него, а не на разборе PR.
-- PR открыт без ревьювера: он не попадает во входящие владельца, и очередь стоит, выглядя
-  работающей.
-- `--delete-source-branch` забыт: ветки задач копятся в репозитории, и по списку веток больше
-  не видно, какая работа идёт сейчас.
-- Автозавершение включено до того, как прогнаны проверки до пуша: конвейер зелёный на том, что
-  он умеет, и слияние происходит без всего остального.
 - Правка владельца ни токена, ни переменных не берёт — они только для машинной работы.