@rt-tools/agent-kit 0.2.0 → 0.4.0

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,117 @@
+---
+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`). Пробелы, которые роли не смогли
+закрыть, возвращаются владельцу — их относит главный агент.
+
+### 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`.**
+  Папка задачи умирает с мержем, а порядок задач и зависимости между ними должны его
+  пережить.
+- **Задача заводится командой, а не четырьмя вызовами подряд.** Борда к репозиторию не
+  привязана, и задача попадает на неё только явным добавлением.

package/assets/patterns/testing-e2e.md

@@ -0,0 +1,92 @@
+---
+name: testing-e2e
+kind: pattern
+rule: testing
+description: Паттерн правила testing. Брать при правке и прогоне сквозных спек в apps/site-e2e и apps/admin-e2e — что закрывается сквозной спекой, готовые команды прогона, стенд из прод-сборки под настоящим nginx, выключатели спек. Не брать для юнитов — это паттерн testing-unit.
+---
+
+# Сквозные спеки
+
+Паттерн правила `testing`. Что при этом должно быть верно — закон
+`docs/constitution/verifiability.md`.
+
+## Когда брать
+
+- Пишется или правится спека в `apps/site-e2e/src` или `apps/admin-e2e/src`.
+- Надо воспроизвести дефект, который виден только на прод-конфигурации.
+- Готовится стенд под прогон против nginx.
+
+## Сквозной спекой закрывается накопленное состояние
+
+Случай для неё — тот, где состояние копится нажатиями: открытая панель, активный маршрут,
+гард прошлого экрана. Всё, что проверяется одним заходом по адресу, дешевле закрыть юнитом на
+чистой функции или замером экрана.
+
+Отсюда и способ: нажатия по тем же элементам, что нажимает владелец, несколько подряд, без
+перезагрузки между ними. Заход по прямому адресу поднимает приложение заново, накопленного
+состояния у него нет, и проход читается как «дефект не подтверждается» — так на прод уехала
+панель, застревавшая в адресе при уходе в соседний раздел.
+
+Элементы находятся по `qa-dataid`: классы меняются вместе с вёрсткой, а поиск по роли и тексту
+ломается на переводах.
+
+## Прогон
+
+```bash
+npx nx e2e site-e2e -- --project=chromium
+npx nx e2e admin-e2e -- --project=chromium
+BASE_URL=http://localhost:{{dockerSitePort}} npx nx e2e site-e2e -- --project=chromium   # против внешнего стенда
+```
+
+По умолчанию конфиг идёт на {{sitePort}} и подхватывает уже поднятый сервер. С `BASE_URL` свой сервер
+не стартует вовсе.
+
+Полный набор админки гоняется **одним воркером** (`--workers=1`): тесты с настоящей сессией
+правят одни и те же объекты живой базы и в параллельном прогоне мешают друг другу. Одни и те
+же файлы дали три падения на восьми воркерах и ноль на одном.
+
+## Стенд из прод-сборки под настоящим nginx
+
+Как его поднять — паттерн `browser-verification-stand`; там же сказано, почему главный конфиг
+монтируется отдельной строкой и почему каталогом, а не файлом. Здесь важно одно: против такого
+стенда прогон идёт с `BASE_URL`, и вместе с ним включаются проверки перенаправлений локалей.
+
+## Выключатели
+
+```typescript
+const ALLOW_RENAME: boolean = process.env['E2E_ALLOW_SLUG_RENAME'] === '1';
+test.skip(!ALLOW_RENAME, 'меняет живой адрес объекта: включается E2E_ALLOW_SLUG_RENAME=1');
+```
+
+- Спека, необратимо меняющая данные стенда, по умолчанию пропускается и включается своей
+  переменной.
+- `BEHIND_NGINX` в `home.smoke.spec.ts` — это `!!process.env['BASE_URL']`: вместе с ним
+  просыпаются проверки перенаправлений локалей. Голый сервер отдачи страниц их не проходит, и
+  два падения выглядят регрессией.
+- `HAS_ADMIN_SESSION` в `sign-in.ts` — пара `E2E_ADMIN_EMAIL` и `E2E_ADMIN_PASSWORD`.
+- `playwright/no-skipped-test` выключен в `eslint.config.mjs`: выключатель теста здесь —
+  приём, а не забытый `test.skip`.
+
+## Частые промахи
+
+- **Порт {{ssrPort}} занимать осторожно:** стенд разработчика на {{sitePort}} ходит по тому же имени
+  `ssr:{{ssrPort}}` через `host-gateway`, и пока на нём висит чужой процесс, стенд отдаёт чужую
+  сборку.
+- Браузер стоит один — chromium; узкий экран — `--project=mobile-chrome`. Ошибка «Executable
+  doesn't exist» разобрана в правиле `testing`: она же приходит после смены версии Playwright.
+- Спеки админки без сессии пропускаются молча — прогон выглядит успешным, а проверено меньше
+  половины.
+- Конфиг nginx монтируется каталогом, а не одиночным файлом: редактор пересоздаёт файл, и
+  контейнеру остаётся обрезанная копия.
+- **Подменяется не только то, что запрашивает экран, но и то, что запрашивает шапка.** Счётчик
+  непрочитанного запрашивается на каждом экране под шапкой. Без подмены на этот запрос
+  отвечает настоящий сервер, поддельный вход он отбивает, интерцептор сбрасывает сессию, и
+  пятьдесят девять тестов падают на пропавшей шапке — выглядит это дефектом экрана.
+- **Состояние, которое живёт только во время операции, тестом не проверяется.** Список заливки
+  под кнопкой виден, пока файлы летят: на подменённых ответах они долетают раньше, чем тест
+  успевает его прочитать, и тест краснеет через раз. Проверяют либо конечное состояние
+  (`data-state` строки стал `done`), либо то же промежуточное — но на ответе, который тест сам
+  задержал и сам отпускает.
+- **Каталог сборки, удалённый под смонтированным томом, оставляет контейнер с пустым
+  корнем:** стенд отвечает 403 на всё, и падают сразу все тесты. Контейнер после
+  `rm -rf dist/apps/<приложение>` пересоздаётся.

