@rt-tools/agent-kit 0.1.0 → 0.3.0

package/assets/rules/spec-driven.md

@@ -0,0 +1,89 @@
+---
+name: spec-driven
+kind: rule
+law: project-documentation
+description: Правило под закон «Документация проекта». Брать при правке спека домена, закона и любого скила. Три слоя — закон, правило, паттерн, — обязательные разделы, привязка утверждений к коду, связь сценариев с тестами. Готовый порядок действий — в паттернах spec-driven-domain и spec-driven-rule. Чем это названо здесь — в implementation.md рядом.
+---
+
+# Документация проекта — каким приёмом
+
+Правило под закон `{{lawsDir}}/project-documentation.md`. Закон говорит, что должно быть верно
+про тексты; здесь — из каких слоёв они сложены и что сверяет машина. Где лежат спеки домена,
+чем они проверяются и какой у них шаблон — `implementation.md` рядом. Формулировки — правило
+`doc-style` под тем же законом.
+
+## Когда берётся
+
+Правка закона, правила, паттерна или спека домена. Заведение нового слоя документации.
+
+## Как сложены слои
+
+```
+ЗАКОН      {{lawsDir}}/<закон>.md
+           верен для любого приложения этого класса; о проекте не знает ничего:
+           ни путей, ни имён файлов, ни привязок
+
+  ├─ ПРАВИЛО    {{rulesDir}}/<правило>/SKILL.md      (kind: rule, law: <закон>)
+  │             каким приёмом закон исполняется; несколько правил на закон
+  │             {{rulesDir}}/<правило>/implementation.md — имена этого дерева и привязка к коду
+  │
+  │  └─ ПАТТЕРН  {{rulesDir}}/<правило>-<что>/SKILL.md  (kind: pattern, rule: <правило>)
+  │              готовый код и конкретные приёмы; минимум один на правило
+  │
+  └─ СПЕК ДОМЕНА  как работает домен; объявляет законы, которые применяет
+```
+
+Ссылки идут только снизу вверх: закон не ссылается ни на правило, ни на спек, ни на файл.
+
+## Что здесь действует
+
+- **Набор разделов спека задан заранее, и отсутствие раздела — отказ.** «Не применимо» —
+  законный ответ, отсутствие раздела — нет: сквозные требования вспоминаются постфактум именно
+  тогда, когда для них не заведено места.
+- **Каждое утверждение привязано к месту в коде, и связь сверяется в обе стороны.** Ключ связи
+  — сам текст утверждения, поэтому переформулировать его, забыв про привязку, нельзя.
+- **Привязка не ведёт в код, который никто не зовёт.** Символ, объявленный в своём файле и
+  больше нигде не встречающийся, местом исполнения не считается.
+- **Таблица обработчиков сверяется с объявлениями в обе стороны.** Иначе обработчик, который
+  домен обслуживает, но забыл описать, виден только в объявлении.
+- **Код отказа принимается, только если он в домене бросается.** Коды, выписанные по замыслу,
+  живут в документе годами, а на одном из путей обещанный отказ не бросает никто.
+- **Префикс сценариев в домене один.** Второй префикс означает, что домен описан дважды.
+- **У закона обязателен раздел статей, и кроме них он не держит ничего.** Истории правок и
+  доводов о выбранном когда-то варианте в законе нет: историю держит система контроля версий, а
+  довод с отвергнутой альтернативой — свойство работы, и место ему в «Ловушках» правила.
+- **Закон, назвавший файл проекта, — отказ.** Путям и привязкам место в правиле: иначе закон
+  нельзя ни прочитать без знания дерева, ни применить на другом приложении.
+- **Правило объявляет закон, под который написано.** Правило без закона — набор приёмов, из
+  которого не видно, что именно должно быть верно.
+- **Спек объявляет законы, которые применяет, и связь сверяется в обе стороны.** Закон,
+  названный в тексте спека, обязан стоять в его шапке: иначе по закону не узнать, какие домены
+  на нём стоят.
+
+## Паттерны
+
+- `spec-driven-domain` — заведение и правка спека домена, сценарии, привязка.
+- `spec-driven-rule` — заведение закона, правила и паттерна.
+
+## Ловушки
+
+- **Список шагов в спеке не заводить.** Шаги — артефакт сессии, им место в ветке или в описании
+  PR. Как только в директории появляются «шаги», спек снова становится планом и умирает после
+  слияния.
+- **Спек описывает установившееся, а не предстоящее.** Единственное место, где он говорит о
+  будущем, — отдельная директория предложенного; после выкатки её текст вливается в спек
+  домена, директория удаляется, идентификаторы сценариев не меняются.
+- **Семантику полей не сверяет ничто.** Проверка знает имена обработчиков, коды отказа и связь
+  сценариев с тестами; что означает пустое поле — не знает.
+- **Живость символа считается совпадением имени по дереву, а не вызовом.** Символу хватает
+  второго упоминания где угодно — в чужом поле с тем же именем, в атрибуте разметки. Место, где
+  правило исполняется на самом деле, подтверждается только чтением кода.
+- **Зелёная проверка не значит, что структура верна.** Проверка сверяет структуру с тем, чего
+  сама и ждёт: неверная раскладка, совпавшая с её ожиданием, проходит зелёной.
+- **Конфликт слияния в спеке разрешается сохранением обеих сторон, а не выбором одной.** Две
+  ветки дописывают в конец одних и тех же списков, и обе стороны верны: конфликт здесь не спор,
+  а две дописи в одно место. Номера сценариев при разрешении не пересчитываются — идентификатор
+  это ключ связи с тестами, и сдвиг номеров рвёт сверку у соседей, которых правка не касалась.
+  Порядок сохранённых сторон держится одинаковым во всех файлах спека, иначе правило, его
+  сценарий и его привязка перестают находиться друг по другу. После разрешения гоняется
+  проверка спеков: конфликт в тексте кода не задевает, и ни сборка, ни линтеры его не увидят.

