forgeplan activate

forgeplan activate переводит артефакт из состояния draft в active. Это наиболее частый переход в жизненном цикле: он отмечает момент, когда PRD, RFC, ADR, Epic или Spec считается действующим, готовым для ссылок из других артефактов, и ожидается, что он будет подкреплен доказательствами. Для структурированных артефактов активация запускает гейт валидации - все правила MUST должны быть пройдены. Для легковесных артефактов (Note, Problem) активация происходит без проверки и немедленно.

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

Вы только что завершили реализацию PRD: все FR отмечены как выполненные, EvidencePack связан, и forgeplan score PRD-001 возвращает R_eff > 0.
ADR был рассмотрен командой, и решение окончательное - пришло время сделать его авторитетным.
RFC прошел гейт верификации, и его этапы реализации начали производить доказательства.

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

У артефакта все еще есть ошибки валидации MUST - сначала исправьте их с помощью forgeplan validate <id> вместо того, чтобы использовать --force.
За решением еще нет кода, тестов или измерений. Активация без доказательств создает слепое пятно в forgeplan health.

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

forgeplan activate [OPTIONS] <ID>

Аргументы

  <ID>  ID артефакта

Опции

      --force    Принудительная активация, даже если валидация содержит ошибки MUST
  -h, --help     Вывести справку
  -V, --version  Вывести версию

Примеры

Пример 1: Активация полностью валидированного PRD

forgeplan validate PRD-001
forgeplan score PRD-001
forgeplan activate PRD-001

Сначала запустите validate и score, чтобы убедиться, что гейт MUST пройден и R_eff не равен нулю, затем активируйте.

Пример 2: Активация ADR после ревью

forgeplan review ADR-005
forgeplan activate ADR-005

review выполняет те же проверки, что и activate, но без изменения состояния - полезно в качестве пробного запуска перед переключением.

Пример 3: Принудительная активация, несмотря на ошибки валидации

forgeplan activate RFC-012 --force

Используйте только в исключительных случаях (например, при миграции существующих артефактов). Предпочтительнее исправлять недочеты.

Как это вписывается в рабочий процесс

Эта команда является частью полного жизненного цикла артефакта - см. руководство для сквозного процесса. Активация - это то, как Forgeplan отличает работу “в процессе” от “действующих” решений, от которых могут зависеть другие артефакты.

Распространенные ошибки

Ошибка	Причина	Исправление
`MUST rule failed: Problem section missing`	Обязательный фронтматтер или раздел пуст	Отредактируйте файл артефакта, затем повторно запустите `forgeplan validate <id>`
`Artifact already in state: active`	Уже активирован в предыдущей сессии	Действий не требуется; проверьте с помощью `forgeplan show <id>`
`R_eff = 0 after activation`	EvidencePack не связан	Создайте доказательство с помощью `forgeplan new evidence`, затем `forgeplan link` + `forgeplan score`
`Cannot activate from terminal state`	Артефакт `superseded` или `deprecated`	Конечные состояния никогда не активируются повторно - вместо этого создайте новый черновик

См. также

forgeplan validate - запускает гейт валидации без изменения состояния
forgeplan score - проверяет R_eff до и после активации
forgeplan review - пробный запуск готовности
forgeplan supersede - замещает один активный артефакт другим
forgeplan deprecate - отменяет активный артефакт без замены
Руководство по жизненному циклу v2
Методология: Жизненный цикл артефакта