@rt-tools/agent-kit 0.1.0 → 0.3.0

package/assets/rules/component-structure.md

@@ -0,0 +1,48 @@
+---
+name: component-structure
+kind: rule
+law: frontend-application
+description: Правило под закон «Фронтовое приложение». Брать при правке любого файла компонента и его шаблона — порядок свойств декоратора, группировка импортов, договорённости шаблона, обязательный якорь для спек, класс блока на хосте. Готовый код — в паттерне component-structure-new. Чем это названо здесь — в implementation.md рядом.
+---
+
+# Файл компонента — каким приёмом
+
+Правило под закон `{{lawsDir}}/frontend-application.md`. Закон говорит, что должно быть верно;
+здесь — как устроен сам файл компонента и его шаблон. Какой у компонентов префикс, чем зовётся
+якорь спек и где лежат правила линтера — `implementation.md` рядом. Состояние и потоки —
+`angular-patterns`, оформление — `styling-bem`, окружение браузера — `platform-access`, слой
+обращения к серверу — `api-layer`. Все пять под одним законом.
+
+## Когда берётся
+
+Заведение или правка файла компонента и его шаблона.
+
+## Что здесь действует
+
+- **Шаблон не зовёт методов.** Вызов в привязке считается заново на каждую проверку изменений;
+  готовое значение объявляется вычисляемым, а там, где оно зависит от контекста шаблона, —
+  чистым преобразователем.
+- **Каждый интерактивный элемент несёт якорь для спек.** Это единственная устойчивая зацепка:
+  классы оформления меняются вместе с вёрсткой, а поиск по роли и тексту ломается на первой же
+  второй локали.
+- **Класс блока висит на хосте, а не на обёртке внутри шаблона.** Лишняя обёртка вокруг всех
+  детей — это раскладка, и ей место на хосте.
+- **Якорь для спек не заменяет доступности и не снимается при правке вёрстки.** Доступность
+  отдельно, якорь отдельно; на якорь завязаны спеки, и снятый он роняет их молча.
+
+## Паттерны
+
+- `component-structure-new` — готовый файл компонента и договорённости шаблона.
+
+## Ловушки
+
+- **Ссылка на фрагмент в разметке не прокручивает страницу.** Когда в разметке объявлен
+  базовый адрес, браузер разрешает фрагмент относительно него: вместо прокрутки получается
+  полная навигация с перезагрузкой. Прокрутка делается средствами маршрутизатора.
+- **Один и тот же компонент в обеих ветках условия — это условная привязка.** Две ветки с
+  разными входами пересоздают компонент и теряют его состояние.
+- **Компонент, который рисуется в перекрытии, из хоста вызывающего не адресуется.** Его
+  разметка лежит вне хоста, и селектор от хоста до его кнопок не дотянется: такие кнопки носят
+  собственные якоря в своём шаблоне.
+- **Готовое не пишется заново.** Своя разметка с ролью оповещения, таблицы, диалога, вкладок
+  или подсказки означает, что мимо готового компонента прошли. Правило целиком — `reuse-first`.

package/assets/rules/doc-style.md