package/assets/rules/styling-bem.md

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

package/assets/rules/testing.md

@@ -0,0 +1,69 @@
+---
+name: testing
+kind: rule
+law: verifiability
+description: Правило под закон «Проверяемость». Брать при правке любого файла спеки и всего, что лежит в сквозных прогонах. Идентификатор сценария в заголовке теста, отметка непокрытого, вынос решения в чистую функцию, выключатели разрушающих спек. Готовый код — в паттернах testing-unit и testing-e2e. Чем это названо здесь — в implementation.md рядом.
+---
+
+# Проверяемость — каким приёмом
+
+Правило под закон `{{lawsDir}}/verifiability.md`. Закон говорит, что считается подтверждением;
+здесь — каким приёмом это делается. Чем это названо в этом дереве, каким прогонщиком гоняется и
+где лежит — `implementation.md` рядом. Проверка работающего приложения глазами и замером —
+правило `browser-verification` под тем же законом.
+
+## Когда берётся
+
+Правка файла спеки, заведение теста, разбор упавшего прогона, закрытие сценария из спеки
+домена.
+
+## Что здесь действует
+
+- **Идентификатор сценария стоит в начале заголовка теста, через тире.** Один сценарий
+  проверяется несколькими тестами, один тест закрывает несколько сценариев; связь читается из
+  заголовка, а не из памяти писавшего.
+- **Сценарий без теста несёт отметку с причиной.** Пустая отметка не принимается, а отметка при
+  существующем тесте — отказ: она означает, что долг закрыли, а отметку не сняли.
+- **Тест, идущий не тем путём, что пользователь, помечается частичным покрытием.** В сводку он
+  попадает долгом, а не покрытием.
+- **Упоминание в тесте сценария, которого в спеках нет, роняет проверку.** Так ловится
+  переименованный или выкинутый сценарий: тесты при этом остаются зелёными.
+- **Решение выносится в чистую функцию и проверяется вызовом.** Компонент и сервис остаются
+  тонкой обёрткой и отдельно не проверяются, пока своего ветвления у них нет.
+- **Обработчик серверной стороны проверяется вызовом своего метода с рукописным двойником
+  хранилища.** Контейнер и маршрутизатор поднимать не надо: спека проверяет решение, а не
+  раскладку полей.
+- **Спека, необратимо меняющая данные стенда, выключена по умолчанию.** Адрес стенда уводится
+  одной переменной окружения, и без выключателя такая спека правила бы данные чужого стенда.
+- **Спеки, которым нужен прокси перед приложением, просыпаются вместе с адресом стенда.** Голый
+  сервер отдачи страниц их не проходит: перенаправления живут в конфиге прокси, а не в
+  приложении.
+- **Правило линтера, которое запрещает принятый здесь приём, выключают в конфиге, а не обходят
+  в каждом тесте.** Точечное отключение в файле остаётся для того, что запрещено по делу; рядом
+  со строкой отключения пишут причину.
+
+## Паттерны
+
+- `testing-unit` — тест на чистую функцию, на обработчик серверной стороны и разовый
+  тест-доказательство, который не коммитится.
+- `testing-e2e` — прогон сквозных тестов, стенд под настоящим прокси, выключатели.
+
+## Ловушки
+
+- **Зелёный прогон тестов не значит, что хоть один файл исполнялся.** Либа без своего конфига
+  прогонщика не запускает ничего. Либа с конфигом, но без единого файла спеки, проходит зелёной
+  из-за настройки «успех при отсутствии тестов», и на глаз эти два случая неотличимы: в обоих
+  прогон успешен. Перед правкой в незнакомой либе проверяется, есть ли в ней хоть один файл
+  спеки; если нет — первый заводится этой же правкой, а не откладывается: откладывать здесь не
+  с чего, долг уже накоплен.
+- **«Executable doesn't exist» — состояние машины, а не дефект правки.** Обычно установлен один
+  движок браузера, остальные падают всегда. Та же ошибка приходит после смены версии
+  прогонщика сквозных тестов: браузер ставится под конкретную версию, и после подъёма его надо
+  поставить заново. Выглядит это как регрессия обновления, а ею не является.
+- **Первому прогону сразу после установки браузера верить нельзя.** Падения, не повторяющиеся
+  ни при отдельном прогоне тех же тестов, ни при втором полном, — свойство первого прогона.
+  Такой прогон повторяют, а выводы делают по второму.
+- **Сквозные тесты без учётных данных в окружении пропускаются молча.** В отчёте они значатся
+  пропущенными, и прогон выглядит успешным.
+- **Поднятый сервер разработки проверкой не является.** Это шаг правила `browser-verification`,
+  а не тест.

