Перейти к содержимому
F●RGEPLAN

forgeplan fpf rules

forgeplan fpf rules выводит каждое активное правило в движке правил First Principles Framework, сгруппированное по рекомендуемой категории действий: EXPLORE (генерировать больше гипотез), INVESTIGATE (собирать больше доказательств для существующих гипотез) или EXPLOIT (придерживаться проверенного пути).

Правила кодируют Trust Calculus FPF в машиноисполняемой форме. Именно их fpf check использует для оценки отдельных артефактов, а fpf dashboard агрегирует в рекомендации на уровне проекта.

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

Заголовок раздела «Когда использовать»
  • Перед спринтом - просмотрите набор правил, чтобы понять, что ищет движок.
  • Когда правило срабатывает неожиданно - прочитайте полный текст правила, чтобы понять причину срабатывания.
  • При написании документации по методологии - ссылайтесь на правила по ID.
  • При отладке вывода fpf check - см. полное определение правила, стоящее за совпадением.

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

Заголовок раздела «Когда НЕ использовать»
  • Для совпадений по отдельным артефактам - используйте fpf check <id>.
  • Для рекомендаций по действиям в масштабе проекта - используйте fpf dashboard.

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

Заголовок раздела «Использование»
forgeplan fpf rules [OPTIONS]

Опции

Заголовок раздела «Опции»
      --flat     Плоская таблица по приоритету вместо дерева, сгруппированного по действиям
      --json     Вывод полного дампа правил в формате JSON
  -h, --help     Вывести справку
  -V, --version  Вывести версию

Представление по умолчанию группирует правила по действиям (EXPLORE / INVESTIGATE / EXPLOIT). --flat переключает на единую таблицу, упорядоченную по приоритету, если вы хотите просмотреть правила с наивысшим приоритетом независимо от действия. --json выводит полный дамп правил для клиентов MCP и скриптов аудита.

Примеры

Заголовок раздела «Примеры»
Окно терминала
# По умолчанию: дерево, сгруппированное по действиям
forgeplan fpf rules


# Плоская таблица, упорядоченная по приоритету
forgeplan fpf rules --flat


# Машиночитаемый полный дамп
forgeplan fpf rules --json


# Типичный процесс ревью
forgeplan fpf rules
forgeplan fpf check PRD-019
forgeplan fpf dashboard

Три категории действий

Заголовок раздела «Три категории действий»

Правила соответствуют оси explore→investigate→exploit из части B FPF:

  • EXPLORE - артефакт или контекст имеет слишком мало гипотез. Правило предлагает генерировать альтернативы (например, “Менее 3 гипотез на Deep глубине - запустите forgeplan reason”).
  • INVESTIGATE - гипотезы существуют, но доказательства слабые или имеют низкий уровень конгруэнтности. Правило предлагает собрать больше (например, “R_eff ниже порога - прикрепите EvidencePack с измерениями”).
  • EXPLOIT - доверие достаточно сильно, чтобы принять обязательства. Правило разрешает активацию или замещение артефакта.

Каждое правило содержит условие (предикат для метаданных артефакта), метку действия и удобочитаемое обоснование, привязанное к разделу FPF (например, ref: B.3).

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

Заголовок раздела «Как это работает»

Движок правил был представлен в PRD-041 и расширен в PRD-043 (целостность методологии). Он считывает состояние артефактов из LanceDB и обращается к базе знаний FPF за текстом обоснования. Вывод поступает в:

  • fpf check <id> - представление по отдельным артефактам
  • fpf dashboard - агрегированное представление по контекстам
  • forgeplan validate / activate гейты (для правил целостности)

См. также

Заголовок раздела «См. также»