forgeplan_session

Показать текущее состояние сессии методологии - в какой фазе вы находитесь (idle / routing / shaping / coding / evidence / pr), активный артефакт, управляющий сессией, маршрутизированную глубину и включено ли принудительное применение методологии. Сессия - это конечный автомат Forgeplan, который связывает Route → Shape → Code → Evidence → Activate воедино (PRD-019).

Категория: Качество

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

• Возобновить работу - “что я делал раньше?” - сессия запоминает активный артефакт и фазу.
• Перед переходом - прочитать состояние, затем вызвать forgeplan_guard, чтобы проверить, разрешен ли следующий переход.
• Проверки согласованности - если вы думаете, что вы “coding”, но сессия говорит shaping, что-то не так.
• Онбординг новых агентов - они могут найти точку входа в рабочий процесс с помощью этого инструмента.

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

Входные параметры отсутствуют. Вызовите этот инструмент с пустым объектом {}.

Возвращает

{
  "phase": "coding",
  "active_artifact": "PRD-042",
  "depth": "standard",
  "enforcement": "enabled",
  "started_at": "2026-04-11T09:17:00Z",
  "history": [
    { "phase": "routing", "at": "2026-04-11T09:05:00Z" },
    { "phase": "shaping", "at": "2026-04-11T09:10:00Z" },
    { "phase": "coding", "at": "2026-04-11T09:17:00Z" }
  ]
}

Если ничего не активно:

{
  "phase": "idle",
  "active_artifact": null,
  "depth": null
}

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

{}

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

1. forgeplan_session - прочитать состояние.
2. forgeplan_guard с целевой фазой - проверить, разрешен ли переход.
3. Если разрешено, выполнить работу фазы (code / evidence / PR).
4. Фаза автоматически продвигается по мере прохождения артефактов через жизненный цикл.

Эквивалент CLI

forgeplan session

См. также

• forgeplan_guard - гейт для фазовых переходов.
• forgeplan_route - точка входа, которая открывает сессию.
• Руководство по методологии