forgeplan review

forgeplan review - это гейт, предназначенный для человека, который вы запускаете непосредственно перед forgeplan activate. Он объединяет validate (правила MUST/SHOULD) с чек-листом жизненного цикла (есть ли родитель? есть ли доказательство? R_eff > 0? соответствует ли глубина?) и возвращает один из трёх вердиктов:

READY - валидация пройдена, и все пункты чек-листа жизненного цикла отмечены. Можно безопасно активировать.
NEEDS-ATTENTION - обнаружены SHOULD или неблокирующие элементы жизненного цикла, но вы можете продолжить, если принимаете риск.
BLOCKED - сбои MUST или отсутствующие критические связи. Активация будет отклонена.

Если validate сообщает вам, какие правила сработали, то review говорит вам, что делать дальше.

Когда использовать

Всегда запускайте перед forgeplan activate - это каноническая предстартовая проверка.
В конце спринта при пакетной активации - сначала пройдитесь по каждому кандидату с помощью review.
При возвращении к черновику после перерыва, чтобы увидеть, что ещё требует внимания.

Когда НЕ использовать

Для Note / Problem - им не нужен гейт валидации для активации.
В конвейерах CI - используйте validate --ci вместо этого (машиночитаемый формат, коды выхода).

Использование

forgeplan review <ID>

Аргументы

  <ID>  ID артефакта

Опции

  -h, --help     Вывести справку
  -V, --version  Вывести версию

Примеры

Проверка перед активацией

forgeplan review PRD-001

Вывод, когда готово:

PRD-001 - Auth System
  Валидация:       ПРОЙДЕНО (0 MUST, 1 SHOULD)
  Родительская связь:      EPIC-002 ✓
  Доказательство:         EVID-012, EVID-015 (2 связаны)
  R_eff:            0.90
  FGR:              F=3 G=3 R=2 (общий 2.67)
  Глубина:            Standard (соответствует роутингу)
  Жизненный цикл:        черновик → активный

  Вердикт: READY - запустите `forgeplan activate PRD-001`

Вывод, когда заблокировано:

PRD-004 - Search Intelligence
  Валидация:       СБОЙ (2 ошибки MUST)
    - Отсутствует раздел: Non-Goals
    - Список FR пуст
  Родительская связь:      (нет)
  Доказательство:         (нет - слепое пятно)
  R_eff:            0.00

  Вердикт: BLOCKED - исправьте ошибки MUST, свяжите родителя, добавьте доказательство

Проверка перед пакетной активацией

for id in PRD-001 PRD-002 PRD-003; do
  forgeplan review "$id"
done

Быстрая сортировка результатов спринта.

Интерпретация вывода

Вердикт	Значение	Следующее действие
READY	Валидация чиста, доказательство присутствует, R_eff > 0	`forgeplan activate <ID>`
NEEDS-ATTENTION	SHOULD или незначительные пробелы - нет сбоев MUST	Исправьте, что можете, затем активируйте
BLOCKED	Сбои MUST или R_eff = 0 для решения	Не активируйте; сначала исправьте

Чек-лист также указывает на распространённые отклонения: отсутствующая родительская связь, просроченное доказательство, несоответствие глубины (роутинг указывает Deep, но артефакт Tactical).

Как это вписывается в рабочий процесс

code → new evidence → link → score → REVIEW → activate
                                        │
                                        ├── READY        → activate
                                        ├── ATTENTION    → fix SHOULDs (optional)
                                        └── BLOCKED      → fix MUSTs (required)

Представьте review как окончательный отчёт, который движок жизненного цикла показывает вам перед изменением состояния. Это чисто рекомендательный инструмент, когда у вас всё настроено чисто, и спасение, когда нет.

См. также

forgeplan validate - гейт на уровне правил, который оборачивает review
forgeplan activate - переход состояния, который питает этот гейт
forgeplan score - вход R_eff для чек-листа ревью
forgeplan fgr - тройка F-G-R, показанная в отчёте
Обзор CLI