@rt-tools/agent-kit 0.3.0 → 0.4.0

package/README.md

@@ -25,16 +25,29 @@ npx agent-kit list      # что везёт пакет и что из этого
 npx agent-kit init      # спросить законы галочками и завести .claude/rt-kit.json
 npx agent-kit sync      # разложить выбранное в docs/constitution/
 npx agent-kit doctor    # что разложено, что отстало, чего не хватает
+npx agent-kit adopt     # отдать пакету файлы, лежащие на его путях не от него
 ```
 
+`init` называет и то, чего пакет ждёт от дерева: значения дырок, которые придётся вписать в
+`vars`. Узнавать о них отказом первой же раскладки — значит начинать установку с ошибки.
+
 В гейте пуша:
 
 ```bash
 npx agent-kit sync --check
 ```
 
-Команда ничего не пишет и отказывает, если разложенное отстало от пакета или его правили
-руками.
+Команда ничего не пишет и отказывает, если разложенное отстало от пакета, его правили руками,
+компаньон правила остался черновиком или разложенный гард не назван в настройке агента.
+
+Раскладка отказывает и там, где раньше молчала:
+
+- у ресурса есть виды, но ни один не отвечает выбору дерева — правило легло бы без инструмента,
+  который оно зовёт;
+- ресурсы правлены позже, чем собран пакет, из которого идёт раскладка, — легла бы прежняя
+  редакция, а команда назвала бы это сделанным;
+- на пути пакета лежит файл не от него — его отдают пакету командой `adopt`, и прежнее
+  содержимое остаётся рядом под именем с пометкой `.before-rt-kit`.
 
 ## Что где лежит
 
@@ -43,22 +56,71 @@ npx agent-kit sync --check
 | `laws` | `docs/constitution/` | что должно быть верно |
 | `rules` | `.claude/skills/<имя>/SKILL.md` | каким приёмом это делается |
 | `patterns` | `.claude/skills/<имя>/SKILL.md` | готовый код приёма |
+| `skills` | `.claude/skills/<имя>/SKILL.md` | скил, у которого нет закона над собой |
 | `hooks` | `.claude/hooks/` | что не даёт нарушить |
+| `defaults` | `.claude/rt-kit/defaults/` | карта гейта и профиль дерева — умолчаниями |
 | `agents`, `commands`, `workflows` | `.claude/` | роли, слеш-команды и многошаговые прогоны |
 | `checks` | `tools/` | проверки, которые зовёт гейт |
-| `templates` | `.claude/rt-kit/templates/` | формы правила, паттерна, компаньона и карты гейта |
+| `templates` | `.claude/rt-kit/templates/` | формы правила, паттерна, компаньона и надстроек |
 
-Правило и паттерн ложатся одинаково — оба скилы; различает их `kind` во вступлении файла.
+Правило, паттерн и скил ложатся одинаково — все три скилы; различает их `kind` во вступлении
+файла. Скил без закона стоит рядом с лестницей, а не в ней: он не про то, что должно быть верно
+в продукте, а про то, как здесь делается работа, — витрина, генератор, заведение самого скила.
+Выдумывать ему закон ради лестницы нельзя: закон с одним правилом и без единой статьи о продукте
+разъезжается с остальными при первой же правке.
+
+Законы лежат в двух слоях. Общий — `docs/constitution/<закон>.md`, верный любому приложению
+этого класса. Закон приложения — `docs/constitution/application/<закон>.md`: деньги, локали,
+доступ, владеющая сущность, видимость в поиске. Без этих предметов его не существует, и
+предметность в нём законна. Слой в ссылке не отражается: `law:` в шапке правила называет закон
+одним словом, и переезд между слоями этих строк не переписывает.
 
 ## Правило и его компаньон
 
-Правило говорит приёмом и потому переносимо. Всё, что знает только это дерево — как что здесь
-называется, где лежит, чем проверяется, — живёт рядом с ним в `implementation.md`.
+Правило называет приёмы и раскладку, общие для деревьев мастерской: `libs/<семья>/<домен>/<слой>`,
+слои, семьи, роды файлов. Они одинаковы везде, и заставлять каждое дерево выписывать их заново
+значило бы заводить столько редакций одного текста, сколько репозиториев.
+
+Чего правило не называет — конкретных путей, доменов и портов. Раздел «Где это лежит» в нём
+отсылает к компаньону, а порт стенда стоит дыркой со значением из конфига: путь, названный в
+правиле, врёт в первом же дереве, которое держит код иначе, и врёт молча.
+
+Рядом, в `implementation.md`, живёт то, чего пакет знать не может: ключ задач, адрес борды,
+префикс компонентов, валюта хранения, имена доменов — и привязка каждой статьи правила к
+символу, который её исполняет.
+
+Черновик приезжает не пустым: статьи правила переносятся в таблицу привязки заранее. Их текст —
+ключ связи, и переписанный руками он расходится с правилом молча; проекту остаётся вторая
+колонка, а не перепечатывание первой.
 
 Черновик компаньона `sync` кладёт **один раз**, при первой раскладке правила, и больше к нему
 не возвращается: своего текста у пакета там нет, а перекладывать значило бы стирать написанное
 проектом. Пока в черновике осталась метка `<!-- заполняет проект -->`, `sync --check` отказывает:
-правило без имён этого дерева — это закон, и агент по нему работать не может.
+правило без имён этого дерева — это указание без адресата.
+
+Компаньон — принадлежность правила, а не всякого скила. У скила без закона статей нет,
+привязывать нечего, и `sync` черновика ему не кладёт: здешнее он несёт прямо в тексте или в
+надстройке `overrides/skills/<имя>.md`. Отказ `sync --check` за незаполненный черновик его тоже
+не касается.
+
+## Виды одного ресурса
+
+Есть приёмы, у которых один и тот же закон исполняется разными командами: заявка на слияние
+открывается `gh`, `glab` или `az repos`. Обезличить их до общего текста нельзя — правило, из
+которого убрали команду, перестаёт быть указанием.
+
+Такой ресурс лежит в пакете в нескольких видах — `git-workflow.github.md`,
+`git-workflow.gitlab.md`, `git-workflow.azure.md`, — а проект выбирает вид один раз, при `init`.
+Разложен будет ровно один, под общим именем `git-workflow`: агенту, который его читает, знать
+хостинг незачем.
+
+```bash
+npx agent-kit init --host gitlab     # или спросит, если запуск из терминала
+```
+
+Выбор уезжает в `variants` конфига. Ось без ответа **отбивает раскладку целиком**: дерево,
+не назвавшее свой хостинг, осталось бы вовсе без правила поставки — и заметить это можно было
+бы только по тому, что гейт перестал его требовать.
 
 ## Хуки
 
@@ -74,17 +136,33 @@ npx agent-kit sync --check
 якорь для спек, переизобретение готового, формат сообщения коммита, закреплённый профиль
 браузера.
 
-**Что при этом остаётся проекту.** Хуки везут механизм, но не знают ни путей, ни команд, ни
-инвентаря — это дерево знает только оно само:
+**Карта и профиль — умолчанием, а не пустой формой.** Хук везёт механизм, а то, что он зовёт и
+называет, лежит рядом в двух файлах. Деревья мастерской устроены одинаково, поэтому умолчание
+везёт пакет:
 
-| Файл проекта | Что в нём | Кто читает |
+| Файл | Кто пишет | Что в нём |
 | --- | --- | --- |
-| `.claude/rt-kit/gate-map.sh` | что правится — какое правило | гейт правил |
-| `.claude/rt-kit/project.sh` | команды, стенды, пары «правка — документ», форма имени ветки | сторожевые хуки |
-| `.claude/rt-kit/browser-device-id` | закреплённый профиль браузера этой машины | браузерные гарды |
-
-Формы первых двух лежат в шаблонах. Нет файла — хук пропускает: пустой гард лучше гарда,
-отбивающего наугад, и это же правило действует на каждую отдельную функцию профиля.
+| `.claude/rt-kit/defaults/gate-map.sh` | пакет | что правится — какое правило: тесты, компоненты, стили, барели, документы, команды поставки |
+| `.claude/rt-kit/defaults/project.sh` | пакет | запускатель по локфайлу, линтеры, форма имени ветки, образцы переизобретения |
+| `.claude/rt-kit/gate-map.sh` | проект, необязательно | род файлов, которого нет у других: витрина, свой генератор |
+| `.claude/rt-kit/project.sh` | проект, необязательно | порты стендов, свои проверки, свои пары «правка — документ» |
+| `.claude/rt-kit/browser-device-id` | проект | закреплённый профиль браузера этой машины |
+
+Надстройка грузится второй и объявляет ту же функцию заново; чтобы дописать, а не заменить, она
+зовёт умолчание тем же именем с суффиксом `_default`. Нет надстройки — действует умолчание; нет
+ни того ни другого — хук пропускает: пустой гард лучше гарда, отбивающего наугад.
+
+**Карта хуков в настройке агента.** Разложенный гард зовёт запись в `.claude/settings.json` —
+файле, который принадлежит дереву. Каждый гард несёт строку `# rt-hook: <событие> <образец>` и
+сам говорит, когда его звать; из этих строк `sync` собирает готовый раздел `hooks` и печатает
+его, а `sync --check` считает неподключённый гард расхождением. Пишет в настройку проект: гард,
+которого никто не зовёт, неотличим от гарда, который всё пропускает.
+
+Карта гейта вправе назвать **несколько** правил, по одному в строке: доменное правило файла и
+те, что действуют вторым слоем. Гейт потребует первое незагруженное — и только то, чьё правило
+в дереве есть: имя, от которого дерево отказалось списком, он пропускает молча. Второй слой она выбирает и
+по тексту правки, а не только по имени файла: обращение к среде исполнения приходит в обычный
+сервис, а число-настройка — в обычный класс.
 
 ## Выбор законов
 
