forgeplan reopen

forgeplan reopen - это переход “давайте подумаем об этом снова”. Он отменяет текущий артефакт (переводя его в конечное состояние deprecated с указанной вами причиной) и одновременно создает новый артефакт-черновик того же типа, связанный с оригиналом в качестве указателя родословной. Используйте его, когда решение устарело и требует новой проработки через Shape → Validate → ADI вместо быстрого продления. В отличие от supersede, вы не заменяете его уже активным преемником - вы начинаете исследование заново.

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

• ADR просрочился, и по результатам ревью было решено, что сам подход нуждается в переосмыслении, а не просто в продлении срока действия.
• Исходные предположения PRD больше не соответствуют реальности, и вы хотите переписать его, а не просто внести исправления.
• RefreshReport выявил множество тревожных сигналов по ранее активному решению - переоткройте его, чтобы начать новый черновик.
• ProblemCard, который вы считали решенным, вновь появился в новой форме, и вам нужен новый артефакт, чтобы переопределить его область действия.

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

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

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

forgeplan reopen --reason <REASON> <ID>

Аргументы

  <ID>  ID артефакта для переоткрытия

Опции

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

Примеры

Пример 1: Переоткрыть ADR для полной переоценки

forgeplan reopen ADR-007 --reason "стратегия хранения требует переосмысления после изменений в LanceDB v0.8"

ADR-007 переходит в состояние deprecated (конечное), и создается новый черновик ADR со ссылкой на родословную, указывающей на ADR-007. Заполните его и проведите через обычный цикл Shape → Validate → ADI.

Пример 2: Переоткрыть PRD, чьи предположения изменились

forgeplan reopen PRD-010 --reason "целевые пользователи изменились после исследования персон в 1 квартале 2026 года"

Новый черновик наследует тип (PRD) и связывается как преемник, находящийся на переоценке. Старый PRD остается читаемым для исторического контекста.

Пример 3: Использование reopen как части цикла обновления

forgeplan stale
forgeplan refresh ADR-012
forgeplan reopen ADR-012 --reason "отчет об обновлении выявил 3 недействительных инварианта"

Комбинируйте с refresh, когда переоценка требует структурированного отчета до открытия нового черновика.

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

Reopen - это самый затратный переход в жизненном цикле: он перезапускает цикл Shape → Validate → ADI → Code → Evidence → Activate для всего решения. После переоткрытия вы должны рассматривать новый черновик как артефакт полной глубины - заполните разделы MUST, запустите forgeplan reason, если глубина этого требует, создайте новые доказательства, и только затем активируйте. Старый артефакт сохраняется в конечном состоянии, поэтому ссылки из исторического контекста (другие артефакты, история git, предыдущие обсуждения) по-прежнему разрешаются. Обращайтесь к нему, когда простое renew скрыло бы реальное изменение, и когда еще нет преемника, чтобы supersede с ним.

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

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

См. также

• forgeplan renew - продлить срок действия, когда решение все еще корректно
• forgeplan supersede - заменить уже активным преемником
• forgeplan deprecate - вывести из эксплуатации без последующих действий
• forgeplan new - вручную создать основу нового артефакта, если reopen не подходит
• forgeplan activate - активировать новый черновик, как только он будет готов
• Руководство по жизненному циклу v2
• Методология: Жизненный цикл артефактов