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

forgeplan_phase

Возвращает рекомендательную методологическую фазу артефакта (Shape, Validate, Adi, Code, Test, Audit, Evidence, Done) плюс полную append-only историю переходов из .forgeplan/state/<id>.yaml. Трекинг фаз - рекомендательный: ни один другой инструмент на нём не блокируется. Если файла состояния нет (артефакт до PRD-056 или phase.enabled: false в конфиге), ответом будет current_phase: "unknown" с пустой историей; никогда - ошибка.

Категория: Lifecycle (рекомендательный)

Когда агент вызывает

Заголовок раздела «Когда агент вызывает»
  • Старт сессии на in-flight артефакте: «где я остановился?».
  • Перед вызовом тяжёлого инструмента: убедиться, что мы прошли нужную фазу (например, не запускать forgeplan_score, пока ещё в shape).
  • Просмотр старого артефакта: пройтись по истории, чтобы понять, как он пришёл к текущему состоянию.
  • Аудит / отладка: каждый переход фазы записан с timestamp и опциональной причиной.

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

Заголовок раздела «Входные параметры»
ИмяТипОбязательноОписание
idstringyesID артефакта, чьё состояние фазы прочитать.

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

Возвращает

Заголовок раздела «Возвращает»
{
  "artifact_id": "PRD-057",
  "current_phase": "code",
  "workflow_type": "greenfield",
  "advanced_at": "2026-04-26T09:30:00Z",
  "history": [
    { "phase": "shape", "ts": "2026-04-25T14:00:00Z", "reason": null },
    { "phase": "validate", "ts": "2026-04-25T15:20:00Z", "reason": null },
    { "phase": "code", "ts": "2026-04-26T09:30:00Z", "reason": "FRs implemented" }
  ],
  "_next_action": "`PRD-057` is on phase `code`. Suggested next: `test`. Manual override: `forgeplan_phase_advance PRD-057 --to <phase>`."
}

Когда файла состояния ещё нет:

{
  "artifact_id": "PRD-001",
  "current_phase": "unknown",
  "workflow_type": "greenfield",
  "history": [],
  "message": "No phase state file on disk - advisory only, never an error",
  "_next_action": "`PRD-001` has no phase state yet. ..."
}

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

Заголовок раздела «Пример вызова»
{ "id": "PRD-057" }

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

Заголовок раздела «Типичная последовательность»
  1. forgeplan_phase - прочитать текущую фазу.
  2. Если current_phase: "unknown" и трекинг нужен: forgeplan_phase_advance --to shape.
  3. Иначе следовать подсказке _next_action к рекомендуемой следующей фазе.

CLI эквивалент

Заголовок раздела «CLI эквивалент»

forgeplan phase <id> - те же данные, та же рекомендательная семантика.

См. также

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