@rt-tools/agent-kit 0.4.0 → 0.5.1

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

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

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

@@ -0,0 +1,115 @@
+---
+name: task-flow-handoff
+kind: pattern
+rule: task-flow
+description: Паттерн правила task-flow. Брать, когда заход упирается в заполнение окна — выбор точки остановки, запись хода работы, форма передачи и что владелец с ней делает. Не брать для возвращения к работе новым заходом — это паттерн task-flow-resume.
+---
+
+# Закрытие захода по заполнению окна
+
+Паттерн правила `task-flow`. Что при этом должно быть верно — закон
+`docs/constitution/work-conduct.md`.
+
+## Когда брать
+
+- Пришло напоминание о заполнении окна.
+- Работа не влезает в заход, и это стало видно заранее.
+- Заход прерывается по любой другой причине: владелец уходит, машина занята.
+
+## Что происходит на порогах
+
+| Заполнение          | Что делает гард                                              | Что делает заход                                      |
+| ------------------- | ------------------------------------------------------------ | ----------------------------------------------------- |
+| до первого порога   | молчит                                                       | работает                                              |
+| первый порог и выше | напоминание на каждой следующей ступени в пять процентов     | выбирает точку остановки и доводит до неё текущий шаг |
+| второй порог и выше | отбивает всё, кроме папки задачи, передачи и команд поставки | закрывается                                           |
+
+Пороги сторожит гард заполнения окна; размер окна он берёт из настройки дерева — из записи
+захода тот не выводится. Место между порогами и есть то, на что заход закрывается: дописать ход
+работы, написать передачу, закоммитить и открыть отчёт, если работа кончена.
+
+## Точка остановки
+
+Логическая точка — не «где застало напоминание», а состояние, с которого следующий заход
+продолжит, ничего не переделывая:
+
+- этап замысла закрыт целиком, а не наполовину;
+- то, что сделано, проверено — прогон прошёл, сборка собрана, замер снят;
+- проверенное закоммичено: незакоммиченное не переживёт перерыв;
+- начатое и брошенное названо в ходе работы прямо, вместе с причиной.
+
+Незакрытый этап — тоже законная точка, если в ходе работы записано, что именно из него сделано и
+чем это подтверждено. Незаконная точка одна: правка, о которой не записано ничего.
+
+## 8. Заход закрывается передачей
+
+Уборку этого шага — главную ветку, влитые ветки и запись самой передачи — делает команда
+`next-session`: она проходит его целиком и называет путь к передаче последней строкой. Ниже —
+что при этом должно получиться; порядок один и тот же, зовут его командой или руками.
+
+### Ход работы
+
+Раздел «Где стоим» перезаписывается, решения по ходу и запись захода дописываются. Форма —
+паттерн `task-flow-resume`.
+
+### Коммит
+
+Проверенное коммитится сразу, а не копится до конца задачи. Работа кончена — открывается отчёт:
+паттерн `git-workflow-commit`.
+
+### Передача
+
+Кладётся вне дерева, одним файлом на ветку — каталог передачи называет профиль дерева:
+
+```bash
+mkdir -p <каталог передачи>
+# файл — <каталог передачи>/<ветка>.md
+```
+
+Внутри — готовый текст для вставки в новый заход, без обращения к владельцу за подробностями:
+
+```markdown
+Работа: <КЛЮЧ>-<номер> «<название задачи>». Рабочее дерево — <полный путь>, ветка
+<КЛЮЧ>-<номер>-<slug> (заведена, в работе).
+
+Ход работы и замысел придут на запуске сессии хуком — перечитывать их файлами не надо. Разбор
+просьбы владельца лежит в папке задачи и читается, когда непонятна причина решения.
+
+Сделано: этапы 1–3 замысла закрыты и закоммичены.
+Следующий шаг: этап 4 — <что именно>.
+
+Что учесть в этом заходе:
+
+- стенды уже подняты владельцем, свой не поднимать;
+- зависимости этого дерева отстают от главной ветки — при падении сборки на чужой ошибке
+  сперва установка зависимостей;
+- <прочее, чего нет ни в правилах, ни в ходе работы>.
+```
+
+Разделы фиксированы, и порядок у них тот же:
+
+1. **Работа** — номер задачи, её название, рабочее дерево полным путём, ветка и её состояние.
+2. **Где искать** — что придёт хуком само, а что читается по надобности.
+3. **Сделано и следующий шаг** — одной строкой каждое; подробности уже в ходе работы.
+4. **Что учесть** — особенности этого захода, которых нет ни в правилах, ни в ходе работы:
+   поднятые стенды, отставшие зависимости, чужие процессы на портах, незакрытые вопросы к
+   владельцу.
+
+### Путь владельцу
+
+Последнее действие захода — назвать владельцу путь к передаче, чтобы он вставил текст в новый
+заход одной вставкой. Пересказывать содержание передачи в ответе не надо: владелец её и так
+прочитает, а место на неё уже потрачено.
+
+## Ловушки
+
+- **Заход закрывается на втором пороге, а не начинает на нём новый этап.** Напоминание на
+  первом — это уже сигнал выбирать точку, а не работать дальше, пока не отобьют.
+- **Передача пишется как пересказ переписки.** В неё идёт то, чего нет ни в ходе работы, ни в
+  правилах: дерево, ветка, состояние стендов. Всё остальное следующий заход прочитает сам.
+- **Состояние работы в передачу не переезжает.** Сделанное отмечается в ходе работы — одной
+  записью; передача его пересказывает, но не заменяет и в дерево не коммитится.
+- **Незакоммиченное не названо.** Работа живёт в дереве неделями, и строка «что лежит
+  несохранённым и почему» — единственное, по чему это видно.
+- **Заход, кончившийся ничем, тоже пишет передачу.** «Пробовали так — не вышло, потому что» —
+  это и есть его результат; без записи следующий заход повторит тот же путь.

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