@@ -0,0 +1,61 @@
+---
+name: doc-style
+kind: rule
+law: project-documentation
+description: Правило под закон «Документация проекта». Брать при правке любого документа, включая спеки, а также комментариев в коде, тел коммитов и описаний PR. Пути, которые существуют, пара «правка и её документ», словарь проекта, запрет упоминать чужие проекты. Готовые формулировки — в паттерне doc-style-write. Чем это названо здесь — в implementation.md рядом.
+---
+
+# Тексты проекта — каким приёмом
+
+Правило под закон `{{lawsDir}}/project-documentation.md`. Закон говорит, что должно быть верно
+про тексты; здесь — каким приёмом это держится и что остаётся за автором. Где лежит словарь,
+чем проверяются пути и какие пары требует гейт — `implementation.md` рядом. Устройство спеков и
+слоёв документации — правило `spec-driven` под тем же законом.
+
+## Когда берётся
+
+Правка любого документа, комментария в коде, тела коммита, описания PR.
+
+## Что здесь действует
+
+- **Путь, названный в документе, существует.** Ссылка на переехавший файл читается как
+  действующее указание, и следующий читатель заводит снятое заново.
+- **Описание прошлого из проверки путей выведено целиком.** Архив по устройству называет файлы,
+  которых уже нет, и правкой это не лечится.
+- **Документ едет в том же коммите, что и правка, которую он описывает.** Обход — отметка с
+  причиной в теле коммита; пустая причина не принимается.
+- **Термин берётся из словаря проекта, а не придумывается на месте.** Слова, которого там нет,
+  у читателя нет тоже. Новое слово либо заводится в словаре вместе с правкой, либо заменяется
+  тем, что уже есть.
+- **Чужие проекты не упоминаются нигде** — ни имени репозитория, ни «портировано из», ни ссылок
+  на его файлы. Описывается то, что код делает здесь, в терминах этого проекта.
+
+## Паттерны
+
+- `doc-style-write` — как формулировать: примеры «так» и «не так», правила для комментариев.
+- `doc-style-sweep` — разбор документа, накопившего список работ, на действующее и закрытое.
+
+## Ловушки
+
+- **Оставшаяся работа не записывается в документ, а заводится задачей.** «Сделать потом» в
+  плане, README или спеке — второй список работ: он расходится с очередью задач молча, а
+  разбирать его потом дороже, чем завести задачу сразу. Документ держит только то, что задачей
+  не бывает: договорённости и решения, которые решено не править.
+- **Словарь действует и на разговор с владельцем, не только на файлы.** Слово, от которого в
+  дереве отказались, всплывает именно в отчёте о сделанном — и владелец читает ровно то слово,
+  которое просил не употреблять.
+- **Проход по словарю глазами слово не находит.** «Формулировки приведены к словарю» означает
+  ровно те строки, которые в тот момент читали. Снятое слово вычищается поиском по всему дереву,
+  а не вычиткой; ищутся сочетания, а не корень — совпадений по корню законных обычно больше,
+  чем нарушений.
+- **Снятое имя вычищается одним проходом по всему дереву:** правила, их зеркала, документы и
+  комментарии. Описание того, чего в коде уже нет, читается как действующее указание.
+- **Число в тексте пересчитывается командой в том же коммите, где пишется.** Оно стареет внутри
+  одной ветки. Число, которое придётся пересчитывать при каждой правке, лучше не писать вовсе;
+  число, полученное разбором текста, сверяется на выборке руками — разбор, не знающий второй
+  формы записи, ошибается молча.
+- **Сделанность читается по дереву, а не по тексту, который о ней написан.** Это верно в обе
+  стороны: вычеркнутый пункт при несделанной работе и несделанным названная задача, закрытая
+  наполовину, встречаются одинаково часто. Пункт плана описывает день, когда его написали.
+- **Комментарий в файле — такое же утверждение, как строка в документе.** Выдуманное
+  обоснование живёт в коде годами и каждый раз читается как основание ничего не трогать.

package/assets/rules/git-workflow.md

