forgeplan_new

Создаёт новый артефакт-заглушку из встроенного шаблона для его типа. Агент вызывает это, когда он решил (обычно через forgeplan_route), какой тип артефакта нужен следующим - как правило, сразу после того, как запрос пользователя классифицирован как Standard или более глубокий. Возвращаемый ID является идентификатором, который агент использует для каждой последующей операции.

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

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

После того как forgeplan_route возвращает Depth: Standard, Pipeline: PRD → RFC и агенту нужна заглушка PRD.
Когда агенту говорят «создать ADR для решения X, которое мы только что приняли», и он хочет получить скелет для заполнения.
При декомпозиции работы - после того как forgeplan_decompose предлагает RFC, агент может вызвать new один раз для каждого предложенного RFC.

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

Имя	Тип	Обязательный	Описание
`kind`	`string`	yes	Тип артефакта: `prd`, `epic`, `spec`, `rfc`, `adr`, `problem`, `solution`, `evidence`, `note`, `refresh`.
`title`	`string`	yes	Заголовок артефакта.

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

Возвращает

Сгенерированный ID плюс отрендеренное тело. Агент должен немедленно заполнить разделы MUST через forgeplan_update вместо того чтобы оставлять заглушку - незаполненные PRD считаются слепыми пятнами в forgeplan_health.

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

{
  "id": "PRD-042",
  "kind": "prd",
  "status": "draft",
  "path": ".forgeplan/prds/prd-042-authentication-system.md",
  "body": "# PRD-042: Authentication system\n\n## Problem\n..."
}

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

{ "kind": "prd", "title": "Authentication system" }

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

Маршрутизатор вернул Depth: Standard, Pipeline: PRD → RFC. Агент создаёт заглушку PRD, прежде чем приступать к коду.

{ "kind": "prd", "title": "Rate limit auth endpoints" }

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

forgeplan_route → forgeplan_new → forgeplan_update (заполнить разделы MUST) → forgeplan_validate (PASS) → forgeplan_reason (ADI для Standard+) → код → доказательство → forgeplan_activate.

Эквивалент CLI

forgeplan new - та же операция с интерактивными подсказками

См. также

Обзор MCP
forgeplan_generate - тело, сгенерированное LLM, вместо заглушки
forgeplan_update - заполнить заглушку
forgeplan_validate - подтвердить полноту