@rt-tools/agent-kit 0.1.0

package/README.md

@@ -0,0 +1,85 @@
+# @rt-tools/agent-kit
+
+Переносимый слой правил для агента: законы, шаблоны правил и паттернов раскладываются в
+репозиторий одной командой и обновляются следующей, не затирая того, что проект дописал сам.
+
+## Зачем
+
+Правила, по которым агент правит код, копятся в каждом репозитории заново. Скопированные из
+соседнего они устаревают молча: правку в исходнике никто не переносит, а расхождение видно
+только по последствиям.
+
+Пакет разделяет текст на два слоя. **Закон** — что должно быть верно; он не знает ни путей, ни
+имён файлов и потому переносится целиком. **Правило** — чем это названо в конкретном дереве;
+оно остаётся в проекте, потому что только там имеет смысл.
+
+Везёт пакет законы. Правила, паттерны и привязки к коду пишет проект.
+
+## Как пользоваться
+
+```bash
+pnpm add -D @rt-tools/agent-kit
+
+npx agent-kit init      # завести .claude/rt-kit.json и каталог надстроек
+npx agent-kit sync      # разложить законы в docs/constitution/
+npx agent-kit doctor    # что разложено, что отстало, чего не хватает
+```
+
+В гейте пуша:
+
+```bash
+npx agent-kit sync --check
+```
+
+Команда ничего не пишет и отказывает, если разложенное отстало от пакета или его правили
+руками.
+
+## Конфиг
+
+`.claude/rt-kit.json` коммитится: раскладка обязана повторяться на чужой машине без вопросов.
+
+```json
+{
+    "vars": { "mainBranch": "main" },
+    "layout": { "laws": "docs/constitution" },
+    "skip": ["laws/admin-lists.md"]
+}
+```
+
+- **`vars`** — значения дырок `{{имя}}` в тексте пакета. Пути раскладки подставляются сами:
+  `{{lawsDir}}`, `{{hooksDir}}`, `{{checksDir}}`, `{{agentsDir}}`, `{{templatesDir}}`.
+  Неподставленная дырка — отказ раскладки, а не строка в разложенном тексте: `{{mainBranch}}`
+  посреди правила агент прочтёт как имя.
+- **`layout`** — куда класть каждый род ресурса. Умолчания менять без нужды не стоит: правила
+  ссылаются на законы теми же путями.
+- **`skip`** — ресурсы, от которых проект отказался, идентификаторами вида `laws/<закон>.md`.
+
+## Надстройки
+
+Проект дописывает своё не в разложенный файл, а рядом — в
+`.claude/rt-kit/overrides/<идентификатор ресурса>`. Правка разложенного файла теряется на
+следующем `sync`, и пакет на неё отказывает, вместо того чтобы переписать молча.
+
+Слияние идёт по разделам `## `:
+
+| В надстройке | Что происходит |
+| --- | --- |
+| заголовок, который есть у пакета | раздел замещается целиком |
+| заголовок, которого у пакета нет | раздел дописывается в конец |
+| заголовок без тела | раздел пакета снимается |
+
+Так правка пакета доезжает во все разделы, которых проект не трогал, а проектная история
+решений остаётся при проекте.
+
+## Что разложено
+
+Каждый разложенный файл несёт шапку с версией пакета и суммой тела. По ней `sync` отличает три
+случая: файл отстал от пакета, файл правили руками, файл положен вообще не пакетом. Первый
+перекладывается, на двух других раскладка отказывает и называет их поимённо.
+
+Отказ хотя бы по одному файлу не пишет ничего: половина разложенного хуже целого.
+
+## Чего в пакете пока нет
+
+Хуков, проверок, агентов и пресетов карты гейта он не везёт — только законы и шаблоны правила и
+паттерна. Генератора черновиков правил по закону тоже нет.

package/assets/laws/access.md

