@rt-tools/agent-kit 0.17.0 → 0.18.0

package/assets/rules/spec-driven.md

@@ -51,7 +51,7 @@ description: Правило под «Закон о документации пр
 | утверждение документа           | пункт `## Правила` в спеке, `## Статьи` в законе, `## Как закон применяется здесь` в правиле         |
 | место, где оно исполняется      | строка в `implementation.md` рядом: `` `файл:символ` ``                                              |
 | обещанное поведение             | сценарий `SC-<ПРЕФИКС>-<НОМЕР>` в `docs/specs/<домен>/scenarios.md`                                  |
-| открытый вопрос                 | `Q-N` — на него ссылаются из задачи на борде и из коммитов; номер после закрытия не переиспользуется |
+| открытый вопрос                 | `Q-<буква закона>-<номер>` в разделе «Открытые вопросы» закона; на него ссылаются из задачи и коммитов, номер после закрытия не переиспользуется |
 | законы, которые применяет домен | строка `**Законы:**` в шапке спека, именами в кавычках                                               |
 
 ## Где это лежит
@@ -94,14 +94,12 @@ flowchart TD
   связи — сам текст утверждения, поэтому переформулировать его, забыв про привязку, нельзя.
 - **Первая колонка компаньона — текст статьи, скопированный, а не пересказанный.** Ключ связи —
   сам текст, поэтому строка, написанная по смыслу статьи, разрывает связь, оставаясь на вид
-  заполненной. Проверка это подтверждает: она считает статьи без адреса и о статье, адрес которой
-  описывает не её, не знает ничего. Статье о действиях, требующих отдельного слова владельца,
-  поставили привязкой гард, держащий действие не из её перечня: совпал род, а не перечень, и
-  строка продержалась до перечитывания диффа.
-- **Привязка не ведёт в код, который никто не зовёт.** Символ, объявленный в своём файле и
-  больше нигде не встречающийся, местом исполнения не считается.
-- **Таблица процедур сверяется с декораторами в обе стороны.** Иначе процедура, которую домен
-  обслуживает, но забыл описать, видна только в декораторе.
+  заполненной. Проверка считает статьи без адреса и о статье, адрес которой описывает не её, не
+  знает ничего: совпадает род, а не перечень, и строка стоит до перечитывания диффа.
+- **Привязка не ведёт в код, который никто не зовёт:** нигде не зовущийся символ — не место.
+- **Таблица процедур сверяется с декораторами в обе стороны, право — вместе с именем.** Иначе
+  процедура, которую домен обслуживает, но забыл описать, видна только в
+  декораторе, а право, разошедшееся со спеком, — нигде.
 - **Код отказа принимается, только если он в домене бросается.** Коды выписывались по
   замыслу, и на одном пути обещанный отказ не бросал никто.
 - **Префикс сценариев в спеке один, и по всему дереву он занят им одним.** Второй префикс
@@ -181,14 +179,12 @@ flowchart TD
 
     Образцы разделены пробелом и сверяются с путём правки как образцы оболочки, а не поиском по
     словам: поиск называет не ту статью и молчит об этом. Образец без каталога сверяется и с
-    именем файла. Комментарий не виден в собранной разметке, поэтому статья читается человеком
-    как прежде.
+    именем файла, а комментарий в собранной разметке не виден.
 
 - **Статья без признака законна, и правило без единого признака — тоже.** Признак ставится тем
   статьям, чьё правило отбивает на правке файла; остальные размечаются по мере того, как их
   отбития попадут в сводку. Отсутствие признака означает «эту статью по пути правки не
-  выбирают», а не промах: требовать его у всех значило бы размечать наугад те правила, которые
-  ни разу никого не отбили.
+  выбирают», а не промах: требовать его у всех значило бы размечать наугад.
 
 - **Паттерн находится по полю `rule:`, а не по приставке имени.** Приставку имени несут не все
   паттерны, и поиск по имени правила таких не видит: сверка ищет их полем, человек — разделом
@@ -208,12 +204,10 @@ flowchart TD
   сторон: якорем утверждения оказывается слово из комментария, тогда как объявление рядом
   называется иначе.
 
-- **Проверка, прибитая к имени ресурса, ломается на его делении, и знать об этом надо до
-  правки.** Имя правила и имя паттерна стоят не только в текстах, но и в проверках дерева, в
-  пробах их наборов и в таблицах, которые связывают состояние с ведущим его паттерном. Деление
-  ресурса поэтому начинается с поиска его имени по всему дереву, а не по слою правил: найденное
-  правится тем же изменением. Иначе красное приходит по одной проверке за прогон, и каждая
-  выглядит отдельной поломкой — так деление одного правила уронило три подряд.
+- **Проверка, прибитая к имени ресурса, ломается на его делении, и знать об этом надо до правки.**
+  Имя правила и имя паттерна стоят не только в текстах, но и в проверках дерева, в пробах их наборов
+  и в таблицах состояний. Деление поэтому начинается с поиска имени по всему дереву: иначе красное
+  приходит по одной проверке за прогон — так деление одного правила уронило три.
 
 ## Форма сжатой статьи
 
