forgeplan fpf check

forgeplan fpf check <ID> оценивает каждое активное правило First Principles Framework для отдельного артефакта и выводит совпадения - сгруппированные по действию (EXPLORE / INVESTIGATE / EXPLOIT) и аннотированные разделом FPF, из которого выведено каждое правило.

Это проекция на уровне артефакта для fpf rules и fpf dashboard.

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

Перед активацией PRD/RFC/ADR - убедитесь, что правила INVESTIGATE больше не срабатывают.
Когда forgeplan validate проходит успешно, но вам требуется более глубокий анализ обоснования - правила выявляют то, что не может обнаружить валидация (например, «слишком мало гипотез для глубины Deep»).
При отладке застрявшего артефакта - посмотрите, какое именно правило блокирует прогресс.
Во время состязательной ревью - используйте вывод правил в качестве структурированного контрольного списка для критики.

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

Для синтаксических / структурных проверок - используйте forgeplan validate.
Для обзора в масштабе проекта - используйте fpf dashboard.
Для элементов глубины Tactical, где обоснование FPF намеренно обходится.

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

forgeplan fpf check [OPTIONS] <ID>

Аргументы

  <ID>   ID артефакта (например, PRD-041)

Опции

      --verbose  Показывать также названия несопоставленных правил
      --json     Вывести полный RuleCheckResult в формате JSON
  -h, --help     Вывести справку
  -V, --version  Вывести версию

Примеры

# По умолчанию: показывать совпадающие правила, сгруппированные по действию
forgeplan fpf check PRD-019

# Показывать также несопоставленные правила (полезно при отладке, почему правило не сработало)
forgeplan fpf check PRD-019 --verbose

# Машиночитаемый вывод для клиентов MCP и аудиторских скриптов
forgeplan fpf check ADR-005 --json

Как работают пороги explore / investigate / exploit

Каждый ограниченный контекст, к которому принадлежит артефакт, имеет три производных значения R_eff:

explore_reff - насколько хорошо охвачено пространство гипотез. Низкое значение → срабатывают правила EXPLORE («генерировать альтернативы»).
investigate_reff - насколько сильны доказательства для существующих гипотез. Низкое значение → срабатывают правила INVESTIGATE («прикрепить лучшие доказательства»).
exploit_reff - соответствует ли выбранный путь критерию «готовности к коммиту». Высокое значение → правила EXPLOIT разблокируют активацию.

Пороги калибруются по глубине:

Глубина	Требуется очистка EXPLORE	Требуется очистка INVESTIGATE	Требуется очистка EXPLOIT
Tactical	-	-	-
Standard	рекомендуется	рекомендуется	требуется
Deep	требуется	требуется	требуется
Critical	требуется + ревью	требуется + ревью	требуется + ревью

Для артефактов глубины Deep/Critical, fpf check фактически является гейтом предварительной активации: исправьте правила INVESTIGATE перед вызовом forgeplan activate.

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

fpf check считывает:

Строку артефакта из LanceDB (тип, глубина, статус, R_eff, связанные доказательства).
Активный набор правил из движка правил FPF (PRD-041).
Разделы базы знаний FPF, цитируемые каждым правилом (PRD-042).

…и формирует удобочитаемый отчёт, а также машиночитаемую сводку, используемую fpf dashboard и forgeplan validate (целостность методологии PRD-043).

См. также

forgeplan fpf - родительская команда
forgeplan fpf rules - полный набор правил
forgeplan fpf dashboard - обзор в масштабе проекта
forgeplan validate - структурная валидация
forgeplan reason - генерировать больше гипотез, когда срабатывают правила EXPLORE
forgeplan score - входные данные R_eff, лежащие в основе порогов