@@ -0,0 +1,46 @@
+# Доступ
+
+Кто что может делать: вход владельца, права на действия, поведение публичных путей.
+Правила держат все процедуры контракта и все разделы админки.
+
+**Ревизия:** 2026-08-02
+
+## Терминология
+
+| Термин         | Определение                                                                                 |
+| -------------- | ------------------------------------------------------------------------------------------- |
+| Право          | Пара «ресурс и действие», например `bookings:manage`. Не роль: роль набирается из прав      |
+| Пресет         | Именованный набор прав, который выдаётся пользователю целиком                               |
+| Оверрайд       | Точечная правка права поверх пресета для одного пользователя                                |
+| Публичный путь | Процедура, доступная гостю без входа. Публичность объявляется, а не получается по умолчанию |
+
+## Статьи
+
+- **Каждая процедура объявляет свой доступ, и объявление ровно одно.** Процедура без
+  объявления или с двумя объявлениями не даёт приложению подняться.
+- **Доступов четыре: по праву, любому вошедшему, публично и публично с чтением входа.**
+  Последний отдаёт вошедшему больше, чем гостю, — так админ видит скрытые объекты в общем
+  списке.
+- **Права пользователя — это права пресета, поверх которых применены его оверрайды.**
+- **Запрос без входа туда, где вход нужен, отбивается как неаутентифицированный, а вход
+  без нужного права — как отказ в доступе.** Это разные ответы: первый лечится входом,
+  второй — нет.
+- **Право проверяется до тела процедуры.** Обработчик не решает, пускать ли вызывающего.
+- **Публичность объявляется с причиной.** Причина живёт в коде рядом с объявлением и
+  наружу не уходит.
+- **Админка не показывает разделы, на которые у владельца нет права.**
+- **Адрес раздела закрыт тем же правом, что и пункт меню.** Иначе скрытый пункт закрывает
+  раздел лишь на вид: адрес открывается по прямой ссылке.
+- **Пока права не получены, админка ничего не прячет.** Пустая шапка после сетевого сбоя
+  выглядит как сломанная админка и не оставляет выхода; запрос без права всё равно
+  отобьётся на сервере.
+
+## Открытые вопросы
+
+- **Q-A-1.** Что видит владелец, у которого право отобрали посреди сессии? Токен живёт со
+  своими правами до истечения, и раздел останется доступным до перевхода. Заведён
+  2026-07-31.
+- **Q-A-2.** Как владелец меняет свой пароль? Сегодня пароль задаётся при заведении учётной
+  записи и из интерфейса не меняется: ни экрана смены, ни процедуры, ни восстановления
+  забытого. Решение потребует процедуры смены и правила о подтверждении прежним паролем.
+  Заведён 2026-07-31, уточнён 2026-08-01 по коду домена `auth`.

package/assets/laws/admin-lists.md

@@ -0,0 +1,47 @@
+# Список записей в админке
+
+Как владелец видит набор записей и что с ними делает, не открывая ни одну: заявки, объекты,
+адреса страниц, промокоды, подписки на календарь. Правила общие для всех разделов — список,
+устроенный иначе остальных, владелец читает заново.
+
+Открытая запись, попадание в раздел и объём данных на строку — предмет других законов.
+
+**Ревизия:** 2026-08-02
+
+## Статьи
+
+- **Записи показаны таблицей: строка — запись, столбец — её свойство.**
+- **Клик по строке открывает запись.** Меню строки — для действий над ней, а не для входа.
+- **Пока список читается, на месте строк — скелетоны.** Пустая область неотличима от списка,
+  в котором ничего нет.
+- **Пустой список объясняет, почему он пуст.**
+- **На узком экране строка становится карточкой.**
+- **Состав и порядок столбцов задаёт владелец, и выбор сохраняется между заходами.**
+- **Слева в тулбаре — то, что меняет выборку, справа — действия над списком.**
+- **Действие, недоступное записи, в её меню не показано.**
+- **У записи, которой нельзя сделать ничего, кнопки меню нет.**
+- **Действие, которое нельзя отменить, спрашивает подтверждение и называет последствие.**
+- **Отказ загрузки подаётся тостом, а повторить владелец может кнопкой обновления.**
+- **Список показывает тот порядок и тот отбор, которые применены к записям.** Порядок по
+  умолчанию виден стрелкой сразу, а условие, которого сервер не принял, не остаётся в тулбаре
+  как действующее.
+- **Заголовки столбцов, тексты состояний и подписи действий приходят из словарей.**
+
+## Открытые вопросы
+
+- **Q-L-4 — вид списка уходит в адрес у трёх списков.** Промокоды, прежние адреса объекта и
+  подписки на календари читают из адреса номер страницы, порядок и строку поиска; у остальных
+  списков выборка живёт в состоянии экрана: перезагрузка возвращает список к умолчанию, а
+  ссылку на отфильтрованный список не передать. Решено класть в адрес весь вид списка — фильтры, сортировку и номер страницы, — чтобы ссылка открывала ту же
+  страницу с тем же порядком, а возврат из панели ничего не сбрасывал. Размер страницы и состав
+  столбцов остаются за владельцем и в адресе не участвуют. Заведён 2026-08-01.
+- **Q-L-5 — страницу отдают три процедуры.** Промокоды, прежние адреса объекта и подписки на
+  календари принимают выборку и отвечают страницей; остальные списки приходят одним ответом
+  целиком, и заявки за несколько сезонов по нескольким объектам придут им же. Решено, что
+  список запрашивается страницей: номер и размер страницы, сортировка по одному полю
+  и несколько фильтров сразу. Форма запроса одна на все списки и объявлена в общей части
+  контракта, а не переписывается в каждом домене. Ответ несёт общее число записей — без него не
+  показать, сколько страниц. Заведён 2026-08-01.
+- **Q-L-7 — выпадающие списки грузятся целиком.** Выбор объекта, гостя или тега приходит одним
+  ответом. Решено брать их той же страницей, что и таблицу, но догружать следующую при
+  прокрутке: страниц в таком списке не видно, значит и переключать их нечем. Заведён 2026-08-01.

