@rt-tools/agent-kit 0.2.0 → 0.4.0

package/assets/rules/git-workflow.azure.md

@@ -0,0 +1,116 @@
+---
+name: git-workflow
+kind: rule
+law: delivery
+description: Правило под «Закон о поставке» для дерева в Azure DevOps. Брать на заведение задачи, ветки, коммит, пуш, создание PR, слияние, а также на правку схемы хранилища, её миграций и вызовы миграций. Называет рабочий элемент как начало работы, его состояние как ход работы, соответствие задачи и ветки один к одному, имя ветки, формат коммита, учётную запись машинной работы, обязательный состав PR, гарды поставки и сверку очереди работ. Готовый код — в паттернах git-workflow-commit, git-workflow-merge, git-workflow-migration и git-workflow-restart.
+---
+
+# Поставка — как это устроено здесь
+
+Правило под закон `docs/constitution/delivery.md`. Закон говорит, что должно быть верно;
+здесь — каким приёмом это держится в дереве, лежащем в Azure DevOps. Организация, проект,
+учётная запись машинной работы и области коммита — при этом дереве, в `implementation.md`
+рядом: их не угадать, и общими они не бывают.
+
+## Как это называется здесь
+
+| В законе                         | Здесь                                                                                                                                                                                                                                  |
+| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| главная ветка                    | `main`                                                                                                                                                                                                                                 |
+| отдельная ветка                  | `<номер рабочего элемента>-<короткий-slug>`; форма — в `implementation.md`. Имя без номера (`feat/…`, `fix/…`) законно, пока ветка живёт локально: PR с неё не откроется                                                               |
+| задача                           | рабочий элемент (work item) рода `Task` или `Bug`, заголовок `[<номер>] <Что не так>`, исполнитель — учётная запись машинной работы; PR прикрепляется к нему при создании флагом `--work-items`, а коммит — строкой `AB#<номер>`       |
+| очередь работ                    | Azure Boards проекта. Рабочий элемент попадает на доску тем, что заведён: доска показывает элементы своей области и итерации                                                                                                           |
+| состояние задачи в очереди работ | поле `State` рабочего элемента: `New` у заведённого, `Active` у взятого в работу, `Resolved` у ждущего разбора. Набор состояний зависит от процесса проекта и назван в `implementation.md`; закрытая задача уходит из очереди слиянием |
+| отчёт о задаче                   | заголовок PR `[<номер>] <Что сделано>` — тот же номер, что у рабочего элемента, и его название, переведённое в сделанное; тип и область коммита сюда не идут                                                                           |
+| обсуждение правки                | разбор PR: ревьювер — владелец репозитория, исполнитель — учётная запись машинной работы, метки — те же, что у рабочего элемента                                                                                                       |
+| попадание правки в главную ветку | слияние PR; оно же запускает выкатку — `azure-pipelines.yml`                                                                                                                                                                           |
+| образ того коммита               | `IMAGE_TAG=<sha>` в командах `docker compose` на сервере                                                                                                                                                                               |
+| изменение хранилища              | миграция в `prisma/migrations/<метка>_<имя>/`                                                                                                                                                                                          |
+| запись о правке                  | коммит формата `type(scope): description` — типы `feat`, `fix`, `refactor`, `docs`, `style`, `test`, `chore`, `perf`; области — в `implementation.md`                                                                                  |
+| автор машинной работы            | отдельная учётная запись; её имя и место токена — в `implementation.md`. Токен лежит вне репозитория                                                                                                                                   |
+
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
+
+- **Коммит в главную ветку отбивается гардом.** Гард ищет вызов коммита в любом месте команды
+  и смотрит текущую ветку на момент запуска, поэтому составная «создать ветку и сразу
+  коммитить» отклоняется целиком: ветки в момент разбора ещё нет.
+- **Ветка без номера рабочего элемента PR не открывает.** Гард поставки отбивает
+  `az repos pr create` с такой ветки: локально она законна, но правка из неё — это выкатка, за
+  которой в очереди работ ничего не стоит. Заводится рабочий элемент, и работа переносится в
+  ветку с его номером.
+- **Номер ветки и номер в заголовке PR сверяются на месте, а состояние — по доске.** Формат
+  читается из текста команды и работает без сети; существование рабочего элемента, его
+  состояние, исполнитель и то, что он ещё открыт, — только когда есть чем спросить. Нет сети
+  или нет токена — второй ярус молча пропускается: проверка, падающая в самолёте, перестаёт
+  что-либо значить.
+- **Состояние рабочего элемента двигается тем же движением, что и работа.** Ветка заведена —
+  элемент переводится в `Active`, PR открыт — в `Resolved`; делает это команда перевода, а не
+  набор вызовов по памяти. Перевод идёт сразу за шагом, который его вызвал: очередь работ
+  читают между шагами, а не после них.
+- **Отставшее состояние находится сверкой очереди, а не глазами.** Сверка судит состояние по
+  отчёту в обе стороны: открытый PR при элементе не в разборе и разбор без открытого PR — оба
+  расхождения. Момента, когда задачу берут в работу, ей не видно: ветки на доске нет.
+- **Задачи, чинящиеся одной правкой, сливаются до слияния ветки.** Вторая закрывается как
+  дубликат, а недостающее из неё дописывается в первую. После слияния слить уже нельзя: ветка
+  въехала, и откатывается она целиком.
+- **Слияние в главную ветку выкатывает прод.** Фильтры путей конвейера покрывают документы
+  отдельно, поэтому переменные окружения, секреты и записи имён ставятся до слияния, а не
+  после.
+- **Признак режима объявлен в образе, а не только в составе прода.** Значение, заданное
+  составом, действует лишь на контейнер, поднятый этим составом; ручной прогон того же образа
+  идёт с пустым значением, а пусто здесь означает локалхост — со всеми отладочными
+  умолчаниями, которые он разрешает. Умолчание образа задаётся в самом образе.
+- **Образы выкатываются по sha коммита, а не по метке «последний».** Метка в реестре отстаёт
+  от главной ветки, и прод молча возвращается к прежней версии, продолжая отвечать.
+- **Цепочка миграций прогоняется с пустого хранилища до слияния.** Порядок применения
+  лексикографический по имени каталога, а метку времени ставит момент создания: миграция из
+  ветки, начатой раньше, встаёт перед той, от которой зависит.
+- **Документ едет в том же коммите, что и правка.** Обход — строка `Docs-skip: <причина>` в
+  теле коммита; пустая причина не принимается.
+- **Заголовок коммита сверяется с форматом на месте.** Разобранный по типу и области
+  заголовок читается списком, а свободный текст — только целиком.
+- **Перед пушем прогоняются все линтеры, а не один.** Линтер кода обычно не читает файлы
+  стилей вовсе, и правила оформления без второго прогона не проверяет ничто.
+- **Рабочий элемент привязывается к PR при создании, а не после.** `az repos pr create`
+  принимает `--work-items`; привязка второй командой обходится молча, когда у токена нет права
+  править чужой элемент, и PR остаётся ни с чем не связанным.
+- **Слияние с автозавершением не заменяет проверок до пуша.** Автозавершение видит только
+  конвейер, а конвейер видит только отправленное: красная ветка занимает очередь работ и
+  выглядит готовой к разбору.
+- **Набор состояний берётся у процесса проекта, а не назначается правилом.** Agile, Scrum и
+  Basic называют одни и те же три шага по-разному, и перевод в состояние, которого в процессе
+  нет, отвечает отказом на каждой задаче подряд.
+- **Сценарии гардов задают настройки git сами, а не берут их с машины.** Коммит во временном
+  репозитории сценария наследует общий конфиг: если включена подпись, git идёт в агент ключей,
+  а заблокированный агент роняет весь набор — со стороны это выглядит сломанным гардом. Автор,
+  почта и подпись передаются флагами `-c` прямо в команду.
+- **Расхождение миграций со схемой меряется на теневом хранилище, а не на том, где работает
+  тот, кто пушит.** Оно законно несёт след любой недоделанной ветки, и сверка с ним держала бы
+  чужую правку. Гейт и выкатка зовут одну и ту же проверку — иначе «сошлось» станет значить в
+  двух местах разное.
+
+## Чего из закона здесь нет
+
+Гард поставки стоит на командах агента, поэтому ветку, заведённую руками в редакторе, он не
+видит: имя такой ветки держится памятью. Требование от этого не слабеет — просто отдельной
+проверки под него не заводится: работа опознаётся заголовком рабочего элемента и отчёта, а это
+сверяется у всех. Сверка очереди имя ветки не судит вовсе: у открытого PR его не переименовать.
+
+Взятие задачи в работу не стережёт ничто: доска ветки не видит, а гард поставки её видит, но
+доску не правит — сетевой вызов в разборе команды падал бы вместе со связью и отбивал бы
+работу вместо промаха. Держится это памятью и подсказкой, которую печатает команда заведения
+задачи. Отставшее состояние находит сверка очереди — но уже после того, как PR открыт.
+
+## Паттерны
+
+- `git-workflow-commit` — рабочий элемент, ветка, коммит, пуш и PR от учётной записи машинной
+  работы.
+- `git-workflow-merge` — главная ветка влита в ветку задачи, конфликт разобран.
+- `git-workflow-migration` — правка схемы хранилища и её миграций.
+- `git-workflow-restart` — ручной перезапуск прода.