@@ -255,14 +249,17 @@ flowchart TD
 
 Закон, которого не применяет ни один спек, отказом не считается: законы про устройство кода,
 поставку и проверяемость доменов не касаются вовсе. Порядок «сначала описание, потом код»
-держится договорённостью — это `Q-PD-3` в законе.
+держится договорённостью: закон о документации проекта такого требования не несёт, и открытого
+вопроса под него в нём не заведено.
 
 Таблицы состояний экрана не сверяются ничем. `check:specs` знает сценарии против заголовков
-тестов, правила против якорей, процедуры против декораторов и коды отказа против бросков —
-строка таблицы состояний не привязана ни к чему и проходит зелёной, даже когда код в
-названное состояние не попадает. Состояние «проверка не загрузилась» стояло в таблицах двух
-доменов раньше, чем код научился в него приходить, и всё это время читалось описанием
-работающего.
+тестов, правила против якорей, процедуры против декораторов и коды отказа против бросков — строка
+таблицы состояний не привязана ни к чему и проходит зелёной, даже когда код в названное состояние
+не попадает. Состояние «проверка не загрузилась» стояло в таблицах двух доменов раньше, чем код
+научился в него приходить, и всё это время читалось описанием работающего.
+
+Смысл сценария с соседним не сверяется ничем: проверка судит номер. Два сценария, обещающих одно
+и то же разными словами, для неё разные, и второй числится непроверяемым, сколько проживёт.
 
 Полноту разметки статей признаком применимости не считает ничто. Правило, у которого признака
 нет ни у одной статьи, отбивает прежним текстом — и от размеченного отличается только тем, что
@@ -292,3 +289,10 @@ flowchart TD
 - `spec-driven-domain` — заведение и правка спека домена, сценарии, привязка.
 - `spec-driven-rule` — заведение закона, правила и паттерна.
 - `spec-driven-sweep` — сплошной разбор привязки домена, проходы и их разбор.
+
+## Ловушки
+
+- **Строка требования к соседнему ресурсу не проверяется ничем, и промах в ней виден только
+  счётом.** Правило без неё выглядит целым: разделы на месте, привязки сходятся, набор полноты
+  зелёный. Считается она одной командой по каталогу правил, и расхождение читается сразу — сколько
+  правил объявило требования и сколько ссылается на соседний ресурс прозой.

package/assets/rules/task-flow.md

@@ -15,7 +15,7 @@ description: Правило под «Закон о ведении работы»
 Грузится по требованию, а не вместе с правилом: при обычном решении она не нужна — она нужна
 тому, кто разбирает промах или спорит с гардом.
 
-**Требует:** `hooks/task-flow-guard.sh`, `hooks/task-flow-draft-guard.sh`, `hooks/task-context-load.sh`, `hooks/grill-gate.sh`, `hooks/window-fill-guard.sh`, `hooks/turn-exit-guard.sh`
+**Требует:** `hooks/task-flow-guard.sh`, `hooks/task-flow-draft-guard.sh`, `hooks/task-context-load.sh`, `hooks/grill-gate.sh`, `hooks/window-fill-guard.sh`, `hooks/turn-exit-guard.sh`, `hooks/work-start-guard.sh`
 
 ## Как это называется здесь
 
@@ -120,11 +120,10 @@ flowchart TD
   `этап-идёт`, `этапы-кончились`, `разбор-кончился`. Четвёртый путь не состояние, а история
   ветки: папка, разобранная её коммитом, означает отданную работу, и правка по замечаниям идёт
   без замысла на диске.
-- **Строка состояния, переведённая вперёд, — то же объявление намерения, только
-  машиночитаемое.** Она точнее всякого обещания, и пустоты за ней не видно никому. Состояние
-  объявляется тем ходом, в котором его обязательное действие начато делом, а не тем, в котором о
-  нём отчитались.
-- **Отказ по состоянию называет обязательное действие того состояния, которое объявлено.**
+- **Строка состояния, переведённая вперёд, — то же объявление намерения, только машиночитаемое.**
+  Пустоты за ней не видно никому: состояние объявляется тем ходом, в котором его обязательное
+  действие начато делом, а не тем, в котором о нём отчитались.
+- **Отказ по состоянию называет обязательное действие объявленного состояния.**
   Исполнитель, которому сказано только «не в том состоянии», перепишет строку состояния вместо
   того, чтобы сделать шаг.
 - **Именем состояния считается только слово из перечня.** Своё слово не говорит ни о входе, ни о
@@ -139,25 +138,33 @@ flowchart TD
 - **Договорённость требуется по путям правки, а не по оценке задачи.** `apps/**` и `libs/**` —
   признак; правила, тексты, обвязка и зависимости под него не подпадают. Обход — строка
   `**Поведение:** не меняется — <причина владельца>` в замысле; пустая причина не принимается.