package/assets/laws/admin-navigation.md

@@ -0,0 +1,50 @@
+# Навигация админки
+
+Как владелец находит раздел и попадает в него. Правила держат все разделы админки сразу —
+заявки, объекты, календарь, переписку, аналитику, цены, организацию, — и разойтись им нельзя:
+раздел, который ведёт себя иначе остальных, выглядит сломанным.
+
+**Ревизия:** 2026-08-02
+
+## Статьи
+
+- **Пункт меню ведёт на свой экран.** Не на вкладку внутри чужого экрана и не на панель: адрес
+  открывается по прямой ссылке, переживает перезагрузку и передаётся другому человеку.
+- **Раздел, ни один пункт которого владельцу не виден, в меню не показан.**
+- **Адрес раздела открывается только тому, кому виден его пункт меню.**
+- **Одного права из перечисленных достаточно, чтобы раздел был виден.** Части страницы гейтятся
+  отдельно: дашборд полезен и тому, кто видит только деньги, и тому, кто видит только трафик.
+- **Пункт, у которого экрана ещё нет, виден любому владельцу.** Права на него не выдаются:
+  право открывает экран, а экрана нет.
+- **Недоступный пункт остаётся видимым.** Исчезнувший пункт неотличим от того, которого никогда
+  не было.
+- **Подсказка есть только у недоступного пункта и объясняет, почему он не нажимается.** У
+  доступного она дословно повторяет подпись рядом и ничего не добавляет.
+- **Недоступный пункт принимает наведение и фокус с клавиатуры.**
+- **Адрес экрана начинается с адреса раздела, в котором стоит его пункт меню.**
+- **Активный раздел подсвечен, даже когда открыт его вложенный экран.**
+- **Подписи разделов приходят из словарей и меняются вместе с языком без перезагрузки.**
+- **Панель второго уровня открывается наведением, нажатие — запасной путь для касания.**
+- **Панель второго уровня разложена колонками, а внутри колонки — группами с подписью.**
+- **Колонка без заголовка у первой группы начинает пунктами от верха панели.** Пустое место
+  на высоту заголовка в ней не оставляется.
+- **Ширина панели зависит от числа колонок, а не от длины подписей.**
+- **Панель целиком помещается в экран.** Панель на три колонки шире расстояния от своего
+  раздела до правого края, и без этого её последняя колонка остаётся за экраном.
+- **Раздел с панелью несёт указатель раскрытия, раздел без панели — не несёт.** Иначе не видно,
+  откроется ли что-то при наведении, и владелец наводит наугад.
+- **На узком экране меню сворачивается в кнопку и раскрывается списком с теми же разделами.**
+- **Меню на узком экране прокручивается, когда пункты не помещаются по высоте.**
+
+## Открытые вопросы
+
+- **Q-N-5.** Хлебных крошек нет: на вложенном экране не видно, из какого он раздела и как вернуться
+  на уровень выше. Заведён 2026-08-01.
+- **Q-N-6 — маркер непросмотренного не загорается ни у одного пункта.** Точку кит рисует, и у
+  раздела с панелью она сводится с его пунктов, но признак не поднимает никто: отметки «владелец
+  видел до сюда» нет ни в контракте, ни в базе. Решение заведёт отметку на пару владелец-раздел,
+  научит разделы считать записи, появившиеся после последнего захода, и гасить точку при
+  открытии. Заведён 2026-08-01, переписан 2026-08-02.
+- **Q-N-8 — «Финансы» показывают одну подсказку вместо счетов и налогов.** Раздел стоит в ряду
+  недоступным: спеков на счета организации и расчёт налогов нет, и показывать в нём нечего.
+  Решение опишет раздел спеком и заведёт его экраны. Заведён 2026-08-02.

