forgeplan reason

forgeplan reason выполняет структурированный анализ существующего артефакта с помощью ИИ, используя цикл ADI FPF: абдукция (генерация 3+ гипотез) → дедукция (прогнозирование последствий каждой) → индукция (проверка прогнозов на основе существующих доказательств). Это гейт между «PRD выглядит разумным» и «я действительно знаю, какой подход выбрать» - он заставляет агента перечислять альтернативы вместо того, чтобы зацикливаться на первом правдоподобном ответе. Для глубины Deep и Critical это обязательно: никакого кода, пока reason не сгенерирует как минимум три конкурирующие гипотезы и обоснованного победителя.

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

• Сразу после forgeplan new prd + forgeplan validate PASS, до начала работы с кодом.
• Глубина Deep или Critical - ADI не подлежит обсуждению.
• Глубина Standard, и пространство решений имеет реальные компромиссы (уровень кэширования, алгоритм ограничения скорости, поток аутентификации).

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

• Глубина Tactical - исправление ошибки за один час не требует трёх гипотез.
• Разделы MUST ещё не заполнены - ADI на заглушке создаёт галлюцинаторный контекст.
• Артефакт является чистым EvidencePack, Note или RefreshReport (нет решения для рассуждений).

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

forgeplan reason [OPTIONS] <ID>

Аргументы

  <ID>  ID артефакта для анализа (PRD, RFC, ADR, Epic, Problem, ...)

Опции

      --json     Вывод структурированного JSON вместо markdown
      --save     Сохранить анализ ADI как артефакт Note, связанный с источником
      --fpf      Внедрить соответствующие шаблоны FPF в промпт ADI
  -h, --help     Вывести справку
  -V, --version  Вывести версию

Примеры

Пример 1: Стандартный ADI для PRD

forgeplan reason PRD-001

Считывает PRD-001, извлекает его разделы Problem/Goals/Related и просит LLM сгенерировать 3+ гипотезы о том, как достичь целей. Для каждой гипотезы он перечисляет прогнозируемые последствия и существующие доказательства, которые её поддерживают или ослабляют.

Пример 2: ADI с контекстом базы знаний FPF

forgeplan reason PRD-001 --fpf

--fpf внедряет соответствующие разделы из базы знаний FPF (B.3 Trust Calculus, B.5 Reasoning loops) в промпт. Используйте это, когда решение затрагивает границы доверия, обратимость или качество рассуждений - LLM будет оценивать гипотезы по инвариантам FPF, а не только по инженерной интуиции.

Пример 3: Сохранение анализа как Note

forgeplan reason PRD-001 --save

Создаёт артефакт note-*, содержащий полный вывод ADI, и связывает его с исходным PRD (отношение informs). Полезно, когда вы хотите, чтобы рассуждения сохранились после текущей сессии терминала и отображались в forgeplan get PRD-001 --graph.

Пример 4: Машиночитаемый вывод для агентов

forgeplan reason PRD-001 --json

Выводит структурированный JSON с hypotheses[], каждый из которых содержит summary, confidence, supporting_evidence[], weakening_evidence[] и verdict. Используется клиентами MCP и скриптами аудита.

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

Типичный запуск markdown выводит три раздела:

• Абдукция - 3+ гипотезы, каждая с однострочным утверждением и оценкой достоверности (0-100%). Если все три сходятся на одном и том же подходе, вы можете действовать с высоким уровнем доверия. Если они расходятся, расценивайте это как сигнал для обсуждения с человеком перед кодированием.
• Дедукция - прогнозируемые последствия для каждой гипотезы (производительность, стоимость отката, радиус поражения, влияние на пользователя).
• Индукция - вердикт по каждой гипотезе: supported (подтверждена), weakened (ослаблена) или insufficient evidence (недостаточно доказательств). Окончательная рекомендация перечисляет выигрышную гипотезу и пробелы в доказательствах, которые должны стать последующими EvidencePack.

Красные флаги:

• Все гипотезы имеют достоверность < 50% - PRD недостаточно детализирован, вернитесь к Shape
• Победитель - insufficient evidence - создайте целевые доказательства перед реализацией
• Сгенерирована только одна гипотеза - привязка LLM, повторите запуск с --fpf или другой моделью

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

Эта команда является частью полного жизненного цикла артефакта - см. руководство для сквозного процесса. reason запускается после validate PASS и до написания кода; для глубины Critical, используйте в паре с /audit и человеческим ревью перед реализацией.

См. также

• forgeplan route - решить, требуется ли ADI
• forgeplan decompose - разбить проанализированный PRD на задачи RFC
• forgeplan validate - предварительное условие перед рассуждением
• forgeplan generate - черновик содержимого артефакта
• Методология: цикл ADI