@rt-tools/agent-kit 0.2.0 → 0.4.0

package/assets/skills/agent-kit.md

@@ -0,0 +1,81 @@
+---
+name: agent-kit
+description: Переносимый слой правил агента — законы, правила, хуки и проверки, которые везёт пакет, а дерево настраивает надстройками. Брать, когда правится файл с шапкой rt-kit, обновляется пакет, отказывает `sync --check`, или своё поведение надо дописать поверх пакетного. Как заводится сам скил — write-a-skill; устройство слоёв текста — spec-driven.
+---
+
+# Переносимый слой правил
+
+Законы, правила, паттерны, хуки, проверки и роли везёт пакет; дерево берёт их раскладкой и
+настраивает надстройками. Разложенный файл несёт шапку и правке не подлежит — правится либо
+пакет, либо надстройка.
+
+## Когда брать
+
+- В файле, который собираешься править, стоит шапка
+  `rt-kit v<версия> · <ресурс> · <сумма> · правится надстройкой, не здесь`.
+- Обновился пакет, или `sync --check` отказал в гейте пуша.
+- Своё поведение надо дописать поверх пакетного: гард, карта гейта, набор проверок.
+- Пакет ставится в дерево, где хуки и проверки уже свои.
+
+## Где что настраивается
+
+| Что меняешь                                    | Куда правка                                        |
+| ---------------------------------------------- | -------------------------------------------------- |
+| какое правило гейт требует под какой файл      | `.claude/rt-kit/gate-map.sh` — своя `skill_for`    |
+| порты, адреса, линтеры, форма ветки, инвентарь | `.claude/rt-kit/project.sh` — свои `rt_*`          |
+| пути и идентификаторы, которыми живут проверки | `.claude/rt-kit/checks.json`                       |
+| раздел разложенного текста                     | `.claude/rt-kit/overrides/<идентификатор ресурса>` |
+| что брать, а от чего отказаться                | `.claude/rt-kit.json`, ключи `only` и `skip`       |
+| сам механизм — гард, проверка, текст правила   | ресурс в пакете                                    |
+
+Надстройка объявляет функцию заново и вправе позвать умолчание тем же именем с суффиксом
+`_default`. Слияние текста идёт по разделам `## `: совпавший заголовок замещает, новый
+дописывается, пустой снимает раздел пакета.
+
+## Порядок
+
+Правка ресурса доезжает до дерева только через сборку пакета: строка запуска читает собранное,
+а не исходники ресурсов. Порядок один и тот же всегда — правка, сборка, `sync`. Отказ хотя бы
+по одному файлу не пишет ничего: половина разложенного хуже целого.
+
+## Команды
+
+```bash
+npx agent-kit doctor        # что разложено, что отстало, что лежит от отказанного
+npx agent-kit sync          # разложить
+npx agent-kit sync --check  # ничего не писать, отказать при расхождении
+```
+
+## Установка туда, где уже всё своё
+
+1. `init`, затем `skip` на всё, что дерево держит само. Пустая раскладка — законное начало.
+2. Снимок того, что говорят проверки дерева, до единой правки. Он и есть мерило.
+3. Ресурс за ресурсом: пакетную редакцию довести до здешней, предметность вынести в
+   надстройку, снять отказ, разложить, прогнать сценарии и сверить снимок.
+4. Разложенное поверх своего пакет не пишет: файл без шапки для него чужой. Снять его —
+   решение владельца, и до этого раскладка отказывает поимённо.
+
+## Ловушки
+
+- **Прогонять сценарии гардов можно, ничего не раскладывая.** Обвязка набора принимает каталог
+  гардов переменной, и пакетную редакцию гоняют по сценариям дерева до установки. Заход,
+  потраченный на диагноз по последствиям, стоил ровно этой строки.
+- **Отбитая правка не всегда про текст гарда.** Гард зовут по пути, и файл без права на
+  запуск отвечает отказом доступа — ненулевым кодом, который читается как «правка отбита».
+  Набор при этом отбивает подряд всё, включая сборку и тесты, и причины не называет.
+- **Правка shell-скрипта заменой по шаблону сверяется `bash -n` сразу.** Замена границ
+  конструкции не видит: `case` теряет свою `esac`, файл остаётся синтаксически неверным, а
+  гард с ошибкой синтаксиса отвечает ненулевым кодом — то есть «правка отбита». Два раза за
+  заход, и оба раза это выглядело дефектом самого гарда.
+- **Разложенный файл узнаётся по шапке, а не по каталогу.** Раскладка ложится в те же
+  `tools/`, `.claude/hooks/` и `.claude/skills/`, где лежит своё, поэтому карта гейта,
+  написанная по путям, требует под него доменное правило — а оно уводит править файл на месте.
+  Правка на месте теряется на следующей раскладке, и до тех пор выглядит применённой. Ветка по
+  шапке ставится в карте первой и решает раньше путей.
+- **Настройки проверок сливаются на один уровень.** Верхние ключи `checks.json` ложатся поверх
+  умолчаний по одному, а вложенный объект замещается целиком: назвав один ключ борды, дерево
+  теряет остальные — и увидит это отказом «нет токена бота», то есть как неполадку машины.
+  Вложенный раздел заполняется целиком либо не заводится вовсе.
+- **Утверждение правила переезжает вместе с кодом.** Вынесенное в надстройку перестаёт
+  находиться по прежнему символу, и привязка в спутнике правила врёт молча — сверка спеков
+  ловит это, но только если её позвать.