-- **Что требует слова владельца, берётся списком, а не оценкой на месте.** Оценку «это
-  безопасно» назначает тот, кому она в эту минуту удобна, и меняется она вместе с настроением
-  разговора, а не со свойствами команды: за один заход одна и та же команда была сначала слишком
-  опасной, чтобы её позвать, а через два хода — достаточно безопасной, чтобы позвать без спроса.
-  Недовольство владельца простоем разрешением не бывает: оно говорит, что стоять не следовало, а
-  не что можно то, чего нельзя было ходом раньше.
+- **Что требует слова владельца, берётся списком, а не оценкой на месте.** Оценку «это безопасно»
+  назначает тот, кому она удобна, и меняется она с настроением разговора, а не со свойствами
+  команды. Недовольство владельца простоем разрешением не бывает.
+- **Заход работу не начинает сам.** Начало требует слова владельца в этом же заходе: передача,
+  состояние из хука запуска и назначенный эпик говорят, что делать, если работать, и молчат о
+  том, работать ли. Судится это формой реплики, а не смыслом: правка кода после пустой реплики,
+  одного слова или одного пути ход не заканчивает.
+- **Указание работать по ходу работы покрывает все его шаги, включая меняющие историю.** Отметка
+  этапа, пуш и заявка предписаны им самим: спрашивают о том, чего в нём нет.
+- **Вопрос, записанный прошлым заходом, вопросом владельца не становится.** Он адресован автору
+  передачи, и часть таких вопросов закрыта шагом работы.
+- **Слово владельца об устройстве — постановка, а не решение.** Названное им обычно уже живёт в
+  дереве под этим самым словом: у него есть имя на экране, раздел в спеке и поле в модели. Прежде
+  чем строить, слово сверяется с ними, а разошлось прочтение с деревом — спрашивается владелец, до
+  правки: истолкованное по ближайшему коду, оно выглядит исполненной просьбой ровно до приёмки.
 - **Папка задачи заводится под любую работу, без исключений.** Исключение, у которого есть хоть
   одна законная форма, исполняется как разрешение. Заводится она до первой правки: сколько
   заходов уйдёт на работу, заранее не знает никто.
 - **Папка задачи едет в ветку коммитом, а не живёт в одном рабочем дереве.** Незакоммиченная,
   она проходит все правки без отказа, а признак отданной работы берётся из истории: отказ придёт
-  в последней точке, когда замысел уже снят своими руками. Вне истории законен один черновик без
-  номера.
+  в последней точке, когда замысел уже снят. Вне истории законен один черновик без номера.
 - **Папка задачи разбирается последним коммитом до открытия PR, а не после одобрения.** Человек
   вливает, как только видит зелёное, и закрывающему коммиту места не остаётся вовсе. Цена:
   замысла с этой минуты на диске нет, и признак отданной работы гард берёт из истории ветки.
 - **Открыв PR, исполнитель называет владельцу три вещи: номер, чего ждёт и что сделает следом.**
-  Ждёт он прогона, следом идёт снятие черновика. Зелёный прогон однозначным не бывает: он
-  говорит, что не сломано, и молчит о заблокированной у черновика кнопке слияния.
+  Ждёт он прогона, следом идёт снятие черновика. Зелёный прогон говорит, что не сломано, и молчит
+  о заблокированной у черновика кнопке слияния.
 - **Просьба о слиянии — отдельный ход, и раньше зелёного прогона её не бывает.** Порядок один:
   папка разобрана и запушена → PR открыт черновиком → прогон зелёный → черновик снят →
   исполнитель просит влить, называя номер.
@@ -165,14 +172,18 @@ flowchart TD
   вовсе, а открытый PR читается как приглашение влить — поэтому незаконченная работа идёт
   черновиком. Черновик снимается тем ходом, которым исполнитель говорит, что решение готово.
 - **Гард замысла — нижняя граница требования, а не его предел.** Он требует папку только под
-  правку кода приложения, а статья выше — под любую работу. Прочитанный как признак, гард
-  становится разрешением работать без замысла везде, куда он не смотрит.
+  правку кода приложения, а статья выше — под любую работу. Прочитанный как признак, он
+  становится разрешением работать без замысла везде, куда не смотрит.
+- **Указание работать по правилу — это указание делать его шаги, включая те, что меняют
+  историю.** Отметка сделанного этапа, коммит, пуш и открытие заявки правилом предписаны, и
+  отдельного слова владельца на каждый из них не требуется: спросить надо о том, чего в правиле
+  нет. Ход, который довёл работу до готовности и встал перед коммитом, работу не отдал, а спрятал.
 - **Взятая задача ходом не кончается.** Заведение задачи, ветки, колонки и папки — подготовка, а
   не работа: они переводят её в состояние записанного замысла, где обязательное действие уже
   другое. Держит это страж выхода хода, называя в отказе первый этап замысла.
 - **Ожидание одной части этапа остановкой этапа не бывает.** Части, которые от ожидаемого не
