@rt-tools/agent-kit 0.3.0 → 0.4.0

package/assets/patterns/seo-verify.md

@@ -2,63 +2,82 @@
 name: seo-verify
 kind: pattern
 rule: seo
-description: Паттерн правила seo. Брать после любой правки, задевающей публичную разметку, теги головы документа или маршруты — сборка, поднятие сервера отдачи страниц, проверка отданной разметки по всем локалям, карта сайта, кэшируемость перенаправления. Не брать для самой правки разметки — это паттерн seo-page.
+description: Паттерн правила seo. Брать после любой правки, задевающей разметку публичного сайта, meta или маршруты — готовые команды сборки, поднятия SSR и проверки отданного HTML по локалям, карты сайта и кэшируемости перенаправления. Не брать для самой правки разметки — это паттерн seo-page.
 ---
 
 # Проверка разметки на прод-сборке
 
-Паттерн правила `seo`. Что при этом должно быть верно — закон `{{lawsDir}}/search-visibility.md`.
+Паттерн правила `seo`. Что при этом должно быть верно — закон
+`docs/constitution/application/search-visibility.md`.
 
 ## Когда брать
 
-После любой правки, задевающей публичную разметку, теги головы документа, маршруты, серверную
-точку входа, правила обхода или конфиг прокси.
+После любой правки, задевающей разметку сайта, `meta`, маршруты, `server.ts`, `robots.txt`
+или `deploy/nginx.conf`.
 
-## Сервер разработки здесь не показатель
+## Дев-сервер здесь не показатель
 
-Теги ставятся при отдаче страницы сервером. В режиме разработки этот путь другой, поэтому
-проверка идёт на собранном приложении с поднятым сервером отдачи страниц.
+Теги ставятся при отдаче страницы сервером. В дев-режиме этот путь другой, поэтому проверка
+идёт на собранном приложении с поднятым SSR.
 
-Сервер отдачи страниц отвечает отказом на чужое имя хоста — запросы идут с явным заголовком
-хоста.
+```bash
+npx nx build site
+PORT={{prodSitePort}} node dist/apps/site/server/server.mjs &
+```
+
+Порт {{prodSitePort}} — тот же, что берёт стенд; дев-серверы владельца на {{sitePort}} и {{adminPort}} при этом не
+трогаются. Angular SSR отвечает `400` на чужой `Host`, поэтому запросы идут с
+`-H "Host: localhost"`.
 
-## Что смотреть в отданной разметке
+## Что смотреть в отданном HTML
 
 ```bash
-for locale in "" <остальные локали>; do
-    printf '%-10s ' "${locale:-<по умолчанию>}"
-    curl -s -H "Host: localhost" "http://localhost:<порт>/${locale}<путь>" \
+for locale in "" ru/ de/ zh-Hans/ zh-Hant/ ko/ th/ hi/; do
+    printf '%-10s ' "${locale:-en}"
+    curl -s -H "Host: localhost" "http://localhost:{{prodSitePort}}/${locale}<адрес страницы>" \
         | grep -c -E '<title>|name="description"|property="og:|rel="canonical"|hreflang=|application/ld\+json'
 done
 ```
 
-В ответе каждой локали должны быть заголовок, описание, набор тегов соцсетей, канонический
-адрес, полный набор языковых ссылок вместе со ссылкой по умолчанию и блок структурированных
-данных.
+В ответе каждой локали должны быть `<title>`, `description`, набор `og:*`, `canonical`,
+полный набор `hreflang` плюс `x-default` и блок `application/ld+json`.
 
-Отдельно проверяется, что канонический адрес ведёт на **свой** язык, а не на локаль по
-умолчанию.
+Отдельно проверяется, что `canonical` ведёт на **свой** язык, а не на локаль по умолчанию:
+
+```bash
+curl -s -H "Host: localhost" http://localhost:{{prodSitePort}}/de/<адрес страницы> \
+    | grep -o 'rel="canonical" href="[^"]*"'
+```
 
 ## Карта сайта
 
-Карта строится из живых данных, а не из файла. Пустой ответ означает, что не поднялся запрос за
-записями, — это отказ, а не «записей нет».
+```bash
+curl -s -H "Host: localhost" http://localhost:{{prodSitePort}}/sitemap.xml | head -20
+```
+
+Карта строится из живых данных, а не из файла. Пустой ответ означает, что не поднялся запрос
+за объектами, — это отказ, а не «объектов нет».
 
 ## Кэшируемость перенаправления
 