package/assets/rules/git-workflow.github.md

@@ -0,0 +1,123 @@
+---
+name: git-workflow
+kind: rule
+law: delivery
+description: Правило под «Закон о поставке» для дерева на GitHub. Брать на заведение задачи, ветки, коммит, пуш, создание PR, мерж, а также на правку схемы хранилища, её миграций и вызовы миграций. Называет задачу на борде как начало работы, колонку задачи как ход работы, соответствие задачи и ветки один к одному, имя ветки, формат коммита, учётную запись машинной работы, обязательный состав PR, гарды поставки и сверку очереди работ. Готовый код — в паттернах git-workflow-commit, git-workflow-merge, git-workflow-migration и git-workflow-restart.
+---
+
+# Поставка — как это устроено здесь
+
+Правило под закон `docs/constitution/delivery.md`. Закон говорит, что должно быть верно;
+здесь — каким приёмом это держится в дереве, лежащем на GitHub. Ключ задач, адрес борды,
+учётная запись машинной работы и области коммита — при этом дереве, в `implementation.md`
+рядом: их не угадать, и общими они не бывают.
+
+## Как это называется здесь
+
+| В законе                         | Здесь                                                                                                                                                                                           |
+| -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| главная ветка                    | `main`                                                                                                                                                                                          |
+| ключ задач                       | короткое слово, которым дерево зовёт свои задачи; задаётся ключом `board.taskKey` в `.claude/rt-kit/checks.json`, а в `implementation.md` называется для читателя                               |
+| отдельная ветка                  | `<КЛЮЧ>-<номер задачи>-<короткий-slug>`. Имя без номера (`feat/…`, `fix/…`) законно, пока ветка живёт локально: PR с неё не откроется                                                           |
+| задача                           | issue репозитория, заголовок `[<КЛЮЧ>-<номер>] <Что не так>`, исполнитель — учётная запись машинной работы; PR прикрепляется к нему строкой `Closes #<номер>` в теле                            |
+| очередь работ                    | борда GitHub Projects. К репозиторию она не привязана: `projectsV2` у него пуст, и задача попадает на борду только явным добавлением                                                            |
+| состояние задачи в очереди работ | колонка борды — поле «Status»: заведённая, взятая в работу, ждущая разбора. Имена колонок — в `implementation.md`; закрытая задача уходит из очереди мержем, а не переводом в последнюю колонку |
+| отчёт о задаче                   | заголовок PR `[<КЛЮЧ>-<номер>] <Что сделано>` — тот же номер, что у задачи, и её название, переведённое в сделанное; тип и область коммита сюда не идут                                         |
+| обсуждение правки                | разбор PR: ревьювер — владелец репозитория, исполнитель — учётная запись машинной работы, метки — те же, что у задачи                                                                           |
+| попадание правки в главную ветку | мерж PR; он же запускает выкатку — `.github/workflows/deploy.yml`                                                                                                                               |
+| образ того коммита               | `IMAGE_TAG=<sha>` в командах `docker compose` на сервере                                                                                                                                        |
+| изменение хранилища              | миграция в `prisma/migrations/<метка>_<имя>/`                                                                                                                                                   |
+| запись о правке                  | коммит формата `type(scope): description` — типы `feat`, `fix`, `refactor`, `docs`, `style`, `test`, `chore`, `perf`; области — в `implementation.md`                                           |
+| автор машинной работы            | отдельная учётная запись; её имя и место токена — в `implementation.md`. Токен лежит вне репозитория                                                                                            |
+
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
+
+- **Коммит в главную ветку отбивается гардом.** Гард ищет вызов коммита в любом месте команды
+  и смотрит текущую ветку на момент запуска, поэтому составная «создать ветку и сразу
+  коммитить» отклоняется целиком: ветки в момент разбора ещё нет.
+- **Ветка без номера задачи PR не открывает.** Гард поставки отбивает `gh pr create` с такой
+  ветки: локально она законна, но правка из неё — это выкатка, за которой в очереди работ
+  ничего не стоит. Заводится задача, и работа переносится в ветку с её номером.
+- **Ключ задач задаётся один раз, и все три формы имени выводятся из него.** Заголовок задачи,
+  имя ветки и заголовок отчёта строит один и тот же ключ: команда заведения задачи собирает по
+  нему заголовок, гард поставки достаёт по нему номер из имени ветки, сверка очереди — из
+  заголовка. Форма ветки в профиле дерева пишется той же парой `<КЛЮЧ>-<номер>`, а не своей
+  похожей: разойдясь, они не отказывают, а перестают узнавать номер, и проверка, искавшая
+  работу без задачи, пропускает всё подряд.
+- **Незаданный ключ отбивает работу с очередью на месте.** Модуль борды отказывает при первом
+  же вызове и называет, где ключ задаётся. Умолчания у ключа нет намеренно: собранный из
+  пустого значения заголовок `[-317]` не совпадает ни с чем, и сверка очереди помечает
+  неправильно названной каждую задачу — настоящее расхождение тонет среди этих строк.
+- **Номер ветки и номер в заголовке PR сверяются на месте, а состояние задачи — по борде.**
+  Формат читается из текста команды и работает без сети; существование задачи, её присутствие
+  на борде, исполнитель и то, что она ещё открыта, — только когда есть чем спросить. Нет сети
+  или нет токена — второй ярус молча пропускается: проверка, падающая в самолёте, перестаёт
+  что-либо значить.
+- **Колонка задачи двигается тем же движением, что и работа.** Ветка заведена — задача
+  переставляется во взятые в работу, PR открыт — в ждущие разбора; делает это команда
+  перевода, а не набор вызовов GraphQL по памяти. Перевод идёт сразу за шагом, который его
+  вызвал: очередь работ читают между шагами, а не после них.
+- **Отставшая колонка находится сверкой очереди, а не глазами.** Сверка судит колонку по
+  отчёту в обе стороны: открытый PR при задаче не в разборе и разбор без открытого PR — оба
+  расхождения. Момента, когда задачу берут в работу, ей не видно: ветки на борде нет.
+- **Задачи, чинящиеся одной правкой, сливаются до мержа.** Вторая стирается вместе с номером,
+  а недостающее из неё дописывается в первую. После мержа слить уже нельзя: ветка въехала, и
+  откатывается она целиком.
+- **Мерж в главную ветку выкатывает прод.** Исключения по путям покрывают только документы,
+  поэтому переменные окружения, секреты и записи имён ставятся до мержа, а не после.
+- **Признак режима объявлен в образе, а не только в составе прода.** Значение, заданное
+  составом, действует лишь на контейнер, поднятый этим составом; ручной прогон того же образа
+  идёт с пустым значением, а пусто здесь означает локалхост — со всеми отладочными
+  умолчаниями, которые он разрешает. Умолчание образа задаётся в самом образе.
+- **Образы выкатываются по sha коммита, а не по метке «последний».** Метка в реестре отстаёт
+  от главной ветки, и прод молча возвращается к прежней версии, продолжая отвечать.
+- **Цепочка миграций прогоняется с пустого хранилища до мержа.** Порядок применения
+  лексикографический по имени каталога, а метку времени ставит момент создания: миграция из
+  ветки, начатой раньше, встаёт перед той, от которой зависит.
+- **Документ едет в том же коммите, что и правка.** Обход — строка `Docs-skip: <причина>` в
+  теле коммита; пустая причина не принимается.
+- **Заголовок коммита сверяется с форматом на месте.** Разобранный по типу и области
+  заголовок читается списком, а свободный текст — только целиком.
+- **Перед пушем прогоняются все линтеры, а не один.** Линтер кода обычно не читает файлы
+  стилей вовсе, и правила оформления без второго прогона не проверяет ничто.
+- **Автор PR не может быть его ревьювером.** Запрос разбора на самого себя GitHub принимает и
+  молча не создаёт — разбор при этом выглядит запрошенным.
+- **Метки, исполнитель и ревьювер PR ставятся вызовами `gh api`, а не `gh pr edit`.** На
+  репозитории со старой бордой `gh pr edit` отвечает отказом про Projects (classic) и до
+  правки не доходит вовсе.
+- **Борда правится запросом GraphQL по идентификатору проекта.** `gh project` с `--owner`
+  отвечает `unknown owner type`, когда владелец борды — не та учётная запись, под которой
+  идёт вызов.
+- **Сценарии гардов задают настройки git сами, а не берут их с машины.** Коммит во временном
+  репозитории сценария наследует общий конфиг: если включена подпись, git идёт в агент ключей,
+  а заблокированный агент роняет весь набор — со стороны это выглядит сломанным гардом. Автор,
+  почта и подпись передаются флагами `-c` прямо в команду.
+- **Расхождение миграций со схемой меряется на теневом хранилище, а не на том, где работает
+  тот, кто пушит.** Оно законно несёт след любой недоделанной ветки, и сверка с ним держала бы
+  чужую правку. Гейт и выкатка зовут одну и ту же проверку — иначе «сошлось» станет значить в
+  двух местах разное.
+
+## Чего из закона здесь нет
+
+Гард поставки стоит на командах агента, поэтому ветку, заведённую руками в редакторе, он не
+видит: имя такой ветки держится памятью. Требование от этого не слабеет — просто отдельной
+проверки под него не заводится: работа опознаётся заголовком задачи и отчёта, а это сверяется
+у всех. Сверка очереди имя ветки не судит вовсе: у открытого PR его не переименовать.
+
+Взятие задачи в работу не стережёт ничто: борда ветки не видит, а гард поставки её видит, но
+борду не правит — сетевой вызов в разборе команды падал бы вместе со связью и отбивал бы
+работу вместо промаха. Держится это памятью и подсказкой, которую печатает команда заведения
+задачи. Отставшую колонку находит сверка очереди — но уже после того, как PR открыт.
+
+## Паттерны
+
+- `git-workflow-commit` — задача, ветка, коммит, пуш и PR от учётной записи машинной работы.
+- `git-workflow-merge` — главная ветка влита в ветку задачи, конфликт разобран.
+- `git-workflow-migration` — правка схемы хранилища и её миграций.
+- `git-workflow-restart` — ручной перезапуск прода.

