@rt-tools/agent-kit 0.4.0 → 0.5.0

package/assets/laws/work-conduct.md

@@ -15,6 +15,10 @@
   всего.
 - **Владельцу не задаётся вопрос, ответ на который уже записан.** Записанное читают до
   разговора, а не вместо ответа: вопрос о том, что уже решено, обесценивает и остальные.
+- **Решение, однажды записанное, действует, пока его не отменили, и читается до того, как
+  принимается заново.** Отменённое решение следа в работе не оставляет — по результату не
+  видно ни того, что его принимали, ни того, что от него отказались. Принятое заново оно
+  расходится с прежним молча и стоит той же работы второй раз.
 - **Понимание записано там, где идёт работа.** Оставленное в переписке живёт у одного
   участника и до следующего дня; работу продолжает тот, у кого этой переписки нет.
 - **Сказанное владельцем записывается его словами и задним числом не переписывается.**
@@ -22,6 +26,10 @@
 - **Договорённость о том, как продукт себя ведёт, записана раньше кода, который её
   исполняет.** Записанная после, она пишется по коду и повторяет его ошибки: разойтись ей
   уже не с чем, а значит она ничего не проверяет.
+- **Описание приведено к сделанному прежде, чем работа закрыта.** Договорённость пишется до
+  кода и описывает замысел, а к концу работы приложение отличается и от замысла тоже.
+  Расхождение, отложенное на потом, не находится: назавтра оно уже незаметно, а описание
+  продолжают читать как верное.
 - **Состояние незаконченной работы восстанавливается без участия владельца.** Иначе каждый
   перерыв стоит ему пересказа, а очередь работ показывает начатое и не говорит, что внутри
   него сделано.
@@ -39,6 +47,9 @@
   нетронутое, и второй заход начинает его заново.
 - **Записи о законченной работе не лежат среди записей о текущей.** Закрытое, лежащее рядом
   с действующим, читается как действующее — тем убедительнее, чем оно старше.
+- **Законченная работа убирает за собой до того, как войдёт в общее дерево.** Потом за
+  оставленным уже никто не следит: работа перешла к следующей задаче, а правки, которой это
+  убрали бы заодно, больше нет.
 - **Достаточность понимания судит тот, кто просил.** Машине видно наличие записи, но не то,
   что в ней закрыты все пробелы: запись из одной строки проходит так же, как разбор на сто.
   Признак достаточности, выведенный из объёма или числа вопросов, сам становится целью —

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

@@ -305,6 +305,10 @@ in-review`, — и `npm run check:board` прогоняется ещё раз:
   `git commit --amend` при этом уносит в коммит всё, что осталось в индексе, — так в коммит
   уехало удаление файла, принадлежавшее соседней ветке. Состав коммита читается
   `git show --stat` сразу после него, а не на разборе PR.
+- Состав индекса читается `git diff --cached --stat` **до** коммита, а не только `git show --stat`
+  после него. Команды дерева кладут файлы в индекс сами: `npm run task:new` добавляет папку
+  задачи, и вместе с ней уезжает всё, что лежало рядом, — так в индексе оказался временный
+  каталог диагностики.
 - `gh project` с `--owner` отвечает `unknown owner type`: владелец борды — другая учётная
   запись, и правка идёт только через GraphQL.
 - Заведённый тикет на борду сама она не забирает: репозиторий с ней не связан, и добавление

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

@@ -23,11 +23,16 @@ docs/specs/<домен>/
     spec.md              — как домен работает
     implementation.md    — таблица «правило → файл:символ»
     scenarios.md         — сценарии SC-<ПРЕФИКС>-<НОМЕР>
+    <поддомен>/          — свой spec.md, implementation.md и scenarios.md
     proposed/<фича>/     — только то, чего ещё нет
 ```
 
 Шаблон — `docs/specs/_template/spec.md`, указатель с префиксами — `docs/specs/README.md`.
 
+Поддомен спрашивается наравне с доменом: те же обязательные разделы, тот же компаньон рядом,
+та же связь сценариев с тестами. Домен, у которого половина поддоменов описана, а половина
+заведена пустыми каталогами, зелёным не бывает.
+
 ## Обязательные разделы
 
 `## Зачем` · `## Терминология` с подразделом `### Как это называется в интерфейсе` ·
@@ -94,6 +99,14 @@ docs/specs/<домен>/
 
 ## Частые промахи
 
