Files

T

docs: проект переведён на канон документов версии 4

- каталог задач: PLAN.md → ROADMAP.md с каноническими секциями, все 44
  записи получили тип, заголовки приведены к форме своего типа
- расхождения, найденные судьями канона: исключения инварианта «источник
  неприкосновенен», инвариант про один активный infohash, UTC в logging.md,
  поведение из architecture.md заменено ссылками на спеки
- триггеры профиля ревью переписаны под умолчание standard

2026-08-06 13:32:06 +03:00

4.8 KiB

Raw Blame History

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

Тип: 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 — поимённая сверка со стайлгайдами языка не задаётся теперь ни одним проходом; способные части переселены в ops и architecture. Класс обратимый (портит форму кода, не данные) и признаётся в границах покрытия.
negative — вопрос «что опытный человек отсюда удалил бы» вошёл в architecture вторым обязательным.

Осталось

Ревьювер наименований (соответствие словарю единого языка) — отдельной оптикой не выделен: зависит от задачи «Словарь единого языка», без глоссария проверять не по чему. Завести после неё.
Калибровка проходов по процедуре references/calibration.md скилла av-dev-pipeline:review-pipeline — ни один проход ещё не замерен инъекцией. До замера ничего не удаляем и промпты не правим.
Заполнить журнал дефектов в docs/review.md случаями, которые уже проскочили ревью, — они станут первыми пробами калибровки.
Решить судьбу упразднённых проходов: нужен ли проекту свой idiom поверх плагина, или записи в «Недоступно проверке» достаточно.

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

4.8 KiB Raw Blame History