forgeplan_update

Применяет изменения к телу и/или метаданным frontmatter существующего артефакта на месте. Это путь прямого редактирования - агент использует его для заполнения только что созданной заглушки, переписывания раздела после обратной связи от пользователя или переименования артефакта. Для переходов жизненного цикла (draft → active → superseded) агент должен использовать специализированные инструменты forgeplan_activate / forgeplan_supersede / forgeplan_deprecate вместо этого, которые обеспечивают гейты валидации.

Категория: Редактирование артефактов

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

• Сразу после forgeplan_new для заполнения ОБЯЗАТЕЛЬНЫХ разделов (Problem, Goals, Non-Goals, FR).
• Применение запрошенного пользователем изменения: “добавить раздел о наблюдаемости в RFC-007”.
• Исправление обнаружения валидатора: forgeplan_validate сообщает об отсутствующем разделе, агент записывает его и повторно валидирует.

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

Имя	Тип	Обязательный	Описание
id	string	yes	ID артефакта для обновления.
status	string	no	Новый статус: draft, active, superseded, deprecated.
title	string	no	Новый заголовок.
body	string	no	Новое содержимое тела (полная замена markdown).

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

Возвращает

Обновлённая запись артефакта с новым значением updated_at. Проекция markdown на диске перерисовывается автоматически. Если status установлен в значение, требующее гейта жизненного цикла (например, active), вызов отклоняется - агент должен использовать forgeplan_activate вместо этого.

Пример формы ответа:

{
  "ok": true,
  "id": "PRD-042",
  "updated_at": "2026-04-11T10:02:14Z",
  "changed": ["title", "body"]
}

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

{ "id": "PRD-042", "title": "Authentication and session system" }

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

Агент только что запустил forgeplan_new, получил PRD-042, и теперь заполняет ОБЯЗАТЕЛЬНЫЕ разделы одной заменой тела.

{ "id": "PRD-042", "body": "# PRD-042: Authentication system\n\n## Problem\n..." }

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

forgeplan_new → forgeplan_update (заполнение заглушки) → forgeplan_validate → цикл по любым обнаружениям → forgeplan_activate. Для поздних изменений активного артефакта шаблон такой: forgeplan_get → вычислить патч → forgeplan_update.

Эквивалент CLI

• Прямое редактирование markdown (нет эквивалента одной командой - пользователи CLI редактируют .forgeplan/*/*.md и полагаются на автопроекцию).

См. также

• Обзор MCP
• forgeplan_activate - правильный путь для draft → active
• forgeplan_validate - валидировать после редактирования
• forgeplan_supersede - заместить вместо редактирования