+- Выросший домен делят на новые домены, а не на поддомены: новый домен приходится заводить в
+  указателе, сверять с кодом отдельно и объяснять, чем он соседу не поддомен, — а поддомен
+  остаётся в своём домене и наследует его контракт. Соседний домен заводится только тогда,
+  когда предмет живёт своей сущностью. Границу проводит владелец: деление переписывает номера
+  во всех заголовках тестов домена, и вернуть его назад тем же движением нельзя.
+- Счётчик правил или сценариев в указателе доменов: он пересчитывается при каждой правке
+  любого спека, и через год большая часть таких чисел молча описывает позавчерашний спек.
+  Указатель держит домен, префикс и одну строку «о чём».
 - `tasks.md` в спеке: шаги — артефакт сессии, им место в ветке или в описании PR.
 - Скопированная из контракта таблица полей: источник — `libs/common/proto/proto/<область>/v1/`,
   и компилируется из двух только одна.
@@ -102,6 +115,9 @@ docs/specs/<домен>/
 - Место, где правило исполняется, внутри текста правила: оно меняется при первом рефакторинге,
   и для него заведён `implementation.md`.
 - Пометка «Не покрыто» при существующем тесте — отказ: долг закрыли, а отметку не сняли.
+- Пометка «Не покрыто» читается дословно и с начала строки. Любое слово между ней и двоеточием
+  — «Не покрыто, и прогоном не покрывается вовсе: …» — и сценарий считается непомеченным вовсе,
+  а причина, ради которой пометку и писали, до отчёта не доезжает.
 - Закон, названный в тексте, но забытый в строке `**Законы:**`: по закону тогда не узнать,
   какие домены на нём стоят.
 - Правка `.proto` без спеков задетых доменов: `docs-guard` отбивает такой коммит.

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

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

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

