forgeplan list

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

Когда использовать

В начале сессии, после forgeplan health, чтобы просканировать существующие артефакты
Перед forgeplan new - чтобы избежать создания дубликатов
При составлении объёма спринта (“все активные PRD с тегом auth”)
В скриптах CI для перечисления артефактов по статусу для отчётности

Когда не использовать

Вам нужно полное содержимое → используйте forgeplan get
Вам нужно нечёткое/семантическое сопоставление → используйте forgeplan search
Вам нужна иерархия (Epic → PRD → RFC) → используйте forgeplan tree
Вам нужен порядок зависимостей → используйте forgeplan order

Использование

forgeplan list [OPTIONS]

Опции

  -t, --type <TYPE>      Фильтровать по типу (prd, epic, spec, rfc, adr, etc.)
  -s, --status <STATUS>  Фильтровать по статусу (draft, active, etc.)
      --tag <TAG>        Фильтровать по тегу. Поддерживает "ключ=значение" или просто "ключ" (соответствует любому значению). Примеры: --tag source=code, --tag legacy
      --json             Выводить в формате JSON для машинной обработки
  -h, --help             Вывести справку
  -V, --version          Вывести версию

Примеры

Вывести всё (вид по умолчанию в новом рабочем пространстве):

forgeplan list

Только активные PRD - текущий активный объём продукта:

forgeplan list --type prd --status active

Всё с тегом security, в формате JSON для скриптов:

forgeplan list --tag security --json | jq '.[] | .id'

Интерпретация вывода

Вывод по умолчанию представляет собой таблицу из четырёх столбцов:

Столбец	Значение
`ID`	Стабильный ID артефакта (например, `PRD-001`, `RFC-002`, `EVID-012`)
`KIND`	Тип артефакта - prd, rfc, adr, epic, note, problem, evidence
`STATUS`	Жизненный цикл: draft / active / superseded / deprecated / stale
`TITLE`	Человекочитаемое название из frontmatter

Строки отсортированы по created в порядке убывания (сначала самые новые). С опцией --json каждая запись включает полный frontmatter, а также score и R_eff, если они доступны - полезно для передачи в jq для дашбордов.

Как это работает

list является точкой входа в цикл исследования только для чтения:

list → get → tree → graph   (понять, что существует и как это связано)

Для планирования используйте в связке с order и blocked, чтобы увидеть состояние зависимостей. Для сортировки качества используйте в паре с blindspots, чтобы найти артефакты без доказательств.

Смотрите также

forgeplan get - прочитать полный markdown одного артефакта
forgeplan tree - иерархический вид
forgeplan search - умный поиск по ключевым словам + семантический поиск
forgeplan health - дашборд на уровне проекта
Руководство по методологии