package/assets/rules/translations.md

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

package/assets/rules/typescript-conventions.md

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

package/assets/templates/gate-map.sh

@@ -0,0 +1,37 @@
+#!/usr/bin/env bash
+# Карта «что правится — какое правило» этого дерева. Её читает хук гейта правил.
+#
+# Живёт в проекте, а не в пакете: имена каталогов, расширения и команды поставки у каждого
+# дерева свои. Пакет везёт механизм, проект — карту.
+#
+# Функция печатает ИМЯ ПРАВИЛА или молчит. Молчание — «правила на это нет», и гейт пропускает.
+#
+# Порядок веток решает: первое совпадение выигрывает, поэтому частное идёт раньше общего.
+# Файл спеки — не файл компонента, и обе ветки обязаны стоять до общей ветки расширения.
+
+skill_for() {
+    kind="$1"
+    target="$2"
+
+    case "$kind" in
+        edit)
+            case "$target" in
+                # Файлы самого агента правятся без правила: правило на них — это оно само.
+                */.claude/*)                        return 0 ;;
+                *.spec.ts)                          printf '%s' '<правило про тесты>' ;;
+                *.component.ts|*.component.html)    printf '%s' '<правило про компонент>' ;;
+                *.scss)                             printf '%s' '<правило про оформление>' ;;
+                */index.ts)                         printf '%s' '<правило про раскладку либ>' ;;
+                *.ts)                               printf '%s' '<правило про код>' ;;
+                *.md)                               printf '%s' '<правило про тексты>' ;;
+            esac
+            ;;
+        bash)
+            case "$target" in
+                *git\ commit*|*git\ push*|*gh\ pr\ create*) printf '%s' '<правило про поставку>' ;;
+            esac
+            ;;
+    esac
+
+    return 0
+}