@@ -0,0 +1,106 @@
+---
+name: git-workflow
+kind: rule
+law: delivery
+description: Правило под закон «Поставка». Брать на заведение задачи, ветки, коммит, пуш, создание PR, слияние, а также на правку схемы хранилища и её миграций. Задача как начало работы, колонка задачи как ход работы, соответствие задачи и ветки один к одному, формат коммита, обязательный состав PR, сторожевые хуки. Готовый код — в паттернах git-workflow-commit, git-workflow-merge, git-workflow-migration и git-workflow-restart. Чем это названо здесь — в implementation.md рядом.
+---
+
+# Поставка — каким приёмом
+
+Правило под закон `{{lawsDir}}/delivery.md`. Закон говорит, что должно быть верно; здесь — каким
+приёмом это держится. Как названы главная ветка, борда, колонки, формат имени ветки и учётная
+запись машинной работы — `implementation.md` рядом.
+
+## Когда берётся
+
+Заведение задачи и ветки, коммит, пуш, открытие PR, слияние, правка схемы хранилища и её
+миграций, ручной перезапуск прода.
+
+## Что здесь действует
+
+- **Коммит в главную ветку отбивается гардом.** Гард ищет вызов коммита в любом месте команды и
+  смотрит текущую ветку на момент запуска, поэтому составная «создать ветку и сразу коммитить»
+  отклоняется целиком: ветки в момент разбора ещё нет.
+- **Ветка без номера задачи PR не открывает.** Локально такая ветка законна, но правка из неё —
+  это выкатка, за которой в очереди работ ничего не стоит.
+- **Номер ветки и номер в заголовке PR сверяются на месте, а состояние задачи — по борде.**
+  Формат читается из текста команды и работает без сети; существование задачи, её присутствие в
+  очереди, исполнитель и то, что она ещё открыта, — только когда есть чем спросить. Нет сети
+  или нет токена — второй ярус молча пропускается: проверка, падающая в самолёте, перестаёт
+  что-либо значить.
+- **Колонка задачи двигается тем же движением, что и работа.** Ветка заведена — задача
+  переставляется во взятые в работу, PR открыт — в разбор. Перевод идёт сразу за шагом, который
+  его вызвал: очередь работ читают между шагами, а не после них.
+- **Отставшая колонка находится сверкой очереди, а не глазами.** Сверка судит колонку по отчёту
+  в обе стороны: открытый PR при задаче не в разборе и разбор без открытого PR — оба
+  расхождения.
+- **Задачи, чинящиеся одной правкой, сливаются до слияния ветки.** Недостающее из поглощённой
+  дописывается в первую, а сама она уходит из очереди. После слияния ветки слить уже нельзя:
+  она въехала, и откатывается целиком.
+- **Слияние в главную ветку выкатывает прод.** Исключения по путям покрывают только документы,
+  поэтому переменные окружения, секреты и записи имён ставятся до слияния, а не после.
+- **Признак режима объявлен в образе, а не только в составе прода.** Значение, заданное
+  составом, действует лишь на контейнер, поднятый этим составом; ручной прогон того же образа
+  идёт с пустым значением, а пусто здесь означает разработку — со всеми отладочными
+  умолчаниями, которые она разрешает.
+- **Образы выкатываются по хешу коммита, а не по метке «последний».** Метка в реестре отстаёт
+  от главной ветки, и прод молча возвращается к прежней версии, продолжая отвечать.
+- **Цепочка миграций прогоняется с пустого хранилища до слияния.** Порядок применения
+  лексикографический по имени каталога, а метку времени ставит момент создания: миграция из
+  ветки, начатой раньше, встаёт перед той, от которой зависит.
+- **Документ едет в том же коммите, что и правка.** Обход — отметка с причиной в теле коммита;
+  пустая причина не принимается.
+- **Заголовок коммита сверяется с форматом на месте.** Разобранный по типу и области заголовок
+  читается списком, а свободный текст — только целиком.
+- **Перед пушем прогоняются все линтеры, а не один.** Линтер кода обычно не читает файлы стилей
+  вовсе, и правила оформления без второго прогона не проверяет ничто.
+
+## Паттерны
+
+- `git-workflow-commit` — ветка, коммит, пуш и PR от учётной записи машинной работы.
+- `git-workflow-merge` — влить главную ветку в ветку задачи и разрешить конфликт.
+- `git-workflow-migration` — файл миграции и прогон цепочки на одноразовом хранилище.
+- `git-workflow-restart` — ручной перезапуск прода без отката на прежний образ.
+
+## Ловушки
+
+- **Одна работа — одна задача, сколько бы файлов она ни задела.** Числа, за которым правка
+  становится второй задачей, нет: делится то, что придётся откатывать порознь. Сплошная правка,
+  разделённая «по объёму», кончается стиранием лишних задач, закрытием их PR и переносом
+  коммитов с конфликтами.
+- **Задача заводится одной командой, а не набором вызовов подряд.** Очередь работ к репозиторию
+  обычно не привязана, и задача попадает в неё только явным добавлением: переписанный руками
+  шаг оставляет её вне очереди, и заметить это нечем.
+- **Ветка заводится вторым вызовом, а не тем же.** Гард главной ветки отклоняет составную
+  «создать ветку и сразу коммитить» целиком.
+- **Колонка, приведённая в порядок задним числом, ничего не значила ровно тогда, когда очередь
+  читали.** Перевод стоит одной команды и делается на месте, а не собирается в уборку под
+  конец: очередь для того и ведётся, чтобы отвечать в любой момент.
+- **Сторона конфликта бывает удалением, и «сохранить обе стороны» заводит второе объявление.**
+  Главная ветка снимает объявление, потому что символ переехал, — в конфликте это выглядит как
+  сторона, которая ничего не дописала. Разбирается чтением версии главной ветки целиком, а не
+  по куску: обе копии сами по себе исправны, сборка и линтер зелёные.
+- **Конфликт при вливании главной ветки почти всегда лежит в текстах, а не в коде.** Соседние
+  ветки дописывают в конец одних и тех же списков; зелёная сборка после слияния про такой
+  конфликт не говорит ничего.
+- **PR без ревьювера, исполнителя и меток открывать нельзя.** Ревьювер не узнаёт, что его ждут,
+  а метки — единственное, по чему в очереди из полутора десятков PR видно род правки и её
+  область.
+- **Заголовок PR без номера задачи не сопоставить с очередью.** В списке PR тела не видно, а
+  строка о закрытии задачи живёт именно там. Название при этом идёт в сделанном: задача просит
+  исправить, PR отчитывается, что исправлено.
+- **На самом PR не гоняется ничто.** Выкатка запускается пушем в главную ветку, и выборочный
+  прогон по затронутому до PR не доходит: сборки, проверки текстов и браузер идут до
+  публикации.
+- **Субагентам работа с историей запрещена полностью, включая чтение состояния.** Отложенные
+  изменения, спрятанные субагентом, выглядят как потеря всей работы. Историю ведёт главный
+  агент.
+- **Подъём контейнера без явного тега образа подставляет «последний».** Приложение при этом
+  отвечает, и подмену видно только по пропавшим строкам нового кода в журнале.
+- **Команда разработчика для миграций на живом хранилище не запускается.** Любое расхождение
+  состояния она лечит предложением сбросить хранилище, а в нём лежат данные владельца.
+- **Переименованная миграция остаётся в хранилище под прежним именем.** Накат падает на «объект
+  уже существует» и лечится отметкой о применении, а не повторным накатом.
+- **Флаги инструмента миграций не те, что в примерах из сети.** На неизвестный флаг команда
+  печатает справку, а не строку ошибки, — промах виден только в ней. Какие флаги есть сейчас,
+  смотрят в её собственной справке, а не в этом тексте.