-Проверяется только на стенде с настоящим конфигом прокси: голый сервер отдачи страниц отдаёт
-заголовки, но не показывает, попадёт ли ответ в кэш.
+Проверяется только на стенде с настоящим `deploy/nginx.conf`: голый SSR отдаёт заголовки, но
+не показывает, попадёт ли ответ в кэш.
 
 ```bash
-curl -sI http://<стенд>/<прежний адрес> | grep -i -E 'HTTP/|location|cache-control|x-cache'
+curl -sI http://<стенд>/<прежний-slug> | grep -i -E 'HTTP/|location|cache-control|x-cache'
 ```
 
-Ответ обязан быть постоянным перенаправлением, нести срок жизни и попадать в кэш.
+Ответ обязан быть `301`, нести `Cache-Control` со сроком и попадать в кэш. Некэшируемое
+перенаправление не вытесняет старую запись, и гость видит прежнюю страницу до суток.
+
+## Тексты
+
+`title` и `description` берутся из словарей во всех локалях перевода. Непереведённый ключ уезжает
+в выдачу по-английски — полноту словарей держит `npx nx test common-i18n`.
 
 ## Частые промахи
 
-- **Проверка на сервере разработки:** теги ставит другой путь, и результат ничего не говорит о
-  проде.
-- **Проверена одна локаль:** ветка маршрутов, забытая для остальных, отдаёт отказ и поисковику,
-  и читателю.
-- **Заголовки смотрели на голом сервере:** кэш и перенаправления живут в прокси.
+- Проверка в дев-сервере: разметку там ставит другой путь, и отсутствие тега не видно.
+- Проверка одной локали: расходится обычно та, которую не смотрели.
+- Проверка кэша без nginx: заголовки видны, попадание в кэш — нет.
+- Вывод по коду ответа: `200` приходит и со страницы без разметки.

package/assets/patterns/shared-code-new.md

@@ -2,29 +2,30 @@
 name: shared-code-new
 kind: pattern
 rule: shared-code
-description: Паттерн правила shared-code. Брать, когда заводится новое число-настройка, общая функция или общий тип, который должны одинаково понимать все приложения — куда класть, как объявить, как сверить строку с набором и как убедиться, что копия не осталась на старом месте.
+description: Паттерн правила shared-code. Брать, когда заводится новое число-настройка, общая функция или общий тип, который должны одинаково понимать сайт, админка и бэкенд — куда класть, как объявить, как сверить строку с набором и как убедиться, что копия не осталась на старом месте.
 ---
 
 # Новое общее заводится так
 
-Паттерн правила `shared-code`. Что при этом должно быть верно — закон `{{lawsDir}}/shared-code.md`.
+Паттерн правила `shared-code`. Что при этом должно быть верно — закон
+`docs/constitution/shared-code.md`.
 
 ## Когда брать
 
 - Появилось число-настройка: предел, размер, длительность.
-- Появилась функция без каркаса, нужная обеим сторонам.
+- Появилась функция без фреймворка, нужная обеим сторонам.
 - Значение приходит строкой и должно быть сверено с конечным набором.
 
 ## Куда класть
 
-| Что                                          | Куда                                        |
-| -------------------------------------------- | ------------------------------------------- |
-| число или функция без каркаса                | общая либа утилит, файл по предмету         |
-| готовый тип или набор значений               | берётся из общего пакета, не переписывается |
-| токен внедрения, общий двум фронтовым семьям | либа платформы                              |
+| Что                                   | Куда                                            |
+| ------------------------------------- | ----------------------------------------------- |
+| число или функция без фреймворка      | `libs/common/util`, файл по предмету            |
+| готовый тип или набор значений        | берётся из `@rt-tools/utils`, не переписывается |
+| токен DI, общий двум фронтовым семьям | `libs/common/platform`                          |
 
-Файл выбирается по предмету, а не по роду («константы», «функции»): предметный файл читается
-целиком, свалка по роду — никогда. Дальше — строка в барель.
+Файл выбирается по предмету: `const/list.const.ts`, `functions/list-selection.util.ts`.
+Дальше — строка в барель `libs/common/util/src/index.ts`.
 
 ## Число объявляется один раз и без довода
 
