@rt-tools/agent-kit 0.3.0 → 0.5.0

package/assets/patterns/styling-bem-component.md

@@ -2,76 +2,87 @@
 name: styling-bem-component
 kind: pattern
 rule: styling-bem
-description: Паттерн правила styling-bem. Брать при правке стилей компонента источника вида — готовый хост, модификаторы, значения только токенами, перебивание умолчаний источника вида. Не брать для раскладки экрана — это паттерн styling-bem-layout.
+description: Паттерн правила styling-bem. Брать при правке стилей компонента кита — готовый :host, модификаторы, токены оформления, язык оформления публичного сайта, обход умолчаний кита. Не брать для раскладки экрана — это паттерн styling-bem-layout.
 ---
 
 # Стили компонента
 
 Паттерн правила `styling-bem`. Что при этом должно быть верно — закон
-`{{lawsDir}}/frontend-application.md`.
+`docs/constitution/frontend-application.md`.
 
 ## Когда брать
 
-- Правится компонент источника вида.
-- Правится оформление отдельного компонента.
-- Нужно перебить умолчание источника вида в своём компоненте.
+- Правится компонент кита — он живёт в пакете `@rt-tools/ui-kit-v2`, а не в этом дереве.
+- Правится оформление публичного сайта.
+- Нужно перебить умолчание кита в своём компоненте.
 
-## Хост — сам блок
+## `:host` — сам блок
 
-Хост несёт класс блока, раскладка на хосте, элементы вложены внутрь:
+Хост несёт класс блока, раскладка на `:host`, элементы вложены внутрь:
 
 ```scss
 :host {
     display: inline-flex;
 
-    .<блок > {
+    .<префикс > -tag {
         display: inline-flex;
-        gap: var(--<токен отступа>);
+        gap: var(--<префикс>-space-1);
         align-items: center;
 
-        &--<модификатор > {
-            border-radius: var(--<токен скругления>);
+        &--shape--pill {
+            border-radius: var(--<префикс>-radius-full);
         }
     }
 }
 ```
 
-Модификатор — вложенным селектором или привязкой класса на хосте. У экрана вне источника вида
-такого раздела нет: раскладка на хосте — это общий слой приложения, а не файл экрана.
+Отступ — четыре пробела. Модификатор — `&--<имя>` или привязка класса на хосте
+(`[class.<префикс>-component-name--active]="isActive()"`).
+
+У экрана вне кита такого раздела нет: `display: flex` с `gap` и `padding` на `:host` — это
+раскладка, и она в общем слое приложения.
 
 ## Значения — только токенами
 
 ```scss
 ✗ color: #fff;
 ✗ box-shadow: 0 1px 2px rgb(0 0 0 / 12%);
-✓ color: var(--<токен цвета поверхности>);
-✓ box-shadow: var(--<токен тени>);
+✓ color: var(--<префикс>-color-surface);
+✓ box-shadow: var(--<префикс>-shadow-sm);
 ```
 
-Составное значение берётся готовым токеном целиком, а не собирается из частей. Переменные
-препроцессора для значений оформления не используются вовсе: они разрешаются на сборке и темой
-не переключаются.
+Составное значение берётся готовым токеном целиком, а не собирается из частей. SCSS-переменные
+(`$primaryColor`) для значений оформления не используются вовсе.
+
+## Язык оформления публичного сайта
+
+Тропический премиум, фото-first:
+
+- светлая тёплая палитра — песок, терракота, пальмовая зелень, только через `--<префикс>-color-*`;
+- акцентная антиква в заголовках (`--<префикс>-font-serif`), гуманистический гротеск в тексте
+  (`--<префикс>-font-sans`);
+- большие полноэкранные фото, щедрые отступы, сдержанные анимации;
+- тёмные оверлеи поверх фото — переменными с прозрачностью.
 
-## Перебить умолчание источника вида
+## Перебить умолчание кита
 