package/assets/laws/code-structure.md

@@ -0,0 +1,32 @@
+# Устройство кода
+
+Что должно быть верно про сам код независимо от того, что он делает. Закон нужен потому, что
+код читают чаще, чем пишут: имя, по которому не видно рода объявления, и тип, объявленный
+подходящим вместо проверенного, стоят читателю отдельного похода в соседний файл.
+
+**Ревизия:** 2026-08-05
+
+## Статьи
+
+- **Имя объявления говорит, какого оно рода.** Без этого род объявления выясняется переходом
+  к нему, и на каждом чтении заново.
+- **Источник значения, за которым следят, виден по его имени.** Иначе подписка на него
+  выглядит как обычное чтение, и её забывают снять.
+- **Тип берётся из того пакета, где объявлен.** Своя копия чужого типа расходится с
+  оригиналом молча, а компилируется из них только одна.
+- **Отметка об устаревании — повод убрать, а не повод оставить.** Устаревшее объявление,
+  которое молча продолжает работать, переживает того, кто его пометил.
+
+## Открытые вопросы
+
+- **Q-CS-1 — приведение значения к типу не проверяет ничто.** Объявить значение подходящим
+  вместо того, чтобы проверить, можно в любом месте: приведение принимает любую строку и
+  компилируется. Решение изменит, появится ли на это проверка. Заведён 2026-08-05.
+- **Q-CS-2 — имя файла не связано с тем, что в нём лежит.** Соответствие держится
+  договорённостью, и файл под чужим именем проходит все проверки. Решение изменит, появится
+  ли на это проверка. Заведён 2026-08-05.
+
+## История изменений
+
+- **2026-08-05.** Закон заведён: статьи собраны из правила `typescript-conventions` — в нём
+  осталось то, из чего объявление собирается.

package/assets/laws/delivery.md

@@ -0,0 +1,34 @@
+# Поставка
+
+Как правка доезжает до работающего приложения. Закон держит и историю изменений, и то, что
+в этот момент видит пользователь: неудачная выкатка отличается от удачной только тем, что
+приложение перестаёт отвечать, а причина этого выясняется по истории.
+
+**Ревизия:** 2026-08-05
+
+## Статьи
+
+- **Правка попадает в главную ветку только через отдельную ветку.** Прямая запись в главную
+  лишает правку и обсуждения, и возможности откатить её одним движением.
+- **Попадание правки в главную ветку означает выкатку.** Всё, от чего правка зависит снаружи
+  кода — переменные окружения, секреты, записи имён, — ставится до этого момента, а не после.
+- **Выкатывается образ того коммита, который выкатывают.** Умолчание «последний» отстаёт от
+  главной ветки, и приложение молча возвращается к прежней версии, продолжая отвечать.
+- **Порядок изменений хранилища проверяется с пустого места.** На уже работающем хранилище
+  неверный порядок незаметен: он проявляется только при развёртывании с нуля.
+- **Документ едет вместе с правкой, которую он описывает.** Ни сборка, ни проверки текстов
+  не читают, поэтому расхождение копится молча и потом выглядит действующей справкой.
+
+## Открытые вопросы
+
+- **Q-D-1 — что происходит с выкаткой, когда правка задела несколько задач.** Сегодня одна
+  ветка закрывает одну задачу, и вторая идёт отдельной строкой связи. Решение изменит, можно
+  ли откатить одну задачу, не откатывая соседнюю. Заведён 2026-08-05.
+- **Q-D-2 — связь ветки с задачей не проверяет ничто.** Имя ветки складывается по
+  договорённости, и ветка без номера задачи проходит все гарды. Решение изменит, появится ли
+  на это проверка или связь остаётся за автором. Заведён 2026-08-05.
+
+## История изменений
+
+- **2026-08-05.** Закон заведён: статьи собраны из правила `git-workflow` — в нём осталось
+  то, из чего поставка собирается.

package/assets/laws/entity-editing.md