package/assets/skills/write-a-skill.md

@@ -0,0 +1,108 @@
+---
+name: write-a-skill
+description: Заведение нового скила — того, у которого нет закона над собой: витрина, генератор, чужой сервис, приём работы этого дерева. Брать, когда просят завести, написать или переписать скил. Форма правила и паттерна сюда не входит — это паттерн spec-driven-rule.
+---
+
+# Как заводится скил
+
+Скил — это то, что агент загружает перед работой и читает целиком. Отсюда всё остальное: он
+короткий, он объявляет, когда его брать, и он не пересказывает то, что уже написано в соседнем.
+
+## Когда брать
+
+- Заводится скил, у которого нет закона над собой: витрина, генератор, работа с чужим сервисом,
+  приём, принятый в этом дереве.
+- Скил разросся, и его пора делить.
+- Скил есть, но его никто не загружает — надо чинить объявление.
+
+**Правило и паттерн сюда не идут.** Правило стоит под законом, паттерн — при правиле, и форму
+обоих держит паттерн `spec-driven-rule`. Скил без закона — третий случай, и только он здесь.
+
+## Порядок
+
+1. **Спроси, чего не хватает.** Какую работу скил закрывает, на чём спотыкались без него, нужны
+   ли готовые команды или хватает порядка действий. Скил, написанный без этого, пересказывает
+   документацию инструмента — а её агент и так знает.
+2. **Напиши черновик.** Один файл. Дополнительные — только когда первый перестаёт читаться
+   целиком.
+3. **Покажи владельцу.** Скил действует на все будущие сессии, и заводить его молча нельзя.
+
+## Что в файле
+
+```
+<имя-скила>/
+├── SKILL.md          # обязателен, и обычно единственный
+├── <ЧТО-ТО>.md       # отдельный файл — когда SKILL.md перестал читаться целиком
+└── scripts/          # готовые скрипты, если операция детерминированная
+```
+
+Вступление между `---` — `name` и `description`, дальше заголовок и разделы. Первым разделом —
+«Когда брать»: агент решает по нему, а не по названию.
+
+## Объявление решает всё
+
+`description` — **единственное, что агент видит**, когда решает, грузить скил или нет. Он стоит
+в системном приглашении рядом с описаниями всех остальных, и выбор идёт по ним.
+
+Оно отвечает на два вопроса: что скил даёт и когда его брать. Пиши третьим лицом, до 1024
+знаков: первая фраза — что делает, вторая — «Брать, когда…», третья — чего в нём нет и где это
+искать.
+
+```
+✓ Заведение нового скила — того, у которого нет закона над собой. Брать, когда просят
+  завести, написать или переписать скил. Форма правила и паттерна сюда не входит — это
+  паттерн spec-driven-rule.
+
+✗ Помогает со скилами.
+```
+
+Второе объявление не даёт агенту ни одного способа отличить этот скил от соседнего — и он не
+загрузит ни один.
+
+Строка «чего здесь нет» не украшение: скилов в дереве десятки, и половина ошибок выбора — это
+взятый соседний. Назови его по имени.
+
+## Готовые команды вместо описания
+
+Скрипт кладётся рядом со скилом, когда операция детерминированная — проверка, приведение к
+форме, разбор вывода. Такое дешевле позвать, чем породить заново, и ошибку в нём видно один раз,
+а не в каждом порождении.
+
+Порядок действий, зависящий от того, что нашлось, скриптом не становится: он остаётся текстом.
+
+## Когда делить
+
+Делить, когда:
+
+- файл перестал читаться целиком — по опыту это около сотни строк;
+- в нём два разных предмета, и второй нужен раз в месяц;
+- готовый код занял больше места, чем объяснение, зачем он.
+
+Не делить ради красоты: два файла вместо одного стоят одного лишнего перехода при каждом
+чтении, а ссылка глубже одного уровня не читается вовсе.
+
+## Чем скил вредит
+
+- **Пересказ документации инструмента.** Агент читает скил при каждой работе; строка, которую он
+  знает и без того, вытесняет ту, которой не знает.
+- **Дублирование соседа.** Два скила об одном начинают противоречить друг другу, и первым это
+  замечает тот, кто выполнил оба.
+- **То, что устареет вместе с кодом.** Скил, называющий версию, число или имя файла, которое
+  правится чаще раза в квартал, врёт молча.
+- **Длина.** Скил в три экрана перестают читать целиком, а читают до первого знакомого раздела.
+
+## Перед тем как отдать
+
+- [ ] в объявлении есть «Брать, когда…» и назван сосед, которого брать не надо;
+- [ ] первый раздел — «Когда брать»;
+- [ ] файл читается целиком за один заход;
+- [ ] ни одной строки, которая повторяет соседний скил;
+- [ ] ничего, что устареет само собой: версий, чисел, сроков;
+- [ ] есть хотя бы один готовый пример, а не только объяснение;
+- [ ] ссылки уходят на один уровень, не глубже.
+
+## Чтобы скил загружали
+
+Написанного мало: скил, который никто не открывает, не действует. Новый скил либо называется в
+карте гейта этого дерева, либо его зовёт по имени другой скил или роль. Скил, не названный
+нигде, останется декорацией.