package/assets/patterns/testing-unit.md

@@ -0,0 +1,117 @@
+---
+name: testing-unit
+kind: pattern
+rule: testing
+description: Паттерн правила testing. Брать при заведении или правке *.spec.ts под Vitest — готовая раскладка describe и it, сборщик фикстур, идентификатор сценария в заголовке, спека процедуры Connect с рукописным двойником базы. Не брать для сквозных спек — это паттерн testing-e2e.
+---
+
+# Спека на чистую функцию и на процедуру
+
+Паттерн правила `testing`. Что при этом должно быть верно — закон
+`docs/constitution/verifiability.md`.
+
+## Когда брать
+
+- Заводится или правится `*.spec.ts` рядом с исходником.
+- Логику надо вынести из компонента или сервиса, чтобы её стало чем проверить.
+- Пишется спека на процедуру Connect.
+
+## Импорты явные
+
+`globals: true` в конфиге стоит, но список всё равно пишется:
+
+```typescript
+import { describe, expect, it } from 'vitest';
+```
+
+## Один `describe` на функцию
+
+Имя блока совпадает с именем функции дословно; заголовки `it` — предложения по-русски,
+настоящим временем, о поведении, а не об устройстве:
+
+```typescript
+describe('applyDayClick', () => {
+    it('SC-BK-19 — клик по занятому дню ничего не меняет', () => {
+        expect(applyDayClick(day('2026-08-12'), selection)).toEqual(selection);
+    });
+});
+```
+
+Идентификатор сценария из `docs/specs/<домен>/scenarios.md` стоит в начале заголовка, через
+тире. Краевые случаи — отдельные `it` в том же блоке, а не один тест с десятком проверок.
+
+## Фикстура собирается функцией с `Partial<T>`
+
+Не повторяющимся литералом:
+
+```typescript
+function day(iso: string, overrides: Partial<ICalendarDay> = {}): ICalendarDay {
+    return {
+        iso,
+        dayOfMonth: Number(iso.slice(8)),
+        priceThb: 6000,
+        busyNight: isNightBusy(iso, BUSY),
+        past: false,
+        ...overrides,
+    };
+}
+```
+
+Общие константы (`PRICING`, `BUSY`) лежат наверху файла, в области модуля.
+
+## Решение выносится в чистую функцию
+
+Господствующая форма в этом дереве: логика уезжает в `*.logic.ts`, `*.util.ts` или
+`*.calculator.ts`, и проверяется вызовом — без `TestBed`, без подмены зависимостей. Образцы —
+`libs/site/common/booking/util/src/lib/availability-calendar.logic.ts` и
+`libs/api/<домен расчёта>/util/src/lib/quote.calculator.ts`.
+
+## Процедура зовётся напрямую
+
+Обработчик — метод `handle` класса процедуры в слое `feature` своего домена. Двойник базы
+пишется руками; образец — `FakePrismaClient` в
+`libs/api/<домен заявок>/feature/src/lib/link-booking.procedure.spec.ts`:
+
+```typescript
+const prisma: FakePrismaClient = new FakePrismaClient();
+await procedureWith(prisma, emitter).handle(request());
+```
+
+Проверяются порядок действий, откат при отказе половины, идемпотентность повтора и то, что
+именно ушло в базу. Раскладку полей стерегут тесты слоя `api`, и здесь она не повторяется.
+
+## Разовый тест-доказательство
+
+Дефект, который иначе подтверждается только чтением кода, доказывается тестом, написанным на
+время разбора: он поднимает настоящую процедуру, подменяет её единственный выход наружу и
+считает походы.
+
+```typescript
+globalThis.fetch = (): Promise<Response> => Promise.resolve(Response.json({ success: false }));
+```
+
+Число до правки и число после — единственная форма ответа, которую такая проверка даёт: «сто
+походов из ста» и «двадцать из ста» различимы, а «код выглядит правильным» — нет.
+
+Второй способ снять «до» — вернуть на место версию файла из точки расхождения ветки и
+прогнать тест ветки: падение теста и есть воспроизведение дефекта. Файл после этого
+восстанавливается копией, и восстановление проверяется прогоном того же теста, а не памятью.
+
+Двойники соседей не выдумываются: рабочий набор берётся из теста соседней процедуры того же
+домена. Двойник, собранный по типу, падает не на утверждении, а на вызове метода, которого у
+него нет.
+
+**Такой файл не коммитится.** Он живёт до конца разбора и удаляется вместе с ним; проверка,
+которую стоит оставить, переписывается в обычный `*.spec.ts` с идентификатором сценария в
+заголовке и едет в ветке. Признак временного файла — его заголовок не называет ни одного
+сценария.
+
+## Частые промахи
+
+- Либа без своего `vitest.config.mts`: `nx test <проект>` пройдёт зелёным, не запустив ни
+  одного файла. Прежде чем писать первый тест в либе, проверить, что конфиг рядом есть.
+- Подмена модуля (`vi.mock`) скрыла бы то, ради чего тест и заводится, — какой именно вызов
+  ушёл в базу и в каком порядке. Двойник пишется руками.
+- Своих помощников для проверок не заводить: `expect(...).toBe(...)` и `.toEqual(...)` прямо.
+- Заголовок с несуществующим идентификатором сценария роняет `npm run check:specs`, а сами
+  тесты при этом остаются зелёными.

