forgeplan deprecate

forgeplan deprecate переводит артефакт из состояния active (или stale) в deprecated - терминальное состояние. В отличие от supersede, отмена не указывает на замену: вы заявляете, что “это решение больше не актуально, и ничто не занимает его место”. Флаг --reason обязателен, чтобы будущие читатели понимали, почему артефакт был выведен из эксплуатации, а сам артефакт сохраняется, чтобы исторические ссылки продолжали разрешаться.

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

• Изменение бизнес-стратегии сделало PRD неактуальным: функция была отменена, и нет последующего PRD.
• ProblemCard была закрыта, потому что основная проблема исчезла (изменилась среда, временное решение стало постоянным), и SolutionPortfolio не требуется.
• Ограничивающий ADR больше не актуален: технология, которой он управлял, была полностью удалена из стека.
• Артефакт в состоянии stale был пересмотрен, и команда решила, что его не следует продлевать - срок действия действительно истёк.

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

• У вас есть прямая замена - используйте forgeplan supersede с --by, чтобы отслеживать родословную.
• Вы хотите переоценить решение в новом черновике - используйте forgeplan reopen, который сочетает отмену с созданием последующего черновика.
• Артефакт всё ещё находится в состоянии draft - черновики, которые никогда не были активированы, могут быть удалены или переписаны, но не отменены.
• Вам нужно только продлить срок действия просроченного артефакта - используйте forgeplan renew.

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

forgeplan deprecate --reason <REASON> <ID>

Аргументы

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

Опции

      --reason <REASON>  Причина отмены
  -h, --help             Вывести справку
  -V, --version          Вывести версию

Примеры

Пример 1: Вывод из эксплуатации отменённого PRD

forgeplan deprecate PRD-011 --reason "feature cancelled after Q1 roadmap review, no successor"

PRD-011 переходит в состояние deprecated. Отчёты о состоянии исключают его из расчётов слепых пятен, но он остаётся читаемым.

Пример 2: Закрытие устаревшей ProblemCard

forgeplan deprecate PROB-018 --reason "root cause removed by infra migration, problem no longer reproducible"

ProblemCard не проходят гейт MUST при активации, но отмена всё равно фиксирует терминальную причину.

Пример 3: Отмена просроченного ADR, который не будет продлён

forgeplan stale
forgeplan deprecate ADR-009 --reason "valid_until expired 2026-03; architecture replaced by RFC-014 scope"

Используйте forgeplan stale для поиска просроченных артефактов, затем отмените те, которые не должны быть продлены.

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

Отмена - это чистое, терминальное завершение: артефакт покидает активный набор и перестаёт влиять на forgeplan health. Это правильный инструмент, когда актуальность решения действительно исчерпана и преемника не существует. Поскольку состояние является терминальным, указанная вами причина становится постоянным объяснением - пишите её для читателя через шесть месяцев, а не для себя сегодня.

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

Ошибка	Причина	Исправление
--reason обязателен	Флаг опущен	Передайте --reason "..." с удобочитаемым объяснением
Невозможно отменить из черновика	Артефакт никогда не был активирован	Вместо этого удалите или перепишите черновик
Уже в терминальном состоянии	Уже deprecated или superseded	Терминальные состояния окончательны - ничего не нужно делать
Слепые пятна увеличились после отмены	Активные артефакты зависели от этого	Обновите или заместите зависимые артефакты перед отменой

См. также

• forgeplan supersede - вывести из эксплуатации со ссылкой на замену
• forgeplan reopen - отменить и автоматически создать новый черновик
• forgeplan renew - продлить срок действия просроченного артефакта вместо отмены
• forgeplan stale - найти артефакты, срок действия valid_until которых истёк
• forgeplan health - проверить состояние проекта после отмены
• Руководство по жизненному циклу v2
• Методология: Жизненный цикл артефакта