package/assets/rules/lib-layers.md

@@ -0,0 +1,54 @@
+---
+name: lib-layers
+kind: rule
+law: lib-imports
+description: Правило под закон «Импорты между либами». Брать при правке манифестов проектов, алиасов, конфигов границ, любого бареля и проверок раскладки, а также когда решается, где живёт общий символ. Готовый порядок действий — в паттернах lib-layers-new и lib-layers-move. Чем это названо здесь — в implementation.md рядом.
+---
+
+# Импорты между либами — каким приёмом
+
+Правило под закон `{{lawsDir}}/lib-imports.md`. Закон говорит, кто кого видит; здесь — каким
+приёмом это держится. Как нарезаны семьи и слои в этом дереве, чем названы теги и где лежат
+конфиги границ — `implementation.md` рядом.
+
+## Когда берётся
+
+Правка манифеста проекта, алиасов, конфига границ, любого бареля, проверок раскладки. И раньше
+всего этого — решение, в какой либе живёт общий символ.
+
+## Что здесь действует
+
+- **Чужой символ не реэкспортируется ни одной из двух форм.** Запрещены и прямой реэкспорт по
+  алиасу, и пара «импорт плюс экспорт того же имени»: вторая выглядит как собственное
+  объявление и глазами в разборе проходит.
+- **Строка с алиасом чужой либы в бареле — тот же реэкспорт.** Относительный путь в бареле
+  законен: он собирает наружу собственные файлы либы.
+- **Не хватает права — оно дописывается строкой в конфиге домена с комментарием.** Импорт,
+  который «просто заработал», означает, что тег ещё не сужен.
+- **У либы, общей всем приложениям, список зависимостей пуст, и каркас фронта туда не
+  попадает.** Её импортирует и серверная сторона, и каркас уехал бы в её сборку; общий двум
+  фронтовым семьям токен внедрения живёт отдельной либой.
+- **Основание семейства видит только слой утилит.** Его зовут все домены семьи, и любая его
+  зависимость становится общей для всех сразу.
+- **Домен заводится под предмет, а не под механику.** Механика, общая нескольким доменам, едет
+  в либу, которой она уже видна: у фронта это основание семейства, у серверной стороны — слой
+  утилит, перечисленный у каждого домена.
+
+## Паттерны
+
+- `lib-layers-new` — завести или удалить либу: генератор, теги, алиас, README.
+- `lib-layers-move` — перенести код между либами: порядок, границы, импорты, README обеих.
+
+## Ловушки
+
+- **Либа, которую никто не импортирует, не проверена ничем.** Линтер и тесты проверяют её саму,
+  а не договор с потребителем: потерянное поле в модели ошибкой не считается, пока нет
+  вызывающего кода. Первый импортёр и есть первая проверка — слой моделей принимается после
+  сборки и живого прогона сценария, а не по зелёному линтеру с тестами.
+- **Проверка раскладки принимается на нарушении, а не на зелёном прогоне.** Нарушение вносится
+  руками, прогон краснеет, правка снимается. У самих проверок тестов обычно нет, и это
+  единственная их приёмка.
+- **Удаление каталога средствами гита оставляет то, что гит не отслеживал.** Кэш сборщика
+  внутри удалённой либы остаётся на диске, и проверка продолжает видеть её как домен без слоёв.
+- **Пустой слой механики неотличим от слота под будущую задачу.** Проверка требует полного
+  набора слоёв у всех, и оба случая выглядят одинаково.