package/assets/templates/gate-map.sh

@@ -0,0 +1,45 @@
+#!/usr/bin/env bash
+# Надстройка карты гейта: то, чего нет у других деревьев мастерской.
+#
+# Скопировать в `.claude/rt-kit/gate-map.sh` и дописать своё. Файл необязателен: без него
+# действует умолчание пакета — `.claude/rt-kit/defaults/gate-map.sh`, где уже разобраны тесты,
+# компоненты, стили, барели, манифесты, документы и команды поставки.
+#
+# Заводить эту надстройку стоит ровно тогда, когда у дерева есть род файлов, которого нет у
+# остальных: витрина, свой генератор, чужая раскладка каталогов.
+#
+# Функция печатает ИМЯ ПРАВИЛА или молчит. Имён может быть несколько, по одному в строке.
+# Порядок веток решает: первое совпадение выигрывает, поэтому частное идёт раньше общего — и
+# своё частное обязано стоять ДО вызова умолчания, иначе общая ветка расширения его перехватит.
+
+skill_for() {
+    kind="$1"
+    target="$2"
+    written="$3"
+
+    case "$kind" in
+        edit)
+            case "$target" in
+                # Пример: у витрины своё правило, пакет такого не везёт.
+                # *.stories.ts | *.mdx) printf '%s\n' '<правило витрины>' ; return 0 ;;
+
+                # Пример: домен, который правится по своему правилу.
+                # */libs/<домен>/*) printf '%s\n' '<правило домена>' ; return 0 ;;
+                *) ;;
+            esac
+            ;;
+        bash)
+            case "$target" in
+                # Пример: своя команда развёртывания.
+                # *<команда>*) printf '%s\n' '<правило>' ; return 0 ;;
+                *) ;;
+            esac
+            ;;
+    esac
+
+    # Всё, что дерево не назвало своим, разбирает умолчание пакета. Проверка на объявленность
+    # нужна ровно в одном промежутке: пакет обновлён, а `sync` в этом дереве ещё не прогнан.
+    command -v skill_for_default >/dev/null 2>&1 && skill_for_default "$kind" "$target" "$written"
+
+    return 0
+}

package/assets/templates/implementation.md

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

package/assets/templates/pattern.md

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

package/assets/templates/project.sh