package/assets/patterns/translations-key.md

@@ -0,0 +1,64 @@
+---
+name: translations-key
+kind: pattern
+rule: translations
+description: Паттерн правила translations. Брать, когда в интерфейсе появляется видимый текст — куда положить ключ, как подставить его в разметку и в класс, чем дозаполнить остальные семь локалей и чем проверить полноту. Не брать для перевода контента объекта — его заполняет бэкенд.
+---
+
+# Ключ перевода
+
+Паттерн правила `translations`. Что при этом должно быть верно — закон
+`docs/constitution/application/locales.md`.
+
+## Когда брать
+
+- В интерфейсе появляется любой текст, который видит человек.
+- Правится подпись, пустое состояние, текст отказа, подпись кнопки подтверждения.
+
+## Куда кладётся ключ
+
+`libs/common/i18n/src/lib/dictionaries/<локаль>/<раздел>.json`. Разделов четыре, и наборы
+ключей сверяются внутри раздела:
+
+| Раздел        | Что в нём                   |
+| ------------- | --------------------------- |
+| `common.json` | общее для сайта и админки   |
+| `site.json`   | публичный сайт              |
+| `admin.json`  | админ-панель                |
+| `mail.json`   | письма и документ-основание |
+
+Локалей восемь: `en`, `ru`, `de`, `zh-Hans`, `zh-Hant`, `ko`, `th`, `hi`. Ключ заводится во
+всех — пустое значение считается пропуском, а не переводом.
+
+## Подстановка
+
+В разметке — пайпом:
+
+```html
+<h1 rtElem="title">{{ 'bookingsTitle' | transloco }}</h1>
+<<префикс>-table [emptyMessage]="'bookingsEmpty' | transloco" [ariaLabel]="'bookingsTableAria' | transloco">
+```
+
+В классе — сигналом:
+
+```typescript
+protected readonly title: Signal<string> = translateSignal('promoCodesTitle');
+```
+
+## Дозаполнить и проверить
+
+```bash
+npm run i18n:fill        # дозаполняет недостающее в остальных локалях
+npx nx test common-i18n  # роняет сборку на недостающем или пустом ключе
+```
+
+## Частые промахи
+
+- Текст строкой прямо в шаблоне: он уедет в интерфейс по-английски во всех локалях перевода.
+- Ключ заведён только в `en` и `ru`: тест полноты падает, но замечают это уже в гейте пуша.
+- Пустая строка вместо перевода: на экране она выглядит как задуманная — кнопка без подписи,
+  заголовок без текста.
+- Ключ положен не в свой раздел: наборы сверяются внутри раздела, и расхождение вылезет как
+  недостача в другом.
+- Свой ключ успеха у панели правки записи: текст успеха принадлежит мутации, и заводится он во
+  всех локалях перевода сразу.