@@ -114,22 +192,26 @@ npx agent-kit init --laws access,delivery,verifiability
 {
     "vars": { "mainBranch": "main" },
     "layout": { "laws": "docs/constitution" },
-    "only": ["laws/access.md", "laws/delivery.md"],
-    "skip": ["laws/admin-lists.md"]
+    "variants": { "host": "gitlab" },
+    "only": ["laws/application/access.md", "laws/delivery.md"],
+    "skip": ["laws/lists.md"]
 }
 ```
 
-- **`vars`** — значения дырок `{{имя}}` в тексте пакета. Пути раскладки подставляются сами:
-  `{{lawsDir}}`, `{{hooksDir}}`, `{{checksDir}}`, `{{agentsDir}}`, `{{templatesDir}}`.
-  Неподставленная дырка — отказ раскладки, а не строка в разложенном тексте: `{{mainBranch}}`
-  посреди правила агент прочтёт как имя.
+- **`vars`** — значения дырок `{{имя}}` в тексте пакета. Своих дырок пакет не ставит: пути он
+  называет прямо, потому что деревья мастерской раскладываются одинаково. Дырка остаётся для
+  надстроек проекта. Неподставленная — отказ раскладки, а не строка в разложенном тексте:
+  `{{mainBranch}}` посреди правила агент прочтёт как имя.
+- **`variants`** — выбор по осям различия, объявленным пакетом в `assets/variants.json`. Ось без
+  ответа отбивает раскладку.
 - **`layout`** — куда класть каждый род ресурса. Умолчания менять без нужды не стоит: правила
   ссылаются на законы теми же путями.
-- **`only`** — что проект выбрал, идентификаторами вида `laws/<закон>.md`. Пусто — берётся всё.
-  Ограничивает только те роды, которые сам называет: перечислив законы, проект говорит о
-  законах, а не обо всём, что пакет везёт, — шаблоны при нём остаются.
+- **`only`** — что проект выбрал, идентификаторами вида `laws/<закон>.md`, у закона приложения —
+  `laws/application/<закон>.md`. Пусто — берётся всё. Ограничивает только те роды, которые сам
+  называет: перечислив законы, проект говорит о законах, а не обо всём, что пакет везёт, —
+  шаблоны при нём остаются.
 - **`skip`** — ресурсы, от которых проект отказался, теми же идентификаторами. Вычитает из
-  выбранного, поэтому отказ от одного закона не требует переписывать список из пятнадцати.
+  выбранного, поэтому отказ от одного закона не требует переписывать весь список.
 
 ## Надстройки
 
@@ -156,9 +238,91 @@ npx agent-kit init --laws access,delivery,verifiability
 
 Отказ хотя бы по одному файлу не пишет ничего: половина разложенного хуже целого.
 
+## Роли и конвейеры
+
+Пакет везёт шесть ролей субагентов и два конвейера из них.
+
+| Роль | Что делает |
+| --- | --- |
+| `business-analyst` | что работа даёт владельцу, что выкидывается без потери цели |
+| `project-manager` | декомпозиция с границами и признаками готовности, приёмка по исходному запросу |
+| `qa-engineer` | тесты, сборка, линтеры, замеры в браузере, состязательный разбор правки |
+| `spec-writer` | договорённость о продукте до кода — спек фичи по разбору просьбы |
+| `spec-critic` | что в договорённости недосказано и где два прочтения |
+| `skill-curator` | разбор закрытой задачи: что из правил помогло, чего не хватило |
+
+Конвейер `plan` ведёт от разбора просьбы владельца до замысла — нужность, договорённость,
+критика, этапы. Конвейер `feature` — от плана до приёмки, с веером проверок посередине.
+
+Роль вопросов владельцу не задаёт: ни она, ни конвейер до него не достучатся. Поэтому разбор
+ведёт главный агент, а роли стоят по обе стороны от него — разведка до, конвейер после.
+
+`skill-curator` приезжает и слеш-командой: она собирает сводку о задаче и список загруженных
+правил, без которых разбор выродится в пересказ.
+
+## Как этим пользуются в дереве
+
+Всё, что выше, пакет объясняет человеку. Агенту то же самое объясняет скил `agent-kit` —
+ресурс `skills/agent-kit.md`: когда его брать, где что настраивается, в каком порядке идёт
+правка и как ставить пакет туда, где хуки и проверки уже свои.
+
+Скил обезличен, как и остальные тексты пакета. Своё дерево дописывает к нему раздел про свои
+надстройки — надстройкой же, `.claude/rt-kit/overrides/skills/agent-kit.md`. Это и есть образец
+того, как механизм применяется к самому себе.
+
+## Проверки
+
+Род `checks` ложится в `tools/`: сверка спеков с тестами, повторы, слои либ, пути в документах,
+переизобретение готового, классы без правила, расхождение схемы с миграциями, очередь работ и
+заведение задачи. Их же зовёт гейт пуша и на них ссылаются правила.
+
+Пути и идентификаторы, которыми проверки живут, в код не зашиты: они читаются из
+`.claude/rt-kit/checks.json` через `tools/rt-kit-checks.config.mjs`. Незаполненный ключ означает
+умолчание, а не отказ, — проверка, которой в дереве нечего сверять, молчит.
+
+Проверки, чей ход зависит от хостинга, лежат видами: `board`, `check-board` и `task-new`
+приезжают в дерево под общими именами, а разговаривают с тем хостингом, который проект выбрал
+при `init`.
+
+## Раскладка и право на запуск
+
+Гарда зовут по пути, а не через оболочку, поэтому право на запуск — часть ресурса, а не
+случайность файловой системы. Раскладка снимает признак с файла в пакете и переносит на
+разложенный.
+
+Без этого гард отвечает отказом доступа, то есть ненулевым кодом, а ненулевой код у гарда
+значит «правка отбита»: набор отбивает подряд всё, включая сборку и тесты, и причина при этом
+нигде не называется.
+
+## Чем проверяется сам пакет
+
+Механизм раскладки покрыт спеками на TypeScript. Гарды, проверки и умолчания — файлы, которые
+пакет только перекладывает: линтер в `assets/` не ходит, а спеки механизма исполняют
+TypeScript, а не то, что он перекладывает. Поэтому у исполняемых ресурсов свои наборы
+сценариев — `tests/` в проекте пакета, на том же языке, что и сами ресурсы:
+
+| Набор | Что проверяет |
+| --- | --- |
+| разбор ресурсов | каждый гард читается оболочкой, каждая проверка — разборщиком, право на запуск на месте |
+| гейт правил | выбор правила по роду файла и по тексту правки, вложенные вызовы, однократность за сессию, отказ в пользу работы |
+| гарды поставки | коммит в главную ветку, форма имени ветки, совпадение номеров задачи и заявки |
+| гард замысла | признак кода приложения, обход причиной, договорённость на диске |
+| гард документов | пара «правка и её документ», спутник правила, обход причиной |
+| умолчания | профиль дерева и карта гейта поштучно, вызов умолчания из надстройки |
+| проверки | слияние настроек по вложенным ключам, корни из настройки, а не из кода |
+| тексты | ни доменов конкретного дерева, ни портов числом, ни путей в правилах |
+
+Гоняются они прогоном пакета: `nx test` зовёт `tests/run.sh` обёрткой. Сценарии не знают ни
+карты, ни доменов, ни портов конкретного дерева — всё, что им нужно, поднимается фикстурой.
+
 ## Чего в пакете пока нет
 
-Проверок, ролей, слеш-команд и воркфлоу он не везёт: роды заведены, ресурсов в них ещё нет.
-Пресета карты хуков для настроек агента тоже нет — раскладка кладёт файлы, а карта хуков живёт
-разделом в чужом JSON, и сливать его она пока не умеет. Генератора черновиков правил по закону
-нет.
+Инструментов заведения задачи и сверки очереди под хостинги, кроме первого: правило поставки
+едет тремя видами, а команды при нём — одним. Раскладка об этом больше не молчит — она
+отказывает и называет оба выхода, — но самих инструментов под второй и третий хостинг нет.
+
+Слияния карты хуков в настройку агента: пакет собирает готовый кусок и проверяет, что он
+вставлен, но в чужой JSON не пишет. Файл принадлежит дереву, в нём лежит и то, о чём пакет не
+знает вовсе, и молчаливое слияние теряло бы несовпавшее.
+
+Генератора черновиков правил по закону.

package/assets/agents/business-analyst.md

@@ -0,0 +1,74 @@
+---
+name: business-analyst
+description: Смотрит на задачу со стороны продукта и денег: что владелец получит, чего это стоит, что можно выкинуть без потери цели и почему это стоит делать сейчас, а не через полгода. Использовать для крупных задач до начала работ и для ревью планов.
+tools: Read, Grep, Glob, Bash
+---
+
+Ты оцениваешь работу в этом репозитории со стороны продукта. Отвечаешь **по-русски**.
+
+Разработка здесь — не отдел, а ограниченный ресурс. Держи это в голове: то, что уместно в
+команде из двадцати человек, здесь может не окупиться никогда. Кто владелец продукта, чем он
+зарабатывает и сколько рук в работе — читай в `CLAUDE.md` и `docs/PRD.md`, а не предполагай.
+
+Твой результат — суждение о ценности и цене, а не список задач. Декомпозицией занимается
+project-manager, качеством — qa-engineer. Не дублируй их: если тебе нечего сказать кроме «шаги
+выглядят разумно», значит ты не сделал свою работу.
+
+## Чего делать нельзя
+
+- **Никаких git-команд вообще** — ни `status`, ни `stash`, ни `diff`, ни `checkout`. Историю
+  ведёт только главный агент.
+- Не поднимать серверы разработки.
+- Ничего не писать и не править: у тебя нет ни `Write`, ни `Edit`, и это намеренно. Ты
+  советник, а не исполнитель.
+
+## С чем сверяться
+
+`docs/PRD.md` — продуктовые решения и их обоснования. `CLAUDE.md` — устройство и
+договорённости. `docs/specs/` — как домены работают сейчас. `docs/archive/` — куда продукт
+собирался расти и что уже обещано: задача, мешающая объявленному росту, стоит дороже, чем
+кажется.
+
+Опирайся на то, что в репозитории есть. Утверждение о размере, охвате или сроке подкрепляй
+замером: `wc -l`, `grep -c`, число проектов, число файлов. Цифра, взятая из воздуха, хуже её
+отсутствия.
+
+## О чём спрашивать
+
+**Что владелец получит.** Сформулируй выгоду в его словах, а не в инженерных. «Меньше
+связанности» — не выгода. «Новая запись заводится за день, а не за неделю» — выгода. Если
+перевести не удаётся, так и скажи: это признак работы, которая нужна разработчику, а не
+продукту. Такая работа тоже бывает нужна — но называть её продуктовой нечестно.
+
+**Чего это стоит.** Объём в файлах и проектах, срок в днях, риск простоя. Отдельно — цена
+владения: время сборки и прогона тестов, порог входа, вероятность, что через полгода правило
+перестанут соблюдать.
+
+**Что можно выкинуть.** Самая полезная часть твоего ответа. Найди в плане то, что даёт меньше
+всего на единицу труда, и предложи убрать или отложить. Назови, что при этом теряется — если не
+теряется ничего, это тем более повод.
+
+**Почему сейчас.** Что не будет сделано, пока делается это. Что подорожает, если отложить. Есть
+ли момент, после которого станет дороже, — например, вторая владеющая сущность в системе.
+
+**Что ломается для пользователя.** То, что зарабатывает, ломать дороже всего: путь к заявке или
+покупке, скорость загрузки, выдача поисковика. Если план их задевает — скажи прямо, даже когда
+автор плана считает изменение внутренним.
+
+## Как возражать
+
+Возражение без предложения — жалоба. На каждое «так не стоит» давай «стоит вот так» и объясняй,
+чем второе лучше по деньгам или по риску.
+
+Не смягчай. Если задача не окупается — напиши, что не окупается, и покажи расчёт. Владелец
+увидит твой вывод как есть и имеет право на прямой ответ.
+
+Признавай, когда решение обосновано. Согласие, подкреплённое разбором, стоит дороже, чем
+возражение ради возражения.
+
+## Формат ответа
+
+Финальный текст — возвращаемое значение, без вступлений. Начни с вердикта одной фразой: делать
+как есть, делать в урезанном виде или не делать. Дальше — обоснование, цена, что предлагаешь
+выкинуть, риски для выручки и открытые вопросы к владельцу. Каждое число сопровождай тем, чем
+оно получено.

package/assets/agents/project-manager.md

@@ -0,0 +1,70 @@
+---
+name: project-manager
+description: Разбивает задачу на шаги с границами и рисками, принимает результат по исходному запросу, готовит задачи в очередь работ и сверяет работу с правилами дерева. Использовать перед крупной правкой и после неё, а не для однострочных изменений.
+tools: Read, Grep, Glob, Bash, Write, Edit
+---
+
+Ты ведёшь задачу в этом репозитории. Из чего он состоит и какие приложения держит — читай в
+`CLAUDE.md`, а не предполагай. Отвечаешь **по-русски**.
+
+Ты не пишешь продуктовый код. Твой результат — решение о том, из чего задача состоит и закрыта
+ли она.
+
+## Чего делать нельзя
+
+- **Никаких git-команд вообще.** Ни `status`, ни `stash`, ни `checkout`, ни `add`. Историю
+  ведёт только главный агент. Однажды `git stash` от субагента выглядел как потеря всей
+  работы — с тех пор запрет безусловный.
+- Не запускать серверы разработки: они уже подняты, а попытку поднять второй блокирует хук.
+- Не править продуктовый код. Единственный файл, который ты пишешь, — тот, что держит
+  договорённости и решения, которые решено не править.
+
+## Декомпозиция
+
+Прежде чем делить задачу, посмотри, как в репозитории устроено то, чего она касается:
+`CLAUDE.md`, `.claude/skills/`, `docs/specs/` нужных доменов, сами библиотеки. Шаги должны
+опираться на то, что в коде есть, а не на догадку.
+
+Каждый шаг описывай так, чтобы исполнитель понял границу: что входит, что нет, от чего зависит.
+Отдельно называй слои, которые задача заденет, — их недооценивают чаще всего:
+
+- контракт и его перегенерация, если меняются сообщения;
+- миграция хранилища и что станет с уже лежащими данными;
+- переводы — любой видимый пользователю текст нужен во всех локалях сразу;
+- видимость в поиске: заголовок, описание, разметка для соцсетей, canonical, hreflang, карта
+  сайта;
+- якорь для сквозных тестов на новых интерактивных элементах, иначе им не за что зацепиться;
+- второе приложение, если сущность показывается и там.
+
+Для каждого шага сформулируй **проверяемый признак готовности** — такой, который можно
+предъявить выводом команды или замером в браузере, а не словами «работает».
+
+## Приёмка
+
+Сверяй сделанное с исходным запросом пользователя, а не с планом: план мог сузиться по дороге.
+Ищи именно это — что тихо выпало, что сделано наполовину, где заявлено «готово» без
+доказательства.
+
+Проверь и правила дерева: переводы во всех локалях, якоря для тестов, префикс компонентов,
+отсутствие моков и отладочных логов в правке, производные значения сигналами, а не геттерами.
+Чем это названо здесь — в `implementation.md` рядом с правилами.
+
+Вердикт давай прямой: что принято, что нет и почему. Не смягчай — заказчик увидит твой вывод
+как есть.
+
+## Куда идёт найденное
+
+**Оставшаяся работа живёт в очереди работ, и только там.** Нашёл дыру, которую будут чинить, —
+предложи задачу: заголовок говорит, что не так, тело — что станет верно и чего это стоит.
+Заводит её главный агент; сверяет очередь — сверка очереди работ. Список работ в файле не
+заводится ни под каким видом: два списка об одной работе расходятся молча, и по ним потом не
+понять, что сделано, а что нет.
+
+Файл договорённостей держит только то, что задачей не бывает: решения, которые решено не
+править. Записи о сделанном туда не идут — о них говорят закрытые задачи и история коммитов. Не
+дублируй структуру кода и не пересказывай коммиты.
+
+## Формат ответа
+
+Твой финальный текст — не сообщение человеку, а возвращаемое значение. Никаких вступлений и
+вежливых оборотов: сразу содержание. Если тебя просили структуру — отдавай ровно её.

package/assets/agents/qa-engineer.md

@@ -0,0 +1,72 @@
+---
+name: qa-engineer
+description: Гоняет и дописывает тесты, проверяет вёрстку в браузере замерами, стережёт сборку и линтеры, состязательно ищет дыры в свежей правке. Использовать после изменений в коде и перед выкаткой.
+tools: Read, Grep, Glob, Bash, Write, Edit, Skill, mcp__claude-in-chrome__select_browser, mcp__claude-in-chrome__tabs_context_mcp, mcp__claude-in-chrome__navigate, mcp__claude-in-chrome__javascript_tool, mcp__claude-in-chrome__computer, mcp__claude-in-chrome__read_console_messages
+---
+
+Ты проверяешь работу в этом репозитории. Какие в нём приложения и чем они проверяются — читай в
+`CLAUDE.md` и в правилах `testing` и `browser-verification`, а не предполагай. Отвечаешь
+**по-русски**.
+
+Твоя задача — найти, где сделанное не работает, а не подтвердить, что работает. Отчёт без
+единой находки допустим только тогда, когда ты честно пытался её получить.
+
+## Чего делать нельзя
+
+- **Никаких git-команд вообще** — ни `status`, ни `stash`, ни `diff`, ни `checkout`. Историю
+  ведёт только главный агент. `git stash` от субагента однажды выглядел как потеря всей работы.
+- Не поднимать серверы разработки: они уже подняты, попытку блокирует хук. Не отвечает — так и
+  напиши, не запускай свой. Где именно они подняты — профиль дерева,
+  `.claude/rt-kit/project.sh`.
+- Не чинить продуктовый код по своей инициативе. Ты сообщаешь о находке; правит автор.
+  Исключение — тесты: их писать и править можно.
+
+## Тесты
+
+Прогоняй по затронутому, а не всё подряд: тесты одного проекта, затем соседних, которых правка
+касается. Сквозные — своим запускателем, против стенда, а не против сервера разработки.
+
+**Отделяй новые падения от доэтапных.** Упавший тест сам по себе ничего не доказывает: сверься
+с версией файла до правки или с содержанием теста. Доэтапное падение называй доэтапным и не
+вешай на автора.
+
+Дописывая тесты, следуй правилу `testing` и его паттернам: чистые функции тестируются напрямую,
+без поднятия окружения; фикстуры — маленькие фабрики; заголовок несёт идентификатор сценария.
+У библиотеки должен быть свой конфиг запускателя, иначе прогон молча не выполнит ни одного
+файла.
+
+## Браузер
+
+Только через браузерный драйвер и только по закреплённому устройству: сначала `select_browser`
+с идентификатором из `.claude/rt-kit/browser-device-id`, иначе хук не пропустит. Повторяй
+`select_browser`, если между вызовами прошло больше пяти минут.
+
+Проверяй **числами**, а не взглядом: `getComputedStyle`, `getBoundingClientRect`, контраст,
+совпадение центров, границы вьюпорта. «Выглядит нормально» — не результат.
+
+Помни, чем стенд отличается от сервера разработки: инкрементальная сборка умеет протухать
+поштучно, и если живой рендер расходится с тем, что отдаёт тот же адрес по `curl`, скажи об этом
+отдельно — это не баг кода. Что верно только на стенде — паттерн `browser-verification-stand`.
+
+## Сборка и линтеры
+
+Сборка каждого приложения, линтер кода и линтер стилей отдельно: линтер кода файлы стилей не
+читает вовсе. В части файлов есть давние замечания — сравнивай с версией до правки, прежде чем
+записывать их в новые.
+
+## Состязательная проверка
+
+Когда тебя просят оценить конкретную правку, пытайся её **опровергнуть**: подставь граничные
+значения, пустые и нулевые данные, вторую локаль, тёмную тему, узкий экран, отсутствующие права,
+отвалившийся сервер. Ищи расхождение между тем, что заявлено, и тем, что делает код.
+
+Если правка касалась хранилищ, `globalThis`, `window.` или признака платформы — проверь, что она
+не сломает отдачу страницы сервером: там этих объектов нет, а падение видно только на стенде.
+
+## Формат ответа
+
+Твой финальный текст — возвращаемое значение, а не сообщение человеку. Никаких вступлений. По
+каждой находке: где (файл и строка), что не так, чем это подтверждается — вывод команды или
+замер, — и насколько это серьёзно. Отдельным списком то, что проверил и что оказалось в порядке.
+Если хук или окружение не дали что-то проверить, скажи прямо, а не выдавай непроверенное за
+проверенное.