-  зависят, делаются тем же ходом. Владельцу называется, что уже сделано и что осталось на его
-  шаг, — этим ожидание и отличается от остановки.
+  зависят, делаются тем же ходом, а владельцу называется, что сделано и что осталось на его шаг.
+  Отбитая гардом команда и отклонённый вызов читаются так же: сперва делается всё, что мимо них.
 - **Сделанное отмечается только в ходе работы.** «Где стоим» перезаписывается каждым заходом, а
   не дописывается: это первое, что читает следующий заход.
 - **Слово для нового понятия ищется в словаре дерева.** Общую часть везёт пакет, предметную
@@ -182,16 +193,15 @@ flowchart TD
   сколько задач из него выйдет, поэтому номер не может быть первым. Команда заведения
   переименовывает черновик, проставляет шапку замысла и собирает папку с образца, снимая с копий
   шапку раскладки.
-- **Брошенный разбор виден.** Черновик старше недели перечисляет сверка очереди работ.
-- **Следующая задача берётся из замысла эпика, а список очереди работ спрашивается только там,
-  где эпика нет.** По списку, отсортированному номером, первая задача чужого эпика неотличима от
-  своей. Кончившийся эпик называется владельцу тем же ходом, которым берётся работа вне его.
+- **Брошенный разбор виден.** Черновик старше недели перечисляет сверка очереди.
+- **Следующая задача берётся из замысла эпика, а список очереди работ спрашивается только там, где
+  эпика нет.** По списку номеров первая задача чужого эпика неотличима от своей. Кончившийся эпик
+  называется владельцу тем же ходом, которым берётся работа вне его.
 - **Эпик не закрывается по признаку, подтверждённому только чтением.** Признак, проверяемый
-  глазами, называется проверенным лишь вместе с командой или замером и их выводом. Пометка
-  «подтверждается живым замером» — обещание проверки, а не проверка.
+  глазами, называется проверенным лишь вместе с командой или замером и их выводом.
 - **Задачи эпика заводятся все разом, тем же ходом, что и сам эпик.** Заведение по одной прячет
-  объём. Номера возвращаются в раздел порядка той же правкой — без них «взять следующую»
-  отвечает названием, а не карточкой. Метку эпика несёт только его карточка.
+  объём. Номера возвращаются в раздел порядка той же правкой: без них «взять следующую» отвечает
+  названием, а не карточкой.
 
 - **Замысел эпика лежит там, где его найдут без сети и после мержа.** Карточка порядка задач не
   держит, а папка задачи держала бы его до слияния первой из них; каталог называет компаньон
@@ -200,9 +210,9 @@ flowchart TD
 - **Сборка по образцу начинается с чтения самого образца, а не пересказа о нём.** Пересказ лежит
   в разборе просьбы и в замысле эпика; образцом они не считаются. Повторяемая часть открывается
   целиком — обходом каталогов, а не одним файлом, за которым пришли.
-- **Путь к образцу лежит вне дерева и приходит в заход хуком запуска сессии.** Имя чужого дерева
-  в файлы репозитория не пишется: там законна ссылка без имени. Каталог для записи — тот же, где
-  лежит передача захода. Не записанный так, образец теряется на первой же чистке контекста.
+- **Что действует на дерево, а не на правку, лежит вне индекса.** Путь к образцу и разрешение
+  работать вне эпика ветке не принадлежат: записанные файлом репозитория, они в ней и остаются,
+  а следующая, отведённая от главной, их не несёт. Место записи — рядом с передачей захода.
 - **Закрытая работа разбирается правилами, и это шаг закрытия, а не отдельная просьба.** Что
   грузилось, что помогло и чего не хватило, видно только тому заходу, который работу вёл. Разбор
   кончается правкой слоя правил или предложением наружу; ведёт его роль разбора закрытой задачи,
@@ -213,25 +223,21 @@ flowchart TD
 - **Находки разбора ждут владельца, а в пакет уезжает только сводка наблюдений.** Предложение —
   заготовка правки чужого дерева, и уехавшая без разбора, она становится работой того, кто её не
   заказывал. Сводка уезжает всегда: она говорит, чем пользовались, и мнением не бывает.
-- **Дешёвый шаг закрытия идёт раньше дорогого, а прогон — после вливания.** Вливание
-  договорённости и приведение текстов стоят минуты, прогон — окно захода. Прогон, идущий после
-  вливания, вдобавок проверяет и его самого: идущий до, он смотрит то состояние дерева, которое
-  в главную ветку не поедет.
+- **Дешёвый шаг закрытия идёт раньше дорогого, а прогон — после вливания.** Вливание договорённости
+  и приведение текстов стоят минуты, прогон — окно захода. Идущий после вливания, он проверяет и его
+  самого: идущий до, он смотрит то, что в главную не поедет.
 - **Договорённость вливается в спек домена одним из последних коммитов ветки, до открытия PR.**
   К этому моменту код написан, привязки известны, и в главной ветке директория `proposed/` не
   появляется вовсе. Готовые к вливанию перечисляет `npm run check:specs`.
