forgeplan_supersede

Помечает активный артефакт как замещённый более новым. Это конечный переход - после замещения артефакт никогда не возвращается в активное состояние. Инструмент также автоматически создаёт ссылку supersedes, чтобы история решения сохранялась и была отслеживаемой. Агенты используют это, когда PRD/RFC/ADR заменяется (не отменяется, не удаляется) новой, улучшенной версией.

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

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

Редизайн: новый RFC-019 замещает RFC-018 - агент вызывает supersede RFC-018 --by RFC-019.
Вторая итерация решения после того, как новые доказательства противоречат старым.
Переименование/реструктуризация: создать новый артефакт, затем заместить старый, чтобы история оставалась связанной.

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

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

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

Возвращает

Подтверждение перехода плюс автоматически созданная ссылка. Агенты должны прочитать from/to, чтобы убедиться, что он действительно переместился, и проверить link, чтобы подтвердить согласованность графа.

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

{
  "ok": true,
  "id": "RFC-018",
  "from": "active",
  "to": "superseded",
  "link": { "source": "RFC-019", "target": "RFC-018", "relation": "supersedes" }
}

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

{ "id": "RFC-018", "by": "RFC-019" }

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

Команда приняла новую стратегию повторных попыток, задокументированную в RFC-019. Агент замещает RFC-018.

{ "id": "RFC-018", "by": "RFC-019" }

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

forgeplan_new (замена) → forgeplan_update → forgeplan_validate УСПЕШНО → forgeplan_activate замену → forgeplan_supersede старый. Никогда не замещайте до того, как замена станет активной - вы оставите сироту (артефакт без связей).

Эквивалент CLI

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

См. также

Обзор MCP
forgeplan_activate - предыдущий шаг
forgeplan_deprecate - отмена без замены
forgeplan_link - создание ссылки вручную