-Стили компонента без инкапсуляции весят столько же, сколько умолчания источника вида: у обоих
-селекторов по одному классу, и исход решает порядок подключения. Переопределение пишется
-потомком блока — так вес растёт на единицу, и порядок перестаёт что-либо решать:
+Стили компонента с `ViewEncapsulation.None` весят столько же, сколько умолчания кита: у
+`.<префикс>-block__item` и у `.<префикс>-kit-item` по одному классу, и исход решает порядок подключения.
+Переопределение пишется потомком блока:
 
 ```scss
 & &__item {
-    color: var(--<токен приглушённого текста>);
+    color: var(--<префикс>-color-text-muted);
 }
 ```
 
 ## Частые промахи
 
-- **Комментарий-выключатель линтера стилей:** селекторы объединяются вложенностью, а не
-  отключением правила.
-- **Приоритетное объявление:** запрещено, и оформление, заданное на месте, перебить им всё
-  равно не выйдет.
-- **Новые объявления при переносе стилей:** переносится существующее, новое появляется, только
-  когда задача — фича.
-- **Замечание линтера, лежавшее в файле раньше, оставлено:** правятся все, и новые, и старые.
-- **Своё наследование гарнитуры в компоненте:** оно включено глобально, и местное объявление
-  только расходится с ним.
+- Комментарий-выключатель stylelint: селекторы объединяются вложенностью, а не отключением
+  правила.
+- `!important`: запрещён, и инлайновый `width: 100%` на боксе панели перебить им нельзя.
+- Новые объявления при переносе стилей: переносится существующее, новое появляется только
+  тогда, когда задача — фича.
+- Замечание линтера, лежавшее в файле раньше, оставлено: правятся все, и новые, и старые.
+- Свой `font-family: inherit` в компоненте: наследование включено глобально в `styles.scss`
+  обоих приложений.

package/assets/patterns/styling-bem-layout.md

@@ -2,13 +2,13 @@
 name: styling-bem-layout
 kind: pattern
 rule: styling-bem
-description: Паттерн правила styling-bem. Брать при сборке экрана раздела, формы, панели или окна — блоки общего слоя, разметка директивами блока и элемента, свой элемент в чужом поддереве, признак того, что правка идёт не туда. Не брать для стилей компонента источника вида — это паттерн styling-bem-component.
+description: Паттерн правила styling-bem. Брать при сборке экрана раздела, формы, панели или окна — готовые блоки общего слоя, разметка через rtBlock и rtElem, свой элемент в чужом поддереве, признак того, что правка идёт не туда. Не брать для стилей компонента кита — это паттерн styling-bem-component.
 ---
 
 # Экран на общем слое раскладки
 
 Паттерн правила `styling-bem`. Что при этом должно быть верно — закон
-`{{lawsDir}}/frontend-application.md`.
+`docs/constitution/frontend-application.md`.
 
 ## Когда брать
 
@@ -17,51 +17,57 @@ description: Паттерн правила styling-bem. Брать при сбо
 
 ## Файл стилей экрана по умолчанию пустой
 
-Раскладка объявлена один раз в общем слое приложения, а экран её только применяет. Блоков этого
-слоя немного, и каждый отвечает за свой род экрана: экран раздела с заголовком и прокруткой,
-форма с разделами и строками полей, содержимое панели правки, содержимое модального окна.
+Раскладка объявлена один раз в общем слое приложения (`apps/<app>/src/styles/`), а экран её
+только применяет. Блоков в админке четыре, у сайта один:
 
-Блок вешается на хост, элементы получают классы от директивы блока в корне шаблона:
+| Блок                  | Что раскладывает                                                |
+| --------------------- | --------------------------------------------------------------- |
+| `<префикс>-page`      | экран раздела: заголовок, тулбар, прокрутка, таблица, пагинация |
+| `<префикс>-form`      | форма с разделами-карточками и строками полей                   |
+| `<префикс>-panel`     | содержимое панели правки                                        |
+| `<префикс>-window`    | содержимое модального окна                                      |
+| `<префикс>-site-page` | колонка содержимого сайта: заголовок раздела и вводный абзац    |
 