-- **Папка закрытой задачи разбирается, а не переносится целиком.** В `docs/archive/` уезжает то,
-  что объясняет состоявшееся решение; остальное удаляется. Неразобранную ловит сверка очереди.
-- **Открытие PR и снятие черновика отбиваются, пока ветка везёт папку своей задачи.** Требование
-  стоит здесь, а не на слиянии: слияние нажимает человек на хостинге, где гардов нет, и его отказ
-  до владельца не доходит. Снятый черновик он читает как приглашение влить и нажимает кнопку, не
-  дожидаясь коммита уборки, — три работы подряд уехали в главную именно так. Судится содержимое
-  ветки, а не рабочее дерево.
-- **Ветка, снёсшая папку, обязана прибавить запись в архив.** Снести дешевле, чем разобрать, и
+- **Папка закрытой задачи разбирается, а не переносится целиком.** В `docs/archive/` уезжает то, что
+  объясняет решение; остальное удаляется. Неразобранную ловит сверка очереди.
+- **Открытие PR и снятие черновика отбиваются, пока ветка везёт папку своей задачи.** Слияние
+  нажимает человек на хостинге, где гардов нет: снятый черновик он читает как приглашение влить и
+  кнопку нажимает, не дожидаясь коммита уборки. Судится содержимое ветки, а не рабочее дерево.
+- **Ветка, снёсшая папку, обязана прибавить запись в архив.** Снести дешевле, чем разобрать, а
   первым уходит разбор просьбы — единственная запись слов владельца.
-- **Обход — строка `Task-folder-skip: <причина>` в PR или в самой команде.** Пустая причина
-  обходом не считается, а сам обход снимает отказ, но не гасит строку сверки очереди — иначе он
-  через месяц становится рабочим путём.
+- **Обход — строка `Task-folder-skip: <причина>` в PR или в самой команде.** Пустая причина обходом
+  не считается, а сам обход снимает отказ, но не гасит строку сверки очереди.
 
 ## Чего из закона здесь нет
 

package/assets/rules/testing.md

@@ -90,6 +90,11 @@ flowchart TD
   того, кто её не трогал. Ни линтер, ни сборка, ни сверка спеков времени не знают.
 - **Процедура Connect проверяется вызовом своего метода с рукописным двойником базы.** Контейнер и
   роутер поднимать не надо: спека проверяет решение, а не раскладку полей.
+- **Процедуру зовёт и сквозной набор, а не только тест рядом с ней.** У сквозного набора есть
+  свой помощник прямого вызова, и спека берёт ответ сервера оттуда, а не поднимает экран ради
+  одного поля. Поэтому «тестов на процедуру нет» утверждается после поиска её имени по всему
+  дереву, каталоги сквозных наборов включая, а не после того, как рядом с её файлом не нашлось
+  файла проверки: шесть отметок покрытия подряд объявили непокрытым закрытое.
 - **Сид заводит то, без чего экран не открыть, и ничего, что гость примет за настоящее.**
   Содержимое, у которого есть автор, — отзывы, вопросы, обсуждения — гость читает как написанное
   людьми, а стенд собирается из той же базы, что и проверка глазами. Настройки владельца —
@@ -160,6 +165,17 @@ flowchart TD
   в заголовке стоит — сценарий числится покрытым, а что именно утверждается, не спрашивает никто.
   Тело читается вместе с заголовком: обещание в заголовке и утверждение в теле — два разных
   текста, и расходятся они молча.
+- **Успешный ответ команды перечитывается отдельным запросом.** Код возврата говорит, что вызов
+  прошёл, и молчит о том, наступило ли нужное состояние: заведение задачи, отметка записи и
+  постановка ревьювера отвечают нулём и тогда, когда сделали не то. В отчёт идёт прочитанное, а
+  не заказанное.
+- **Служба считается поднятой по выполненному заданию, а не по открытому порту.** Ответ на порту
+  говорит, что кто-то там слушает, и неотличим от прошлой сборки, оставшейся с прежнего захода:
+  проверяются обе стороны связи — что заказчик выбирает именно её и что задание через неё прошло.
+- **Эталоны снимочного набора лежат рядом со спекой, а обновляются отдельным вызовом и читаются
+  глазами.** Обновление «на всякий случай» вместе с прогоном стирает разницу между починенным
+  видом и сломанным: обновлённый эталон делает зелёным любой кадр. Где эталоны и чем они
+  обновляются, называет компаньон правила.
 - **Растр браузера называется явно, иначе кадр не сходится сам с собой.** Профиль цвета, взятый у
   дисплея машины, ускоритель, считающий растр, и дорисовка кусками — каждый из трёх двигает цвет
   на единицу-другую по каналу, и видно это только там, где смешение стоит на границе округления:
@@ -176,9 +192,19 @@ flowchart TD
 Полнота теста не проверяется: сверка судит путь — сквозной он или юнит, — но не то, сколько
 из обещанного тест на этом пути закрыл. Признак пути читается из слов «Тогда» и нарочно
 молчалив: сценарий, чьё обещание человека не называет, под него не подпадает вовсе, и