package/assets/rules/permissions.md

@@ -0,0 +1,52 @@
+---
+name: permissions
+kind: rule
+law: access
+description: Правило под закон «Доступ». Брать при заведении или правке обработчика серверной стороны, перехватчика входа, стража маршрута и декларации меню. Четыре вида доступа, объявление ровно одно, пресет плюс точечные правки, закрытие раздела и его адреса одной декларацией. Готовый код — в паттерне permissions-procedure. Чем это названо здесь — в implementation.md рядом.
+---
+
+# Доступ — каким приёмом
+
+Правило под закон `{{lawsDir}}/access.md`. Закон говорит, что должно быть верно; здесь — каким
+приёмом это держится. Как названы права, метки объявления и где лежат перехватчик и сложение
+прав — `implementation.md` рядом.
+
+## Когда берётся
+
+Заведение или правка обработчика серверной стороны, перехватчика входа, стража маршрута,
+декларации пункта меню.
+
+## Что здесь действует
+
+- **Каждый обработчик объявляет свой доступ меткой, и объявление ровно одно.** Обработчик без
+  объявления или с двумя не даёт приложению подняться: молчание здесь опаснее отказа.
+- **Видов доступа четыре: по праву, любому вошедшему, публично и публично с чтением входа.**
+  Последний отдаёт вошедшему больше, чем гостю, — так владелец видит скрытые записи в общем
+  списке.
+- **Права пользователя — это права пресета, поверх которых применены его точечные правки.**
+- **Запрос без входа отбивается как неаутентифицированный, а вход без права — как отказ в
+  доступе.** Это разные ответы: первый лечится входом, второй — нет.
+- **Право проверяется перехватчиком до тела обработчика.** Обработчик не решает, пускать ли
+  вызывающего.
+- **Публичность объявляется с причиной.** Причина — аргумент метки, записанный для читателя
+  кода; ни в ответ, ни в журнал она не уходит.
+- **Пункт меню и адрес раздела закрыты по одной декларации.** Иначе скрытый пункт закрывает
+  раздел лишь на вид: адрес открывается по прямой ссылке.
+- **Пока права не получены, интерфейс ничего не прячет.** Пустая шапка после сетевого сбоя
+  выглядит как сломанное приложение и не оставляет выхода.
+
+## Паттерны
+
+- `permissions-procedure` — объявление доступа у обработчика и закрытие раздела интерфейса.
+
+## Ловушки
+
+- **Обработчик, о котором перехватчик ничего не знает, отбивается как отказ в доступе, а не
+  пропускается.**
+- **Страж стоит на дочерних маршрутах защищённой группы, а не на самой группе.** Страж группы
+  отрабатывает один раз за загрузку страницы и переходов между разделами не видит.
+- **Права приходят ответом профиля уже внутри защищённой группы**, поэтому страж дожидается
+  запуска приложения. Отказ запроса ожидание не роняет: с неизвестными правами не закрывается
+  ничего.
+- **Метки объявления живут в утилитах домена входа, а не рядом с перехватчиком.** Их ставит
+  каждый домен с обработчиками, и ребро к объявлениям дешевле ребра к секрету и хранилищу.