-```
-host: { class: '<блок экрана>' },
+Блок вешается на хост, элементы получают классы от `rtBlock` в корне шаблона:
+
+```typescript
+host: { class: '<префикс>-page' },
 ```
 
 ```html
-<ng-container rtBlock="<блок экрана>">
+<ng-container rtBlock="<префикс>-page">
     <header rtElem="header">
         <div rtElem="header-main">
-            <h1 rtElem="title">{{ '<ключ заголовка>' | <перевод> }}</h1>
+            <h1 rtElem="title">{{ 'bookingsTitle' | transloco }}</h1>
+            <p rtElem="hint">{{ 'bookingsHint' | transloco }}</p>
         </div>
     </header>
 </ng-container>
 ```
 
-Директива блока на контейнере без своего узла класса не ставит — узел это комментарий. Второго
-носителя класса блока не нужно, и своей обёртки тоже.
+`rtBlock` на `<ng-container>` класса не ставит — узел это комментарий. Второго носителя класса
+блока не нужно, и своей обёртки `<section>` тоже.
 
 ## Свой элемент в чужом поддереве
 
 Пара директив на одном элементе; класс блока при этом не ставится, только класс элемента:
 
 ```html
-<div rtBlock="<свой блок>" rtElem="confirm"></div>
+<div rtBlock="<префикс>-bookings-page" rtElem="confirm"></div>
 ```
 
-Класс получается составной, а потомки внутри считаются от того же блока.
+Класс получается `<префикс>-bookings-page__confirm`, а потомки внутри считаются от того же блока.
 
 ## Своё в файле экрана
 
-Остаётся только то, что принадлежит одному этому экрану и в общий слой не просится, — сетка
-календаря, карта на странице записи, лента переписки. Рядом пишется, почему это не общее.
+Остаётся только то, что принадлежит одному этому экрану и в общий слой не просится — сетка
+календаря, карта на странице объекта, лента переписки. Рядом пишется, почему это не общее.
 
 ## Частые промахи
 
-- **Раскладка на хосте в файле экрана.** Одинаковые с виду экраны от неё расходятся: заголовок
-  страницы, объявленный в каждом экране заново, живёт тремя разными кеглями.
-- **Директива элемента без предка, объявившего блок:** отрисовка падает во время работы, сборка
-  и линтер молчат.
-- **Класс, у которого правило сняли, а директива в шаблоне осталась:** ловит проверка «класс
-  без правила».
-- **Элемент чужого блока в чужом поддереве:** имя блока приходит от предка, и подмешать его
-  нечем.
+- `display: flex` с `gap` и `padding` на `:host` в файле экрана — это раскладка. Одинаковые с
+  виду экраны от неё расходятся: заголовок страницы объявлялся в одиннадцати компонентах тремя
+  разными кеглями.
+- `rtElem` без предка с `rtBlock`: отрисовка падает в рантайме, сборка и линт молчат.
+- Класс, у которого правило сняли, а `rtElem` в шаблоне остался: ловит `npm run check:styles`.
+- Элемент чужого блока в чужом поддереве: имя блока приходит инъекцией, и подмешать его нечем.

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

@@ -0,0 +1,154 @@
+---
+name: task-flow-close
+kind: pattern
+rule: task-flow
+description: Паттерн правила task-flow. Брать при закрытии работы — вливание договорённости в спек домена последним коммитом отчёта, разбор папки задачи, переезд в архив, сверка очереди работ. Не брать для хода работы — это паттерн task-flow-resume.
+---
+
+# Закрытие работы
+
+Паттерн правила `task-flow`. Что при этом должно быть верно — закон
+`docs/constitution/work-conduct.md`.
+
+## Когда брать
+
+- Этапы замысла закрыты, проверки зелёные, отчёт готовится к публикации.
+- `npm run check:specs` перечислил договорённость в разделе «Пора вливать».
+
+## 1. Договорённость вливается в спек домена
+
+Последним коммитом отчёта, до слияния. Код к этому моменту написан, поэтому привязки
+`файл:символ` известны — правило въезжает в спек домена сразу проверяемым.
+
+```bash
+npm run check:specs   # раздел «Пора вливать» называет готовые директории
+```
+
+Порядок переезда:
+
+- правила из `proposed/<фича>/spec.md` дописываются в `spec.md` домена, в его разделы;
+- сценарии переезжают в `scenarios.md` домена **с прежними номерами**: на них ссылаются
+  заголовки тестов, и пересчёт рвёт сверку;
+- привязки из `proposed/<фича>/implementation.md` дописываются в `implementation.md` домена
+  и проставляются на код, который теперь есть;
+- законы, объявленные фичей в шапке, дописываются в шапку спека домена;
+- директория `proposed/<фича>/` удаляется, строка о фиче снимается из раздела «Что
+  предложено, но ещё не выкачено» в `docs/specs/README.md`;
+- домена ещё не было — `proposed/` заменяется полноценным спеком, и домен получает строку в
+  таблице `docs/specs/README.md`.
+
+Работа шла несколькими задачами — вливание идёт в последней из них. Какая последняя, видно в
+`docs/plans/<линия>.md`; закрытая линия уезжает в `docs/archive/` или удаляется.
+
+```bash
+npm run check:specs   # после вливания: привязки на месте, сценарии не потерялись
+```
+
+## 2. Тексты домена приводятся к сделанному
+
+В спек уезжает только то, что записали до кода. Остальные тексты — правила, паттерны, законы
+приложения — после правки никто не перечитывает, и они продолжают описывать старое дерево.
+Следующий читатель принимает их за верные.
+
+Что перечитывать, берётся из раздела замысла, где названо, что работа задевает: там стоят
+спеки, законы и правила по её следу. К ним добавляется то, что всплыло по ходу. Всю
+конституцию и все правила читать не надо.
+
+| Род текста                        | Что с ним делается                                                                                       |
+| --------------------------------- | -------------------------------------------------------------------------------------------------------- |
+| спек домена и его поддомены       | у новой фичи появляется правило, сценарий и привязка; из «Что не входит» убирается то, что теперь входит |
+| правило и его `implementation.md` | новое утверждение с привязкой `файл:символ`; снятое убирается вместе со строкой привязки                 |
+| паттерн                           | код, разошедшийся с деревом, правится; новый приём дописывается разделом                                 |
+| закон приложения и общий закон    | **файл не правится**: владельцу приносится текст статьи, работа идёт дальше без неё                      |
+| обзорный документ продукта        | новая фича дописывается строкой; строка о снятом правится                                                |
+
+Устаревшее чаще всего лежит в трёх местах, и все три читаются целиком:
+
+- **«Чего из закона здесь нет» в правиле.** Сверка спеков этот раздел не читает, поэтому
+  неправда живёт в нём сколько угодно: правило три задачи подряд писало, что нужного механизма
+  в дереве нет, — а он был;
+- **«Что не входит» в спеке домена.** Туда писали границу задачи, а задача давно закрыта;
+- **«Где это лежит» в правиле.** Файлы переезжают, пути в таблице остаются.
+
+```bash
+# где правило и спеки говорят о том, что задевала работа
+grep -rn -i "<слово работы>" <каталог правил>/*/SKILL.md docs/specs/*/spec.md
+# раздел, который не сверяется ничем, — читается глазами целиком
+grep -rn -A3 "Чего из закона здесь нет" <каталог правил>/<правило>/SKILL.md
+```
+
+**Закон в ветке не правится.** Статья закона — договорённость с владельцем, и меняет её он.
+Работа с ней разошлась — пишется готовый текст статьи: в ход работы и в тело отчёта. Файл
+закона правится после ответа. С законами приложения так же: деньги, локали и доступ — та же
+договорённость, только про это приложение.
+
+Что сделали на этом шаге, пишется в тело отчёта: что перечитали, что изменили, а если ничего
+не изменили — почему. Форма раздела — паттерн `git-workflow-commit`.
+
+## 3. Папка задачи разбирается
+
+Целиком в архив не переносится: `docs/archive/` — место для записей о состоявшемся, которые
+кто-то читает, а не свалка ходов работы.
+
+| Файл          | Куда                                                                                                               |
+| ------------- | ------------------------------------------------------------------------------------------------------------------ |
+| `grill.md`    | в `docs/archive/` — ответы владельца невосстановимы, и это единственная запись о том, почему задача поставлена так |
+| `progress.md` | в `docs/archive/`, если в нём есть решения по ходу с причинами; иначе удаляется                                    |
+| `plan.md`     | удаляется — после выкатки на его вопрос отвечает код, а на «как работает» отвечает спек домена                     |
+
+Уезжающее складывается одним файлом с говорящим именем, а не папкой из трёх:
+
+```bash
+cat docs/tasks/<КЛЮЧ>-<номер>-<slug>/grill.md > docs/archive/<ЧТО_РЕШАЛИ>.md
+rm -r docs/tasks/<КЛЮЧ>-<номер>-<slug>
+```
+
+Разбор идёт в том же отчёте, что и работа: папка, оставленная до мержа, попадает в главную
+ветку и читается там как текущая.
+
+## 4. Сверка
+
+```bash
+npm run check:board   # папка закрытой задачи среди текущих, брошенные черновики
+npm run check:specs   # договорённость влита, привязки на месте
+npm run check:docs    # пути, названные в текстах, существуют
+```
+
+## Ловушки
+
+- **Папку разбирают до слияния — потом о ней уже никто не вспомнит.** Сверка очереди считает
+  задачу закрытой по слиянию: до него папка среди текущих законна, а после за неё никто не
+  отвечает — работа перешла к следующей задаче, и находка достанется чужому заходу. Три раза
+  подряд папка закрытой задачи так и уехала в главную ветку, в последний раз их набралось
+  пять. Теперь это держит гард поставки: слияние отбивается, пока папка лежит в ветке.
+- **Разбирают последним коммитом, а не перед открытием отчёта.** Пока идёт ревью, замысел
+  нужен на диске: без него правку по замечаниям не пропустит гард хода работы. Порядок такой:
+  правки по ревью, потом разбор папки, потом слияние.
+- **Разбор папки идёт последним, после того как гейт пуша прошёл целиком.** Гард хода работы
+  не пускает правку кода приложения без замысла на диске, а после разбора замысла нет: чужое
+  замечание линтера, приехавшее мержем из главной ветки, чинить уже нечем, и гейт пуша стоит.
+  Порядок один: мерж главной ветки, все линтеры и проверки зелёные, вливание договорённости,
+  приведение текстов домена, разбор папки. Понадобилась правка кода после разбора — замысел
+  восстанавливается на диске на время правки, и разбор повторяется тем же коммитом.
+- **Тексты правятся до разбора папки.** Список того, что перечитывать, лежит в замысле, а
+  разбор папки его удаляет. После разбора остаётся только память о том, что задевали.
+- **Утверждение правила снимается вместе со строкой привязки.** Связь идёт по тексту
+  утверждения. Убрали утверждение и оставили строку в `implementation.md` — сверка спеков
+  краснеет; убрали строку и оставили утверждение — тоже.
+- **Раздел «Чего из закона здесь нет» читается глазами, греп тут не помогает.** Искать
+  приходится не то слово, которое ждёшь: правило ссылалось на статью закона, которой в законе
+  нет вовсе, и по слову из своей темы эта строка находилась — а неправда была в другом.
+- **Сказать «сверено», не открыв файл, нельзя.** Правило читается целиком. Устаревшее
+  утверждение стоит в списке среди верных и ничем от них не отличается.
+- **Если папку просто удалить, первым пропадёт `grill.md`.** Удалить проще, чем разобрать, а
+  слова владельца записаны только там, и восстановить их неоткуда. Поэтому гард требует, чтобы
+  ветка добавила запись в архив. Что именно перенесли, он не проверяет — это смотрит владелец
+  на ревью.
+- **Вливание после мержа не делается.** В главной ветке тогда лежит раздел «предложено, но не
+  выкачено» с тем, что работает месяц, — беззвучная ложь, тем убедительнее, чем старше.
+- **Номера сценариев при вливании не пересчитываются.** Идентификатор — ключ связи с тестами;
+  сдвиг рвёт сверку у соседей, которых правка не касалась.
+- **Правило без привязки в спек домена не въезжает.** Кода, который его исполняет, нет —
+  значит это намерение, и место ему в открытых вопросах домена, а не в правилах.
+- **Архив не обновляется после выкатки.** Уехавшее туда описывает день переезда, и правится
+  оно только вместе с признанием, что описывало неверно.

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

@@ -0,0 +1,94 @@
+---
+name: task-flow-resume
+kind: pattern
+rule: task-flow
+description: Паттерн правила task-flow. Брать при возвращении к незаконченной работе новым заходом — что уже пришло в контекст, чего не спрашивать у владельца, как править «Где стоим», как записывать решение по ходу и пересмотр этапа. Не брать для начала работы — это паттерн task-flow-start.
+---
+
+# Возвращение к незаконченной работе
+
+Паттерн правила `task-flow`. Что при этом должно быть верно — закон
+`docs/constitution/work-conduct.md`.
+
+## Когда брать
+
+- Сессия начата на ветке `<КЛЮЧ>-*`, работа в ней уже шла.
+- Работа прерывается — надо оставить её так, чтобы следующий заход поднял без владельца.
+
+## Что уже пришло в контекст
+
+Хук `task-context-load.sh` на запуске сессии отдал замысел и ход работы целиком, а разбор
+просьбы — путём. Перечитывать их файлами не нужно; `grill.md` читается, когда в ходе работы
+всплыло решение, причина которого неясна.
+
+Пришло предупреждение «РАБОТА БЕЗ ПАПКИ ЗАДАЧИ» — работа шла мимо: папка собирается с
+образца, а `progress.md` заполняется по тому, что видно в дереве и в истории ветки, а не по
+расспросам владельца.
+
+## Чего не делать
+
+- **Не спрашивать владельца о том, что записано.** Ради этого всё и заведено.
+- **Не начинать заново то, что отмечено сделанным.** Отметка стоит в ходе работы; сомнение в
+  ней проверяется деревом — сборкой, тестами, чтением файла, — а не вопросом.
+- **Не править замысел.** С ним сверяют результат; пересмотр идёт записью в ходе работы.
+
+## Первое действие захода
+
+Сверить «Где стоим» с деревом. Запись описывает день, когда её сделали:
+
+```bash
+git status --short
+git log --oneline origin/main..HEAD
+```
+
+Разошлось — «Где стоим» правится сразу, до работы: следующий заход поверит записи, а не
+дереву.
+
+## Как ведётся ход работы
+
+Раздел «Где стоим» **перезаписывается**, а не дописывается — это первое, что читает следующий
+заход, и единственное, что переживает обрезку по объёму:
+
+```markdown
+## Где стоим
+
+- **Этап:** 3 из 6 — гард и хук запуска
+- **Сделано:** закон заведён, папка задачи и образец написаны
+- **Следующий шаг:** сценарии обоих хуков, затем подключение в настройках
+- **Незакоммиченное:** всё, ветка пока без коммитов
+- **Ждём владельца:** нет
+```
+
+Решение, принятое по ходу, — вместе с причиной и с тем, что было альтернативой:
+
+```markdown
+- **2026-08-07. Гард судит по путям правки, а не по замыслу задачи.** Оценку «меняет ли
+  поведение» назначал бы тот, кому она мешает. Альтернатива — строка в замысле — отвергнута.
+```
+
+Пересмотр этапа — туда же, а не правкой замысла:
+
+```markdown
+- **2026-08-07. Этап 4 заменён: роли заводятся обе, а не одна.** Владелец решил при разборе;
+  прежний этап в замысле оставлен видимым.
+```
+
+Запись захода отмечает сделанное и то, чем это подтверждено:
+
+```markdown
+### 2026-08-07
+
+- 28 сценариев в наборе, `bash .claude/hooks/tests/run.sh` — все наборы зелёные.
+- Доэтапное, не этой работы: сверка очереди перечисляет шесть закрытых задач вне борды.
+```
+
+## Ловушки
+
+- **Заход, кончившийся ничем, тоже записывается.** Иначе следующий пойдёт той же дорогой:
+  «пробовали так — не вышло, потому что» стоит одной строки и экономит целый заход.
+- **Незакоммиченное называется явно.** Работа живёт в дереве неделями; строка «что лежит
+  несохранённым и почему» — единственное, по чему это видно, пока отчёта нет.
+- **Подтверждение — вывод команды или замер, а не пересказ.** «Проверил, работает» через
+  заход неотличимо от «казалось, что работает».
+- **Доэтапное отделяется от своего.** Красное, найденное по дороге и не этой работой
+  сделанное, помечается таковым сразу: иначе следующий заход примет его за свою поломку.

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

@@ -0,0 +1,129 @@
+---
+name: task-flow-start
+kind: pattern
+rule: task-flow
+description: Паттерн правила task-flow. Брать в начале работы от владельца — готовый порядок: разведка до первого вопроса, шесть обязательных вопросов, договорённость о продукте, конвейер ролей, заведение задачи и ветки, сборка папки задачи. Не брать для возвращения к незаконченной работе — это паттерн task-flow-resume.
+---
+
+# Начало работы
+
+Паттерн правила `task-flow`. Что при этом должно быть верно — закон
+`docs/constitution/work-conduct.md`.
+
+## Когда брать
+
+- Владелец просит что-то сделать, и работы больше, чем на одну реплику.
+- Замеченный по ходу дефект становится задачей.
+
+## Порядок
+
+### 1. Разведка — до первого вопроса
+
+Вопрос, ответ на который лежит в коде, владельцу не задаётся: он обесценивает и остальные.
+
+```
+Agent(subagent_type: "Explore", prompt: "<тема просьбы>: что по ней уже есть в дереве —
+  какие спеки описывают, какие законы и правила задевает, какие либы затронуты,
+  есть ли готовый образец рядом. Верни находки, а не пересказ файлов.")
+```
+
+Находки складываются в раздел «Что уже есть в дереве» разбора.
+
+### 2. Разбор с владельцем
+
+Ведёт главный агент: субагент до владельца не достучится. Команда — `/grill-me`, один вопрос
+за раз, к каждому — свой рекомендуемый ответ с доводом.
+
+Шесть вопросов задаются всегда, даже когда задача кажется понятной:
+
+| Вопрос                                       | Зачем                                                    |
+| -------------------------------------------- | -------------------------------------------------------- |
+| Меняет ли задача поведение приложения        | от этого зависит договорённость о продукте               |
+| Требует ли правки закона или правила         | закон без ведома владельца не правится                   |
+| Одна задача или несколько                    | делится то, что откатывается порознь, и делится ДО ветки |
+| Что в задачу не входит                       | не названная вслух граница не существует                 |
+| Чем будет видно, что задача закрыта          | «работает» признаком не является                         |
+| Есть ли образец, с которого снимается подход | разведка найдёт похожее, а не то                         |
+
+Форму вопроса задают настройки владельца: где они требуют меню, спрашивается меню, и тогда к
+каждому вопросу добавляется свободный вариант — у закрытого набора нет строки «вопрос не тот».
+Выбор слова, имени и термина уточняется прозой в любом случае.
+
+Ответы пишутся в `docs/tasks/_draft-<slug>/grill.md` — папка ещё черновик, номера нет.
+
+```bash
+mkdir -p docs/tasks/_draft-<slug>
+cp docs/tasks/_template/grill.md docs/tasks/_draft-<slug>/grill.md
+```
+
+### 3. Конвейер после разбора
+
+Вопросов больше не будет — дальше роли:
+
+```
+Workflow(name: "plan", args: "docs/tasks/_draft-<slug>")
+```
+
+Нужность → договорённость о продукте (`spec-writer`) → её состязательный разбор
+(`spec-critic`) → замысел и разбивка (`project-manager`). Пробелы, которые роли не смогли
+закрыть, возвращаются владельцу — их относит главный агент.
+
+Договорённость, вышедшая из конвейера, сверяется с `grill.md` построчно до того, как по ней
+пойдёт работа. Роль пишет текст, не видя владельца, и способна развернуть его ответ в
+противоположный: очередь этапов оказалась перевёрнута, а два пункта из входящих переехали в
+«не входит». Находка критика, расходящаяся с ответом владельца, относится владельцу — она не
+исполняется молча и не считается закрытой правкой текста.
+
+### 4. Задача, ветка, папка
+
+```bash
+npm run task:new -- --title '<Что не так>' --slug <slug> --label documentation --label area:tooling < тело.md
+git checkout -b <КЛЮЧ>-<номер>-<slug>
+npm run task:move -- <номер> in-progress
+```
+
+`task:new` переименовывает `_draft-<slug>` в `<КЛЮЧ>-<номер>-<slug>` и проставляет шапку замысла.
+Ветка заводится вторым вызовом: составную «завести и сразу коммитить» гард главной ветки
+отклоняет целиком.
+
+Остальные два файла — с образца:
+
+```bash
+cp docs/tasks/_template/plan.md docs/tasks/<КЛЮЧ>-<номер>-<slug>/plan.md
+cp docs/tasks/_template/progress.md docs/tasks/<КЛЮЧ>-<номер>-<slug>/progress.md
+```
+
+### 5. Шапка замысла
+
+Её читает гард:
+
+```markdown
+**Задача:** <КЛЮЧ>-282 · **Ветка:** <КЛЮЧ>-282-task-flow
+**Драфт:** `docs/specs/bookings/proposed/aside-header/`
+**Поведение:** меняется
+```
+
+Работа, не задевающая `apps/**` и `libs/**`, договорённости не требует:
+
+```markdown
+**Поведение:** не меняется — переезд слоя, снаружи не видно. Подтверждено владельцем.
+```
+
+Пустая причина не принимается.
+
+## Ловушки
+
+- **Номер не бывает первым.** До конца разбора неизвестно даже, сколько задач из него выйдет:
+  заведённая заранее задача после разбивки закрывается и остаётся мусором в очереди работ.
+- **Разбор пишется на диск сразу, а не копится в переписке.** Сессия обрывается, и разбор,
+  прожитый в разговоре, восстанавливается только пересказом владельца.
+- **Из одного разбора вышло несколько задач — общее уезжает в `docs/plans/<линия>.md`.**
+  Папка задачи умирает с мержем, а порядок задач и зависимости между ними должны его
+  пережить.
+- **Задача заводится командой, а не четырьмя вызовами подряд.** Борда к репозиторию не
+  привязана, и задача попадает на неё только явным добавлением.
+- **Slug ветки берётся из терминологии договорённости, а не из слов просьбы.** Договорённость
+  пишется раньше ветки и как раз там отказывается от слова владельца: спек завёл своё имя
+  предмету и прямо сказал, каким словом его не называть, — а ветка и папка задачи остались с
+  отвергнутым. Заголовок задачи и отчёта поправить можно, имя ветки после открытия отчёта —
+  уже нет.