@@ -33,48 +34,53 @@ export const DEFAULT_PAGE_SIZE: number = 20;
 ```
 
 ```typescript
-✗ export function listPageOf(query: IListQuery | undefined, defaultPageSize: number): IListPage
-✓ export function listPageOf(query: IListQuery | undefined): IListPage
+✗ export function listPageOf(query: ListQuery | undefined, defaultPageSize: number): IListPage
+✓ export function listPageOf(query: ListQuery | undefined): IListPage
 ```
 
-Пока умолчание передаётся доводом, домен вправе назвать своё число — и называет, расходясь с
-соседним на единицу, которую никто не заметит.
+Пока умолчание передаётся доводом, домен вправе назвать своё число — так у промокодов
+появилось `25` против `20` у остальных списков.
 
 ## Строка сверяется с набором, а не приводится к типу
 
-Приведение принимает любую строку. Сверку делает общая функция, а что делать с промахом, решает
-вызывающий:
+Приведение принимает любую строку. Сверку делает общая пара функций, а что делать с промахом,
+решает вызывающий.
 
 ```typescript
-const operator: TFilterOperator | null = listFilterOperatorOf(filter.operatorType);
+const operator: FilterOperatorType | null = listFilterOperatorOf(filter.operatorType);
 if (!operator) {
-    throw new RequestError(`filter operator is required: ${filter.propertyName}`);
+    throw new ConnectError(`filter operator is required: ${filter.propertyName}`, Code.InvalidArgument);
 }
 ```
 
 ```typescript
-const direction: TListSortOrder = listSortOrderOf(rawDirection) ?? LIST_SORT_ORDER_ENUM.ASC;
+const direction: ListSortOrderType = listSortOrderOf(rawDirection) ?? LIST_SORT_ORDER_ENUM.ASC;
 ```
 
-Сервер отбивает запрос, экран берёт умолчание. Общий переводчик здесь не годится: он подал бы
+Сервер отбивает запрос, экран берёт умолчание. Общий маппер здесь не годится: он подал бы
 промах умолчанием, и клиент получил бы отбор, которого не просил.
 
-Помощник приведения типов для этого тоже не годится — значение вне набора он пишет в журнал и
-возвращает строкой.
+`typeCast.getAsType` для этого тоже не годится — значение вне набора он пишет в консоль и
+возвращает строкой `'unknown'`.
 
 ## Проверить, что копия не осталась
 
-Проверка повторов падает на четырёх признаках: одно имя из двух либ, два перечисления с
-одинаковым набором членов, число-настройка под одним именем в двух либах, перечисление,
-повторяющее набор из общего пакета.
+```bash
+npm run check:dupes
+```
+
+Проверка падает на четырёх признаках: одно имя из двух либ, два перечисления с одинаковым
+набором членов, число-настройка под одним именем в двух либах, перечисление, повторяющее набор
+из `@rt-tools/utils`.
 
-Накопленное лежит в списке исключений и отказом не считается. Список только сокращается: новая
-строка в нём означает, что повтор завели уже после проверки.
+Накопленное лежит в `tools/dupes-allowlist.json` под ключом `debt` и отказом не считается.
+Список только сокращается: новая строка в нём означает, что повтор завели уже после проверки.
 
 ## Частые промахи
 
-- Своё перечисление с теми же членами, что уже есть в общем пакете, — копия, даже если имена
-  разошлись.
+- Своё перечисление с теми же членами, что уже есть в `@rt-tools/utils`, — копия, даже если
+  имена разошлись.
 - Умолчание, переданное доводом, — домен назовёт своё число, и разъезд будет молчаливым.
-- Ту же логику, написанную заново под другим именем, проверка не ловит.
-- Строковая настройка и таблица соответствий не учитываются вовсе.
+- Ту же логику, написанную заново под другим именем, проверка не ловит и ловить не будет —
+  такой повтор находит только тот, кто читает правку.
+- Строковая настройка и таблица соответствий не учитываются вовсе — долг `Q-S-2`.

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

@@ -2,48 +2,54 @@
 name: spec-driven-domain
 kind: pattern
 rule: spec-driven
-description: Паттерн правила spec-driven. Брать при заведении или правке спека домена — раскладка файлов, обязательные разделы, форма правила и его привязки, форма сценария, порядок работы от спека к коду. Не брать для заведения закона, правила или паттерна — это паттерн spec-driven-rule.
+description: Паттерн правила spec-driven. Брать при заведении или правке спека домена в docs/specs — обязательные разделы, форма сценария, привязка правила к коду, порядок работы от спека к коду. Не брать для заведения закона, правила или паттерна — это паттерн spec-driven-rule.
 ---
 
 # Спек домена
 
 Паттерн правила `spec-driven`. Что при этом должно быть верно — закон
-`{{lawsDir}}/project-documentation.md`.
+`docs/constitution/project-documentation.md`.
 
 ## Когда брать
 
-- Заводится новый домен или фича, которой ещё нет.
-- Правится контракт — спеки задетых доменов едут той же веткой.
+- Заводится новый домен или фича в `proposed/`.
+- Правится `.proto` — спеки задетых доменов едут той же веткой.
 - Замечено расхождение спека с кодом.
 
 ## Раскладка
 
 ```