@@ -32,7 +32,7 @@ description: Паттерн правила task-flow. Брать при возв
   ней проверяется деревом — сборкой, тестами, чтением файла, — а не вопросом.
 - **Не править замысел.** С ним сверяют результат; пересмотр идёт записью в ходе работы.
 
-## Первое действие захода
+## 6. Возвращение к работе новым заходом
 
 Сверить «Где стоим» с деревом. Запись описывает день, когда её сделали:
 
@@ -44,7 +44,7 @@ git log --oneline origin/main..HEAD
 Разошлось — «Где стоим» правится сразу, до работы: следующий заход поверит записи, а не
 дереву.
 
-## Как ведётся ход работы
+## 7. Этап делается и отмечается в ходе работы
 
 Раздел «Где стоим» **перезаписывается**, а не дописывается — это первое, что читает следующий
 заход, и единственное, что переживает обрезку по объёму:

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

@@ -17,6 +17,10 @@ description: Паттерн правила task-flow. Брать в начале
 
 ## Порядок
 
+Шаги ниже — начало сплошного счёта: номер шага один на весь путь работы и в следующем паттерне
+не начинается заново. Весь список — в правиле `task-flow`; он же показывается владельцу в начале
+работы, чтобы после шести вопросов было видно, что впереди.
+
 ### 1. Разведка — до первого вопроса
 
 Вопрос, ответ на который лежит в коде, владельцу не задаётся: он обесценивает и остальные.