package/assets/rules/platform-access.md

@@ -0,0 +1,49 @@
+---
+name: platform-access
+kind: rule
+law: frontend-application
+description: Правило под закон «Фронтовое приложение». Брать, когда правка задевает глобальный объект или среду исполнения — окно, глобальную область, признак браузера, хранилище, наблюдатели. Глобальное приходит внедрением, среда проверяется службой, а не наличием глобала. Не действует на серверной стороне. Готовый код — в паттерне platform-access-di. Чем это названо здесь — в implementation.md рядом.
+---
+
+# Окружение браузера — каким приёмом
+
+Правило под закон `{{lawsDir}}/frontend-application.md`. Закон говорит, что должно быть верно;
+здесь — каким приёмом прямое обращение к глобальному объекту заменяется. Какими токенами и
+службами это названо и откуда они приходят — `implementation.md` рядом. Состояние —
+`angular-patterns`, файл компонента — `component-structure`, оформление — `styling-bem`, слой
+обращения к серверу — `api-layer`. Все пять под одним законом.
+
+Правило про фронт: на серверной стороне своя среда, и ничего из перечисленного к ней не
+относится.
+
+## Когда берётся
+
+Правка задевает глобальный объект, признак среды, хранилище браузера или наблюдателя за
+разметкой.
+
+## Что здесь действует
+
+- **Глобальный объект приходит внедрением, а не берётся напрямую.** Тип уточняется приведением
+  к глобальной области: конструкторы наблюдателей объявлены на ней, а не на интерфейсе окна.
+- **Среда проверяется службой, а не наличием глобала.** Проверка по наличию верна случайно и
+  ломается на первой же среде, где глобал подставлен.
+- **Место прямого доступа заводится только с согласия владельца.** Их немного, и каждое
+  осознанно: скрипт, работающий до подъёма приложения, обработчик отказа подъёма и код,
+  исполняемый внутри страницы в сквозной спеке. Новое в этот список не добавляется молча.
+
+## Паттерны
+
+- `platform-access-di` — готовые внедрения, приведение типа, чистые функции, проверка среды.
+
+## Ловушки
+
+- **Фабрика токена окна бросает отказ, когда у документа нет представления.** Под отдачей
+  страницы сервером представление есть, и внедрение полем класса безопасно, но служба,
+  обязанная работать без разметки вовсе, берёт окно внутри метода под проверкой среды.
+- **После правки, добавляющей окно в службу, которая создаётся на подъёме, нужна не только
+  сборка, но и поднятый сервер отдачи страниц.** Падение видно только там.
+- **Вокруг хранилища проверка среды не нужна.** Служба хранилища и так уходит в память вне
+  браузера, и лишняя проверка вокруг чтения и записи — мёртвый код.
+- **В чистых функциях внедрения нет** — окно принимается параметром, а внедряет его вызывающий.
+- **Подготавливать состояние сквозной спеки записью в хранилище нельзя** — спека проходит те же
+  шаги, что и пользователь.

package/assets/rules/reuse-first.md

