forgeplan session

Показывает текущее состояние сессии методологии - в какой фазе цикла Forgeplan вы находитесь (роутинг, Shape, Validate, Code, Evidence, Activate) и какой должен быть следующий шаг. Это команда «где я?» как для агентов, так и для людей.

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

• Возобновить работу после перерыва - «что я делал?»
• AI-агенты между вызовами инструментов - для принятия решения о следующем действии
• Принудительное соблюдение протокола - чтобы случайно не пропустить ни одну фазу
• Многоагентные системы - супервизор считывает состояние сессии для роутинга работы

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

• Вы хотите список задач → используйте TODO.md или ваш трекер задач
• Вы хотите узнать состояние проекта → используйте forgeplan health

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

forgeplan session [OPTIONS]

Опции

      --reset    Сбросить сессию в состояние Idle
  -h, --help     Вывести справку
  -V, --version  Вывести версию

Примеры

Показать текущую фазу:

forgeplan session

Сбросить состояние после прерывания задачи:

forgeplan session --reset

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

Пример вывода:

Session: shaping
  Active artifact:  PRD-046
  Depth:            Standard
  Next step:        forgeplan validate PRD-046
  Last transition:  2026-04-11 14:05 (routing → shaping)

Фазы соответствуют циклу Forgeplan:

Фаза	Значение
idle	Нет активной задачи
routing	Выполнение forgeplan route - определение глубины/конвейера
shaping	Написание разделов MUST в новом PRD/RFC/ADR
validating	Выполнение forgeplan validate до состояния PASS
reasoning	Генерация гипотез ADI (глубина Standard+)
coding	Реализация изменения
evidence	Создание EvidencePack и связывание
activating	Выполнение activate после R_eff > 0

Состояние хранится в .forgeplan/session.yaml и сохраняется между вызовами CLI. Используйте --reset, если состояние зависло или просрочено.

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

session - это индикатор фазы внутри принудительного цикла:

routing → shaping → validating → reasoning → coding → evidence → activating

Каждая успешная команда продвигает сессию вперёд. Если вы видите одну и ту же фазу в течение нескольких часов, это сигнал к тому, чтобы сдвинуться с места - либо завершить фазу, либо сбросить состояние.

См. также

• forgeplan route - определить глубину и конвейер
• forgeplan health - состояние проекта
• Единый рабочий процесс - полный цикл