@@ -45,8 +49,9 @@ Agent(subagent_type: "Explore", prompt: "<тема просьбы>: что по
 | Чем будет видно, что задача закрыта          | «работает» признаком не является                         |
 | Есть ли образец, с которого снимается подход | разведка найдёт похожее, а не то                         |
 
-Спрашивается прозой. Меню вариантов годится, только когда постановка уже подтверждена и
-остался выбор значения из закрытого набора; выбор слова, имени и термина — никогда.
+Форму вопроса задают настройки владельца: где они требуют меню, спрашивается меню, и тогда к
+каждому вопросу добавляется свободный вариант — у закрытого набора нет строки «вопрос не тот».
+Выбор слова, имени и термина уточняется прозой в любом случае.
 
 Ответы пишутся в `docs/tasks/_draft-<slug>/grill.md` — папка ещё черновик, номера нет.
 
@@ -67,6 +72,12 @@ Workflow(name: "plan", args: "docs/tasks/_draft-<slug>")
 (`spec-critic`) → замысел и разбивка (`project-manager`). Пробелы, которые роли не смогли
 закрыть, возвращаются владельцу — их относит главный агент.
 
+Договорённость, вышедшая из конвейера, сверяется с `grill.md` построчно до того, как по ней
+пойдёт работа. Роль пишет текст, не видя владельца, и способна развернуть его ответ в
+противоположный: очередь этапов оказалась перевёрнута, а два пункта из входящих переехали в
+«не входит». Находка критика, расходящаяся с ответом владельца, относится владельцу — она не
+исполняется молча и не считается закрытой правкой текста.
+
 ### 4. Задача, ветка, папка
 
 ```bash
@@ -115,3 +126,8 @@ cp docs/tasks/_template/progress.md docs/tasks/<КЛЮЧ>-<номер>-<slug>/pr
   пережить.
 - **Задача заводится командой, а не четырьмя вызовами подряд.** Борда к репозиторию не
   привязана, и задача попадает на неё только явным добавлением.
+- **Slug ветки берётся из терминологии договорённости, а не из слов просьбы.** Договорённость
+  пишется раньше ветки и как раз там отказывается от слова владельца: спек завёл своё имя
+  предмету и прямо сказал, каким словом его не называть, — а ветка и папка задачи остались с
+  отвергнутым. Заголовок задачи и отчёта поправить можно, имя ветки после открытия отчёта —
+  уже нет.

package/assets/rules/angular-patterns.md

@@ -59,6 +59,10 @@ description: Правило под «Закон о фронтовом прило
   сигнал, — это ручной пересчёт, и он рано или поздно отстаёт от источника.
 - **Геттеров в компонентах нет.** Геттер пересчитывается на каждой перерисовке, и цена его не
   видна ни в одном месте кода.
+- **Статический атрибут без значения задаёт входу пустую строку, а не умолчание.**
+  `<ng-template someControl>` даёт `''`, и вход с осмысленным умолчанием молча его теряет;
+  сигнальный вход с алиасом здесь ничем не отличается от `@Input()`. Вход, у которого умолчание
+  что-то значит, приводит пустую строку к нему сам — `transform` или проверка в `computed`.
 - **Подписка на каждый вызов метода не даёт выбрать, что делать с предыдущим запросом.**
   Быстрые нажатия дают гонку ответов, и побеждает тот, что вернулся последним, а не тот, что
   нажали последним.

package/assets/rules/browser-verification.md

@@ -15,7 +15,7 @@ description: Правило под «Закон о проверяемости».
 
 | В законе                          | Здесь                                                                                           |
 | --------------------------------- | ----------------------------------------------------------------------------------------------- |
-| работающее приложение             | сайт на 4900, админка на 4901, API на 3333 — всё поднято владельцем                             |
+| работающее приложение             | то, что поднято в этом дереве; перечень и порты — в `implementation.md` рядом                   |
 | место, где его видит пользователь | прод-сборка за настоящим `deploy/nginx.conf`, а не дев-сервер                                   |
 | замер                             | `getComputedStyle`, `getBoundingClientRect`, контраст, совпадение центров, попадание во вьюпорт |
 | драйвер браузера                  | `claude-in-chrome` на закреплённом профиле этого дерева                                         |
@@ -28,8 +28,9 @@ description: Правило под «Закон о проверяемости».
 
 ## Как закон применяется здесь
 
-- **Свой дев-сервер не поднимается.** Приложения уже подняты владельцем, и попытка поднять
-  второй экземпляр отбивается гардом.
+- **Второй экземпляр уже поднятого приложения не поднимается.** До первого запроса выясняется,
+  кто отвечает на порту: поднятый заново экземпляр отвечает своей сборкой, а не той, которую
+  проверяют. Кто поднимает стенд — владелец или агент, — сказано в именах дерева.
 - **Браузер водится одним драйвером на закреплённом профиле.** Остальные двери — второй
   драйвер, `open`, `osascript`, запуск бинарника — закреплённый профиль не спрашивают вовсе.
 - **Выбор браузера протухает и требует повторного вызова.** Выбор, сделанный в начале

package/assets/rules/doc-style.md

@@ -34,8 +34,26 @@ description: Правило под «Закон о документации пр
   которые едут в репозиторий: личный черновик, закрытый `.gitignore` или
   `.git/info/exclude`, проверка не читает — мёртвая ссылка в нём держала гейт пуша, хотя ни
   в одну ветку этот файл не попадёт.
+- **Голое имя и каталог судятся наравне с полным путём.** Имя без каталога ищется по всему
+  дереву, каталог — среди каталогов; дерево спрашивается у системы контроля версий, иначе
+  каталоги, начинающиеся с точки, не видны и всё, что в них лежит, читалось бы как
+  несуществующее. Половина строк в таблицах «Где это лежит» — как раз каталоги.
 - **Описание прошлого из проверки путей выведено целиком.** Архив по устройству называет
-  файлы, которых уже нет, и правкой это не лечится.
+  файлы, которых уже нет, и правкой это не лечится. Папка задачи выведена по той же причине:
+  раздел находок в ходе работы перечисляет ровно то, чего в дереве нет.
+- **Переносимый текст из сверки адресов выведен, как архив.** Закон, правило и паттерн написаны
+  для любого дерева этого класса, и адреса в них принадлежат тому дереву, куда текст ложится:
+  `libs/common/util` там, где корни зовутся иначе, — пример, а не мёртвая ссылка. Разложенную
+  копию проверка узнаёт по шапке раскладки, исходник — по каталогу, названному в настройке; без
+  этого сверка краснеет на полторы сотни строк, ни одна из которых не чинится здесь.
+- **Указатель каталога сверяется с его содержимым обеими сторонами.** Записи каталог набирает
+  быстрее, чем читают его указатель, и промах не виден ни в сборке, ни в браузере: запись,
+  приехавшая слиянием соседней ветки, просто не попадает в таблицу. Сверенный руками указатель
+  расходится снова через сутки.
+- **Имя, названное затем, чтобы сказать «его нет», стоит в списке исключений поимённо.**
+  Отличить такое упоминание от ссылки машине нечем, а текст без него теряет смысл: правило и
+  замысел предупреждают именно о снятом. Туда же — то, что появляется только после сборки,
+  имена веток и правила линтеров: выглядят адресом, адресом не являются.
 - **Документ едет в том же коммите, что и правка, которую он описывает.** Обход — строка
   `Docs-skip: <причина>` в теле коммита; пустая причина не принимается.
 
@@ -57,6 +75,19 @@ description: Правило под «Закон о документации пр
 - `doc-style-write` — как формулировать: примеры «так» и «не так», правила для комментариев.
 - `doc-style-sweep` — разбор документа, накопившего список работ, на действующее и закрытое.
 
+## Скилы дерева
+
+Здесь дерево перечисляет свои скилы о документах — строка на скил: как он называется и какие
+документы ведёт. У пакета этот раздел пуст: свои документы бывают только у дерева.
+
+Раздел заведён затем, чтобы такому списку было куда встать. Дописанный в чужой раздел, он
+уносит его с собой: надстройка сливается по заголовку `## ` и замещает пакетный раздел целиком,
+поэтому приписка к «Ловушкам» стирает те пакетные пункты, которых дерево не переписывало, и
+пропажу не видно ничем.
+
+Читается этот список раньше остального: правило говорит, как формулировать, а скил дерева — что
+у документа этого рода обязательно есть, вплоть до второго файла рядом.
+
 ## Ловушки
 
 - **Оставшаяся работа не записывается в документ, а заводится задачей.** `docs/BACKLOG.md`
@@ -84,6 +115,20 @@ description: Правило под «Закон о документации пр
 - **Снятое имя вычищается одним грепом по всему дереву:** правила, их зеркала в скилах,
   документы и комментарии. Описание того, чего в коде уже нет, читается как действующее
   указание.
+- **Поиск по дереву не покрывает того, что уже уехало наружу.** Заголовок задачи и её тело,
+  заголовок отчёта и его тело, заголовки коммитов лежат вне файлов, и проверки текстов их не
+  читают вовсе. Вычистив слово в дереве, обходят те же места в очереди работ и в истории:
+
+    ```bash
+    <клиент хостинга> api "<путь к отчёту>" --jq '.title, .body' | grep -i '<слово>'
+    <клиент хостинга> api "<путь к задаче>" --jq '.title, .body' | grep -i '<слово>'
+    git log --format='%s%n%b' <база>..HEAD | grep -i '<слово>'
+    ```
+
+    Заголовок отчёта правится вызовом хостинга, заголовок коммита — только переписыванием ветки,
+    поэтому его проверяют до пуша. Выдуманное слово было вычищено из трёх файлов и объявлено
+    снятым, а в заголовке отчёта и в заголовке коммита осталось — владелец прочитал именно его.
+
 - **Число в тексте пересчитывается командой в том же коммите, где пишется.** Оно стареет
   внутри одной ветки: «шестнадцать пар» стало неправдой через два коммита после того, как
   было написано, и нашёл это владелец, а не проверка. Число, которое придётся пересчитывать
@@ -91,6 +136,13 @@ description: Правило под «Закон о документации пр
   выборке руками до того, как его называют: разбор, не знающий второй формы записи, ошибается
   молча — «51 пункт без задачи» оказался шестью, потому что номер стоял и отдельной строкой, и
   в заголовке подраздела.
+- **Названная в тексте проверка запускается, а не пересказывается.** «Проверка есть» и
+  «проверка проходит» — разные утверждения, и второго в тексте обычно нет вовсе. Из четырёх
+  проверок, названных правилом, три оказались не в том состоянии, в каком текст их описывает:
+  одна отдавала полтора десятка замечаний, вторая переписывала файлы самим запуском, третья
+  была красной и роняла общую сводку вместе с собой. Ни одна из трёх не входила в выкатку,
+  поэтому молчание было полным. Проверку, которая переписывает файлы, запускают на чистом
+  дереве: иначе её правки уедут чужим коммитом.
 - **Сделанность читается по дереву, а не по тексту, который о ней написан.** Это верно в обе
   стороны: строка про README обеих либ была вычеркнута как сделанная, а README остался с
   прежним числом импортёров; задача, названная владельцу несделанной, оказалась наполовину

package/assets/rules/git-workflow.azure.md

@@ -114,3 +114,27 @@ description: Правило под «Закон о поставке» для д
 - `git-workflow-merge` — главная ветка влита в ветку задачи, конфликт разобран.
 - `git-workflow-migration` — правка схемы хранилища и её миграций.
 - `git-workflow-restart` — ручной перезапуск прода.
+
+## Ловушки
+
+- **Одна работа — одна задача, сколько бы файлов она ни задела.** Числа, за которым правка
+  становится вторым рабочим элементом, здесь нет: делится то, что придётся откатывать порознь.
+  Сплошная правка текстов дерева была заведена тремя задачами «по объёму» — пришлось стирать
+  два рабочих элемента, закрывать два PR и переносить коммиты по одному с двумя конфликтами.
+  Одна из трёх не дала коммита вовсе: правка тел уже заведённых задач веткой не бывает и задачей
+  под ветку тоже.
+- **Рабочий элемент заводится командой, а не вызовами подряд.** Доска показывает элементы своей
+  области и итерации, и заведённый мимо них в очереди работ не виден: со стороны это выглядит
+  так же, как незаведённый. Команда заведения ставит все поля разом — род, состояние,
+  исполнителя, область и итерацию, — и печатает готовую строку заведения ветки. Замеченный по
+  ходу дефект проходит тот же путь.
+- **Ветка заводится вторым вызовом, а не тем же.** Гард главной ветки отклоняет составную
+  «создать ветку и сразу коммитить» целиком: ветки в момент разбора ещё нет.
+- **Сторона конфликта бывает удалением, и «сохранить обе стороны» заводит второе объявление.**
+  Главная ветка снимает объявление, потому что символ переехал, — в конфликте это выглядит как
+  сторона, которая ничего не дописала. Разбирается чтением версии главной ветки целиком, а не по
+  хунку, и сверяется проверкой повторов: обе копии сами по себе исправны, сборка и линт зелёные.
+- **Учётная запись для пуша и автор PR выбираются отдельно.** Если пушить пришлось из-под другой
+  записи, на следующий вызов это не переносится: PR открывают токеном учётной записи машинной
+  работы, и от того, чьей записью он открыт, зависит, кого можно назначить ревьювером. Однажды
+  смена записи ради пуша утекла в публикацию — отчёт вышел от владельца.

package/assets/rules/git-workflow.github.md

@@ -121,3 +121,26 @@ description: Правило под «Закон о поставке» для д
 - `git-workflow-merge` — главная ветка влита в ветку задачи, конфликт разобран.
 - `git-workflow-migration` — правка схемы хранилища и её миграций.
 - `git-workflow-restart` — ручной перезапуск прода.
+
+## Ловушки
+
+- **Одна работа — одна задача, сколько бы файлов она ни задела.** Числа, за которым правка
+  становится второй задачей, здесь нет: делится то, что придётся откатывать порознь. Сплошная
+  правка текстов дерева была заведена тремя задачами «по объёму» — пришлось стирать две,
+  закрывать два PR и переносить коммиты по одному с двумя конфликтами. Одна из трёх не дала
+  коммита вовсе: правка тел уже заведённых задач веткой не бывает и задачей под ветку тоже.
+- **Задача заводится командой, а не четырьмя вызовами подряд.** Борда к репозиторию не
+  привязана, и задача попадает на неё только явным добавлением: две задачи так и простояли вне
+  очереди работ, потому что шаг переписывали руками. Команда заведения делает все четыре — issue,
+  номер в его заголовке, добавление на борду, начальную колонку, — и печатает готовую строку
+  заведения ветки. Замеченный по ходу дефект проходит тот же путь.
+- **Ветка заводится вторым вызовом, а не тем же.** Гард главной ветки отклоняет составную
+  «создать ветку и сразу коммитить» целиком: ветки в момент разбора ещё нет.
+- **Сторона конфликта бывает удалением, и «сохранить обе стороны» заводит второе объявление.**
+  Главная ветка снимает объявление, потому что символ переехал, — в конфликте это выглядит как
+  сторона, которая ничего не дописала. Разбирается чтением версии главной ветки целиком, а не по
+  хунку, и сверяется проверкой повторов: обе копии сами по себе исправны, сборка и линт зелёные.
+- **Учётная запись для пуша и автор PR выбираются отдельно.** Если пушить пришлось из-под другой
+  записи, на следующий вызов это не переносится: PR открывают токеном учётной записи машинной
+  работы, и от того, чьей записью он открыт, зависит, кого можно назначить ревьювером. Однажды
+  смена записи ради пуша утекла в публикацию — отчёт вышел от владельца.

package/assets/rules/git-workflow.gitlab.md

@@ -111,3 +111,26 @@ description: Правило под «Закон о поставке» для д
 - `git-workflow-merge` — главная ветка влита в ветку задачи, конфликт разобран.
 - `git-workflow-migration` — правка схемы хранилища и её миграций.
 - `git-workflow-restart` — ручной перезапуск прода.
+
+## Ловушки
+
+- **Одна работа — одна задача, сколько бы файлов она ни задела.** Числа, за которым правка
+  становится второй задачей, здесь нет: делится то, что придётся откатывать порознь. Сплошная
+  правка текстов дерева была заведена тремя задачами «по объёму» — пришлось стирать две,
+  закрывать два MR и переносить коммиты по одному с двумя конфликтами. Одна из трёх не дала
+  коммита вовсе: правка тел уже заведённых задач веткой не бывает и задачей под ветку тоже.
+- **Задача заводится командой, а не вызовами подряд.** Доска показывает те issue, чью метку
+  знает, и задача без метки списка в очереди работ не видна: со стороны это выглядит так же, как
+  незаведённая. Команда заведения ставит всё разом — issue, номер в его заголовке, метку списка,
+  исполнителя, — и печатает готовую строку заведения ветки. Замеченный по ходу дефект проходит
+  тот же путь.
+- **Ветка заводится вторым вызовом, а не тем же.** Гард главной ветки отклоняет составную
+  «создать ветку и сразу коммитить» целиком: ветки в момент разбора ещё нет.
+- **Сторона конфликта бывает удалением, и «сохранить обе стороны» заводит второе объявление.**
+  Главная ветка снимает объявление, потому что символ переехал, — в конфликте это выглядит как
+  сторона, которая ничего не дописала. Разбирается чтением версии главной ветки целиком, а не по
+  хунку, и сверяется проверкой повторов: обе копии сами по себе исправны, сборка и линт зелёные.
+- **Учётная запись для пуша и автор MR выбираются отдельно.** Если пушить пришлось из-под другой
+  записи, на следующий вызов это не переносится: MR открывают токеном учётной записи машинной
+  работы, и от того, чьей записью он открыт, зависит, кого можно назначить ревьювером. Однажды
+  смена записи ради пуша утекла в публикацию — отчёт вышел от владельца.

package/assets/rules/spec-driven.md

@@ -69,12 +69,30 @@ description: Правило под «Закон о документации пр
   обслуживает, но забыл описать, видна только в декораторе.
 - **Код отказа принимается, только если он в домене бросается.** Коды выписывались по
   замыслу, и на одном пути обещанный отказ не бросал никто.
-- **Префикс сценариев в домене один.** Второй префикс означает, что домен описан дважды.
+- **Префикс сценариев в спеке один, и по всему дереву он занят им одним.** Второй префикс
+  внутри спека означает, что предмет описан дважды; занятый чужим — что по номеру не видно,
+  чей это сценарий. Договорённость о продукте — исключение: она нумеруется вместе со спеком, в
+  который вольётся, и занятым префикс от неё не становится.
+- **Номер сценария выдаётся один раз и повторно не используется.** Новый сценарий берёт
+  следующий свободный номер, а не вставляется в середину и не занимает номер удалённого: на
+  месте удалённого номер так и остаётся пустым. Номер — единственное, чем сценарий связан с
+  тестом, и отданный второй раз он оставляет старую ссылку правильной на вид и ведущей не туда.
+  Пересчитать номера подряд особенно дёшево на вид: тесты зелёные и до, и после.
+- **Сценарий и заголовок его теста правятся одним изменением.** Изменилось обещание — номер тот
+  же, а заголовок теста правится тем же коммитом; удалён сценарий — удаляется и тест.
+  Разъехавшись, они оставляют прогон зелёным, хотя проверяет он уже не то.
+- **Поддомен спрашивается наравне с доменом.** Те же обязательные разделы, тот же компаньон
+  рядом, та же связь сценариев с тестами. Домен, у которого половина поддоменов описана, а
+  половина заведена пустыми каталогами, зелёным не бывает.
 - **У закона обязателен раздел «Статьи», а кроме них он держит только открытые вопросы.**
   Истории правок и доводов о выбранном когда-то варианте в законе нет: историю держит система
   контроля версий, а довод с отвергнутой альтернативой — свойство работы, и место ему в
   «Ловушках» правила. Закрытый вопрос из закона уходит, а пустой раздел ради заголовка
   проверку всё равно проходил.
+- **Предложенный закон правила не требует.** Договорённость, записанную раньше кода,
+  привязывать не к чему, а требование правила заставило бы завести его с якорями в
+  несуществующие места. Признак стоит строкой статуса в самом законе, а не в списке исключений
+  рядом с проверкой.
 - **Закон, назвавший файл проекта, — отказ.** Путям и привязкам место в правиле: иначе закон
   нельзя ни прочитать без знания дерева, ни применить на другом приложении.
 - **Правило объявляет закон, под который написано.** Правило без закона — набор приёмов, из