@@ -0,0 +1,69 @@
+---
+name: reuse-first
+kind: rule
+law: reuse-first
+description: Правило под закон «Единообразие приложения». Брать перед заведением любого нового экрана, компонента, поля, стора, сервиса, переводчика моделей или обработчика — на что опираться, по каким признакам видно, что готовое обошли. Что делать, когда готового не хватило, — в паттерне reuse-first-extend. Чем это названо здесь — в implementation.md рядом.
+---
+
+# Единообразие — каким приёмом
+
+Правило под закон `{{lawsDir}}/reuse-first.md`. Закон говорит, что одинаковые вещи ведут себя
+одинаково; здесь — каким приёмом это держится. На какие именно источники вида и основы это
+дерево опирается — `implementation.md` рядом.
+
+## Когда берётся
+
+Заведение нового файла: экрана, компонента, поля, стора, сервиса, переводчика моделей,
+обработчика серверной стороны. Правило берётся **до** первой строки, а не после.
+
+## Что здесь действует
+
+- **Источник вида выбирается по приложению, а не по привычке.** У дерева может быть больше
+  одного источника — свой у каждого приложения; перепутанный приносит на экран форму, которой в
+  этом приложении больше нигде нет.
+- **Работа начинается с чтения готового, а не с чистого файла.** Сначала находится опора —
+  готовый компонент, базовый класс, образец в соседнем домене, — потом пишется своё поверх неё.
+  Соседний домен читается целиком: приём, который кажется новым, обычно уже написан, а
+  переименованный при переносе он перестаёт узнаваться.
+- **Свой примитив и своя основа заводятся только с явного одобрения владельца.** Спрашивается
+  это до того, как написан первый файл, а не после.
+- **Панель правки записи наследует общую основу, а не собирается своей разметкой.** Тогда она
+  открывается, закрывается и спрашивает про несохранённое одинаково во всех разделах.
+- **Об удаче и об отказе сообщает общая шина, а не своя разметка на экране.** Своё сообщение
+  расходится с соседним видом, местом и временем показа.
+- **Компонент объявляется отдельными файлами разметки и стилей.** Шаблон и стили внутри
+  декоратора, атрибут стиля в разметке и правка размеров привязкой к стилю — это оформление, до
+  которого не дотянется ни источник вида, ни линтер стилей.
+- **У компонента экрана файл стилей по умолчанию пустой.** Раскладка объявлена один раз в общем
+  слое приложения, а экран её только применяет.
+- **Готовое расширяется, а не клонируется рядом.** Недостающий вариант заводится в источнике
+  вида или в базовом классе, и его видят остальные экраны. Клон, написанный рядом, забирает
+  правки на себя и расходится с оригиналом с первой же.
+
+## Паттерны
+
+- `reuse-first-extend` — что делать, когда готового не хватило: расширить готовое, объявить
+  разовое отступление маркером, снять его.
+
+## Признаки, по которым видно, что готовое обошли
+
+- в шаблоне фичи стоит нативный элемент ввода, кнопки, выбора, таблицы или диалога;
+- отказ или предупреждение собраны руками — своя область оповещения вместо готового сообщения;
+- в стилях фичи появились перекрытие всего экрана, своя вуаль, слой поверх всего, свои кадры
+  вращения или мерцания;
+- в файле стилей экрана объявлена раскладка, а не только его собственные отличия;
+- компонент сам реализует договор поля формы, вместо того чтобы наследовать основу;
+- имя файла кончается на род готового компонента — кнопку, поле, диалог, таблицу — и лежит вне
+  источника вида;
+- переводчик моделей переводит поля вручную, минуя общую основу;
+- обработчик серверной стороны объявлен без общей метки.
+
+## Ловушки
+
+- **Перенос переизобретением не считается.** Строка, которая уже лежала в дереве, при переезде
+  меняет отступ, оставаясь тем же кодом; сверка идёт без отступов, иначе каждый переезд читался
+  бы как новый код.
+- **Ответ, данный до чтения образца, образец отменяет.** Согласованная форма переигрывается,
+  как только находится готовая: договорённость слабее того, что уже написано и работает.
+- **Подсказка, зовущая за ненаписанным, останавливает работу.** Пока свой вариант не написан,
+  правило зовёт за готовым — а не за тем, что «должно появиться».

package/assets/rules/seo.md