-отметку неполноты там по-прежнему ставит рука. Договорённостей о подмене модулей тоже нет:
+отметку неполноты там по-прежнему ставит рука.
+
+Отметка покрытия стареет молча. Сверка знает идентификатор сценария против заголовка теста, а
+текст отметки под ним для неё проза: он читается как действующее описание и через полгода после
+того, как долг закрыли. Перечитывается отметка вместе с той правкой, которая трогает её
+предмет, — иначе не перечитывает её никто. Договорённостей о подмене модулей тоже нет:
 `vi.mock` в дереве не встречается ни разу, и двойник пишется руками.
 
+Наблюдения за тем, как пользуются правилами, это правило не ведёт вовсе: род события, место
+записи и то, что уходит наружу, — предмет закона о наблюдаемости и правила под ним. Здесь оно
+названо затем, чтобы наблюдение не путали с покрытием: покрытие говорит, что проверено, а
+наблюдение — чем пользовались.
+
 ## Паттерны
 
 - `testing-unit` — тест на чистую функцию, на процедуру Connect и разовый тест-доказательство,

package/assets/rules/turn-conduct.md

@@ -105,24 +105,25 @@ flowchart TD
   начатой работой лучше всякого другого обещания — она точна, её видно, и по ней не отличить
   сделанного от собранного. Ответ владельцу пишется после вызова, а не вместо него: реплика
   посреди хода отвечается вместе с начатым действием.
+- **Слово о своей же работе судится сделанным в том же ходе.** «Не стою — продолжаю» к концу
+  хода подтверждается работой, а не намерением: иначе владелец читает пару «обещал — не сделал»
+  как ложь. Это требование к слову о дереве, обращённое на себя.
 - **Вариант, поданный владельцу, назван ценой для человека.** Сколько шагов, где человек окажется
-  и что ему для этого нужно — без этого варианты выглядят равными, и выбор идёт по доводам со
-  стороны кода: «меньше путей», «строку запуска не трогаем». Знание, которое делает вариант
-  негодным, пишется в сам вариант, а не остаётся у того, кто его составил.
+  и что ему нужно — без этого варианты выглядят равными, и выбор идёт по доводам со стороны кода.
+  Знание, которое делает вариант негодным, пишется в сам вариант.
 - **Названное владельцем состояние дерева снимается вызовом раньше объяснения.** «Конфликты»,
   «прогон красный», «ветка отстала» — указание на то, что надо снять, а не тема для разбора.
   Причина называется после починки и только если её спрашивали: объяснение выглядит работой, не
-  трогая при этом ни одной ветки. Вопрос «почему», стоящий в том же сообщении, требования снять
-  состояние не отменяет — он идёт вторым.
+  трогая ни одной ветки. Вопрос «почему» в том же сообщении идёт вторым.
 - **Пересказ действующего порядка без оценки читается как одобрение.** На прямой вопрос владельца
   «как это работает» ответ фактами верен и недостаточен: устройство, названное спокойно, звучит
   принятым. Годность порядка для того, кто им пользуется, называется вместе с ним.
-- **Путь к файлу заданием не бывает.** Строка с адресом называет файл, а не действие;
-  прочитанная как поручение, она даёт заходу задание, которого владелец не давал. То же и с
-  любой репликой, где нет глагола: уточнить дешевле, чем написать полсотни файлов мимо просьбы.
+- **Путь к файлу заданием не бывает.** Строка с адресом называет файл, а не действие: прочитанная
+  как поручение, она даёт заходу задание, которого владелец не давал. То же с любой репликой без
+  глагола — уточнить дешевле, чем написать полсотни файлов мимо просьбы.
 - **Прерывание работы владельцем называется вслух.** Пришло задание, останавливающее начатое, —
-  исполнитель говорит, что стоит, на чём остановлено и что будет с прежней работой, и только потом
-  берётся за новое. Молчание об этом владелец читает как «прежнее кончилось».
+  исполнитель говорит, что стоит, на чём остановлено и что будет с прежним, и только потом берётся
+  за новое. Молчание об этом владелец читает как «прежнее кончилось».
 - **Остановка называется отдельной репликой.** Не строкой в конце отчёта: там она тонет — владелец
   читает отчёт как рассказ о сделанном. Называются три вещи: что стоит, чего оно ждёт и что
   владелец может решить.
@@ -130,12 +131,10 @@ flowchart TD
   и то, что за ход по ней сделано: правку файла или команду, меняющую дерево. Ход, в котором не
   было ни того ни другого, возвращается исполнителю вместе со следующим шагом из хода работы.
   Отданную и влитую работу страж не судит: она уже дождалась чужого шага.
