forgeplan gaps

forgeplan gaps проверяет каждый артефакт на соответствие его объявленной глубине и сообщает, что ожидает конвейер по сравнению с тем, что фактически существует. PRD уровня Deep должен иметь как минимум один связанный Spec и один ADR; Epic уровня Critical должен разветвляться на несколько PRD, RFC и ADR. Когда эти последующие артефакты отсутствуют, возникает пробел в конвейере - глубина даёт обещание, которое цепочка доказательств не выполняет.

Это не ошибка валидации (сам артефакт может быть в порядке) - это проверка соответствия методологии: остановились ли вы на полпути?

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

• В середине спринта: “Я сказал, что это Deep, действительно ли я создал Spec + ADR?”
• После повышения глубины с помощью calibrate - посмотрите, что теперь отсутствует.
• Проверка состояния перед релизом: “соответствует ли проект собственной методологии?”
• Очистка brownfield-проекта: импортированные артефакты часто имеют глубину без последующей цепочки.

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

• В рабочем пространстве только с артефактами уровня Tactical - пробелы не применяются.
• В качестве блокиратора для активации - пробелы носят рекомендательный характер, validate является гейтом.

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

forgeplan gaps

Опции

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

Примеры

Просмотр всех пробелов конвейера

forgeplan gaps

Вывод:

Pipeline compliance gaps
─────────────────────────
Deep PRDs without linked Spec:
  PRD-004  Search Intelligence   (depth=Deep, 0 Specs, 1 ADR)
  PRD-011  FPF KB vector search  (depth=Deep, 0 Specs, 0 ADRs)

Critical Epics without linked RFCs:
  EPIC-003 Search, Discovery, Intelligence  (depth=Critical, 4 PRDs, 1 RFC)  ← expected ≥3 RFCs

Standard PRDs with missing parent Epic:
  PRD-018  OpenSpec DAG integration  (orphan)

Исправление пробелов

Для каждой строки:

1. Отсутствует Spec для Deep PRD → forgeplan new spec "API for PRD-004" и свяжите.
2. Отсутствует ADR для Deep решения → запустите forgeplan reason, затем forgeplan new adr.
3. Critical Epic недостаточно разветвлён → переоцените глубину (возможно, это Deep, а не Critical) или добавьте недостающие RFC.
4. Сирота (артефакт без связей) → свяжите с родительским элементом или понизьте глубину.

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

Ожидаемые последующие артефакты по глубине
Tactical	опциональная Note
Standard	PRD → RFC (рекомендуется ADI)
Deep	PRD → Spec → RFC → ADR (требуется ADI)
Critical	Epic → PRD[] → Spec[] → RFC[] → ADR[]

Пробел означает, что метка глубины сильнее, чем цепочка доказательств. Либо создайте отсутствующий последующий артефакт, либо понизьте глубину с помощью calibrate.

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

calibrate → (depth may change) → gaps → create missing downstream → validate → activate

calibrate сообщает вам правильную глубину. gaps сообщает вам, подкреплена ли ваша существующая глубина ожидаемой последующей цепочкой. Вместе они обеспечивают честность методологии.

См. также

• forgeplan calibrate - перекалибровка глубины при появлении пробелов
• forgeplan health - агрегированные данные на уровне проекта
• forgeplan blocked - представление графа зависимостей
• Модель артефактов - сопоставление глубины с конвейером
• Обзор CLI