-<спеки>/<домен>/
+docs/specs/<домен>/
     spec.md              — как домен работает
     implementation.md    — таблица «правило → файл:символ»
     scenarios.md         — сценарии SC-<ПРЕФИКС>-<НОМЕР>
     proposed/<фича>/     — только то, чего ещё нет
 ```
 
+Шаблон — `docs/specs/_template/spec.md`, указатель с префиксами — `docs/specs/README.md`.
+
 ## Обязательные разделы
 
-Набор разделов задан заранее и сверяется дословно: зачем, терминология, правила, что не входит,
-контракт с кодами отказов, данные, экраны и состояния, сквозные требования, решения. «Не
-применимо» — законный ответ, отсутствие раздела — нет: сквозные требования вспоминаются
-постфактум именно тогда, когда для них не заведено места.
+`## Зачем` · `## Терминология` с подразделом `### Как это называется в интерфейсе` ·
+`## Правила` · `## Что не входит` · `## Контракт` с подразделом `### Коды отказов` ·
+`## Данные` · `## Экраны и состояния` · `## Сквозные требования` с четырьмя подразделами
+`### Локали`, `### SEO`, `### Мобильная раскладка`, `### Мультиобъектность` · `## Решения` ·
+`## Открытые вопросы` · `## История изменений`.
+
+Текст заголовка сверяется дословно. «Не применимо» — законный ответ, отсутствие раздела — нет.
 
-Шапка несёт статус, префикс сценариев, зависимости от других доменов, строку с законами,
-которые домен применяет, и строку с корнями либ, чьи обработчики он обслуживает.
+Шапка несёт статус, дату ревизии, префикс сценариев, зависимости от других доменов, строку
+`**Законы:**` — законы, которые домен применяет, — и строку `**Процедуры:**` — корни либ, чьи
+процедуры домен обслуживает.
 
 ```markdown
-**Зависимости:** `<домен>` (что берётся), `<домен>` (что берётся)
-**Законы:** `access`, `locales`, `shared-code`
-**Обработчики:** `<корень либы>`
+**Зависимости:** `pricing` (сумма заявки), `availability` (занятость дат)
+**Законы:** `access`, `locales`, `money`, `ownership`
+**Процедуры:** `libs/api/<домен>`
 ```
 
-Закон, названный где-нибудь в тексте спека, обязан стоять в этой строке: связь сверяется в обе
-стороны.
+Закон, названный где-нибудь в тексте спека, обязан стоять в этой строке: связь сверяется в
+обе стороны.
 
 ## Правило и его привязка
 
@@ -56,45 +62,46 @@ description: Паттерн правила spec-driven. Брать при зав
 Привязка живёт в `implementation.md` рядом, ключ связи — сам текст правила:
 
 ```markdown
-| Правило                               | Где исполняется   |
-| ------------------------------------- | ----------------- |
-| Применяется одна максимальная скидка. | `<путь>:<символ>` |
+| Правило                               | Где исполняется                                                    |
+| ------------------------------------- | ------------------------------------------------------------------ |
+| Применяется одна максимальная скидка. | `libs/api/<домен>/util/src/lib/quote.calculator.ts:calculateQuote` |
 ```
 