-- **Снятая папка задачи снимает требование состояния, а ход не кончает.** Ход работы уезжает
-  вместе с папкой, а папка разбирается до открытия заявки: с этой минуты и до слияния строки
-  состояния нет вовсе, и первый признак стражу взять неоткуда. Отпускать по этому признаку ход
-  нельзя — снятая папка означает середину отдачи, а не её конец: между уборкой и заявкой работу не
-  видит никто, кроме того, кто её сделал. Дальше ход судится вторым признаком, как всякий другой;
-  ход, в котором заявку открыли или прочитали, второй признак пропускает сам.
+- **Снятая папка задачи снимает требование состояния, а ход не кончает.** Ход работы уезжает вместе
+  с папкой, а папка разбирается до открытия заявки: с этой минуты и до слияния строки состояния нет
+  вовсе. Отпускать по этому признаку ход нельзя — снятая папка означает середину отдачи, а не её
+  конец. Дальше ход судится вторым признаком; ход, в котором заявку открыли, его пропускает сам.
 - **Работа без ветки и без папки задачи судится тем же стражем по второму признаку.** Состояния у
   неё нет, и первый признак взять неоткуда, — но ход, в котором не было ни одной правки дерева, не
   кончается и здесь.
@@ -192,24 +191,25 @@ flowchart TD
   заведения задачи, ни ветки, ни папки, ни перевода колонки. Чужой шаг он узнаёт по двум
   признакам: в ходе открыт PR либо в ходе прочитан красный прогон. Слова «беру следующую задачу»
   гард действием не считает — ровно потому, что их и произносят вместо неё.
-- **Ход, отдавший работу, доводит её до снятого черновика.** Черновик читается владельцем как
-  «работа не кончена»: кнопка слияния у него заблокирована самим хостингом, а по списку заявок
-  готовое от недоделанного не отличить — серое и там и там. Следующая задача берётся сверх этого,
-  а не вместо: требование взять её исполняется буквально и оставляет отданное невидимым. Стережёт
-  это гард ожидания: ход, открывший заявку, не кончается, пока состояние отданной работы не
-  спрошено командой того же хода.
+- **Ход, отдавший работу, доводит её до снятого черновика.** У черновика кнопка слияния
+  заблокирована хостингом, и по списку заявок готовое от недоделанного не отличить. Следующая
+  задача берётся сверх этого, а не вместо. Стережёт это гард ожидания: ход, открывший заявку, не
+  кончается, пока состояние отданной работы не спрошено командой того же хода.
+- **Отказ гарда ожидания снимается обоими действиями сразу.** Взятая следующая задача уносит
+  признак открытой заявки с собой, и требование спросить состояние отданной работы после неё не
+  прозвучит уже никогда.
+- **Работа, оставшаяся в рабочем дереве, ход не кончает.** Ветка впереди удалённой ссылки без
+  открытой заявки — сделанное, которого не видит никто; страж читает это без сети.
 - **«Жду прогона» — утверждение о чужом шаге, а не состояние работы.** Прогон бывает зелёным час,
   а бывает не встав вовсе — и второе само не чинится. Слово это требует команды того же хода,
   которая прогон показывает, и без неё не говорится: сказанное без команды владелец читает как
   «работа ещё идёт» и ждёт напрасно. Держит это гард утверждения, а не память исполнителя.
-- **Конец прогона узнаётся возвратом фоновой команды, а не взглядом на страницу.** Ожидание,
-  запущенное в фоне отдельным ходом, возвращает исполнителя к PR само; до тех пор ход занят
-  следующей задачей. Взгляд на страницу этого не даёт: он либо повторяется вхолостую, либо не
-  повторяется вовсе, и оба исхода со стороны выглядят одинаково — работа не двигается.
+- **Конец прогона узнаётся возвратом фоновой команды, а не взглядом на страницу.** Ожидание в
+  фоне возвращает исполнителя к заявке само; взгляд на страницу либо повторяется вхолостую, либо
+  не повторяется вовсе, и оба исхода выглядят одинаково — работа не двигается.
 - **Ожидание своего же замера ведётся одним ожиданием, а не уведомлением на каждый шаг.**
-  Уведомление ставится там, где на каждое событие надо действовать; где значим только итог —
-  одно ожидание, кончающееся вместе с замером. Иначе замер назначает себе ход на каждый свой
-  шаг, а наполнить их нечем.
+  Уведомление ставится там, где надо действовать на каждое событие; где значим только итог —
+  одно ожидание, кончающееся вместе с замером.
 - **Отказ гарда кончает ход.** Другого пути к отбитой правке не ищут: ни командой оболочки, ни
   соседним инструментом, ни правкой самого гарда. Отбитая правка либо делается после того, как
   условие отказа выполнено, либо не делается вовсе — и тогда владельцу называется отказ, а не
@@ -242,30 +242,29 @@ flowchart TD
   заменяет: её назначает тот, кому она в эту минуту удобна, и она плывёт.
 - **У отказа от необратимого действия есть безопасная часть, и она делается.** Требование спросить
   владельца относится к действию, а не к ходу: работа, у которой отделима часть без последствий,
-  делится, а не откладывается целиком. Список вариантов, поданный вместо работы, читается как
-  работа — тем полнее, чем аккуратнее он составлен: он пронумерован, в нём названы цифры, и именно
-  поэтому пустота хода за ним не видна. Владельцу называется, что уже сделано и что осталось за
-  его словом, — а не выбор из вариантов вместо и того и другого.
+  делится, а не откладывается целиком. Список вариантов вместо работы читается как работа — тем
+  полнее, чем аккуратнее составлен: пронумерован, с цифрами, и пустота хода за ним не видна.
+  Владельцу называется, что уже сделано и что осталось за его словом.
 - **Признак необратимости берётся из списка, а не выводится доводом.** Список составлен тем, кто