package/assets/rules/git-workflow.gitlab.md

@@ -0,0 +1,113 @@
+---
+name: git-workflow
+kind: rule
+law: delivery
+description: Правило под «Закон о поставке» для дерева на GitLab. Брать на заведение задачи, ветки, коммит, пуш, создание MR, слияние, а также на правку схемы хранилища, её миграций и вызовы миграций. Называет задачу на борде как начало работы, колонку задачи как ход работы, соответствие задачи и ветки один к одному, имя ветки, формат коммита, учётную запись машинной работы, обязательный состав MR, гарды поставки и сверку очереди работ. Готовый код — в паттернах git-workflow-commit, git-workflow-merge, git-workflow-migration и git-workflow-restart.
+---
+
+# Поставка — как это устроено здесь
+
+Правило под закон `docs/constitution/delivery.md`. Закон говорит, что должно быть верно;
+здесь — каким приёмом это держится в дереве, лежащем на GitLab. Ключ задач, адрес борды,
+учётная запись машинной работы и области коммита — при этом дереве, в `implementation.md`
+рядом: их не угадать, и общими они не бывают.
+
+## Как это называется здесь
+
+| В законе                         | Здесь                                                                                                                                                                                                 |
+| -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| главная ветка                    | `main`                                                                                                                                                                                                |
+| отдельная ветка                  | `<КЛЮЧ>-<номер задачи>-<короткий-slug>`; ключ задач — в `implementation.md`. Имя без номера (`feat/…`, `fix/…`) законно, пока ветка живёт локально: MR с неё не откроется                             |
+| задача                           | issue проекта, заголовок `[<КЛЮЧ>-<номер>] <Что не так>`, исполнитель — учётная запись машинной работы; MR прикрепляется к нему строкой `Closes #<номер>` в описании                                  |
+| очередь работ                    | доска задач проекта — Issue Board. Задача попадает на неё меткой списка, а не самим фактом заведения: доска показывает те issue, чью метку знает                                                      |
+| состояние задачи в очереди работ | список доски, за которым стоит метка: заведённая, взятая в работу, ждущая разбора. Имена меток — в `implementation.md`; закрытая задача уходит из очереди слиянием, а не переносом в последний список |
+| отчёт о задаче                   | заголовок MR `[<КЛЮЧ>-<номер>] <Что сделано>` — тот же номер, что у задачи, и её название, переведённое в сделанное; тип и область коммита сюда не идут                                               |
+| обсуждение правки                | разбор MR: ревьювер — владелец проекта, исполнитель — учётная запись машинной работы, метки — те же, что у задачи                                                                                     |
+| попадание правки в главную ветку | слияние MR; оно же запускает выкатку — `.gitlab-ci.yml`                                                                                                                                               |
+| образ того коммита               | `IMAGE_TAG=<sha>` в командах `docker compose` на сервере                                                                                                                                              |
+| изменение хранилища              | миграция в `prisma/migrations/<метка>_<имя>/`                                                                                                                                                         |
+| запись о правке                  | коммит формата `type(scope): description` — типы `feat`, `fix`, `refactor`, `docs`, `style`, `test`, `chore`, `perf`; области — в `implementation.md`                                                 |
+| автор машинной работы            | отдельная учётная запись; её имя и место токена — в `implementation.md`. Токен лежит вне репозитория                                                                                                  |
+
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
+
+- **Коммит в главную ветку отбивается гардом.** Гард ищет вызов коммита в любом месте команды
+  и смотрит текущую ветку на момент запуска, поэтому составная «создать ветку и сразу
+  коммитить» отклоняется целиком: ветки в момент разбора ещё нет.
+- **Ветка без номера задачи MR не открывает.** Гард поставки отбивает `glab mr create` с такой
+  ветки: локально она законна, но правка из неё — это выкатка, за которой в очереди работ
+  ничего не стоит. Заводится задача, и работа переносится в ветку с её номером.
+- **Номер ветки и номер в заголовке MR сверяются на месте, а состояние задачи — по доске.**
+  Формат читается из текста команды и работает без сети; существование задачи, её метка
+  списка, исполнитель и то, что она ещё открыта, — только когда есть чем спросить. Нет сети
+  или нет токена — второй ярус молча пропускается: проверка, падающая в самолёте, перестаёт
+  что-либо значить.
+- **Список задачи двигается тем же движением, что и работа.** Ветка заведена — задача
+  переставляется во взятые в работу, MR открыт — в ждущие разбора; делает это команда
+  перевода, а не набор вызовов по памяти. Перевод идёт сразу за шагом, который его вызвал:
+  очередь работ читают между шагами, а не после них.
+- **Отставший список находится сверкой очереди, а не глазами.** Сверка судит список по отчёту
+  в обе стороны: открытый MR при задаче не в разборе и разбор без открытого MR — оба
+  расхождения. Момента, когда задачу берут в работу, ей не видно: ветки на доске нет.
+- **Задачи, чинящиеся одной правкой, сливаются до слияния ветки.** Вторая стирается вместе с
+  номером, а недостающее из неё дописывается в первую. После слияния слить уже нельзя: ветка
+  въехала, и откатывается она целиком.
+- **Слияние в главную ветку выкатывает прод.** Правила `only`/`rules` конвейера покрывают
+  документы отдельно, поэтому переменные окружения, секреты и записи имён ставятся до слияния,
+  а не после.
+- **Признак режима объявлен в образе, а не только в составе прода.** Значение, заданное
+  составом, действует лишь на контейнер, поднятый этим составом; ручной прогон того же образа
+  идёт с пустым значением, а пусто здесь означает локалхост — со всеми отладочными
+  умолчаниями, которые он разрешает. Умолчание образа задаётся в самом образе.
+- **Образы выкатываются по sha коммита, а не по метке «последний».** Метка в реестре отстаёт
+  от главной ветки, и прод молча возвращается к прежней версии, продолжая отвечать.
+- **Цепочка миграций прогоняется с пустого хранилища до слияния.** Порядок применения
+  лексикографический по имени каталога, а метку времени ставит момент создания: миграция из
+  ветки, начатой раньше, встаёт перед той, от которой зависит.
+- **Документ едет в том же коммите, что и правка.** Обход — строка `Docs-skip: <причина>` в
+  теле коммита; пустая причина не принимается.
+- **Заголовок коммита сверяется с форматом на месте.** Разобранный по типу и области
+  заголовок читается списком, а свободный текст — только целиком.
+- **Перед пушем прогоняются все линтеры, а не один.** Линтер кода обычно не читает файлы
+  стилей вовсе, и правила оформления без второго прогона не проверяет ничто.
+- **Слияние по кнопке «Merge when pipeline succeeds» не заменяет проверок до пуша.** Конвейер
+  видит только то, что уже отправлено, а отправленная красная ветка занимает очередь работ и
+  выглядит готовой к разбору.
+- **Метки и исполнитель MR ставятся при создании, а не правкой после.** `glab mr create`
+  принимает их флагами; правка открытого MR второй командой обходится молча, когда токен
+  учётной записи машинной работы не видит проект целиком.
+- **Задача переводится по списку правкой её меток.** Списки доски — это метки: перевод, не
+  снявший прежнюю метку, оставляет задачу в двух списках сразу, и очередь читается неверно.
+- **Сценарии гардов задают настройки git сами, а не берут их с машины.** Коммит во временном
+  репозитории сценария наследует общий конфиг: если включена подпись, git идёт в агент ключей,
+  а заблокированный агент роняет весь набор — со стороны это выглядит сломанным гардом. Автор,
+  почта и подпись передаются флагами `-c` прямо в команду.
+- **Расхождение миграций со схемой меряется на теневом хранилище, а не на том, где работает
+  тот, кто пушит.** Оно законно несёт след любой недоделанной ветки, и сверка с ним держала бы
+  чужую правку. Гейт и выкатка зовут одну и ту же проверку — иначе «сошлось» станет значить в
+  двух местах разное.
+
+## Чего из закона здесь нет
+
+Гард поставки стоит на командах агента, поэтому ветку, заведённую руками в редакторе, он не
+видит: имя такой ветки держится памятью. Требование от этого не слабеет — просто отдельной
+проверки под него не заводится: работа опознаётся заголовком задачи и отчёта, а это сверяется
+у всех. Сверка очереди имя ветки не судит вовсе: у открытого MR его не переименовать.
+
+Взятие задачи в работу не стережёт ничто: доска ветки не видит, а гард поставки её видит, но
+доску не правит — сетевой вызов в разборе команды падал бы вместе со связью и отбивал бы
+работу вместо промаха. Держится это памятью и подсказкой, которую печатает команда заведения
+задачи. Отставший список находит сверка очереди — но уже после того, как MR открыт.
+
+## Паттерны
+
+- `git-workflow-commit` — задача, ветка, коммит, пуш и MR от учётной записи машинной работы.
+- `git-workflow-merge` — главная ветка влита в ветку задачи, конфликт разобран.
+- `git-workflow-migration` — правка схемы хранилища и её миграций.
+- `git-workflow-restart` — ручной перезапуск прода.

