forgeplan_capture

Превращает контекст свободного разговора в постоянный артефакт - либо Note (тактическое микро-решение), либо ADR (запись архитектурного решения) на основе автоматического определения. Агент вызывает это, когда понимает, что в чате только что было принято реальное решение, но никто его ещё не записал. Захват - это то, как Forgeplan восстанавливает «племенные знания», которые иначе были бы потеряны в истории чата.

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

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

Пользователь завершает обсуждение фразой «тогда давайте выберем подход B» - агент захватывает решение, чтобы сохранить обоснование.
Контрольная точка в конце сессии: агент просматривает чат и захватывает решения до того, как контекст будет потерян.
Когда forgeplan_health сообщает, что недавние коммиты не имеют связанных решений - ретроактивный захват.

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

Имя	Тип	Обязательный	Описание
`decision`	`string`	yes	Утверждение о решении для захвата.
`context`	`string`	no	Дополнительный контекст.

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

Возвращает

ID созданного артефакта и тип, выбранный классификатором. Агенты должны считывать kind, потому что это показывает, было ли решение расценено как «тяжёлое» (ADR) или «лёгкое» (Note) - полезно для принятия решения, следует ли дополнять его обоснованием или просто связать.

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

{
  "ok": true,
  "id": "ADR-012",
  "kind": "adr",
  "auto_detected": true,
  "title": "Использовать JWT вместо сессионных куки для мобильных клиентов",
  "path": ".forgeplan/adrs/adr-012-use-jwt-for-mobile.md"
}

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

{ "context": "Мы решили использовать JWT с 15-минутными токенами доступа и 7-дневными токенами обновления для мобильных клиентов, потому что сессионные куки не работают в iOS PWA." }

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

После обсуждения дизайна агент захватывает окончательное решение, чтобы оно сохранилось для будущих сессий.

{ "to": "adr", "context": "Выбрали pg_partman для временного секционирования таблицы событий, потому что он чисто интегрируется с pg_cron." }

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

Conversation → forgeplan_capture → forgeplan_validate (для ADR) → forgeplan_link (к любым связанным PRD/RFC) → forgeplan_activate. Захват часто используется в паре с forgeplan_link relation=informs, чтобы новая запись не оставалась сиротой (артефакт без связей).

Эквивалент CLI

forgeplan capture - та же операция, ввод текста через пайп

См. также

Обзор MCP
forgeplan_generate - более полный черновик с нуля
forgeplan_new - альтернатива в виде пустого заглушки
forgeplan_link - прикрепление к родительским решениям