@@ -0,0 +1,54 @@
+#!/usr/bin/env bash
+# Надстройка профиля дерева: команды, стенды и пары «правка — документ» этого репозитория.
+#
+# Скопировать в `.claude/rt-kit/project.sh` и дописать своё. Файл необязателен: без него
+# действует умолчание пакета — `.claude/rt-kit/defaults/project.sh`, где запускатель выбирается
+# по локфайлу, а линтеры, форма имени ветки и образцы переизобретения уже названы.
+#
+# Каждая функция вправе промолчать. Молчание значит «правила на это нет», и хук пропускает.
+# Объявленная здесь функция замещает умолчание ЦЕЛИКОМ — чтобы дописать, а не заменить, зовите
+# из неё то же имя с суффиксом `_default`.
+
+# Где подняты приложения. Идёт в текст отказа, когда кто-то поднимает второй экземпляр.
+# Умолчание молчит: чужой порт назвать хуже, чем не назвать никакого.
+RT_STANDS='<приложение> http://localhost:<порт>, <приложение> http://localhost:<порт>'
+
+# Адрес боевого хранилища. Любая запись по нему отбивается совсем, и опт-аут не действует.
+RT_PROD_DSN='<хост боевого хранилища>'
+
+# Пути, у которых якорь для сквозных тестов не требуется.
+RT_QA_SKIP_RE='<выражение путей>'
+
+# Команды, которые обязаны пройти перед пушем. По одной на строку; первая упавшая отбивает пуш.
+rt_push_checks() {
+    rt_push_checks_default
+    # printf '%s\n' '<своя проверка>'
+}
+
+# Какой документ обязан ехать тем же коммитом, что и этот файл. Печатает образец пути или молчит.
+rt_docs_pair_for() {
+    case "$1" in
+        # <свой путь>) printf '%s' '<образец пути документа>' ; return 0 ;;
+        *) ;;
+    esac
+
+    rt_docs_pair_for_default "$1"
+}
+
+# Чем линтуется этот файл сразу после правки. Печатает команду или молчит.
+rt_lint_for() {
+    rt_lint_for_default "$1"
+}
+
+# Имя ветки, с которой разрешено открывать заявку на слияние. Успех — годится.
+rt_task_branch_ok() {
+    rt_task_branch_ok_default "$1"
+}
+
+# Что в этом дереве считается переизобретением. По строке «образец<таб>чем заменить».
+rt_reinvented_in() {
+    rt_reinvented_in_default "$1"
+    # case "$1" in
+    #     *.ts) printf '%s\t%s\n' '<образец>' '<чем заменить>' ;;
+    # esac
+}

package/assets/templates/rule.md

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

package/assets/variants.json

@@ -0,0 +1,20 @@
+{
+  "host": {
+    "question": "Где лежит репозиторий и очередь работ?",
+    "title": "хостинг репозитория",
+    "options": [
+      {
+        "value": "github",
+        "title": "GitHub — gh, issues, Projects"
+      },
+      {
+        "value": "gitlab",
+        "title": "GitLab — glab, issues, Boards"
+      },
+      {
+        "value": "azure",
+        "title": "Azure DevOps — az repos, work items, Boards"
+      }
+    ]
+  }
+}

package/assets/workflows/feature.js