@@ -45,8 +45,9 @@ Agent(subagent_type: "Explore", prompt: "<тема просьбы>: что по
 | Чем будет видно, что задача закрыта          | «работает» признаком не является                         |
 | Есть ли образец, с которого снимается подход | разведка найдёт похожее, а не то                         |
 
-Спрашивается прозой. Меню вариантов годится, только когда постановка уже подтверждена и
-остался выбор значения из закрытого набора; выбор слова, имени и термина — никогда.
+Форму вопроса задают настройки владельца: где они требуют меню, спрашивается меню, и тогда к
+каждому вопросу добавляется свободный вариант — у закрытого набора нет строки «вопрос не тот».
+Выбор слова, имени и термина уточняется прозой в любом случае.
 
 Ответы пишутся в `docs/tasks/_draft-<slug>/grill.md` — папка ещё черновик, номера нет.
 
@@ -67,6 +68,12 @@ Workflow(name: "plan", args: "docs/tasks/_draft-<slug>")
 (`spec-critic`) → замысел и разбивка (`project-manager`). Пробелы, которые роли не смогли
 закрыть, возвращаются владельцу — их относит главный агент.
 
+Договорённость, вышедшая из конвейера, сверяется с `grill.md` построчно до того, как по ней
+пойдёт работа. Роль пишет текст, не видя владельца, и способна развернуть его ответ в
+противоположный: очередь этапов оказалась перевёрнута, а два пункта из входящих переехали в
+«не входит». Находка критика, расходящаяся с ответом владельца, относится владельцу — она не
+исполняется молча и не считается закрытой правкой текста.
+
 ### 4. Задача, ветка, папка
 
 ```bash
@@ -115,3 +122,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

@@ -84,6 +84,20 @@ description: Правило под «Закон о документации пр
 - **Снятое имя вычищается одним грепом по всему дереву:** правила, их зеркала в скилах,
   документы и комментарии. Описание того, чего в коде уже нет, читается как действующее
   указание.
+- **Поиск по дереву не покрывает того, что уже уехало наружу.** Заголовок задачи и её тело,
+  заголовок отчёта и его тело, заголовки коммитов лежат вне файлов, и проверки текстов их не
+  читают вовсе. Вычистив слово в дереве, обходят те же места в очереди работ и в истории:
+
+    ```bash
+    <клиент хостинга> api "<путь к отчёту>" --jq '.title, .body' | grep -i '<слово>'
+    <клиент хостинга> api "<путь к задаче>" --jq '.title, .body' | grep -i '<слово>'
+    git log --format='%s%n%b' <база>..HEAD | grep -i '<слово>'
+    ```
+
+    Заголовок отчёта правится вызовом хостинга, заголовок коммита — только переписыванием ветки,
+    поэтому его проверяют до пуша. Выдуманное слово было вычищено из трёх файлов и объявлено
+    снятым, а в заголовке отчёта и в заголовке коммита осталось — владелец прочитал именно его.
+
 - **Число в тексте пересчитывается командой в том же коммите, где пишется.** Оно стареет
   внутри одной ветки: «шестнадцать пар» стало неправдой через два коммита после того, как
   было написано, и нашёл это владелец, а не проверка. Число, которое придётся пересчитывать

package/assets/rules/spec-driven.md

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

package/assets/rules/task-flow.md

@@ -35,10 +35,19 @@ description: Правило под «Закон о ведении работы»
 
 - **Правка кода приложения отбивается, пока на диске нет замысла.** Гард требует папку задачи
   по имени ветки, `plan.md` в ней и названную в его шапке договорённость о продукте.
+- **Влитая договорённость ветку не запирает.** После вливания директории «предложено» на диске
+  нет, а замысел на неё ссылается до конца работы: гард отличает влитое от незаведённого по
+  истории ветки и пропускает первое. Иначе последний коммит отчёта закрывал бы дорогу правкам
+  по замечаниям разбора.
 - **Договорённость требуется по путям правки, а не по оценке задачи.** `apps/**` и `libs/**`
   — признак; правила, тексты, обвязка и зависимости под него не подпадают. Обход — строка
   `**Поведение:** не меняется — <причина владельца>` в замысле; пустая причина не
   принимается.
+- **Ход, в котором владельцу задан вопрос, не заканчивается, пока за этот же ход не читались
+  законы и правила.** Чтением считается любой из трёх путей: загрузка правила, чтение файла
+  законов или правил, поиск по ним. Отбивает гард разговора — на завершении хода, а не на
+  инструменте вопроса: спрашивают чаще прозой, чем меню. Найденное ложится в раздел «Что уже
+  сказано в правилах» разбора.
 - **Состояние незаконченной работы приходит в контекст на запуске сессии.** Замысел и ход
   работы отдаются целиком, разбор просьбы — путём. Ветка вида `<КЛЮЧ>-*` без папки даёт
   предупреждение с готовой командой, но сессию не рвёт.
@@ -55,6 +64,19 @@ description: Правило под «Закон о ведении работы»
 - **Папка закрытой задачи разбирается, а не переносится целиком.** В `docs/archive/` уезжает
   то, что объясняет состоявшееся решение; остальное удаляется. Неразобранную ловит сверка
   очереди работ.
+- **Слияние отбивается, пока ветка везёт папку своей задачи.** Требование стоит на слиянии, а
+  не на открытии отчёта: до слияния папка ещё нужна — правка по замечаниям разбора идёт в ту
+  же ветку, а без замысла на диске её отбивает гард хода работы. На открытии отчёта о лежащей
+  папке говорится вслух, и только. Судится содержимое ветки, а не рабочее дерево: снесённая,
+  но не закоммиченная папка въехала бы вместе с веткой.
+- **Ветка, снёсшая папку, обязана прибавить запись в архив.** Снести дешевле, чем разобрать, и
+  первым уходит разбор просьбы — единственная запись слов владельца. Что именно увезено,
+  требование не судит: это судит владелец.
+- **Обход — строка `Task-folder-skip: <причина>` в отчёте или в самой команде слияния.**
+  Работа, вливаемая частями, папку до конца не разбирает. Чтение из команды работает и без
+  сети: единственный сетевой путь отбивал бы оффлайн то самое слияние, причина которого
+  написана в отчёте. Пустая причина обходом не считается, а сам обход снимает отказ, но не
+  гасит строку сверки очереди — иначе он через месяц становится рабочим путём.
 
 ## Чего из закона здесь нет
 
@@ -78,8 +100,17 @@ description: Правило под «Закон о ведении работы»
 остальные тексты, и правка по ходу отличима от первоначальной записи только по истории.
 Держится это тем же, чем и порядок разбора.
 
-Разбор папки при закрытии не проверяется по существу: сверка очереди работ видит, что папка
-закрытой задачи лежит на месте, но не судит, что из неё стоило увезти в архив.
+Приведение текстов к сделанному не проверяет ничто, и проверки на него не будет: что устарело
+в правиле и в спеке, машине не видно — раздел «Чего из закона здесь нет» не читает ни одна
+сверка, а «Что не входит» выглядит верным ровно так же, как в день, когда его писали. Держится
+это шагом закрытия работы и следом задачи в замысле: там названо, что перечитать. Правило и
+спек правятся в ветке, закон — нет: его статья приносится владельцу текстом, а работа идёт
+дальше без неё.
+
+Что именно перенесли в архив, не проверяется. Гард видит, что папка уезжает в главную ветку и
+что ветка что-то в архив добавила, но не может судить, то ли это и стоило ли переносить именно
+это. Сверять содержимое машине нечем — смотрит владелец на ревью. Отсюда же и обход: если
+работа вливается частями, папку до конца не разбирают, а причина остаётся в отчёте.
 
 ## Паттерны
 
@@ -105,6 +136,15 @@ description: Правило под «Закон о ведении работы»
 - **Субагент вопросов владельцу не задаёт.** Ни роли, ни конвейер до него не достучатся —
   они возвращают текст главному агенту. Поэтому разбор ведёт главный агент, а роли стоят по
   обе стороны от него.
+- **Если дефект чинится правкой одного общего числа, спроси владельца, тем ли способом ты его
+  чинишь.** Замер показывает, что дефект ушёл, — но не то, что причину вылечили. В одной
+  задаче так ушли две правки подряд: сначала подняли общее число у соседнего узла, потом
+  перенесли узел в другое место разметки. Обе владелец отверг, а нужный способ назвал сам.
+  Спрашивают до правки, а не показывают замер после.
+- **Линия работ по теме читается до того, как решается раскладка.** Файл линии держит решения,
+  которые пережили десяток задач, и разведка по коду их не находит: снятое решение следа в
+  дереве не оставляет. Домен, заведённый генератором и снесённый через полчаса, стоял в линии
+  прямым запретом — но линию открыли уже после того, как он был заведён во второй раз.
 - **Слово для нового понятия берётся из `docs/GLOSSARY.md` или заводится там же.** Третий файл
   папки задачи называется `progress.md`, а не `journal.md`, ровно поэтому: журнал в этом
   дереве один, и он другой.

package/assets/skills/agent-kit.md

@@ -57,6 +57,10 @@ npx agent-kit sync --check  # ничего не писать, отказать
 
 ## Ловушки
 
+- **Линтер по следам правки судит файл целиком, а не внесённую правку.** Импорт, добавленный
+  отдельным шагом, отбивается как неиспользуемый ещё до того, как появится строка, которая его
+  зовёт, и работа встаёт на половине. Правка делается одним вызовом либо в порядке «сначала
+  использование, потом импорт».
 - **Прогонять сценарии гардов можно, ничего не раскладывая.** Обвязка набора принимает каталог
   гардов переменной, и пакетную редакцию гоняют по сценариям дерева до установки. Заход,
   потраченный на диагноз по последствиям, стоил ровно этой строки.

package/assets/templates/rule.md

@@ -15,7 +15,7 @@ description: Правило под закон «<Название закона>
 
 <Правка, по которой правило узнаётся. Гейт зовёт его по этому признаку, а не по названию.>
 
-## Что здесь действует
+## Как закон применяется здесь
 
 Каждый пункт начинается жирной статьёй, и у каждой статьи есть строка в `implementation.md`
 рядом. Утверждение, которому места в коде не нашлось, сюда не ставится: оно уходит прозой в

package/lib/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/commands.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAO7C,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,2FAA2F;AAC3F,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;CACvC;AAoDD,+DAA+D;AAC/D,eAAO,MAAM,WAAW,EAAE,MAAyB,CAAC;AAuFpD;;;;GAIG;AACH,wBAAgB,IAAI,CAChB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,SAAS,MAAM,EAAO,EAC5B,QAAQ,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,EAC/C,SAAS,GAAE,MAAW,GACvB,iBAAiB,CAgCnB;AAgBD,wBAAgB,IAAI,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,GAAG,iBAAiB,CA2EzE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,iBAAiB,CA+CpF;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,YAAY,GAAG,iBAAiB,CA2C3D;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,YAAY,GAAG,iBAAiB,CAkDzD"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/commands.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAO7C,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,2FAA2F;AAC3F,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;CACvC;AAoDD,+DAA+D;AAC/D,eAAO,MAAM,WAAW,EAAE,MAAyB,CAAC;AAyFpD;;;;GAIG;AACH,wBAAgB,IAAI,CAChB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,SAAS,MAAM,EAAO,EAC5B,QAAQ,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,EAC/C,SAAS,GAAE,MAAW,GACvB,iBAAiB,CAgCnB;AAgBD,wBAAgB,IAAI,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,GAAG,iBAAiB,CA2EzE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,iBAAiB,CA+CpF;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,YAAY,GAAG,iBAAiB,CA2C3D;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,YAAY,GAAG,iBAAiB,CAkDzD"}

package/lib/commands.js

@@ -97,7 +97,7 @@ const gapLines = (result) => result.gaps.flatMap((gap) => [
 const unboundLines = (result) => result.unbound.length
     ? [
         `гарды разложены, но в \`${SETTINGS_PATH}\` их не зовёт никто: ${result.unbound.length}`,
-        ...result.unbound.map((binding) => `  ${binding.path} — ${binding.event} ${binding.matcher}`),
+        ...result.unbound.map((binding) => `  ${binding.path} — ${binding.event}${binding.matcher ? ` ${binding.matcher}` : ''}`),
         `  вставь в \`${SETTINGS_PATH}\` раздел \`hooks\` — готовый кусок ниже:`,
         ...JSON.stringify({ hooks: hooksSection(result.unbound) }, null, 4)
             .split('\n')