-  обратимость уже взвесил. Довод «действие уходит наружу и не откатывается» приходит в контекст
-  всегда, а список — только когда его прочитали, и применённый поверх списка довод отменяет
-  список молча: со стороны это выглядит осторожностью, а не пропуском шага. Действия, которого в
-  списке нет, исполнитель на слово владельца не гейтит, даже если оно уходит наружу; шаг, снятый
-  разбором прошлого промаха, — тем более.
+  обратимость уже взвесил. Довод «уходит наружу и не откатывается» приходит всегда, а список —
+  только когда его прочитали, и довод поверх списка отменяет его молча: со стороны это выглядит
+  осторожностью, а не пропуском шага. Действия вне списка исполнитель не гейтит.
 - **Ход, в котором исполнитель признал промах, не заканчивается, пока записи о происшествии нет.**
-  Отбивает гард происшествия — на завершении хода: к моменту признания промах уже случился, и
-  ловить раньше нечего. Признание ловится набором образцов, а не пониманием смысла; промах,
-  признанный словами вне набора, гард пропускает, и это его известная граница, а не обещание.
+  Отбивает гард происшествия — на завершении хода: к моменту признания промах уже случился.
+  Каталог записей называет компаньон правила, имя файла — дата и чем был промах, форму держит
+  образец раскладки. Признание ловится набором образцов: промах, признанный словами вне набора,
+  гард пропускает.
 - **Заход, начатый с передачи, входит в работу тем же правилом, что и всякий другой.** Передача
   лежит вне дерева, её не читает ни одна проверка, и написана она вчера: всё, что в ней стоит,
   проверяется деревом. Порядок входа — четыре шага в паттерне возвращения; стережёт его гард, а не
-  память: порядок, записанный только словами, исполняется, пока о нём помнят.
+  память.
 - **Состояние незаконченной работы приходит в контекст на запуске сессии.** Замысел и ход работы
   отдаются целиком, разбор просьбы — путём. Ветка вида `<КЛЮЧ>-*` без папки даёт предупреждение с
   готовой командой, но сессию не рвёт.
 - **Заполненное окно кончает ход только там, где сжатия нет.** Где оно объявлено, окно —
   продолжение хода: заход сжимается и работает дальше, а порог остановки срабатывает лишь тогда,
-  когда сжатие не пришло.
+  когда сжатие не пришло. Ход, закрытый ниже порога, теряет остаток окна, за
+  который дерево заплатило настройкой, и ловит это один владелец.
 - **Заполнение окна захода стережёт гард, а не память исполнителя.** На первом пороге он
   напоминает выбирать точку остановки, на втором отбивает всё, кроме записи хода работы, передачи
   и команд поставки. Размер окна и оба порога дерево задаёт само; не задавшее размера стража не
@@ -279,6 +278,10 @@ flowchart TD
   сделанное, следующий шаг и особенности захода. В историю она не едет — иначе рядом с ходом
   работы заводится вторая запись об одном и том же.
 
+- **Вариант, глушащий проверку, в меню не ставится вовсе.** Выключенное правило линтера, строка
+  в списке известного, выведенный из-под проверки файл — все они чинят показание, а не то, на что
+  она указала, и вариант этот в меню самый дешёвый. Меню собирается после того, как он вычеркнут.
+
 ## Чего из закона здесь нет
 
 Полноту сказанного владельцу не проверяет ничто: гард утверждения ловит слово-утверждение и

package/assets/skills/agent-kit.md

@@ -273,3 +273,12 @@ npx agent-kit propose       # отправить груз в приём: сво
   совпадение текста. Признак один, и он читается, а не ищется: до того как в своей проверке
   заводится разбор списка, чтение настройки или сравнение с накопленным, смотрят, что
   экспортирует модуль настройки проверок и чем живут соседние проверки.
+- **Правило, загруженное инструментом, бывает показано не целиком, и обрыв ничем не помечен.**
+  Длинный файл приезжает в контекст обрезанным по строке, а снаружи это выглядит концом: показанное
+  кончается осмысленным пунктом, и число разделов с оглавлением никто не сверяет. Бьёт обрыв ровно
+  по хвосту, а хвост — то место, где дерево отменяет умолчания пакета: разделы надстройки сливаются
+  по совпавшему заголовку и новыми уходят в конец. Заход, читавший правило до конца по своему
+  ощущению, исполнил пакетный образец буквально и открыл заявку черновиком там, где дерево
+  черновиков не держит вовсе. Отсюда порядок: решение о порядке работы принимается только после
+  того, как показанные строки сверены с длиной файла — одной командой, — а расходятся они, файл
+  дочитывается чтением.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rt-tools/agent-kit",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "description": "Переносимый слой правил для агента: законы, хуки, проверки и агенты, раскладываемые в репозиторий одной командой",
   "author": "RT Team",
   "license": "Apache-2.0",