forgeplan blindspots

Найдите слепые пятна - активные решения, не имеющие под собой доказательств (R_eff = 0), и сироты (артефакты без связей), не привязанные ни к одному родительскому артефакту. Это самая важная команда для оценки состояния: активный PRD/RFC/ADR без доказательств - это «ложное обещание» - решение, которое выглядит реальным, но не имеет под собой никаких измерений.

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

Начало сессии - запустите эту команду сразу после forgeplan health и исправьте проблемы, прежде чем начинать новую работу (не накапливайте долги).
CI gate - прерывайте сборку, если какой-либо активный critical артефакт не имеет доказательств.
Перед релизом - устраните все слепые пятна перед созданием тега.
Ретроспектива - подсчитайте, сколько слепых пятен накопилось за спринт.

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

Если вы хотите найти застрявшие элементы (другая проблема) → используйте forgeplan blocked
Если вам нужен общий сводный отчёт → используйте forgeplan health
Если вам нужна временная шкала решений → используйте forgeplan journal с флагом --risk

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

forgeplan blindspots

Опции

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

Примеры

Вывести все слепые пятна:

forgeplan blindspots

Использовать как CI gate (выход с ненулевым кодом при наличии слепых пятен):

forgeplan blindspots || exit 1

В сочетании с health --ci для полной проверки:

forgeplan health --ci && forgeplan blindspots

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

Две секции - слепые решения и сироты (артефакты без связей):

BLIND DECISIONS (active, R_eff = 0.00)
  PRD-046  Docs v0.18.0 catch-up    → create EvidencePack + link
  ADR-008  Cloudflare Pages choice  → create EvidencePack + link

ORPHANS (no parent)
  PRD-044  Unused PRD               → link to Epic or deprecate
  NOTE-031 One-off observation      → link to artifact or ignore

Summary: 2 blind decisions, 2 orphans

Секция	Что это значит
Слепые решения	Активный PRD/RFC/ADR с `R_eff = 0` (без доказательств)
Сироты (артефакты без связей)	Артефакт без `parent` и без входящей ссылки

Код выхода: 0, если всё чисто, 1 в противном случае. Используйте это в git pre-push хуках или CI.

Как это работает

blindspots - это строгое подмножество того, что сообщает health

выделенное в отдельную команду, потому что это наиболее распространённый гейт, который необходимо применять. Единый рабочий процесс предписывает:

начало сессии → health → blindspots → (исправление) → новая работа

Если blindspots не пуст, исправьте это в первую очередь. Никогда не позволяйте активным решениям дрейфовать без измерений - именно это модель R_eff (слабое звено) призвана предотвращать.

См. также

forgeplan health - полная панель мониторинга проекта (с режимом --ci)
forgeplan journal --risk - временная шкала слепых решений
forgeplan score - R_eff для одного артефакта
forgeplan new evidence - создать EvidencePack
forgeplan link - прикрепить доказательство с --relation informs