@@ -0,0 +1,73 @@
+# Правка сущности
+
+Как ведёт себя приложение, когда владелец создаёт или меняет запись: объект, бронь,
+подписку на календарь, адрес страницы. Поведение одинаково во всех разделах админки и ни
+одному домену не принадлежит — спек домена описывает только то, что у него своего.
+
+Попадание в запись из набора и объём запрашиваемых данных — предмет других законов.
+
+**Ревизия:** 2026-08-02
+
+## Статьи
+
+- **Асайд закрывается только после успешного запроса.** Закрытие — сигнал «сохранено»,
+  и закрыть его до ответа значит соврать.
+- **Пока запрос идёт, кнопка сохранения показывает спиннер и недоступна.** Второе нажатие
+  иначе шлёт второй запрос по той же форме.
+- **Отказ остаётся внутри асайда, рядом с полями.** Асайд не закрывается, введённое
+  сохраняется, кнопка снова доступна — владелец правит и повторяет, а не набирает заново.
+- **Новый запрос гасит прежнюю ошибку.** Иначе рядом с работающей формой висит сообщение
+  о прошлой неудаче.
+- **Создание закрывает асайд всегда, редактирование — по решению экрана.** Созданной
+  записи на экране ещё нет, и оставаться в форме не над чем; при правке экран может
+  оставить асайд открытым и перечитать запись.
+- **Успешная правка подтверждается тостом.** Закрывшийся асайд сам по себе не говорит,
+  сохранилось ли, — особенно когда список за ним обновляется не сразу.
+- **Кнопка записи недоступна, пока в форме ничего не изменили.** Иначе владелец отправляет
+  запрос без правок и получает подтверждение ни о чём.
+- **Закрытие панели с несохранёнными правками спрашивает, что с ними сделать: закрыть без
+  сохранения, закрыть с сохранением или остаться.** Вопрос задаётся на каждом из четырёх
+  путей закрытия.
+- **Кнопка закрытия называет судьбу правок: «Закрыть и не сохранять» на панели с записью и
+  «Закрыть» на панели только для просмотра.**
+- **Ссылка на запись, которой уже нет, не оставляет пустой панели.**
+- **Панель узнаёт, что показывать, из адреса: идентификатор записи стоит в нём.** Иначе панель не
+  открыть по ссылке и не восстановить после перезагрузки.
+- **У панели есть шапка с заголовком и футер, и в футере хотя бы кнопка закрытия.**
+- **Заголовок панели называет действие, а имя записи стоит надстрочником над ним.** Заголовок
+  из одного названия записи не говорит, что сейчас произойдёт.
+- **Создание и правка названы в заголовке по-разному.**
+- **Связанная запись открывается из панели ссылкой.**
+- **Переход по ссылке из панели с несохранёнными правками спрашивает о них так же, как
+  закрытие.**
+- **Кнопка записи в футере одна: «Создать» при создании, «Сохранить» при правке.** Она стоит у
+  противоположного края от кнопки закрытия.
+- **Панель закрывается четырьмя путями: кнопкой в шапке, кнопкой в футере, нажатием мимо неё и
+  клавишей Esc.**
+- **Закрытая панель нажатий не перехватывает.** Она стоит за краем экрана, ничего не видно, и
+  страница под ней перестала бы отвечать на нажатия молча.
+- **Прокручивается только содержимое: шапка и футер видны всегда.**
+- **Поля во всех панелях отбиты от края одинаково и получают одну ширину.** Прокручивается
+  при этом всё содержимое целиком, поэтому обводка фокуса у крайнего поля видна полностью.
+- **Пока запись читается, поля показаны скелетонами.**
+- **Запись, которую можно только смотреть, показана данными, а не полями ввода.** Поле ввода,
+  которое не принимает ввод, владелец сначала пробует заполнить.
+- **Непонятное объясняется на месте: подсказкой под полем или сообщением над формой.**
+
+## Открытые вопросы
+
+- **Q-E-4 — дополнительных действий в шапке нет ни у одной панели.** Место для них есть, но
+  доменные действия живут только в меню строки списка, поэтому из открытой записи их не
+  выполнить. Решено ставить их иконками справа в шапке и прятать под одну кнопку меню, когда их
+  больше двух. Заведён 2026-08-01.
+- **Q-E-5 — вкладок в панелях нет.** Разделы идут подряд одной полосой, и до нижнего нужно
+  прокручивать всю форму. Решено раскладывать разделы по вкладкам, оставлять вкладки на месте
+  при прокрутке и не заводить действий, относящихся к содержимому одной вкладки: с закрытой
+  вкладки такое действие не видно, а на открытой спорит с общей кнопкой записи. Заведён
+  2026-08-01.
+- **Q-E-8 — ненайденная запись обрабатывается двумя способами.** Панель промокода показывает
+  «код не найден» и остаётся открытой, остальные уходят с адреса. Заведён 2026-08-01.
+- **Q-E-12 — правки формы документа пропадают при закрытии молча.** Карточка заявки собирает
+  адресата и состав гостей, но записывает их только выдачей документа, поэтому вопрос о
+  несохранённых правках ей задать нечем: исход «закрыть с сохранением» отправил бы гостю
+  письмо. Заведён 2026-08-02.

