forgeplan_reason

Запускает цикл рассуждений FPF ADI (Абдукция → Дедукция → Индукция) для артефакта, опционально используя контекст из FPF Knowledge Base. Абдукция генерирует 3+ конкурирующие гипотезы, Дедукция формирует проверяемые предсказания для каждой, а Индукция синтезирует заключение с обоснованной уверенностью. Для артефактов глубины Deep и Critical ADI обязателен - агент никогда не должен фиксировать код, пока не будет проконсультирован forgeplan_reason.

Категория: Рассуждения и ИИ

Когда агент вызывает эту функцию

• После forgeplan_validate PASS, но до кодирования артефакта глубины Deep/Critical - обязательный гейт ADI.
• Когда пользователь колеблется между двумя подходами - ADI формирует сопоставимые предсказания.
• Во время состязательной ревью: переосмыслить с другими ограничениями для стресс-тестирования текущего решения.

Входные параметры

Имя	Тип	Обязательный	Описание
id	string	yes	ID артефакта для анализа с помощью цикла рассуждений ADI.

Источник схемы: crates/forgeplan-mcp/src/server.rs::ReasonParams

Возвращает

Структурированный отчёт ADI. Массив hypotheses содержит 3+ записи, каждая с предсказаниями. induction содержит синтезированную рекомендацию и оценку уверенности, которую агент должен выводить дословно.

Пример структуры ответа:

{
  "id": "PRD-042",
  "hypotheses": [
    { "id": "H1", "claim": "Use JWT with 15m access / 7d refresh", "predictions": ["..."] },
    { "id": "H2", "claim": "Use server-side sessions with Redis", "predictions": ["..."] },
    { "id": "H3", "claim": "OAuth2 device flow for CLI clients", "predictions": ["..."] }
  ],
  "deduction": [
    { "hypothesis": "H1", "supported_by": ["..."], "risks": ["..."] }
  ],
  "induction": {
    "recommendation": "H1 with session blacklist fallback",
    "confidence": 0.78,
    "rationale": "Aligns with existing infrastructure; lowest rollback cost."
  }
}

Пример вызова

{ "id": "PRD-001", "fpf": true }

С типичным контекстом агента:

PRD-042 имеет глубину Deep. Агент запускает ADI с контекстом FPF KB, прежде чем приступить к кодированию.

{ "id": "PRD-042", "fpf": true }

Типичная последовательность

forgeplan_validate PASS → forgeplan_reason (обязательно для Deep/Critical) → агент представляет гипотезы пользователю → пользователь выбирает направление (или соглашается с индукцией) → кодирование. Если уверенность индукции низка (< 0.5), агент должен сообщить о неопределённости, а не продвигаться вперёд.

Эквивалент CLI

• forgeplan reason - тот же конвейер, вывод в терминал

См. также

• Обзор MCP
• Методология FPF
• forgeplan_fpf_search - прямой поиск по базе знаний
• forgeplan_decompose - рассуждения, применённые к декомпозиции