package/assets/rules/lib-layers.md

@@ -0,0 +1,80 @@
+---
+name: lib-layers
+kind: rule
+law: lib-imports
+description: Правило под «Закон об импортах между либами». Брать при правке project.json, tsconfig.base.json, eslint/boundaries/**, любого src/index.ts и проверок раскладки, а также когда решается, где живёт общий символ. Называет семьи, слои, теги и границы этого дерева. Готовый порядок действий — в паттернах lib-layers-new и lib-layers-move.
+---
+
+# Импорты между либами — как это устроено здесь
+
+Правило под закон `docs/constitution/lib-imports.md`. Закон говорит, кто кого видит; здесь —
+как это нарезано в этом дереве, чем названо и чего у нас нет.
+
+## Как это называется здесь
+
+| В законе                         | Здесь                                                  |
+| -------------------------------- | ------------------------------------------------------ |
+| семья либ                        | `libs/site`, `libs/admin`, `libs/api`                  |
+| слой                             | `api`, `data-access`, `feature`, `shell`, `ui`, `util` |
+| право видеть либу                | тег в `eslint/boundaries/domains/<семья>.config.mjs`   |
+| общая всем трём приложениям либа | `libs/common/util`, тег `scope:common-util`            |
+| основание семейства              | `<семья>/core`; его тег входит в `ADMIN_UNIVERSAL`     |
+| барель                           | `src/index.ts` либы и `index.ts` каталога компонента   |
+
+Фичевый домен фронта — шесть слоёв (`api`, `data-access`, `feature/<экран>`, `shell`, `ui`,
+`util`), общий домен — те же без `shell`. У бэкенда `ui` и `shell` нет: отдавать разметку и
+роутиться ему нечем.
+
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
+
+- **Чужой символ не реэкспортируется ни одной из двух форм.** Запрещены и
+  `export { X } from '@<область>/…'`, и пара «импорт плюс `export { X };`»: вторая
+  выглядит как собственное объявление и глазами в ревью проходила.
+- **Строка с алиасом чужой либы в бареле — тот же реэкспорт.** Относительный путь в бареле
+  законен: он собирает наружу собственные файлы либы.
+- **Не хватает права — оно дописывается строкой в конфиге домена с комментарием.** Импорт,
+  который «просто заработал», означает, что тег ещё не сужен.
+- **У `libs/common/util` список зависимостей пуст, и Angular туда не попадает.** Либу
+  импортирует бэкенд, и фреймворк уехал бы в его бандл; токен DI, общий двум фронтовым
+  семьям, живёт в `common/platform`.
+- **Основание семейства видит только `util`.** Его зовут все домены семьи, и любая его
+  зависимость становится общей для всех сразу.
+- **Домен заводится под предмет, а не под механику.** Механика, общая нескольким доменам,
+  едет в либу, которой она уже видна: у фронта это основание семейства, у бэкенда — слой
+  `util`, перечисленный у каждого домена.
+- **Домен, у которого непуст один слой, значится строкой с причиной.** Иначе он неотличим от
+  слота: пустые слои есть и у того, и у другого, а барель лежит в обоих.
+
+## Чего из закона здесь нет
+
+Отклонение основания семейства от лесенки сегодня одно и названо в `CORE_EXCEPTIONS`
+проверки: `common/proto` и `common/connect` у `admin/core` ради транспорта Connect.
+
+Полный набор слоёв требуется у всех, и пустой слой дефектом не считается: `api` пуст у
+домена, который ни с кем чужим не говорит. Судится только крайний случай — непуст ровно один
+слой; такой домен обычно один, и он стоит в списке исключений с
+причиной.
+
+## Паттерны
+
+- `lib-layers-new` — завести или удалить либу: генератор, теги, алиас, README.
+- `lib-layers-move` — перенести код между либами: порядок, границы, импорты, README обеих.
+
+## Ловушки
+
+- **Либа, которую никто не импортирует, не проверена ничем.** `nx lint` и `nx test` проверяют
+  её саму, а не договор с потребителем: потерянное поле в `*.State` ошибкой не считается, пока
+  нет вызывающего кода. Первый импортёр и есть первая проверка — слой моделей принимается
+  после `nx build` и живого прогона сценария, а не по зелёному `lint test`.
+- **Проверка принимается на нарушении, а не на зелёном прогоне.** Нарушение вносится руками,
+  прогон краснеет, правка снимается. У проверок в `tools/` тестов нет, и это единственная
+  приёмка.
+- `git rm -r` оставляет `node_modules/.vite` внутри удалённого каталога, и проверка продолжает
+  видеть его как домен без слоёв. Добивать `rm -rf`.
+- Образец, написанный второй раз, ловит `npm run check:dupes` — правило `shared-code`.

package/assets/rules/lists.md

@@ -0,0 +1,73 @@
+---
+name: lists
+kind: rule
+law: lists
+description: Правило под «Закон о списке записей». Брать при правке списочного экрана (libs/admin/*/feature/list), таблицы и пагинации кита. Называет порядок блоков, чем собирается список, где живёт выборка и что уже есть в ките. Готовый код экрана — в паттерне admin-lists-screen.
+---
+
+# Списочный экран — как это устроено здесь
+
+Правило под закон `docs/constitution/lists.md`. Закон говорит, что пользователь видит и
+делает; здесь — из чего этот экран собирается в этом дереве и как он выглядит. Про вид
+говорит правило: закон о нём молчит намеренно.
+
+## Как это называется здесь
+
+| В законе                  | Здесь                                                                     |
+| ------------------------- | ------------------------------------------------------------------------- |
+| таблица записей           | `rt-table` из `@rt-tools/ui-kit-v2`, вход `[dataSource]`                  |
+| состав и порядок столбцов | `[columnsConfig]`, хранятся по ключу `tableId`                            |
+| карточка на узком экране  | ветка `<префикс>-table`, а не своя разметка                               |
+| тулбар                    | `<префикс>-toolbar` со слотами `vmToolbarLeft` и `vmToolbarRight`         |
+| выборка                   | `IList.Query.State` — страница, сортировка, условия отбора, строка поиска |
+| панель настройки столбцов | асайд по маршруту `path: 'table-settings'`                                |
+
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
+
+- **Список собирается `<префикс>-table`, а не своей разметкой.** Скелетоны, пустое состояние,
+  карточки на узком экране и настройка столбцов — входы таблицы; свой
+  `@if (rows().length === 0)` означает, что экран собран мимо неё.
+- **Строки объявляются на `rowsTable.displayedColumns()`, а не на своём списке.** Столбец с
+  меню таблица добавляет сама.
+- **Клик по строке открывает запись, а меню — для действий над ней.** Вид нажимаемой строки
+  даёт `clickable`, активацию мышью и с клавиатуры — `vmTableRow`; клик по кнопке внутри строки
+  активацией не считается.
+- **Доступность действия лежит полем строки, а не вызовом метода компонента.** Метод из шаблона
+  пересчитывался бы на каждой проверке.
+- **Недоступное сейчас действие в меню строки не рисуется вовсе.** Пункт заводится под `@if` по
+  полю строки, а не выключенным: выключенный пункт перечисляет владельцу запреты вместо того,
+  что он может сделать, и набор их меняется от строки к строке.
+- **Кнопка меню не показывается, если у строки не осталось доступных действий.** За это
+  отвечает вход `[rowHasActions]` — предикат по строке; считать по содержимому меню нельзя,
+  спроецированный шаблон известен только после отрисовки.
+- **Отказ загрузки подаётся тостом, а не строкой над таблицей.** Ключ отказа читается сразу
+  после запроса, а не подпиской на сигнал стора: стор делят список и панель правки.
+- **Экран берёт сортировку и условия отбора из ответа, а не из своего запроса.** Сервер мог
+  применить умолчание домена или отбросить условие.
+- **Строка списка получает короткую модель сущности, а не полную.**
+
+## Чего из закона здесь нет
+
+Страницу отдаёт только та процедура, в чьём ответе есть `page_model`; заявки и объекты
+приходят целиком — долги `Q-L-5`, `Q-L-7` и `Q-M-2`. Выборка живёт в адресе не у каждого
+списка — долг `Q-L-4`.
+
+## Паттерны
+
+- `admin-lists-screen` — собрать экран: порядок блоков, таблица, меню строки, сортируемый
+  заголовок, тулбар.
+
+## Ловушки
+
+- Без `[vmTableRowActionsRowType]` тип `let-row` выводится как `unknown`, и падает только
+  продовая сборка — юниты и дев-сервер проходят.
+- Прокрутке нужны оба правила вместе: контейнер с `overflow-x`, таблица с
+  `min-width: max-content`. С одним столбцы сжимаются вместо сдвига.
+- Тулбар и пагинация своих классов не носят: промежуток задаёт `<префикс>-page`.
+- Заголовок стоит в своём `<header>`, а не внутри тулбара.