package/assets/laws/entity-models.md

@@ -0,0 +1,34 @@
+# Модели сущностей
+
+Сколько данных приложение запрашивает и отдаёт на каждом экране: строка списка, открытая
+запись, пункт выпадающего списка. Одна и та же сущность выглядит на них по-разному, и разница
+эта не украшение — от неё зависит, сколько владелец ждёт список.
+
+Как список показывает записи и как ведёт себя панель правки — предмет других законов.
+
+**Ревизия:** 2026-08-01
+
+## Статьи
+
+- **У сущности две стороны: то, что пришло из контракта, и то, чем пользуется экран.** Первая
+  повторяет контракт дословно, вторая нормализована и от смены контракта не зависит.
+- **Сторона контракта руками не пишется.** Она объявляется псевдонимом сгенерированного типа:
+  переписанное вручную расходится с контрактом молча.
+- **Между сторонами стоит перевод, и экраны читают только вторую.**
+- **Пустое значение выражается пустой строкой или нулём, а не отсутствием поля.** Необязательных
+  скаляров в контракте нет, и «не задано» у каждого поля значит своё.
+
+## Открытые вопросы
+
+- **Q-M-1 — уровней у моделей нет.** У сущности одна модель на все случаи: строка списка,
+  открытая запись и пункт выпадающего списка получают одинаковый набор полей. Решено завести
+  уровни, где каждый следующий расширяет предыдущий, а не повторяет его поля: короткий — для
+  строки списка, выпадающего списка и подсказок ввода, полный — для открытой записи. Заведён
+  2026-08-01.
+- **Q-M-2 — контракт короткой модели не различает.** Одно сообщение отдаётся и списком, и
+  поштучно, поэтому список тянет поля, которые в нём не показаны: фотографии, длинные тексты и
+  вложенные наборы. Решено разделить контракт на короткое сообщение списка и полное сообщение
+  записи. Заведён 2026-08-01.
+- **Q-M-3 — открытая запись берётся из уже загруженного списка.** Своего чтения по
+  идентификатору нет: панель, открытая по ссылке, ждёт, пока подгрузится весь список. Заведён
+  2026-08-01.

package/assets/laws/frontend-application.md

@@ -0,0 +1,34 @@
+# Фронтовое приложение
+
+Как устроено то, что рисует экран. Закон держит и сайт, и админку сразу: экран, устроенный
+иначе соседнего, пользователь читает заново, а разработчик правит вслепую.
+
+**Ревизия:** 2026-08-05
+
+## Статьи
+
+- **Состояние экрана пересчитывается само, а не по команде.** Пересчёт вручную рано или
+  поздно пропускают, и экран показывает прежнее значение рядом с новым.
+- **Шаблон показывает готовое, а не вычисляет.** Вычисление в шаблоне повторяется на каждой
+  перерисовке, и цена его не видна ни в одном месте кода.
+- **Подписка живёт не дольше того, кто её завёл.** Пережившая владельца подписка продолжает
+  работать на уничтоженном экране и держит его в памяти.
+- **Оформление берётся из общего набора значений, а не пишется числом на месте.** Написанное
+  числом расходится с остальным при первой же смене оформления, и найти все такие места
+  нечем.
+- **У каждого класса в разметке есть своё правило стилей.** Класс без правила выглядит
+  рабочим и молча ничего не делает.
+- **Набор записей приходит с сервера страницей, а не целиком.** Список, растущий вместе с
+  данными, однажды перестаёт открываться, и заметно это становится уже у пользователя.
+
+## Открытые вопросы
+
+- **Q-FA-1 — обращение к окружению браузера не проверяет ничто.** Прямое обращение к
+  глобальному объекту компилируется и падает только при отдаче страницы сервером. Решение
+  изменит, появится ли на это проверка. Заведён 2026-08-05.
+
+## История изменений
+
+- **2026-08-05.** Закон заведён: статьи собраны из правил `angular-patterns`,
+  `component-structure`, `styling-bem`, `platform-access` и `api-layer` — в них осталось то,
+  из чего экран собирается.

package/assets/laws/lib-imports.md

