@rt-tools/agent-kit 0.3.0 → 0.4.0

package/assets/rules/spec-driven.md

@@ -2,64 +2,103 @@
 name: spec-driven
 kind: rule
 law: project-documentation
-description: Правило под закон «Документация проекта». Брать при правке спека домена, закона и любого скила. Три слоя — закон, правило, паттерн, — обязательные разделы, привязка утверждений к коду, связь сценариев с тестами. Готовый порядок действий — в паттернах spec-driven-domain и spec-driven-rule. Чем это названо здесь — в implementation.md рядом.
+description: Правило под «Закон о документации проекта». Брать при правке docs/specs/**, docs/constitution/** и любого скила в .claude/skills. Называет три слоя — закон, правило, паттерн, — обязательные разделы, привязку к коду и связь сценариев с тестами. Готовый порядок действий — в паттернах spec-driven-domain и spec-driven-rule.
 ---
 
-# Документация проекта — каким приёмом
+# Документация проекта — как это устроено здесь
 
-Правило под закон `{{lawsDir}}/project-documentation.md`. Закон говорит, что должно быть верно
-про тексты; здесь — из каких слоёв они сложены и что сверяет машина. Где лежат спеки домена,
-чем они проверяются и какой у них шаблон — `implementation.md` рядом. Формулировки — правило
-`doc-style` под тем же законом.
+Правило под закон `docs/constitution/project-documentation.md`. Закон говорит, что должно
+быть верно про тексты; здесь — из каких слоёв они сложены в этом дереве и что сверяет машина.
+Формулировки — правило `doc-style` под тем же законом.
 
-## Когда берётся
-
-Правка закона, правила, паттерна или спека домена. Заведение нового слоя документации.
-
-## Как сложены слои
+## Как это называется здесь
 
 ```
-ЗАКОН      {{lawsDir}}/<закон>.md
-           верен для любого приложения этого класса; о проекте не знает ничего:
-           ни путей, ни имён файлов, ни привязок
+ЗАКОН      docs/constitution/<закон>.md              — верен для любого приложения этого класса
+           docs/constitution/application/<закон>.md  — закон приложения: деньги, локали, доступ
+           о проекте не знает ничего: ни путей, ни имён файлов, ни привязок
 
-  ├─ ПРАВИЛО    {{rulesDir}}/<правило>/SKILL.md      (kind: rule, law: <закон>)
-  │             каким приёмом закон исполняется; несколько правил на закон
-  │             {{rulesDir}}/<правило>/implementation.md — имена этого дерева и привязка к коду
+  ├─ ПРАВИЛО    .claude/skills/<правило>/SKILL.md   (kind: rule, law: <закон>)
+  │             привязывает закон к этому проекту; несколько правил на закон
+  │             .claude/skills/<правило>/implementation.md — привязка к коду
   │
-  │  └─ ПАТТЕРН  {{rulesDir}}/<правило>-<что>/SKILL.md  (kind: pattern, rule: <правило>)
+  │  └─ ПАТТЕРН  .claude/skills/<правило>-<что>/SKILL.md   (kind: pattern, rule: <правило>)
   │              готовый код и конкретные приёмы; минимум один на правило
   │
-  └─ СПЕК ДОМЕНА  как работает домен; объявляет законы, которые применяет
+  └─ СПЕК ДОМЕНА  docs/specs/<домен>/
+                  как работает домен; объявляет законы, которые применяет
+
+СКИЛ БЕЗ ЗАКОНА  .claude/skills/<имя>/SKILL.md   (ни kind: rule, ни kind: pattern)
+                 стоит рядом с лестницей, а не в ней: он не про то, что должно быть
+                 верно в продукте, а про то, как здесь делается работа
 ```
 
 Ссылки идут только снизу вверх: закон не ссылается ни на правило, ни на спек, ни на файл.
 
-## Что здесь действует
+Скил без закона — третий случай, и он законный. Витрина, генератор, работа с чужим сервисом,
+заведение самого скила: над таким нет утверждения о продукте, а значит нет и закона. Выдумывать
+ему закон, чтобы уложить в лестницу, нельзя — закон, у которого одно правило и ни одной статьи о
+продукте, разъезжается с остальными при первой же правке. Как такой скил заводится — скил
+`write-a-skill`.
+
+| В законе                        | Здесь                                                                                                |
+| ------------------------------- | ---------------------------------------------------------------------------------------------------- |
+| набор разделов                  | `REQUIRED_HEADINGS` для спека, «Статьи» для закона                                                   |
+| утверждение документа           | пункт `## Правила` в спеке, `## Статьи` в законе, `## Как закон применяется здесь` в правиле         |
+| место, где оно исполняется      | строка в `implementation.md` рядом: `` `файл:символ` ``                                              |
+| обещанное поведение             | сценарий `SC-<ПРЕФИКС>-<НОМЕР>` в `docs/specs/<домен>/scenarios.md`                                  |
+| открытый вопрос                 | `Q-N` — на него ссылаются из задачи на борде и из коммитов; номер после закрытия не переиспользуется |
+| законы, которые применяет домен | строка `**Законы:**` в шапке спека, именами в кавычках                                               |
+
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
 
 - **Набор разделов спека задан заранее, и отсутствие раздела — отказ.** «Не применимо» —
-  законный ответ, отсутствие раздела — нет: сквозные требования вспоминаются постфактум именно
-  тогда, когда для них не заведено места.
-- **Каждое утверждение привязано к месту в коде, и связь сверяется в обе стороны.** Ключ связи
-  — сам текст утверждения, поэтому переформулировать его, забыв про привязку, нельзя.
+  законный ответ, отсутствие раздела — нет: сквозные требования вспоминаются постфактум
+  именно тогда, когда для них не заведено места.
+- **Каждое утверждение привязано к месту в коде, и связь сверяется в обе стороны.** Ключ
+  связи — сам текст утверждения, поэтому переформулировать его, забыв про привязку, нельзя.
 - **Привязка не ведёт в код, который никто не зовёт.** Символ, объявленный в своём файле и
   больше нигде не встречающийся, местом исполнения не считается.
-- **Таблица обработчиков сверяется с объявлениями в обе стороны.** Иначе обработчик, который
-  домен обслуживает, но забыл описать, виден только в объявлении.
-- **Код отказа принимается, только если он в домене бросается.** Коды, выписанные по замыслу,
-  живут в документе годами, а на одном из путей обещанный отказ не бросает никто.
+- **Таблица процедур сверяется с декораторами в обе стороны.** Иначе процедура, которую домен
+  обслуживает, но забыл описать, видна только в декораторе.
+- **Код отказа принимается, только если он в домене бросается.** Коды выписывались по
+  замыслу, и на одном пути обещанный отказ не бросал никто.
 - **Префикс сценариев в домене один.** Второй префикс означает, что домен описан дважды.
-- **У закона обязателен раздел статей, и кроме них он не держит ничего.** Истории правок и
-  доводов о выбранном когда-то варианте в законе нет: историю держит система контроля версий, а
-  довод с отвергнутой альтернативой — свойство работы, и место ему в «Ловушках» правила.
+- **У закона обязателен раздел «Статьи», а кроме них он держит только открытые вопросы.**
+  Истории правок и доводов о выбранном когда-то варианте в законе нет: историю держит система
+  контроля версий, а довод с отвергнутой альтернативой — свойство работы, и место ему в
+  «Ловушках» правила. Закрытый вопрос из закона уходит, а пустой раздел ради заголовка
+  проверку всё равно проходил.
 - **Закон, назвавший файл проекта, — отказ.** Путям и привязкам место в правиле: иначе закон
   нельзя ни прочитать без знания дерева, ни применить на другом приложении.
 - **Правило объявляет закон, под который написано.** Правило без закона — набор приёмов, из
   которого не видно, что именно должно быть верно.
+- **Слоёв законов два, а имя закона одно на оба.** Общий лежит в корне конституции, закон
+  приложения — в `application/`; ни `law:`, ни `**Законы:**` слоя не называют, поэтому имена
+  законов уникальны по всему дереву конституции.
 - **Спек объявляет законы, которые применяет, и связь сверяется в обе стороны.** Закон,
-  названный в тексте спека, обязан стоять в его шапке: иначе по закону не узнать, какие домены
+  названный в тексте спека, обязан стоять в шапке: иначе по закону не узнать, какие домены
   на нём стоят.
 
+## Чего из закона здесь нет
+
+Закон, которого не применяет ни один спек, отказом не считается: законы про устройство кода,
+поставку и проверяемость доменов не касаются вовсе. Порядок «сначала описание, потом код»
+держится договорённостью — это `Q-PD-3` в законе.
+
+Таблицы состояний экрана не сверяются ничем. `check:specs` знает сценарии против заголовков
+тестов, правила против якорей, процедуры против декораторов и коды отказа против бросков —
+строка таблицы состояний не привязана ни к чему и проходит зелёной, даже когда код в
+названное состояние не попадает. Состояние «проверка не загрузилась» стояло в таблицах двух
+доменов раньше, чем код научился в него приходить, и всё это время читалось описанием
+работающего.
+
 ## Паттерны
 
 - `spec-driven-domain` — заведение и правка спека домена, сценарии, привязка.
@@ -67,23 +106,30 @@ description: Правило под закон «Документация про
 
 ## Ловушки
 
-- **Список шагов в спеке не заводить.** Шаги — артефакт сессии, им место в ветке или в описании
+- **`tasks.md` в спеке не заводить.** Шаги — артефакт сессии, им место в ветке или в описании
   PR. Как только в директории появляются «шаги», спек снова становится планом и умирает после
-  слияния.
+  мержа.
 - **Спек описывает установившееся, а не предстоящее.** Единственное место, где он говорит о
-  будущем, — отдельная директория предложенного; после выкатки её текст вливается в спек
-  домена, директория удаляется, идентификаторы сценариев не меняются.
-- **Семантику полей не сверяет ничто.** Проверка знает имена обработчиков, коды отказа и связь
-  сценариев с тестами; что означает пустое поле — не знает.
-- **Живость символа считается совпадением имени по дереву, а не вызовом.** Символу хватает
-  второго упоминания где угодно — в чужом поле с тем же именем, в атрибуте разметки. Место, где
-  правило исполняется на самом деле, подтверждается только чтением кода.
-- **Зелёная проверка не значит, что структура верна.** Проверка сверяет структуру с тем, чего
-  сама и ждёт: неверная раскладка, совпавшая с её ожиданием, проходит зелёной.
-- **Конфликт слияния в спеке разрешается сохранением обеих сторон, а не выбором одной.** Две
-  ветки дописывают в конец одних и тех же списков, и обе стороны верны: конфликт здесь не спор,
-  а две дописи в одно место. Номера сценариев при разрешении не пересчитываются — идентификатор
-  это ключ связи с тестами, и сдвиг номеров рвёт сверку у соседей, которых правка не касалась.
-  Порядок сохранённых сторон держится одинаковым во всех файлах спека, иначе правило, его
-  сценарий и его привязка перестают находиться друг по другу. После разрешения гоняется
-  проверка спеков: конфликт в тексте кода не задевает, и ни сборка, ни линтеры его не увидят.
+  будущем, — `proposed/<фича>/`. После выкатки его текст вливается в спек домена, директория
+  удаляется, идентификаторы сценариев не меняются.
+- **Семантику полей не сверяет ничто.** Проверка знает имена процедур, коды отказа и связь
+  сценариев с тестами; что означает пустое поле — не знает. Правка `.proto` поэтому тянет
+  спеки всех доменов, чьи процедуры она задела, в той же ветке.
+- **Живость символа считается совпадением имени по всему дереву, а не вызовом.** Символу
+  хватает второго упоминания где угодно — в чужом поле с тем же именем, в атрибуте разметки.
+  Место, где правило исполняется на самом деле, подтверждается только чтением кода.
+- **Якорь в `tools/*.mjs` сверяется почти ничем:** живость считается только для `.ts`, а
+  исходники обходятся по `apps`, `libs` и `prisma`. Правило, привязанное к проверке, поэтому
+  читается вместе с её телом.
+- **Зелёная проверка не значит, что структура верна.** Спутники с привязкой сначала лежали
+  рядом с законами, и проверка была зелёной именно потому, что структура совпадала с тем,
+  чего проверка сама и ждала.
+- **Конфликт мержа в спеке разрешается сохранением обеих сторон, а не выбором одной.** Две
+  ветки дописывают в конец одних и тех же списков — сценариев, правил, строк привязки, — и
+  обе стороны верны: конфликт здесь не спор, а две дописи в одно место. Номера сценариев при
+  разрешении не пересчитываются: идентификатор — ключ связи с тестами, и сдвиг номеров рвёт
+  сверку у соседей, которых правка не касалась. Порядок сохранённых сторон держится
+  одинаковым в `spec.md`, `scenarios.md` и `implementation.md`: иначе правило, его сценарий и
+  его привязка перестают находиться друг по другу. После разрешения гоняется
+  `npm run check:specs` — конфликт в спеке кода не задевает, и ни сборка, ни линтеры его не
+  увидят.

package/assets/rules/styling-bem.md

@@ -2,58 +2,73 @@
 name: styling-bem
 kind: rule
 law: frontend-application
-description: Правило под закон «Фронтовое приложение». Брать при правке любого файла стилей и шаблона компонента — токены оформления вместо сырых значений, класс директивой, общий слой раскладки, класс без правила. Готовый код — в паттернах styling-bem-layout и styling-bem-component. Чем это названо здесь — в implementation.md рядом.
+description: Правило под «Закон о фронтовом приложении». Брать при правке любого *.scss и шаблона компонента. Называет директивы BEM, токены оформления, общий слой раскладки приложения и проверку класса без правила. Готовый код — в паттернах styling-bem-layout и styling-bem-component.
 ---
 
-# Оформление — каким приёмом
+# Оформление — как это устроено здесь
 
-Правило под закон `{{lawsDir}}/frontend-application.md`. Закон говорит, что должно быть верно;
-здесь — каким приёмом это держится. Как названы токены, директивы классов и общий слой
-раскладки — `implementation.md` рядом. Раскладка файла компонента — `component-structure`,
-состояние — `angular-patterns`, окружение браузера — `platform-access`, слой обращения к
-серверу — `api-layer`. Все пять под одним законом.
+Правило под закон `docs/constitution/frontend-application.md`. Закон говорит, что должно быть
+верно; здесь — чем это названо в этом дереве и где лежит. Раскладка файла компонента —
+`component-structure`, состояние — `angular-patterns`, окружение браузера —
+`platform-access`, слой обращения к серверу — `api-layer`. Все пять под одним законом.
 
-## Когда берётся
+## Как это называется здесь
 
-Правка любого файла стилей и любого шаблона компонента. И раньше всего этого — момент, когда
-рука тянется написать шестнадцатеричный цвет или число на месте.
+| В законе                        | Здесь                                                                                                                                        |
+| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
+| общий набор значений оформления | шкалы кита `--rt-*`; своё поверх них — `--vm-*` в `styles.scss` приложения                                                                   |
+| класс в разметке                | директивы `rtBlock` и `rtElem` из `@rt-tools`, а не строка в атрибуте                                                                        |
+| правило стилей                  | объявление `&__<элемент>` в `.scss` — своём или в общем слое приложения                                                                      |
+| общий слой раскладки            | `apps/<app>/src/styles/`: `<префикс>-page`, `<префикс>-form`, `<префикс>-panel`, `<префикс>-window` у админки, `<префикс>-site-page` у сайта |
 
-## Что здесь действует
+## Где это лежит
 
-- **Оформление берётся токеном, а не пишется значением на месте.** Составные значения — тени,
-  обводки — берутся готовым токеном целиком, а не собираются из частей: собранное из частей
-  расходится с оригиналом при первой правке шкалы.
-- **У каждого класса элемента есть своё правило стилей.** Класс без правила выглядит рабочим и
-  молча ничего не делает.
-- **Класс ставится директивой, а не строкой в атрибуте.** Имя блока элемент получает от
-  ближайшего предка, объявившего блок, и повторить этот разбор по тексту шаблона нечем.
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
+
+- **Оформление берётся токеном `--rt-*`, а не пишется значением на месте.** Составные
+  значения — `box-shadow`, `text-shadow` — берутся готовым токеном целиком, а не собираются
+  из частей.
+- **У каждого класса элемента есть своё правило стилей.** Класс без правила выглядит рабочим
+  и молча ничего не делает.
+- **Класс ставится директивой, а не строкой в атрибуте.** Имя блока `rtElem` получает
+  инъекцией от ближайшего предка с `rtBlock`, и повторить этот разбор по тексту шаблона нечем.
 - **Раскладка объявлена в общем слое приложения, а не в стилях экрана.** У компонента экрана
-  файл стилей по умолчанию пустой.
-- **Предупреждение линтера стилей роняет прогон наравне с ошибкой.** Иначе запрет читается как
-  пожелание: нарушения лежат в дереве, а прогон возвращает успех и гейтом не является.
+  вне кита файл стилей по умолчанию пустой.
+- **Предупреждение stylelint роняет прогон наравне с ошибкой.** `!important` объявлен
+  предупреждением, а прогон идёт с `--max-warnings 0`: иначе запрет читается как пожелание —
+  два таких предупреждения лежали в дереве, а `npm run stylelint` возвращал ноль и гейтом не был.
+
+## Чего из закона здесь нет
+
+Проверка «класс без правила» считает совпадение по имени элемента, а не по паре «блок —
+элемент»: класс, у которого правило есть, но у чужого блока, она пропускает. Обратное
+направление — снятие правила у живого класса — не проверяется вовсе и ловится чтением шаблона.
 
 ## Паттерны
 
 - `styling-bem-layout` — экран на общем слое раскладки, блоки приложения.
-- `styling-bem-component` — стили компонента источника вида, хост, модификаторы.
+- `styling-bem-component` — стили компонента кита, `:host`, модификаторы, язык оформления сайта.
 
 ## Ловушки
 
-- **Директива элемента без предка, объявившего блок, роняет отрисовку во время работы** —
-  сборка и линтер при этом молчат.
-- **Директива блока на контейнере без своего узла класса не ставит вовсе:** такой узел это
-  комментарий, и имя блока он только объявляет потомкам. Класс блока экрана вешает хост.
-- **Выравнивание по центру в прокручиваемой ленте уводит первые элементы за нулевой скролл** —
-  доскроллить до них невозможно. В прокручиваемых лентах берётся безопасный вариант
-  выравнивания.
-- **Резерв под полосу прокрутки на корне сужает содержащий блок для закреплённых элементов.**
-  Попап, выровненный по правому краю, встаёт на ширину резерва левее своей кнопки.
-- **Изнутри компонента до соседнего хоста не дотянуться.** Разделитель между повторяющимися
-  хостами объявляется через отрицание первого, а не соседним селектором.
-- **Атрибут доступности визуального состояния не даёт.** Браузер стилизует собственное
-  состояние элемента, а атрибуты доступности — нет: к каждому такому атрибуту заводится своё
-  правило.
-- **Гарнитуру с корня элементы формы не наследуют** — браузер задаёт им свой шрифт.
-  Наследование включается глобально и не сбрасывается.
-- **Комментарии-выключатели линтера стилей не ставятся.** Селекторы объединяются вложенностью.
+- **`rtElem` без предка с `rtBlock` роняет отрисовку в рантайме** — сборка и линт молчат.
+- **`rtBlock` на `<ng-container>` класса не ставит вовсе:** узел это комментарий, и имя блока
+  он только объявляет потомкам. Класс блока экрана вешает хост через `host: { class: … }`.
+- **`justify-content: center` во flex-контейнере с `overflow-x` уводит первые элементы за
+  нулевой скролл** — доскроллить до них невозможно. В прокручиваемых лентах —
+  `justify-content: safe center`.
+- **`scrollbar-gutter: stable` на корне не заводить:** резерв под полосу прокрутки сужает
+  содержащий блок для `position: fixed`, и попап, выровненный по правому краю, встаёт на
+  ширину резерва левее своей кнопки.
+- **`& + :host` невалиден:** изнутри компонента до соседнего хоста не дотянуться. Разделитель
+  между повторяющимися хостами — `:host(:not(:first-of-type))`.
+- **`[attr.aria-disabled]` визуального состояния не даёт:** браузер стилизует `:disabled`, но
+  атрибуты `aria-*` — нет. К каждому `aria-disabled` заводится правило `[aria-disabled='true']`.
+- **Гарнитуру с `body` элементы формы не наследуют:** браузер задаёт `button`, `input`,
+  `select` и `textarea` свой шрифт. Наследование включено глобально — сбрасывать его нельзя.
+- **Комментарии-выключатели stylelint не ставятся.** Селекторы объединяются вложенностью.
 - **При переносе стилей новых объявлений не появляется** — только перемещение существующих.

package/assets/rules/task-flow.md

@@ -0,0 +1,110 @@
+---
+name: task-flow
+kind: rule
+law: work-conduct
+description: Правило под «Закон о ведении работы». Брать в начале любой работы от владельца, при правке docs/tasks/**, docs/specs/*/proposed/** и при возвращении к незаконченной задаче. Называет разбор просьбы до первой правки, папку задачи по имени ветки, договорённость о продукте до кода, шесть обязательных вопросов и разбор папки при закрытии. Готовый порядок — в паттернах task-flow-start, task-flow-resume и task-flow-close.
+---
+
+# Ведение работы — как это устроено здесь
+
+Правило под закон `docs/constitution/work-conduct.md`. Закон говорит, что должно быть верно
+про ход работы; здесь — чем это названо в этом дереве, где лежит и что из закона у нас не
+проверяется.
+
+## Как это называется здесь
+
+| В законе                                      | Здесь                                                                                                                         |
+| --------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
+| просьба владельца                             | то, с чего начинается работа; разбирается командой `/grill-me` до первой правки                                               |
+| понимание, записанное там, где идёт работа    | `docs/tasks/<ветка>/grill.md` — просьба дословно, ответы владельца его словами, решения с доводами                            |
+| замысел                                       | `docs/tasks/<ветка>/plan.md` — след задачи и этапы с признаками готовности; после написания не правится                       |
+| ход работы                                    | `docs/tasks/<ветка>/progress.md` — «Где стоим», решения по ходу, записи заходов; единственное место, где отмечается сделанное |
+| договорённость о продукте, записанная до кода | `docs/specs/<домен>/proposed/<фича>/` — спек фичи; переживает мерж и вливается в спек домена                                  |
+| работа шире одной ветки                       | файл в `docs/plans/`, один на линию работ: порядок задач и зависимости между ними                                             |
+| папка задачи до заведения задачи              | `docs/tasks/_draft-<slug>/` — вне истории, пока номера нет                                                                    |
+| разведка                                      | заход `Explore` или `general-purpose` до первого вопроса владельцу                                                            |
+| разбор замысла ролями                         | `.claude/workflows/plan.js` — нужность, договорённость, критика, замысел                                                      |
+
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
+
+- **Правка кода приложения отбивается, пока на диске нет замысла.** Гард требует папку задачи
+  по имени ветки, `plan.md` в ней и названную в его шапке договорённость о продукте.
+- **Договорённость требуется по путям правки, а не по оценке задачи.** `apps/**` и `libs/**`
+  — признак; правила, тексты, обвязка и зависимости под него не подпадают. Обход — строка
+  `**Поведение:** не меняется — <причина владельца>` в замысле; пустая причина не
+  принимается.
+- **Состояние незаконченной работы приходит в контекст на запуске сессии.** Замысел и ход
+  работы отдаются целиком, разбор просьбы — путём. Ветка вида `<КЛЮЧ>-*` без папки даёт
+  предупреждение с готовой командой, но сессию не рвёт.
+- **Сделанное отмечается только в ходе работы.** «Где стоим» перезаписывается каждым заходом,
+  а не дописывается: это первое, что читает следующий заход.
+- **Папка задачи заводится черновиком и получает номер командой.** До конца разбора
+  неизвестно, сколько задач из него выйдет, поэтому номер не может быть первым;
+  `npm run task:new` переименовывает черновик и проставляет шапку замысла.
+- **Брошенный разбор виден.** Черновик старше недели перечисляет сверка очереди работ —
+  задачи за ним ещё нет, и спросить о нём некого.
+- **Договорённость вливается в спек домена последним коммитом отчёта.** К этому моменту код
+  написан, привязки известны, и в главной ветке директория `proposed/` не появляется вовсе.
+  Готовые к вливанию перечисляет `npm run check:specs`.
+- **Папка закрытой задачи разбирается, а не переносится целиком.** В `docs/archive/` уезжает
+  то, что объясняет состоявшееся решение; остальное удаляется. Неразобранную ловит сверка
+  очереди работ.
+
+## Чего из закона здесь нет
+
+Полноту записанного понимания не проверяет ничто, и проверки на неё не будет: машине видно
+наличие записи, но не то, что в ней закрыты все пробелы. Разбор из одной строки проходит гард
+так же, как разбор на сто. То же с вопросом, который стоило задать и не задали, — он не
+оставляет следа. Оба разобраны решениями в законе: судит владелец.
+
+Гард судит по путям правки, а не по тому, меняет ли работа поведение на самом деле.
+Рефакторинг, снаружи не видный, упирается в требование договорённости и проходит обходом с
+причиной. Своего признака рефакторингу не заводится: оценку «поведение не меняется»
+назначал бы тот, кому она мешает.
+
+Ничто из самого разбора не проверяется, и всё это держится памятью того, кто его ведёт.
+Разговор с владельцем инструментом не является — гард видит правку файла и ничего не знает
+ни о том, была ли разведка до первого вопроса, ни о том, задан ли каждый из шести
+обязательных вопросов, ни о том, ответил ли на них владелец. Образец разбора перечисляет их
+таблицей, но пустая таблица проходит так же, как заполненная.
+
+Неизменность замысла не стережёт ничто: `plan.md` правится тем же инструментом, что и
+остальные тексты, и правка по ходу отличима от первоначальной записи только по истории.
+Держится это тем же, чем и порядок разбора.
+
+Разбор папки при закрытии не проверяется по существу: сверка очереди работ видит, что папка
+закрытой задачи лежит на месте, но не судит, что из неё стоило увезти в архив.
+
+## Паттерны
+
+- `task-flow-start` — разведка, разбор, договорённость, замысел, задача и ветка.
+- `task-flow-resume` — возвращение к незаконченной работе новым заходом.
+- `task-flow-close` — вливание договорённости, разбор папки, переезд в архив.
+
+## Ловушки
+
+- **Папка называется именем ветки, один в один.** Хук запуска ищет её по
+  `git branch --show-current`, и папка, названная иначе, не находится ничем: работа идёт с
+  пустым контекстом, а владельца просят пересказать то, что уже записано.
+- **Разбор просьбы задним числом не переписывается.** Пересказ незаметно подгоняется под уже
+  сделанное, и сверять результат становится не с чем. Решение, изменённое по ходу, дописывается
+  в ход работы, а не правится в разборе.
+- **Договорённость о продукте не кладётся в папку задачи.** Папка умирает с мержем, а
+  договорённость обязана его пережить: её сценарии получают номера в общей нумерации домена,
+  и на них ссылаются заголовки тестов. Обратное тоже верно — ход работы не кладётся в
+  `proposed/`: спек, в котором завелись шаги, снова становится планом и умирает после мержа.
+- **Меню вариантов на разборе годится только для выбора значения из закрытого набора.** Пока
+  постановка вопроса не подтверждена, спрашивается прозой: у меню нет строки «вопрос не тот».
+  Выбор слова, имени и термина узким вопросом не является никогда.
+- **Субагент вопросов владельцу не задаёт.** Ни роли, ни конвейер до него не достучатся —
+  они возвращают текст главному агенту. Поэтому разбор ведёт главный агент, а роли стоят по
+  обе стороны от него.
+- **Слово для нового понятия берётся из `docs/GLOSSARY.md` или заводится там же.** Третий файл
+  папки задачи называется `progress.md`, а не `journal.md`, ровно поэтому: журнал в этом
+  дереве один, и он другой.