@@ -0,0 +1,50 @@
+---
+name: seo
+kind: rule
+law: search-visibility
+description: Правило под закон «Видимость в поиске». Брать при любой правке, доходящей до разметки публичной части — шаблоны страниц, заголовок и описание, структурированные данные, канонический адрес, языковые ссылки, маршруты, карта сайта, правила обхода, конфиг прокси. Готовый код — в паттернах seo-page и seo-verify. Чем это названо здесь — в implementation.md рядом.
+---
+
+# Видимость в поиске — каким приёмом
+
+Правило под закон `{{lawsDir}}/search-visibility.md`. Закон говорит, что должно быть верно;
+здесь — каким приёмом это держится. Какие локали набраны, где лежит служба тегов и чем зовётся
+канонический путь — `implementation.md` рядом.
+
+## Когда берётся
+
+Любая правка, доходящая до разметки публичной части: шаблон страницы, теги в голове документа,
+структурированные данные, маршруты, карта сайта, правила обхода, конфиг прокси.
+
+## Что здесь действует
+
+- **Свои теги помечены собственным атрибутом и при повторном применении переписываются.** Чужое
+  в голове документа не трогается: после оживления там остаются теги от отдачи сервером.
+- **Канонический адрес ведёт на локализованный путь**, а не на корень и не на адрес локали по
+  умолчанию.
+- **Языковые ссылки строятся по локалям, перевод которых готов**, плюс ссылка на локаль по
+  умолчанию. Полный список локалей для этого не годится: переводы содержимого заполняются
+  отдельно и готовы не всегда.
+- **Список альтернативных локалей не включает локаль самой страницы** — иначе она объявлена и
+  основной, и альтернативной сразу.
+- **Адрес в структурированных данных — канонический адрес самой страницы**, не корень.
+- **Перенаправление с прежнего адреса отдаётся с временем жизни и кэшируется прокси.** Ключ
+  кэша строится без строки запроса, поэтому запросы с ней идут мимо кэша.
+
+## Паттерны
+
+- `seo-page` — правка разметки страницы: теги, структурированные данные, новый маршрут, новая
+  страница в карте сайта.
+- `seo-verify` — проверка отданной разметки на прод-сборке.
+
+## Ловушки
+
+- **Тег, добавленный мимо общей службы, не помечен и потому не переписывается.** Он переживёт
+  переход между страницами и останется от чужой страницы.
+- **Новый маршрут без ветки под каждую локаль существует только в локали по умолчанию.**
+  Остальные адреса отдадут отказ и поисковику, и читателю.
+- **Новая страница не попадает в карту сайта сама** — карта строится из записей, а не из
+  маршрутов.
+- **Адрес режется по первому знаку вопроса и только им.** Простой разрез по всем вхождениям
+  теряет всё после второго, и перенаправление приходит на страницу без разметки источника —
+  источник обращения считается неверно.

package/assets/rules/shared-code.md

@@ -0,0 +1,45 @@
+---
+name: shared-code
+kind: rule
+law: shared-code
+description: Правило под закон «Общий код приложений». Брать, когда значение должно одинаково пониматься всеми приложениями — предел выборки, набор операторов условия, направление порядка, длина поля, форма запроса и ответа списка. Откуда берётся общее, что считается копией и что ловит проверка повторов. Готовый код — в паттерне shared-code-new. Чем это названо здесь — в implementation.md рядом.
+---
+
+# Общий код — каким приёмом
+
+Правило под закон `{{lawsDir}}/shared-code.md`. Закон говорит, что общим быть обязано; здесь —
+каким приёмом это держится. Из какого пакета и какой либы что берётся — `implementation.md`
+рядом.
+
+## Когда берётся
+
+Значение, которое должны одинаково понимать разные приложения: число-настройка, набор значений,
+форма запроса и ответа списка, длина поля.
+
+## Что здесь действует
+
+- **Число-настройка лежит в общей либе и оттуда берётся всеми сторонами.** Умолчание доводом не
+  передаётся: пока довод есть, домен вправе назвать своё число — и называет, расходясь с
+  соседним на единицу, которую никто не заметит.
+- **Набор значений из общего пакета заново не объявляется.** Своё перечисление с теми же
+  членами считается копией, даже если имена разошлись.
+- **Значение из набора сверяется общей функцией, а промах разбирает вызывающий.** Сервер
+  отбивает запрос отказом, экран берёт умолчание: политика на непонятное значение у сторон
+  разная, и общей может быть только сверка.
+- **Общим делается лишь то, где политика одна.** Переводчик, у которого стороны читают
+  непонятное значение по-разному, общим не становится — он расходится молча.
+- **Перечисления полей порядка и отбора домена копией не считаются.** Они повторяют имена, по
+  которым сортирует сервер именно этого домена, и совпадение здесь случайное.
+
+## Паттерны
+
+- `shared-code-new` — как завести новое общее число, функцию или тип и не оставить копию.
+
+## Ловушки
+
+- **Помощник приведения типов для сверки с набором не годится.** Значение вне набора он пишет в
+  журнал и возвращает строкой, то есть глотает ровно тот случай, ради которого сверку и завели.
+- **Накопленные повторы лежат в списке исключений и отказом не считаются.** Гейт падает только
+  на новом; список исключений только сокращается.
+- **Проверка не ловит ту же логику, написанную заново под другим именем.** Совпадение она ищет
+  по тексту, а не по смыслу.