forgeplan_guard

Проверяет, разрешён ли переход между фазами методологии конечным автоматом сессии (PRD-019). Гард обеспечивает соблюдение основного правила: нельзя перескакивать фазы без выполнения предварительных условий. Пример: вы не можете перейти от shaping к coding, если не существует активного артефакта и не пройдена валидация. Вызывайте это перед любым действием, изменяющим фазу (forgeplan_activate, коммиты, создание PR).

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

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

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

Это механизм, который предотвращает отклонение по принципу «сначала код, потом документация». Когда принудительное выполнение включено, нарушения блокируют операцию с чётким объяснением причины.

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

Имя	Тип	Обязательный	Описание
target_phase	string	yes	Целевая фаза для проверки: idle, routing, shaping, coding, evidence или pr.

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

Возвращает

{
  "allowed": true,
  "from": "shaping",
  "to": "coding",
  "reason": "PRD-042 валидирован (ПРОЙДЕНО), логика ADI записана"
}

Заблокированный случай:

{
  "allowed": false,
  "from": "shaping",
  "to": "coding",
  "reason": "Нет валидированного артефакта - сначала запустите forgeplan_validate",
  "fix": "forgeplan validate PRD-042"
}

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

{ "target_phase": "coding" }

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

1. forgeplan_session - узнайте, где вы находитесь.
2. forgeplan_guard с target_phase - проверьте следующий шаг.
3. Если allowed: false, следуйте инструкции fix (валидируйте, свяжите доказательства и т.д.).
4. Повторите гард → продолжите.

Эквивалент CLI

forgeplan guard --target coding

См. также

• forgeplan_session - текущая фаза.
• forgeplan_validate - разблокировать переход shaping → coding.
• Руководство по методологии