forgeplan_list

Возвращает отфильтрованный перечень артефактов в рабочем пространстве. Это самый экономичный вызов для обнаружения - агенты используют его для ответов на вопросы, такие как “какие PRD активны?” или “сколько у нас просроченных ADR?” без получения полного содержимого. Для полнотекстового обнаружения агенту следует использовать forgeplan_search.

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

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

Запуск сессии: агенту нужен быстрый обзор существующих элементов, прежде чем принимать решение о следующем действии.
Фильтрация по состоянию: “покажи мне все черновики PRD” перед выполнением пакетной валидации.
Ответ на вопрос пользователя, например “сколько RFC мы выпустили?” - полное содержимое не требуется.

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

Имя	Тип	Обязательный	Описание
`kind`	`string`	no	Фильтр по типу (`prd`, `rfc`, `adr`, …).
`status`	`string`	no	Фильтр по статусу (`draft`, `active`, `stale`, `superseded`, `deprecated`).

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

Возвращает

Массив JSON с краткими сведениями об артефактах - ID, тип, статус, заголовок и несколько полей фронтматтера (глубина, теги, updated_at). Содержимое намеренно опущено; используйте forgeplan_get, когда требуется полное содержимое.

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

{
  "count": 3,
  "artifacts": [
    { "id": "PRD-042", "kind": "prd", "status": "active", "title": "Auth system", "depth": "standard" },
    { "id": "PRD-041", "kind": "prd", "status": "active", "title": "FPF rules", "depth": "deep" },
    { "id": "PRD-040", "kind": "prd", "status": "draft", "title": "Scoring intelligence", "depth": "standard" }
  ]
}

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

{ "kind": "prd", "status": "active" }

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

Агент начинает сессию; хочет получить быстрый снимок активной работы, прежде чем читать какое-либо содержимое.

{ "status": "active" }

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

Обычно это второй или третий вызов сессии - после forgeplan_init/forgeplan_health и перед forgeplan_get для конкретного ID. Агенты часто передают результат в сводку для пользователя без каких-либо дальнейших вызовов MCP.

Эквивалент CLI

forgeplan list - те же фильтры, вывод в виде удобочитаемой таблицы

См. также

Обзор MCP
forgeplan_get - читать полное содержимое одного артефакта
forgeplan_search - полнотекстовое / семантическое обнаружение
forgeplan_health - агрегированное состояние проекта