ревью: скилл review-pipeline — стадии, профили, контракт находок, храповик

Конвейер собран по типу проходов, а не по ролям: гейт (детерминированный,
блокирующий) → сверка с дельта-спеками в обе стороны → generative-проходы →
архитектура → враждебные постановки → обязательный триаж. Профили quick /
standard / deep / design с правилом выбора по факту изменения.

Контракт находок: заголовок через последствие, обязательное поле «Последствие»,
critical без оракула или построенного пути не существует, потолок 7 пунктов и
разметка «инлайн | развилка» — отчёт читает оркестратор и молча реализует
прочитанное, поэтому потолок защищает код от незаказанных правок.

Храповик находка → конвенция → правило → удаление из прозы и промптов; журнал
проскочивших дефектов и калибровка инъекцией с вердиктами keep/retune/drop.
Секция границ покрытия обязательна: отчёт без неё потребляет ощущение
проверенности, ничего не гарантируя.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

.claude/skills/review-pipeline/references/migration-2026-07.md

@@ -0,0 +1,77 @@
+# Отчёт о переработке конвейера ревью (2026-07-23)
+
+Что было, что стало и на основании чего. Обоснование «почему» —
+[ADR-2026-07-23-review-pipeline-generative](../../../../docs/adr/ADR-2026-07-23-review-pipeline-generative.md).
+
+## Было
+
+Отдельного скилла ревью не существовало. Ревью — это два сабагента
+(`jellybit-review-specs`, `jellybit-review-code`), вызываемые из шагов 4 и 7
+`task-pipeline`, плюс дубль в финальной сверке `task-batch`. Детерминированные
+проверки жили отдельно и **после** опиниативных: `lefthook` срабатывал на
+коммите, `task test`/`task lint` — внутри apply.
+
+Диагностика показала: все проходы applicative, generative нет ни одного; ни один
+проход не запускает инструменты (обоим это было прямо запрещено); сверка со
+спекой односторонняя; архитектурный угол судит по диффу; триажа нет; границ
+покрытия нет; измерения качества нет. Плюс два мелких долга: ссылка на
+несуществующий скилл `verify` и дублирующие проходы в `task-batch`.
+
+## Стало
+
+| Было | Стало | На основании чего |
+|---|---|---|
+| `task test`/`task lint` внутри apply, lefthook на коммите | **Stage 0** `jellybit-review-gate` + `task gate`: build, vet, lint, gofmt, тесты, повтор на флаки, `-race`, покрытие изменённых строк, миграции, ER-схема, gitleaks, govulncheck. Блокирует опиниативные проходы | детерминированный оракул надёжнее мнения; проверка, идущая после ревью, не защищает ревью |
+| `jellybit-review-specs`: spec → code | **Stage 1** он же + **code → spec** (тихие ветки, самодеятельные дефолты, проглоченные ошибки, незаказанные ретраи), границы спеки, право сказать «требование неверно» | системная болезнь агентского кода — тихо добавленное поведение; односторонняя сверка его не видит |
+| — | **Stage 2** `jellybit-review-rubric`, `jellybit-review-reimpl`, `jellybit-review-idiom`, `jellybit-review-negative` | recall чек-листа равен его длине; неявный слой достаётся только порождением критерия |
+| архитектура как один из 9 буллетов `review-code`, вход = дифф | **Stage 3** `jellybit-review-architecture`, вход = `task review:context` (пакеты, граф зависимостей, публичная поверхность, инвентарь концепций) + дифф. Потолок 3 находки | агент, видящий только дифф, не знает словаря проекта и потому не может судить о втором способе делать то же самое |
+| — | **Stage 4** `jellybit-review-adversary` (находка = построенный путь), `jellybit-review-ops` (условный постмортем) | враждебная постановка находит то, чего не находит перечисление свойств |
+| разгребал оркестратор вручную | **Stage 5** `jellybit-review-triage`: дедуп по причине, оракул для critical/major, понижение неподтверждённого, отсев вкусовщины, потолок 7, разметка `инлайн`/`развилка` | отчёт читает оркестратор и молча реализует прочитанное: без потолка узкое место переезжает в незаказанные правки кода |
+| `review-code`: 9 углов, включая механизируемое | `review-code` сжат до конвенций, **не выраженных правилом** | всё, что проверяет линтер, в промпте только отвлекает внимание |
+| ревью-проходы дублировались в `task-batch` | в `task-batch` осталось **только то, что появилось от слияния**: рассинхроны на стыках + вопрос о втором способе | те же проходы на тех же файлах дают те же находки и удорожают триаж |
+| ссылка на несуществующий скилл `verify` | Skill `run` | скилла `verify` нет ни в проекте, ни у пользователя — шаг молча не выполнялся |
+
+## Что слито и что удалено
+
+- **Слито:** архитектурный угол и стиль/дублирование выведены из
+  `jellybit-review-code` в отдельные проходы с разными классами дефектов;
+  per-capability прогон в `task-batch` сужен до стыков вместо повторного полного
+  ревью.
+- **Удалено:** ничего. Существующий проход не удаляется без замера — сначала
+  калибровка (`calibration.md`), потом решение. `jellybit-review-code` оставлен
+  как дешёвый проход профиля `quick`.
+
+## Конвенции → правила
+
+Механизировано и вычеркнуто из прозы (`docs/conventions/*`) и из
+`openspec/config.yaml`:
+
+| Правило | Инструмент | Откуда убрано |
+|---|---|---|
+| `msg` — константа, без интерполяции; стиль ключ-значение; ошибка полем | `sloglint` | logging.md |
+| `slog` вместо `fmt.Print*` | `forbidigo` | logging.md |
+| конфиг не из env | `forbidigo` (`os.Getenv`) | config.md |
+| время только через `store.Now()` | `forbidigo` (`time.Now`) | database.md |
+| `err == ErrX`, приведение типа ошибки | `errorlint` | errors.md |
+| сторонние пакеты ошибок | `depguard` | errors.md |
+| матчинг ошибки по тексту сообщения | `internal/archrules` | errors.md |
+| `AUTOINCREMENT`, `DEFAULT (datetime('now'))` в новых миграциях | `internal/archrules` | database.md |
+| транспорты не знают друг о друге, ядро не знает о транспортах | `internal/archrules` | CLAUDE.md (осталась одна строка принципа) |
+| ER-схема обновлена вместе с миграцией | `scripts/gate.sh` (по диффу) | — |
+
+Правки кода под новые правила: `logging.StartCall` как единая точка отсчёта
+длительности внешних вызовов, `store.Now` вместо `time.Now` в `httpapi` и
+часах воркера, `slog.DiscardHandler` в тестах.
+
+## Что осталось непокрытым намеренно
+
+- **Ревьювер наименований** по словарю единого языка — глоссария нет, проверять
+  не по чему. Заводится после задачи «Словарь единого языка».
+- **Дробление `review-code` на узкие оптики** — отклонено: декорреляция внимания
+  без декорреляции суждения почти не добавляет recall, но линейно удорожает
+  триаж.
+- **Профиль нагрузки, история инцидентов, завязка внешних потребителей** —
+  недоступны ни одному проходу и остаются человеку. Перечислены в разделе
+  «Честный предел» скилла.
+- **Калибровка проходов не проведена**: процедура заведена, первые прогоны — за
+  пользователем (журнал проскочивших дефектов пока пуст).