package/assets/patterns/ts-procedure.md

@@ -0,0 +1,65 @@
+---
+name: ts-procedure
+kind: pattern
+rule: typescript-conventions
+description: Паттерн правила typescript-conventions. Брать при заведении или правке процедуры Connect на бэкенде — готовый класс с полем method и методом handle, зависимости конструктором, имя файла и класса, почему форма именно такая. Не брать для объявления доступа к процедуре — это паттерн permissions-procedure.
+---
+
+# Процедура Connect
+
+Паттерн правила `typescript-conventions`. Что при этом должно быть верно — закон
+`docs/constitution/code-structure.md`.
+
+## Когда брать
+
+- Заводится новая процедура бэкенда.
+- Правится тело существующей.
+- Домен переезжает на вертикальную нарезку.
+
+## Одна процедура — один класс
+
+Файл `<процедура>.procedure.ts` в слое `feature` своего домена, класс `<Процедура>Procedure`,
+публичное поле `method` с дескриптором из контракта и публичный метод `handle` с телом.
+Зависимости приходят конструктором — на бэкенде DI нестовский, `inject()` там нет.
+
+```typescript
+@Injectable()
+@ConnectProcedure()
+@RequiresPermission('bookings:manage')
+export class PingProcedure implements IConnectProcedure<typeof HealthService.method.ping> {
+    readonly #health: HealthCheckService;
+
+    public readonly method: typeof HealthService.method.ping = HealthService.method.ping;
+
+    constructor(health: HealthCheckService) {
+        this.#health = health;
+    }
+
+    public async handle(): Promise<{ status: EHealthStatus }> {
+        return { status: (await this.#health.check()).status };
+    }
+}
+```
+
+Объявление доступа обязательно, и оно ровно одно — паттерн `permissions-procedure`.
+
+## Почему форма такая
+
+Прежняя — `register(router)` с телами в замыканиях внутри `router.service(...)` — делала
+обработчик недостижимым для спеки: наружу торчал только класс с методом `register`. А
+`router.service` заглушает каждый непереданный метод ответом `Unimplemented`, поэтому один
+proto-сервис не мог обслуживаться двумя доменами.
+
+Класс решает и то, и другое: `handle` зовётся спекой напрямую, а реестр кладёт процедуры
+поштучно через `router.rpc`.
+
+## Частые промахи
+
+- Третий суффикс: `*.rpc.ts` и `*.connect.ts` — прежние имена, они уходят вместе с последним
+  переехавшим доменом, и новых таких файлов не заводится.
+- `inject()` в классе процедуры: на бэкенде зависимости идут конструктором.
+- Тело в замыкании внутри регистрации роутера: спека до него не дотянется.
+- Процедура без объявления доступа: приложение не поднимется.
+- Приведение `as` в переводе моделей: на бэкенде оно запрещено так же, как в маппере фронта.
+- Свой тип у результата `groupBy` Prisma: он условный, собирается из аргументов вызова и с
+  выписанным руками не сходится. Там, где ключей единицы, идёт `count` на ключ в `Promise.all`.

