доки: ADR о переработке конвейера ревью и обновление беклога

ADR фиксирует «почему»: recall чек-листа равен его длине, ценность верификатора
определяется оракулом и декорреляцией с автором (а не числом ролей), отчёт без
границ покрытия хуже отсутствия отчёта.

В беклоге закрыт открытый вопрос «дробить ли review-code на узкие оптики» — не
дробим; осталась калибровка проходов и ревьювер наименований.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
av
2026-07-23 18:18:23 +03:00
co-authored by Claude Opus 4.8
parent f8edfc1782
commit 534572dc9c
4 changed files with 118 additions and 10 deletions
+28 -9
View File
@@ -2,23 +2,42 @@
**Приоритет:** средний
Набор узких сабагентов-ревьюверов поверх ревью-процесса из CLAUDE.md, каждый со своей оптикой: соответствие наименований словарю единого языка, соблюдение архитектурных границ (единое ядро/тонкие транспорты, инварианты безопасности данных), конвенций (ошибки, логирование, конфиг, TZ), стиля кода и поиск дублирования. Запускаются как чекпоинт перед archive/коммитом. Развивает ревью-процесс OpenSpec в сторону воспроизводимых автопроверок, не заменяя человеческое ревью.
Набор сабагентов-ревьюверов поверх ревью-процесса из CLAUDE.md. Развивает
ревью-процесс OpenSpec в сторону воспроизводимых автопроверок, не заменяя
человеческое ревью.
## Сделано (2026-07-10)
- Заведены два кастомных ревьювера в `.claude/agents/`: `jellybit-review-specs`
(оптика спек/требований) и `jellybit-review-code` (архитектура, инварианты,
конвенции, стиль, дублирование).
- Оба подключены как чекпоинт в скилл `.claude/skills/task-pipeline` (ревью спек
ДО кода + ревью кода перед archive; на тривиальной задаче — один
`jellybit-review-code`, на нетривиальной — оба параллельно).
- Оба подключены как чекпоинт в скилл `.claude/skills/task-pipeline`.
## Сделано (2026-07-23) — переработка конвейера
Конвейер пересобран по типу проходов, а не по ролям: скилл
`.claude/skills/review-pipeline` (гейт → сверка со спекой в обе стороны →
generative-проходы → архитектура → враждебные постановки → триаж), профили
`quick`/`standard`/`deep`/`design`, контракт находок, границы покрытия,
храповик «находка → конвенция → правило → удаление», журнал проскочивших
дефектов и процедура калибровки. Подробности — ADR
[ADR-2026-07-23-review-pipeline-generative](../adr/ADR-2026-07-23-review-pipeline-generative.md)
и отчёт о миграции в `references/migration-2026-07.md` скилла.
Открытый вопрос «дробить ли `jellybit-review-code` на узкие оптики» закрыт:
**не дробим** — декорреляция внимания без декорреляции суждения почти не
добавляет recall, но линейно удорожает триаж.
## Осталось
- **Ревьювер наименований** (соответствие словарю единого языка) — отдельной
оптикой пока не выделен: зависит от задачи «Словарь единого языка
(ubiquitous language)», без глоссария проверять не по чему. Завести после неё.
- По опыту эксплуатации — решить, дробить ли `jellybit-review-code` на более
узкие оптики (архитектура / конвенции / стиль+дублирование) или оставить одним.
оптикой не выделен: зависит от задачи «Словарь единого языка (ubiquitous
language)», без глоссария проверять не по чему. Завести после неё.
- **Калибровка проходов** по процедуре
`.claude/skills/review-pipeline/references/calibration.md` — ни один проход
ещё не замерен инъекцией. До замера ничего не удаляем и промпты не правим.
- **Заполнить журнал** `docs/review/journal.md` случаями, которые уже
проскочили ревью, — они станут первыми пробами калибровки.
Связано: CLAUDE.md (ревью-процесс, конвенции), docs/conventions, «Словарь единого языка», скилл `task-pipeline`.
Связано: CLAUDE.md (ревью-процесс, конвенции), docs/conventions, «Словарь
единого языка», скиллы `review-pipeline`/`task-pipeline`/`task-batch`.