forgeplan_get

Возвращает полное тело артефакта в формате Markdown, а также метаданные фронтматтера. Это каноническая операция “чтения” - агент вызывает её, когда ему требуется фактическое содержимое PRD/RFC/ADR, чтобы рассуждать о нём, цитировать или обновлять. В отличие от forgeplan_list, ответ содержит всё, что нужно агенту для понимания артефакта.

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

Когда агент вызывает эту операцию

Пользователь спрашивает: “Что PRD-042 говорит об ограничениях скорости?” - агент извлекает, затем цитирует соответствующий раздел.
Перед вызовом forgeplan_update - агенту требуется текущее тело, чтобы создать патч с учётом различий.
Перед forgeplan_reason - агент предварительно считывает данные, чтобы описать контекст пользователю, если вызов LLM происходит медленно.

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

Имя	Тип	Обязательный	Описание
`id`	`string`	yes	ID артефакта для чтения (например, `PRD-042`, без учёта регистра).

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

Возвращает

Артефакт в виде объекта JSON: все поля фронтматтера (kind, status, depth, tags, dates, valid_until) плюс тело в формате Markdown в виде строки. Если ID не существует, возвращает ошибку, чтобы агент мог восстановиться (часто путём вызова forgeplan_search для поиска правильного ID).

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

{
  "id": "PRD-042",
  "kind": "prd",
  "status": "active",
  "depth": "standard",
  "title": "Authentication system",
  "tags": ["auth", "security"],
  "updated_at": "2026-04-11T09:31:00Z",
  "body": "# PRD-042: Authentication system\n\n## Problem\nUsers currently..."
}

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

{ "id": "PRD-001" }

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

Пользователь спрашивает: “Напомни, что PRD-042 говорит об истечении срока действия токена”. Агент извлекает полное тело, чтобы процитировать соответствующий раздел.

{ "id": "PRD-042" }

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

forgeplan_list или forgeplan_search возвращает ID → forgeplan_get извлекает тело → агент цитирует / рассуждает / обновляет. Для массового чтения агентам следует предпочитать forgeplan_search, который возвращает ранжированные фрагменты, а не вызывать get в цикле.

Эквивалент в CLI

forgeplan show - человекочитаемый вывод в терминале

См. также

Обзор MCP
forgeplan_list - сначала найдите ID
forgeplan_update - редактирование после чтения
forgeplan_search - обнаружение на уровне содержимого