@@ -0,0 +1,31 @@
+# Импорты между либами
+
+Кто кого видит. Приложение нарезано на либы, и у каждой объявлен список тех, от кого ей
+разрешено зависеть: так домен, которому незачем знать про чужой транспорт или чужие экраны,
+и не получает к ним доступа. Список этот работает, только пока символ приходит оттуда, где
+объявлен.
+
+Закон отвечает на вопрос, откуда берётся импорт. Раскладка самих либ и слоёв — не его
+предмет.
+
+**Ревизия:** 2026-08-02
+
+## Статьи
+
+- **Либа отдаёт наружу только то, что объявила сама.** Чужой символ через неё не проходит:
+  потребитель импортирует его у той либы, где символ объявлен.
+- **Право видеть либу даётся списком её тега, а не соседом.** Не хватает права — оно
+  дописывается строкой с объяснением, зачем оно понадобилось.
+- **У либы, общей всем трём приложениям, список зависимостей пуст.** Её видит и бэкенд, и
+  любая её зависимость стала бы общей для всех сразу.
+
+## Открытые вопросы
+
+- **Q-I-2 — куда положен общий символ, не проверяет ничто.** `check:dupes` ловит копию по
+  совпавшему имени или набору членов, а та же логика, написанная заново под другим именем,
+  проходит. Решение изменит, появится ли на это проверка или выбор места остаётся за ревью.
+  Заведён 2026-08-02.
+- **Q-I-3 — доменом ли заведено то, у чего нет ни экранов, ни состояния, ни запросов, не
+  проверяет ничто.** Проверка раскладки требует полного набора слоёв у всех, поэтому пустой
+  слой механики выглядит так же, как слот домена, который заполнит следующая задача. Решение
+  изменит, станет ли признак «непуст один только `util`» отказом проверки. Заведён 2026-08-02.

package/assets/laws/locales.md

@@ -0,0 +1,44 @@
+# Локали и переводы
+
+Как в системе устроены языки: адреса публичного сайта, подписи интерфейса, переводы
+контента и язык админки. Правила держат сайт, админку, письма и документ-подтверждение
+одновременно.
+
+**Ревизия:** 2026-07-31
+
+## Терминология
+
+| Термин           | Определение                                                                                                                                |
+| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
+| Локаль сайта     | Один из восьми языков, на которых существует публичный сайт. Не то же, что валюта показа: валюта у локали лишь начальная и меняется гостем |
+| Локаль ввода     | Язык, на котором владелец написал текст объекта. Задаёт истину: остальные семь считаются производными                                      |
+| Словарь          | Набор подписей интерфейса для одной локали. Живёт в репозитории, а не в базе                                                               |
+| Перевод контента | Текст объекта на локали, отличной от локали ввода. Живёт в базе и заполняется системой                                                     |
+
+## Статьи
+
+- **Локаль по умолчанию отдаётся из корня, остальные семь — из-под префикса пути.**
+- **Видимый человеку текст интерфейса берётся из словарей и заводится во всех восьми
+  локалях.** Ключ, потерянный в одной локали, гость видит на кнопке как есть.
+- **Пустой перевод считается пропуском, а не переводом.** На экране он выглядит как
+  задуманный: кнопка без подписи, заголовок без текста.
+- **Переводы контента производные: владелец пишет текст на своём языке, остальные семь
+  локалей заполняет система при сохранении.** Табов локалей в формах нет — правка вручную
+  всё равно была бы перезаписана.
+- **Отказ перевода сохранение не срывает.** Текст на локали ввода записывается, прежние
+  переводы остаются, и владелец видит предупреждение, а не сообщение об успехе.
+- **Локаль, для которой перевода не пришло, сохраняет прежнее значение.** Половина ответа
+  лучше пустого описания на витрине.
+- **Язык админки выбирает владелец, и выбор живёт в его профиле.** Он же уходит в локаль
+  ввода при сохранении объекта.
+- **У локали есть начальная валюта показа.** Дальше валюту выбирает гость, и его выбор
+  сильнее умолчания локали.
+
+## Открытые вопросы
+
+- **Q-L-1.** Что показывать гостю, чей перевод объекта устарел после правки владельца, но
+  ещё не перезаписан из-за отказа провайдера? Сейчас видно прежний текст, признака
+  устаревания у страницы нет. Заведён 2026-07-31.
+- **Q-L-2.** Как выбирается локаль гостю, пришедшему на корень сайта: сегодня это адрес, а
+  не язык браузера. Решение изменит поведение первой страницы и набор адресов, которые
+  попадают в кэш. Заведён 2026-07-31.

package/assets/laws/project-documentation.md