package/assets/templates/implementation.md

@@ -0,0 +1,38 @@
+# <имя-правила> — как это устроено здесь
+
+Имена этого дерева при правиле `SKILL.md` рядом. Отдельный файл потому, что правило говорит
+приёмом и переносится между репозиториями целиком, а всё, что ниже, верно только здесь и
+устаревает при каждом переименовании.
+
+Пока в файле стоит `<!-- заполняет проект -->`, правило считается неразвёрнутым: `agent-kit
+sync --check` отказывает, а агент читает указание, которому здесь нечего назвать.
+
+## Как это называется здесь
+
+| В правиле         | Здесь                                       |
+| ----------------- | ------------------------------------------- |
+| <понятие правила> | <имя в этом коде> <!-- заполняет проект --> |
+
+## Где это лежит
+
+| Что        | Где                                |
+| ---------- | ---------------------------------- |
+| <механизм> | `<путь>` <!-- заполняет проект --> |
+
+## Где исполняются статьи
+
+Первая колонка — статья дословно, как она написана в разделе «Что здесь действует» правила
+(жирная часть пункта). Статья без строки и строка без статьи — расхождение: правило обещает
+то, чего в дереве нет, либо в дереве стоит то, о чём правило молчит.
+
+| Статья            | Где исполняется                             |
+| ----------------- | ------------------------------------------- |
+| <статья дословно> | `<путь>:<символ>` <!-- заполняет проект --> |
+
+## Что ещё стоит знать при чтении кода
+
+- <Что видно только изнутри этого дерева: почему приём выглядит здесь именно так.>
+
+## Чем это проверяется
+
+- <Команда, которая ловит нарушение, — и что именно она ловит.>

package/assets/templates/pattern.md

@@ -18,6 +18,10 @@ description: Паттерн правила <имя-правила>. Брать <
 
 <Готовый код целиком, а не пересказ: паттерн берут, чтобы не писать заново.>
 
+Имена в примере безымянные — `libs/<домен>`, `<Feature>Component`, `<app>`. Настоящие имена
+этого дерева стоят в `implementation.md` при правиле: пример, написанный на чужих именах,
+читается как рабочий код и переносится в дерево вместе с ними.
+
 ```
 <код>
 ```

package/assets/templates/project.sh