package/assets/rules/angular-patterns.md

@@ -0,0 +1,71 @@
+---
+name: angular-patterns
+kind: rule
+law: frontend-application
+description: Правило под «Закон о фронтовом приложении». Брать при правке любого класса Angular — компонента, стора админки, сервиса, директивы, пайпа, гарда, интерцептора. Называет сигнальный API входов, OnPush, zoneless, inject и место, где живёт подписка. Не действует под libs/api и apps/api. Готовый код — в паттерне angular-patterns-state.
+---
+
+# Реактивность экрана — как это устроено здесь
+
+Правило под закон `docs/constitution/frontend-application.md`. Закон говорит, что должно быть
+верно; здесь — на чём это стоит в этом дереве. Раскладка файла компонента —
+`component-structure`, стили — `styling-bem`, окружение браузера — `platform-access`, слой
+обращения к серверу — `api-layer`. Все пять под одним законом.
+
+Правило про фронт: `libs/api/**` и `apps/api/**` — это NestJS, там своя среда, и ничего из
+перечисленного не применяется.
+
+## Как это называется здесь
+
+| В законе                                | Здесь                                                                                              |
+| --------------------------------------- | -------------------------------------------------------------------------------------------------- |
+| состояние, которое пересчитывается само | `signal()` и `computed()`; Angular без Zone.js (`provideZonelessChangeDetection()`)                |
+| вход и выход компонента                 | `input()`, `input.required()`, `output()`; `viewChild()`, `contentChild()` и их множественные пары |
+| перерисовка по требованию               | `ChangeDetectionStrategy.OnPush` — на каждом компоненте                                            |
+| владелец подписки                       | `takeUntilDestroyed(this.#destroyRef)`                                                             |
+| источник действия                       | `Subject` с суффиксом `Source` в имени поля                                                        |
+
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
+
+- **Подписка объявляется один раз, а не в методе действия.** Метод толкает значение в
+  источник, а долгоживущая подписка со `switchMap`, `exhaustMap` или `concatMap` объявляется в
+  конструкторе, в `ngOnInit` или в инициализаторе поля.
+- **Подписка гасится вместе с владельцем.** `takeUntilDestroyed` ставится в тот же поток, где
+  объявлена подписка.
+- **Источник действия носит суффикс `Source` в имени.** Иначе поток и значение в коде
+  неотличимы, и `next` уходит не туда.
+- **Списочный стор наследует общую основу.** Записи, страница, порядок, условия отбора, строка
+  поиска и конфиг выборки уже там, и наследнику остаются четыре строки.
+
+## Чего из закона здесь нет
+
+Ни `OnPush`, ни сигнальный API входов, ни отсутствие геттеров в компонентах не проверяет
+ничто: `@Input()` и геттер компилируются и работают, а расхождение видно только чтением.
+Обращение к окружению браузера тоже не проверяется — это `Q-FA-1` в законе.
+
+## Паттерны
+
+- `angular-patterns-state` — сигналы, производные значения, состояние сервиса, подписка.
+
+## Ловушки
+
+- **Производное значение считается `computed`, а не эффектом.** `effect`, кладущий значение в
+  сигнал, — это ручной пересчёт, и он рано или поздно отстаёт от источника.
+- **Геттеров в компонентах нет.** Геттер пересчитывается на каждой перерисовке, и цена его не
+  видна ни в одном месте кода.
+- **Подписка на каждый вызов метода не даёт выбрать, что делать с предыдущим запросом.**
+  Быстрые нажатия дают гонку ответов, и побеждает тот, что вернулся последним, а не тот, что
+  нажали последним.
+- Запрет подписки в методе идёт по имени `subscribe`, а не по типу: вызов с таким именем у
+  чего угодно считается подпиской, а `const fn = stream$.subscribe` без вызова — нет.
+  Разрешены конструктор, `ngOnInit`, инициализатор поля и всё, что объявлено вне класса;
+  запрещены остальные методы, включая приватные с `#`, геттеры и `ngAfterViewInit`.
+- Инициализация DOM после первой отрисовки — `afterNextRender()`, а не `ngAfterViewInit`:
+  сайт отдаётся сервером, и DOM там появляется позже.
+- `viewChild` на поле с `#` Angular не принимает — поле объявляется `protected`.