@@ -0,0 +1,39 @@
+# Документация проекта
+
+Что должно быть верно про тексты, которые проект о себе пишет. Расхождение документа с
+работающим приложением беззвучно: ни сборка, ни проверки текстов не читают, поэтому
+устаревшее описание живёт дальше и выглядит действующей справкой — тем убедительнее, чем оно
+старше.
+
+**Ревизия:** 2026-08-05
+
+## Статьи
+
+- **У документа заранее задан набор разделов, и отсутствие раздела — отказ.** Требования,
+  для которых не заведено места, вспоминаются уже после выкатки.
+- **Каждое утверждение документа привязано к месту, где оно исполняется.** Утверждение без
+  такого места — намерение, и называть его действующим нельзя.
+- **Привязка не ведёт в код, который никто не зовёт.** Объявленный и никем не используемый
+  символ ничего не исполняет, а проверка на нём остаётся зелёной.
+- **Путь, названный в документе, существует.** Ссылка на переехавший файл читается как
+  действующее указание, и следующий читатель заводит снятое заново.
+- **Документ, разошедшийся с приложением, правится тогда же, когда замечено расхождение.**
+  Отложенная правка не случается: расхождение перестаёт быть заметным на следующий день.
+
+## Открытые вопросы
+
+- **Q-PD-1 — утверждение о будущем не проверяет ничто.** «Не планируется», «не будет» — это
+  намерение, а не свойство приложения, и сверить его не с чем: оно проходит любую проверку.
+  Решение изменит, появится ли на это проверка или это остаётся за читателем. Заведён
+  2026-08-05.
+- **Q-PD-2 — число в тексте стареет молча.** Пересчёт числа командой в том же изменении
+  держится договорённостью; устаревшее число выглядит так же, как свежее. Решение изменит,
+  появится ли способ отличить одно от другого. Заведён 2026-08-05.
+- **Q-PD-3 — начало работы с описания не проверяет ничто.** Порядок «сначала описание, потом
+  код» держится договорённостью, и обратный порядок виден только по истории. Решение
+  изменит, появится ли на это проверка. Заведён 2026-08-05.
+
+## История изменений
+
+- **2026-08-05.** Закон заведён: статьи собраны из правил `spec-driven` и `doc-style` — в них
+  осталось то, из чего документ собирается и как он формулируется.

package/assets/laws/reuse-first.md

@@ -0,0 +1,35 @@
+# Единообразие приложения
+
+Одинаковые вещи в сайте и в админке выглядят и ведут себя одинаково: поле ввода отвечает на
+ошибку так же, как соседнее, панель правки закрывается так же, как в другом разделе, отказ
+подаётся так же на любом экране. Держится это тем, что части собраны из общего кита и общих
+основ, а не написаны заново каждая под себя.
+
+Закон говорит о том, что верно для владельца и гостя. Как эти основы устроены в коде — не
+его предмет.
+
+**Ревизия:** 2026-08-04
+
+## Статьи
+
+- **Готовое из кита и общих основ берётся, а не пишется заново.** Своя копия расходится с
+  оригиналом с первой же правки, и одинаковые с виду места начинают вести себя по-разному.
+- **Свой примитив и своя основа заводятся только с ведома владельца.** Отступление от общего
+  вида — решение о продукте, а не деталь реализации.
+- **Поле ввода ведёт себя одинаково во всех формах.** Значение, недоступность, тронутость и
+  показ ошибки у всех полей одни.
+- **Панель правки записи ведёт себя одинаково во всех разделах.** Открытие адресом, скелетоны
+  на чтении, спиннер на записи, вопрос о несохранённых правках и закрытие после успеха.
+- **Сообщение об успехе и об отказе подаётся одинаково на всех экранах.** Разный вид у
+  одинаковых по смыслу сообщений читается как разные состояния приложения.
+- **Стили компонента живут в его файле стилей.** Заданные в разметке или в декораторе, они
+  видны только на своём экране, и соседний остаётся с прежним видом.
+- **Раскладка экранов, форм, панелей и окон одна на всё приложение.** Отступы страницы,
+  заголовок, полоса действий и зона содержимого у всех разделов одни, и меняются они разом.
+
+## Открытые вопросы
+
+- **Q-R-2 — расхождение вида на уже написанных экранах не измерено.** Гард отбивает новое, а
+  сколько мест сегодня показывают отказ и поля не так, как кит, известно только по одному
+  признаку — `role="alert"` вне кита. Решение изменит, заводится ли на это проверка по дереву
+  или разбор идёт экраном за экраном. Заведён 2026-08-03.