@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+# Профиль этого дерева: что здесь чем зовётся и какими командами проверяется.
+#
+# Живёт в проекте, а не в пакете: механизм у сторожевых хуков общий, а команды, порты и пары
+# «правка — её документ» у каждого дерева свои. Пакет везёт хуки, проект — этот файл.
+#
+# Каждая функция вправе промолчать. Молчание значит «правила на это нет», и хук пропускает:
+# пустой профиль оставляет хуки безвредными, а не отбивающими наугад.
+
+# Где подняты приложения. Идёт в текст отказа, когда кто-то поднимает второй экземпляр.
+RT_STANDS='<приложение> http://localhost:<порт>, <приложение> http://localhost:<порт>'
+
+# Команды, которые обязаны пройти перед пушем. По одной на строку; первая упавшая отбивает пуш.
+rt_push_checks() {
+    cat <<'EOF'
+<команда линтера кода>
+<команда линтера стилей>
+<команда тестов>
+EOF
+}
+
+# Какой документ обязан ехать тем же коммитом, что и этот файл. Печатает путь или молчит.
+rt_docs_pair_for() {
+    case "$1" in
+        */<каталог правил>/*)   printf '%s' '<зеркало правила>' ;;
+        *.proto)                printf '%s' '<спек задетого домена>' ;;
+    esac
+}
+
+# Чем линтуется этот файл сразу после правки. Печатает команду или молчит.
+rt_lint_for() {
+    case "$1" in
+        *.scss)  printf '%s' '<команда линтера стилей> "$1"' ;;
+        *.ts)    printf '%s' '<команда линтера кода> "$1"' ;;
+    esac
+}
+
+# Имя ветки, с которой разрешено открывать PR: номер задачи в имени. Успех — годится.
+rt_task_branch_ok() {
+    printf '%s' "$1" | grep -qE '<выражение имени ветки>'
+}

package/assets/templates/rule.md

@@ -2,37 +2,26 @@
 name: <имя-правила>
 kind: rule
 law: <закон>
-description: Правило проекта под закон «<Название закона>». Брать при <когда> — <что называет>. Готовый код — в паттернах <имена>.
+description: Правило под закон «<Название закона>». Брать при <когда> — <каким приёмом это делается>. Готовый код — в паттернах <имена>.
 ---
 
-# <О чём закон> — как это устроено здесь
+# <О чём закон> — каким приёмом
 
-Правило под закон `{{lawsDir}}/<закон>.md`. Закон говорит, что должно быть верно; здесь — чем
-это названо в этом дереве, где лежит и что из закона у нас не применяется.
+Правило под закон `{{lawsDir}}/<закон>.md`. Закон говорит, что должно быть верно; здесь — каким
+приёмом это делается. Чем это названо в этом дереве и где лежит — `implementation.md` рядом:
+правило переносится между репозиториями, имена — нет.
 
-## Как это называется здесь
+## Когда берётся
 
-| В законе         | Здесь             |
-| ---------------- | ----------------- |
-| <понятие закона> | <имя в этом коде> |
+<Правка, по которой правило узнаётся. Гейт зовёт его по этому признаку, а не по названию.>
 
-## Где это лежит
+## Что здесь действует
 
-| Что        | Где      |
-| ---------- | -------- |
-| <механизм> | `<путь>` |
+Каждый пункт начинается жирной статьёй, и у каждой статьи есть строка в `implementation.md`
+рядом. Утверждение, которому места в коде не нашлось, сюда не ставится: оно уходит прозой в
+«Ловушки» или статьёй в закон.
 
-## Как закон применяется здесь
-
-Каждый пункт начинается жирной фразой, и у каждой жирной фразы есть строка в
-`implementation.md` рядом. Утверждение, которому места в коде не нашлось, сюда не ставится: оно
-уходит прозой в «Ловушки» или вопросом `Q-N` в закон.
-
-- **<Утверждение одной фразой.>** <Что сломается иначе — не больше двух предложений.>
-
-## Чего из закона здесь нет
-
-<Что из закона этот проект не применяет и почему; ссылка на открытый вопрос закона.>
+- **<Статья одной фразой.>** <Что сломается иначе — не больше двух предложений.>
 
 ## Паттерны
 

package/bin/agent-kit.d.ts

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
 import { IOutcomeOfCommand } from '../lib/commands.js';
-export declare function main(argv: readonly string[]): IOutcomeOfCommand;
+export declare function main(argv: readonly string[]): Promise<IOutcomeOfCommand>;
 //# sourceMappingURL=agent-kit.d.ts.map

package/bin/agent-kit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-kit.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/bin/agent-kit.ts"],"names":[],"mappings":";AAUA,OAAO,EAA8B,iBAAiB,EAAQ,MAAM,oBAAoB,CAAC;AAgCzF,wBAAgB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,iBAAiB,CAc/D"}
+{"version":3,"file":"agent-kit.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/bin/agent-kit.ts"],"names":[],"mappings":";AAaA,OAAO,EAA8B,iBAAiB,EAAc,MAAM,oBAAoB,CAAC;AAwF/F,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAsB9E"}