@rt-tools/agent-kit 0.2.0 → 0.4.0

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

@@ -0,0 +1,86 @@
+---
+name: shared-code-new
+kind: pattern
+rule: shared-code
+description: Паттерн правила shared-code. Брать, когда заводится новое число-настройка, общая функция или общий тип, который должны одинаково понимать сайт, админка и бэкенд — куда класть, как объявить, как сверить строку с набором и как убедиться, что копия не осталась на старом месте.
+---
+
+# Новое общее заводится так
+
+Паттерн правила `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`.
+
+## Число объявляется один раз и без довода
+
+```typescript
+export const DEFAULT_PAGE_SIZE: number = 20;
+```
+
+```typescript
+✗ export function listPageOf(query: ListQuery | undefined, defaultPageSize: number): IListPage
+✓ export function listPageOf(query: ListQuery | undefined): IListPage
+```
+
+Пока умолчание передаётся доводом, домен вправе назвать своё число — так у промокодов
+появилось `25` против `20` у остальных списков.
+
+## Строка сверяется с набором, а не приводится к типу
+
+Приведение принимает любую строку. Сверку делает общая пара функций, а что делать с промахом,
+решает вызывающий.
+
+```typescript
+const operator: FilterOperatorType | null = listFilterOperatorOf(filter.operatorType);
+if (!operator) {
+    throw new ConnectError(`filter operator is required: ${filter.propertyName}`, Code.InvalidArgument);
+}
+```
+
+```typescript
+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

@@ -0,0 +1,107 @@
+---
+name: spec-driven-domain
+kind: pattern
+rule: spec-driven
+description: Паттерн правила spec-driven. Брать при заведении или правке спека домена в docs/specs — обязательные разделы, форма сценария, привязка правила к коду, порядок работы от спека к коду. Не брать для заведения закона, правила или паттерна — это паттерн spec-driven-rule.
+---
+
+# Спек домена
+
+Паттерн правила `spec-driven`. Что при этом должно быть верно — закон
+`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
+**Зависимости:** `pricing` (сумма заявки), `availability` (занятость дат)
+**Законы:** `access`, `locales`, `money`, `ownership`
+**Процедуры:** `libs/api/<домен>`
+```
+
+Закон, названный где-нибудь в тексте спека, обязан стоять в этой строке: связь сверяется в
+обе стороны.
+
+## Правило и его привязка
+
+Правило формулируется так, чтобы его можно было нарушить, и начинается с жирной фразы:
+
+```markdown
+- **Применяется одна максимальная скидка.** Сложение скидок даёт цену ниже себестоимости.
+```
+
+Привязка живёт в `implementation.md` рядом, ключ связи — сам текст правила:
+
+```markdown
+| Правило                               | Где исполняется                                                    |
+| ------------------------------------- | ------------------------------------------------------------------ |
+| Применяется одна максимальная скидка. | `libs/api/<домен>/util/src/lib/quote.calculator.ts:calculateQuote` |
+```
+
+Правило, которому места в коде не нашлось, — намерение: ему место в «Открытых вопросах» как
+`Q-N`, а не формальный якорь.
+
+## Сценарий
+
+```markdown
+### SC-BK-19 — подтверждение на занятые даты отбивается
+
+Дано у объекта есть подтверждённая бронь на пересекающиеся даты
+Когда владелец подтверждает заявку
+Тогда отказ подаётся владельцу как занятые даты, а не как ошибка базы
+```
+
+Идентификатор ставится в начало заголовка теста, через тире. Сценарий без теста помечается
+`Не покрыто: <причина>`, сценарий с неполным тестом — `Покрытие: частичное — <чего не
+хватает>`.
+
+## Порядок работы
+
+1. Задача заводится сценариями: что станет верно, когда работа закончится.
+2. Спек домена (или `proposed/<фича>/`) правится **до** кода.
+3. Код пишется под сценарии, тесты называются их идентификаторами.
+4. `npm run check:specs` — до пуша.
+5. Приёмка идёт по сценариям, а не по пересказу правки.
+
+## Частые промахи
+
+- `tasks.md` в спеке: шаги — артефакт сессии, им место в ветке или в описании PR.
+- Скопированная из контракта таблица полей: источник — `libs/common/proto/proto/<область>/v1/`,
+  и компилируется из двух только одна.
+- Колонки и индексы в спеке: они в `prisma/schema.prisma`, а в спеке остаётся правило, которое
+  ограничение выражает.
+- Место, где правило исполняется, внутри текста правила: оно меняется при первом рефакторинге,
+  и для него заведён `implementation.md`.
+- Пометка «Не покрыто» при существующем тесте — отказ: долг закрыли, а отметку не сняли.
+- Закон, названный в тексте, но забытый в строке `**Законы:**`: по закону тогда не узнать,
+  какие домены на нём стоят.
+- Правка `.proto` без спеков задетых доменов: `docs-guard` отбивает такой коммит.

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

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

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

@@ -0,0 +1,88 @@
+---
+name: styling-bem-component
+kind: pattern
+rule: styling-bem
+description: Паттерн правила styling-bem. Брать при правке стилей компонента кита — готовый :host, модификаторы, токены оформления, язык оформления публичного сайта, обход умолчаний кита. Не брать для раскладки экрана — это паттерн styling-bem-layout.
+---
+
+# Стили компонента
+
+Паттерн правила `styling-bem`. Что при этом должно быть верно — закон
+`docs/constitution/frontend-application.md`.
+
+## Когда брать
+
+- Правится компонент кита — он живёт в пакете `@rt-tools/ui-kit-v2`, а не в этом дереве.
+- Правится оформление публичного сайта.
+- Нужно перебить умолчание кита в своём компоненте.
+
+## `:host` — сам блок
+
+Хост несёт класс блока, раскладка на `:host`, элементы вложены внутрь:
+
+```scss
+:host {
+    display: inline-flex;
+
+    .<префикс > -tag {
+        display: inline-flex;
+        gap: var(--<префикс>-space-1);
+        align-items: center;
+
+        &--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(--<префикс>-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-text-muted);
+}
+```
+
+## Частые промахи
+
+- Комментарий-выключатель stylelint: селекторы объединяются вложенностью, а не отключением
+  правила.
+- `!important`: запрещён, и инлайновый `width: 100%` на боксе панели перебить им нельзя.
+- Новые объявления при переносе стилей: переносится существующее, новое появляется только
+  тогда, когда задача — фича.
+- Замечание линтера, лежавшее в файле раньше, оставлено: правятся все, и новые, и старые.
+- Свой `font-family: inherit` в компоненте: наследование включено глобально в `styles.scss`
+  обоих приложений.

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

@@ -0,0 +1,73 @@
+---
+name: styling-bem-layout
+kind: pattern
+rule: styling-bem
+description: Паттерн правила styling-bem. Брать при сборке экрана раздела, формы, панели или окна — готовые блоки общего слоя, разметка через rtBlock и rtElem, свой элемент в чужом поддереве, признак того, что правка идёт не туда. Не брать для стилей компонента кита — это паттерн styling-bem-component.
+---
+
+# Экран на общем слое раскладки
+
+Паттерн правила `styling-bem`. Что при этом должно быть верно — закон
+`docs/constitution/frontend-application.md`.
+
+## Когда брать
+
+- Собирается экран раздела, форма, содержимое панели или модального окна.
+- В файле стилей экрана появляется раскладка.
+
+## Файл стилей экрана по умолчанию пустой
+
+Раскладка объявлена один раз в общем слое приложения (`apps/<app>/src/styles/`), а экран её
+только применяет. Блоков в админке четыре, у сайта один:
+
+| Блок                  | Что раскладывает                                                |
+| --------------------- | --------------------------------------------------------------- |
+| `<префикс>-page`      | экран раздела: заголовок, тулбар, прокрутка, таблица, пагинация |
+| `<префикс>-form`      | форма с разделами-карточками и строками полей                   |
+| `<префикс>-panel`     | содержимое панели правки                                        |
+| `<префикс>-window`    | содержимое модального окна                                      |
+| `<префикс>-site-page` | колонка содержимого сайта: заголовок раздела и вводный абзац    |
+
+Блок вешается на хост, элементы получают классы от `rtBlock` в корне шаблона:
+
+```typescript
+host: { class: '<префикс>-page' },
+```
+
+```html
+<ng-container rtBlock="<префикс>-page">
+    <header rtElem="header">
+        <div rtElem="header-main">
+            <h1 rtElem="title">{{ 'bookingsTitle' | transloco }}</h1>
+            <p rtElem="hint">{{ 'bookingsHint' | transloco }}</p>
+        </div>
+    </header>
+</ng-container>
+```
+
+`rtBlock` на `<ng-container>` класса не ставит — узел это комментарий. Второго носителя класса
+блока не нужно, и своей обёртки `<section>` тоже.
+
+## Свой элемент в чужом поддереве
+
+Пара директив на одном элементе; класс блока при этом не ставится, только класс элемента:
+
+```html
+<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,90 @@
+---
+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. Папка задачи разбирается
+
+Целиком в архив не переносится: `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>
+```
+
+Разбор идёт в том же отчёте, что и работа: папка, оставленная до мержа, попадает в главную
+ветку и читается там как текущая.
+
+## 3. Сверка
+
+```bash
+npm run check:board   # папка закрытой задачи среди текущих, брошенные черновики
+npm run check:specs   # договорённость влита, привязки на месте
+npm run check:docs    # пути, названные в текстах, существуют
+```
+
+## Ловушки
+
+- **Папку разбирают до мержа — после него о ней уже никто не вспомнит.** Сверка очереди
+  считает задачу закрытой по мержу: до него папка среди текущих законна, а после за неё никто
+  не отвечает — работа ушла в следующую задачу, и находка приходит в чужой заход. Дважды
+  подряд папка закрытой задачи так и уехала в главную ветку. Разбирают её тем же PR, что и
+  работу, а не отдельным заходом «потом».
+- **Вливание после мержа не делается.** В главной ветке тогда лежит раздел «предложено, но не
+  выкачено» с тем, что работает месяц, — беззвучная ложь, тем убедительнее, чем старше.
+- **Номера сценариев при вливании не пересчитываются.** Идентификатор — ключ связи с тестами;
+  сдвиг рвёт сверку у соседей, которых правка не касалась.
+- **Правило без привязки в спек домена не въезжает.** Кода, который его исполняет, нет —
+  значит это намерение, и место ему в открытых вопросах домена, а не в правилах.
+- **Архив не обновляется после выкатки.** Уехавшее туда описывает день переезда, и правится
+  оно только вместе с признанием, что описывало неверно.