-Правило, которому места в коде не нашлось, — намерение: ему место в открытых вопросах, а не
-формальный якорь.
+Правило, которому места в коде не нашлось, — намерение: ему место в «Открытых вопросах» как
+`Q-N`, а не формальный якорь.
 
 ## Сценарий
 
 ```markdown
-### SC-<ПРЕФИКС>-19 — подтверждение на занятые даты отбивается
+### SC-BK-19 — подтверждение на занятые даты отбивается
 
-Дано у записи есть подтверждённая соседняя на пересекающиеся даты
+Дано у объекта есть подтверждённая бронь на пересекающиеся даты
 Когда владелец подтверждает заявку
-Тогда отказ подаётся владельцу как занятые даты, а не как ошибка хранилища
+Тогда отказ подаётся владельцу как занятые даты, а не как ошибка базы
 ```
 
 Идентификатор ставится в начало заголовка теста, через тире. Сценарий без теста помечается
-отметкой с причиной, сценарий с неполным тестом — отметкой о частичном покрытии.
+`Не покрыто: <причина>`, сценарий с неполным тестом — `Покрытие: частичное — <чего не
+хватает>`.
 
 ## Порядок работы
 
 1. Задача заводится сценариями: что станет верно, когда работа закончится.
-2. Спек домена правится **до** кода.
+2. Спек домена (или `proposed/<фича>/`) правится **до** кода.
 3. Код пишется под сценарии, тесты называются их идентификаторами.
-4. Проверка спеков — до пуша.
+4. `npm run check:specs` — до пуша.
 5. Приёмка идёт по сценариям, а не по пересказу правки.
 
 ## Частые промахи
 
-- **Список шагов в спеке:** шаги — артефакт сессии, им место в ветке или в описании PR.
-- **Скопированная из контракта таблица полей:** источник один, а компилируется из двух только
-  одна.
-- **Колонки и индексы в спеке:** они в схеме хранилища, а в спеке остаётся правило, которое
+- `tasks.md` в спеке: шаги — артефакт сессии, им место в ветке или в описании PR.
+- Скопированная из контракта таблица полей: источник — `libs/common/proto/proto/<область>/v1/`,
+  и компилируется из двух только одна.
+- Колонки и индексы в спеке: они в `prisma/schema.prisma`, а в спеке остаётся правило, которое
   ограничение выражает.
-- **Место, где правило исполняется, внутри текста правила:** оно меняется при первом же
-  переносе, и для него заведён отдельный файл.
-- **Отметка о непокрытом при существующем тесте** — отказ: долг закрыли, а отметку не сняли.
-- **Закон, названный в тексте, но забытый в шапке:** по закону тогда не узнать, какие домены на
-  нём стоят.
-- **Правка контракта без спеков задетых доменов** — гард документов отбивает такой коммит.
+- Место, где правило исполняется, внутри текста правила: оно меняется при первом рефакторинге,
+  и для него заведён `implementation.md`.
+- Пометка «Не покрыто» при существующем тесте — отказ: долг закрыли, а отметку не сняли.
+- Закон, названный в тексте, но забытый в строке `**Законы:**`: по закону тогда не узнать,
+  какие домены на нём стоят.
+- Правка `.proto` без спеков задетых доменов: `docs-guard` отбивает такой коммит.

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

@@ -2,13 +2,13 @@
 name: spec-driven-rule
 kind: pattern
 rule: spec-driven
-description: Паттерн правила spec-driven. Брать при заведении или правке закона, правила или паттерна — готовые шапки, набор разделов каждого слоя, таблица привязки, признак того, что правило пора делить. Не брать для спека домена — это паттерн spec-driven-domain.
+description: Паттерн правила spec-driven. Брать при заведении или правке закона в docs/constitution, правила или паттерна в .claude/skills — готовые шапки, набор разделов каждого слоя, таблица привязки, признак того, что правило пора делить. Не брать для спека домена — это паттерн spec-driven-domain.
 ---
 
 # Закон, правило и паттерн
 
 Паттерн правила `spec-driven`. Что при этом должно быть верно — закон
-`{{lawsDir}}/project-documentation.md`.
+`docs/constitution/project-documentation.md`.
 
 ## Когда брать
 
