forgeplan fgr

forgeplan fgr выводит тройку качества F-G-R для артефакта:

F - Формальность: насколько он структурирован? Заполненные обязательные разделы (MUST), связанные родительские элементы, явные критерии приёмки.
G - Гранулярность: насколько он декомпозирован? Количество функциональных требований (FR), флажки фаз, детализация на уровне листьев.
R - Надёжность: насколько ему можно доверять? Связанные доказательства, R_eff, статус состязательной ревью.

Каждая ось оценивается от 0 до 3. F-G-R ортогонален жизненному циклу - артефакт в статусе draft уже может иметь F=3/G=3/R=2, а active может быть F=1/G=1/R=0 (слепое пятно). Trust Calculus FPF использует exploit_fgr ≥ 0.6 как пороговое значение для повторного использования решения без его повторного вывода.

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

Для быстрой визуальной проверки зрелости без запуска всех 30+ правил валидатора.
В начале сессии, после health, для сортировки артефактов по принципу “самый дешёвый для повышения уровня”.
При сравнении двух PRD-кандидатов перед фиксацией объёма работ.
Для Trust Calculus: exploit_fgr управляет решениями explore-vs-exploit в движке правил FPF.

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

В качестве замены validate - FGR это сводка, а не отчёт о правилах.
Для артефактов, не являющихся решениями, где оси не применимы в чистом виде (Notes, RefreshReports).

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

forgeplan fgr [OPTIONS] [ID]

Аргументы

  [ID]  ID артефакта (оценивает все, если пропущено)

Опции

      --json     Вывод в формате JSON для машинной обработки
  -h, --help     Вывести справку
  -V, --version  Вывести версию

Примеры

Проверить один PRD

forgeplan fgr PRD-001

Вывод:

PRD-001 - Auth System
  F = 3/3   Formality     (все обязательные разделы заполнены, родительские элементы связаны)
  G = 2/3   Granularity   (7 FR, 2 фазы - в фазах отсутствуют критерии приёмки)
  R = 1/3   Reliability   (1 связанное доказательство, R_eff = 0.40)
  overall = 2.0/3   exploit_fgr = 0.67

exploit_fgr ≥ 0.6 → движок правил FPF будет доверять этому решению для повторного использования.

Ранжировать все артефакты по зрелости

forgeplan fgr --json | jq 'sort_by(.overall) | reverse | .[0:10]'

10 самых зрелых артефактов - полезно при принятии решения о том, что продвигать или цитировать.

Найти самые “дешёвые победы”

forgeplan fgr --json | jq '.[] | select(.F == 3 and .G == 3 and .R < 2)'

Артефакты, которым нужно только доказательство для достижения полной зрелости - добавьте доказательство, оцените, готово.

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

Ось	0	1	2	3
F - Формальность	заглушка, отсутствуют обязательные разделы	заполнены некоторые обязательные разделы	все обязательные разделы + псевдонимы	все обязательные разделы + ссылки + критерии приёмки
G - Гранулярность	нет FR/фаз	1–3 FR	4–7 FR + фазы	8+ FR + фазы + измеримость
R - Надёжность	нет доказательств, R_eff=0	1 доказательство, CL ≤ 1	2+ доказательств, R_eff ≥ 0.4	веские доказательства, R_eff ≥ 0.8

Overall = среднее значение F/G/R. exploit_fgr = overall / 3.0, используется как гейт в forgeplan fpf trust.

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

health → fgr → найти артефакты с низким R → добавить доказательства → оценить → fgr (перепроверить)

F и G оплачиваются во время Shape (new → validate). R оплачивается во время Evidence (new evidence → link → score). fgr - это линза, которая показывает, какая категория требует работы.

См. также

forgeplan validate - детализация по правилам для оси F
forgeplan score - R_eff, который питает ось R
forgeplan health - агрегированные F-G-R по всему проекту
Quality Gates - FGR и Trust Calculus
Обзор CLI