forgeplan_deprecate

Перемещает артефакт в конечное состояние deprecated (отменённый) без замены. В отличие от supersede (заместить), что подразумевает «используйте вместо этого новую вещь», deprecate (отменить) означает «мы больше этим не занимаемся». Обязательная reason (причина) сохраняется в артефакте и отображается при каждом последующем вызове forgeplan_get, чтобы будущие читатели понимали, почему он был выведен из эксплуатации.

Категория: Жизненный цикл

Когда агент вызывает эту команду

Вывод функции из эксплуатации: «мы убираем ограничение скорости из v3, отмените PRD-020».
Отменённое направление: исследовательский PRD, который оказался невыполнимым.
Очистка в ходе устранения проблем forgeplan_health: просроченные артефакты, которые никто не будет продлевать.

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

Имя	Тип	Обязательный	Описание
`id`	`string`	yes	ID артефакта для отмены.
`reason`	`string`	yes	Причина отмены.

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

Возвращает

Подтверждение перехода с сохранённой причиной. Причина становится частью фронтматтера артефакта и отображается при последующих чтениях.

Пример структуры ответа:

{
  "ok": true,
  "id": "PRD-020",
  "from": "active",
  "to": "deprecated",
  "reason": "Replaced by v3 rate-limit strategy in RFC-019; feature removed from roadmap."
}

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

{ "id": "PRD-020", "reason": "Feature cancelled; see Q2 planning doc." }

В типичном контексте агента:

Заинтересованные стороны решили отказаться от функции. Агент фиксирует причину и отменяет артефакт.

{ "id": "PRD-020", "reason": "Feature cancelled in Q2 planning; no replacement." }

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

forgeplan_list --status active (или --status stale) → выбрать цель → подтвердить с пользователем → forgeplan_deprecate id=X reason="..." → forgeplan_health, чтобы убедиться, что список слепых пятен сокращается. Для просроченных артефактов альтернативой является forgeplan_renew (продлить срок действия) - выберите правильный путь в зависимости от того, является ли решение всё ещё актуальным.

Эквивалент CLI

forgeplan deprecate - та же операция

См. также

Обзор MCP
forgeplan_supersede - когда существует замена
forgeplan_stale - предшествует отмене для просроченных артефактов
forgeplan_delete - необратимое удаление (избегать)