Files
jellybit/docs/tasks/items/quality-review-agents.md
T
av 9a624d4e13 tasks: остаток урожая ревью разнесён по домам
- tests-convention: два кандидата про тесты — один стенд чужого API на пакет,
  интеграционный тест обязан утверждать
- convention-candidates: язык вывода в пяти местах без связывающего правила
- quality-review-agents: четыре прохода не сообщили потолок находок —
  первый замер калибровки
2026-08-07 17:09:52 +03:00

5.6 KiB

🧹 Откалибровать проходы ревью и завести ревьювер наименований

  • Тип: chore
  • Категория: Инфраструктура
  • Зачем: конвейер ревью переехал в плагин av-dev-pipeline; осталась калибровка проходов на этом проекте и ревьювер наименований (ждёт словарь единого языка)
  • Теги: goal:dev-process-quality

Набор проходов ревью поверх ревью-процесса из CLAUDE.md. Развивает ревью-процесс OpenSpec в сторону воспроизводимых автопроверок, не заменяя человеческое ревью.

Сделано (2026-07-10)

Заведены два кастомных ревьювера: оптика спек/требований и оптика кода (архитектура, инварианты, конвенции, стиль, дублирование); оба подключены чекпоинтами в пайплайн задачи.

Сделано (2026-07-23) — переработка конвейера

Конвейер пересобран по типу проходов, а не по ролям: гейт → сверка со спекой в обе стороны → generative-проходы → архитектура → враждебные постановки → триаж, профили quick/standard/deep/design, контракт находок, границы покрытия, храповик «находка → конвенция → правило → удаление», журнал проскочивших дефектов и процедура калибровки. Подробности — ADR ADR-2026-07-23-review-pipeline-generative.

Открытый вопрос «дробить ли проход по конвенциям на узкие оптики» закрыт: не дробим — декорреляция внимания без декорреляции суждения почти не добавляет recall, но линейно удорожает триаж.

Сделано (2026-08-04) — переезд в плагин

Проектные копии агентов (.claude/agents/jellybit-review-*) и скиллов (review-pipeline, task-pipeline, task-batch) удалены в пользу плагина av-dev-pipeline. Проектная специфика теперь приходит из документов канона — docs/review.md: типовые узлы, ложноположительные, вопросы по темам, триггеры метки, недоступное проверке.

Два прохода плагин при этом упразднил, и это надо помнить:

  • idiom — поимённая сверка со стайлгайдами языка не задаётся теперь ни одним проходом; куда переселены способные части и почему класс признан обратимым — docs/review.md → «Перестали проверять сознательно».
  • negative — вопрос «что опытный человек отсюда удалил бы» вошёл в architecture вторым обязательным.

Осталось

  • Ревьювер наименований (соответствие словарю единого языка) — отдельной оптикой не выделен: зависит от задачи «Словарь единого языка», без глоссария проверять не по чему. Завести после неё.
  • Калибровка проходов по процедуре references/calibration.md скилла av-dev-pipeline:review-pipeline — ни один проход ещё не замерен инъекцией. До замера ничего не удаляем и промпты не правим.
  • Проходы не сообщают свой потолок находок. На прогоне tvdb-title-locale (2026-08-07) о потолке промолчали четверо из шести — autotests, specs, architecture, ops; триаж свой назвал («6 из 7, потолок не выбран»). Устав требует объявлять сработавший потолок строкой, и без неё «находок больше нет» неотличимо от «больше не поместилось» — то есть ровно тот сигнал, ради которого потолок и заведён. Первый замер калибровки стоит начать с этого: дефект прогона виден без инъекции.
  • Заполнить журнал дефектов в docs/review.md случаями, которые уже проскочили ревью, — они станут первыми пробами калибровки.
  • Решить судьбу упразднённых проходов: нужен ли проекту свой idiom поверх плагина, или записи в «Недоступно проверке» достаточно.

Связано: CLAUDE.md (ревью-процесс, конвенции), docs/conventions/, «Словарь единого языка».