@@ -18,36 +18,51 @@ description: Паттерн правила spec-driven. Брать при зав
 
 ## Закон
 
-`{{lawsDir}}/<закон>.md`. О проекте не знает ничего: ни путей, ни имён файлов, ни привязок.
-Признак закона: попытка положить статью в один спек заставляет повторить то же самое ещё в
-двух.
+`docs/constitution/<закон>.md`. О проекте не знает ничего: ни путей, ни имён файлов, ни
+привязок. Признак закона: попытка положить правило в спек домена заставляет повторить то же
+самое ещё в двух.
 
-Разделы: вводный абзац без заголовка, затем `## Статьи`. Обязательны статьи — их и сверяет
-проверка.
+Слой выбирается по одному вопросу: останется ли статья верной в приложении, где нет ни денег,
+ни локалей перевода, ни второй владеющей сущности. Останется — закон живёт в корне; не
+останется — это закон приложения, и он кладётся в `docs/constitution/application/<закон>.md`. Имя закона одно на
+оба слоя: ни `law:` в шапке правила, ни `**Законы:**` в шапке спека слоя не называют, а два
+закона с одним именем развели бы правило и его закон между собой.
 
-Ни истории правок, ни доводов о том, почему когда-то выбрали так, в законе нет. Историю держит
-система контроля версий, а довод с отвергнутой альтернативой — свойство работы, а не продукта:
-ему место в «Ловушках» правила под этим законом, где и путям к файлам можно. Утверждение,
-которое нельзя написать как «верно всегда», статьёй не становится вовсе.
+Разделы: `## Зачем` (без заголовка, вводным абзацем) · `## Статьи` · `## Открытые вопросы`.
+Обязательны только «Статьи» — их и сверяет проверка. «Открытые вопросы» заводятся, когда
+вопрос есть, и стираются вместе с последним закрытым: закрытый вопрос из закона убирается, а
+не превращается в пустой раздел.
+
+Ни истории правок, ни доводов о том, почему когда-то выбрали так, в законе нет. Историю
+держит система контроля версий, а довод с отвергнутой альтернативой — свойство работы, а не
+продукта: ему место в «Ловушках» правила под этим законом, где и путям к файлам можно.
+Утверждение, которое нельзя написать как «верно всегда», статьёй не становится вовсе.
 
 ```markdown
-# Поставка
+# Закон о поставке
 
 Как правка доезжает до работающего приложения. …
 
+**Ревизия:** 2026-08-05
+
 ## Статьи
 
 - **Выкатывается образ того коммита, который выкатывают.** Умолчание «последний» отстаёт от
   главной ветки, и приложение молча возвращается к прежней версии, продолжая отвечать.
 ```
 
-Поведение кода законом не является: «стор отвечает булевым», «метод называется так-то» — этого
+Раздел `## Открытые вопросы` заводится, когда вопрос есть, и стирается вместе с последним
+закрытым. Вопрос называется `Q-<буква закона>-<номер>`, говорит, что решение изменит, и несёт
+дату заведения; номер после закрытия не переиспользуется.
+
+Поведение кода законом не является: «стор отвечает булевым», «метод называется `save`» — этого
 не видит ни гость, ни владелец. Граница простая: закон описывает то, что видно снаружи
-приложения.
+приложения. Исключение — статья об устройстве кода, которую сверяет машина: якоря читаются
+только под `docs/specs/` и `docs/constitution/`.
 
 ## Правило
 
-`{{rulesDir}}/<правило>/SKILL.md`. Говорит, каким приёмом закон исполняется; на один закон их
+`.claude/skills/<правило>/SKILL.md`. Привязывает закон к этому проекту; на один закон их
 бывает несколько.
 
 ```markdown
@@ -55,28 +70,28 @@ description: Паттерн правила spec-driven. Брать при зав
 name: git-workflow
 kind: rule
 law: delivery
-description: Правило под закон «Поставка». Брать на … Готовый код — в паттернах … Чем это названо здесь — в implementation.md рядом.
+description: Правило под «Закон о поставке». Брать на … Готовый код — в паттернах …
 ---
 ```
 