@@ -0,0 +1,134 @@
+export const meta = {
+    name: 'feature',
+    description: 'План от PM, реализация по шагам, веер проверок QA и приёмка по исходному запросу',
+    whenToUse: 'Крупная правка, которая заденет несколько слоёв: контракт, хранилище, приложения, переводы',
+    phases: [
+        { title: 'План', detail: 'PM разбивает задачу на шаги с признаками готовности' },
+        { title: 'Реализация', detail: 'по шагу за раз — рабочее дерево одно на всех' },
+        { title: 'Проверка', detail: 'QA веером: тесты, сборка, браузер, состязательный разбор' },
+        { title: 'Приёмка', detail: 'PM сверяет сделанное с исходным запросом' },
+    ],
+};
+
+// Задача приходит строкой в args; без неё сценарий бессмыслен.
+const task = typeof args === 'string' ? args : (args?.task ?? '');
+if (!task) {
+    throw new Error('Нужна задача: передай её строкой в args');
+}
+
+const PLAN = {
+    type: 'object',
+    additionalProperties: false,
+    required: ['steps', 'risks', 'acceptance'],
+    properties: {
+        steps: {
+            type: 'array',
+            maxItems: 6,
+            items: {
+                type: 'object',
+                additionalProperties: false,
+                required: ['title', 'scope', 'done'],
+                properties: {
+                    title: { type: 'string' },
+                    scope: { type: 'string', description: 'что входит и что НЕ входит' },
+                    done: { type: 'string', description: 'проверяемый признак готовности' },
+                },
+            },
+        },
+        risks: { type: 'array', items: { type: 'string' } },
+        acceptance: { type: 'array', items: { type: 'string' }, description: 'критерии приёмки по исходному запросу' },
+    },
+};
+
+const FINDINGS = {
+    type: 'object',
+    additionalProperties: false,
+    required: ['findings', 'checked'],
+    properties: {
+        findings: {
+            type: 'array',
+            items: {
+                type: 'object',
+                additionalProperties: false,
+                required: ['what', 'where', 'evidence', 'severity'],
+                properties: {
+                    what: { type: 'string' },
+                    where: { type: 'string' },
+                    evidence: { type: 'string', description: 'вывод команды или замер, а не пересказ' },
+                    severity: { type: 'string', enum: ['blocker', 'major', 'minor'] },
+                    preExisting: { type: 'boolean' },
+                },
+            },
+        },
+        checked: { type: 'array', items: { type: 'string' } },
+    },
+};
+
+phase('План');
+const plan = await agent(
+    `Задача от пользователя:\n\n${task}\n\nРазбери её и верни план. Шагов не больше шести; ` +
+        `каждый — самостоятельная правка с проверяемым признаком готовности.`,
+    { agentType: 'project-manager', label: 'план', schema: PLAN }
+);
+log(`План: ${plan.steps.length} шаг(ов), рисков ${plan.risks.length}`);
+
+// Шаги идут по очереди, а не веером: рабочее дерево одно, и параллельные
+// правки одних и тех же файлов затирали бы друг друга.
+phase('Реализация');
+const done = [];
+for (const [index, step] of plan.steps.entries()) {
+    const result = await agent(
+        `Задача целиком: ${task}\n\nТвой шаг ${index + 1} из ${plan.steps.length}: ${step.title}\n` +
+            `Границы: ${step.scope}\nПризнак готовности: ${step.done}\n\n` +
+            `Уже сделано на предыдущих шагах:\n${done.join('\n') || '— ничего'}\n\n` +
+            `Соблюдай правила дерева из CLAUDE.md и .claude/skills. Перед правкой файла загрузи ` +
+            `подходящее правило через инструмент Skill — иначе гейт правил заблокирует правку. ` +
+            `Никаких git-команд. Верни коротко: какие файлы изменил и чем подтверждается признак готовности.`,
+        { label: `шаг ${index + 1}: ${step.title}`, phase: 'Реализация' }
+    );
+    done.push(`${step.title}: ${result ?? 'шаг не выполнен'}`);
+}
+
+// Здесь барьер оправдан: приёмке нужны все находки разом, а измерения
+// независимы и честно параллелятся.
+phase('Проверка');
+const LENSES = [
+    { key: 'тесты', prompt: 'Прогони юнит-тесты и e2e по затронутому. Отдели новые падения от доэтапных.' },
+    { key: 'сборка', prompt: 'Прогони сборки затронутых приложений и линтеры. Доэтапные ошибки помечай как доэтапные.' },
+    {
+        key: 'браузер',
+        prompt: 'Проверь результат в браузере замерами: вычисленные стили, геометрия, контраст. Серверы разработки уже подняты — свой не поднимай.',
+    },
+    {
+        key: 'разбор',
+        prompt: 'Состязательно разбери правку: граничные значения, вторая локаль, тёмная тема, узкий экран, отвалившийся сервер, отдача страницы сервером.',
+    },
+];
+const reports = (
+    await parallel(
+        LENSES.map(
+            (lens) => () =>
+                agent(`Задача, которую выполняли: ${task}\n\nЧто сделано:\n${done.join('\n')}\n\n${lens.prompt}`, {
+                    agentType: 'qa-engineer',
+                    label: `qa: ${lens.key}`,
+                    phase: 'Проверка',
+                    schema: FINDINGS,
+                })
+        )
+    )
+).filter(Boolean);
+
+const findings = reports.flatMap((report) => report.findings);
+const blockers = findings.filter((finding) => finding.severity === 'blocker' && !finding.preExisting);
+log(`Находок ${findings.length}, из них блокеров ${blockers.length}`);
+
+phase('Приёмка');
+const verdict = await agent(
+    `Исходный запрос пользователя:\n\n${task}\n\nКритерии приёмки:\n${plan.acceptance.join('\n')}\n\n` +
+        `Что сделано:\n${done.join('\n')}\n\nНаходки проверяющих:\n${JSON.stringify(findings, null, 1)}\n\n` +
+        `Вынеси вердикт: что принято, что нет и почему. Отдельно назови, что из исходного запроса ` +
+        `осталось незакрытым или тихо сузилось.`,
+    { agentType: 'project-manager', label: 'приёмка', phase: 'Приёмка' }
+);
+
+return { plan, done, findings, blockers, verdict };