-Разделы: `## Когда берётся` · `## Что здесь действует` · `## Паттерны` · `## Ловушки`.
+Разделы: `## Как это называется здесь` · `## Где это лежит` · `## Как закон применяется
+здесь` · `## Чего из закона здесь нет` · `## Паттерны` · `## Ловушки`.
 
-Имён этого дерева в правиле нет — оно переносимо ровно поэтому. Как что называется здесь и где
-лежит, пишется рядом, в `implementation.md`, и оттуда же идёт привязка статей к коду:
+Сверяется только `## Как закон применяется здесь`: каждый его пункт начинается жирной фразой,
+и у каждой жирной фразы есть строка в `implementation.md` рядом.
 
 ```markdown
-| Статья                                                          | Где исполняется               |
-| --------------------------------------------------------------- | ----------------------------- |
-| Образы выкатываются по хешу коммита, а не по метке «последний». | `<состав прода>:<переменная>` |
+| Статья                                                         | Где исполняется                     |
+| -------------------------------------------------------------- | ----------------------------------- |
+| Образы выкатываются по sha коммита, а не по метке «последний». | `docker-compose.prod.yml:IMAGE_TAG` |
 ```
 
-Каждый пункт раздела `## Что здесь действует` начинается жирной статьёй, и у каждой статьи есть
-строка в компаньоне. Утверждение, которому места в коде не нашлось, в этот раздел не ставится:
-оно уходит прозой в «Ловушки» или статьёй в закон.
+Утверждение, которому места в коде не нашлось, в этот раздел не ставится: оно уходит прозой в
+«Ловушки» или вопросом `Q-N` в закон.
 
 ## Паттерн
 
-`{{rulesDir}}/<правило>-<что>/SKILL.md`. Минимум один на правило.
+`.claude/skills/<правило>-<что>/SKILL.md`. Минимум один на правило.
 
 ```markdown
 ---
@@ -87,26 +102,26 @@ description: Паттерн правила git-workflow. Брать … Не б
 ---
 ```
 
-Разделы: `## Когда брать` · готовый код · `## Частые промахи`. Компаньона у паттерна нет:
-сверять готовый код с ним самим нечем.
+Разделы: `## Когда брать` · готовый код · `## Частые промахи`. Привязки у паттерна нет:
+проверка его не сверяет, потому что сверять готовый код с ним самим нечем.
 
 ## Порядок
 
 1. Статья пишется в закон — без путей и имён файлов.
-2. Правило объявляет закон в шапке и называет приём, которым статья исполняется.
-3. Имена этого дерева и привязка каждой статьи уходят в `implementation.md` рядом; якорь
-   проверяется открытием файла, а не памятью.
+2. Правило объявляет закон в шапке и называет то же самое в терминах этого дерева.
+3. Каждое утверждение правила получает строку в `implementation.md`; якорь проверяется
+   открытием файла, а не памятью.
 4. Готовый код уезжает в паттерн, а правило на него ссылается.
-5. Проверка спеков — до пуша.
+5. `npm run check:specs` — до пуша.
 
 ## Частые промахи
 
-- Закон назвал файл проекта. Путям место в правиле, а точнее — в его компаньоне.
-- Компаньон лежит не рядом с правилом, а рядом с законом: он привязывает закон к этому проекту,
-  и зелёная проверка это утвердит, потому что структура совпадёт с тем, чего проверка сама и
-  ждёт.
-- Якорь ведёт в мёртвый символ: объявлен и больше нигде не встречается.
-- Статью переформулировали, а строку в привязке не тронули: связь идёт по тексту, и проверка
-  перестанет её находить.
-- В описании не сказано, когда паттерн **не** брать, — соседний паттерн того же правила
+- Закон назвал файл проекта — проверка отбивает. Путям место в правиле.
+- Спутник с привязкой лежит рядом с законом: он привязывает закон к этому проекту, а зелёная
+  проверка это утвердит, потому что структура совпадёт с тем, чего проверка сама и ждёт.
+- Якорь ведёт в мёртвый символ: объявлен и больше нигде не встречается. Так пять правил про
+  правку сущности оказались привязаны к механике, которую не зовёт ни один экран.
+- Утверждение переформулировали, а строку в привязке не тронули: связь идёт по тексту, и
+  проверка перестанет её находить.
+- В `description` не сказано, когда паттерн **не** брать, — соседний паттерн того же правила
   становится неотличимым.