forgeplan tree

Отображает иерархию артефактов в виде ASCII-дерева. Используйте это, чтобы понять, как декомпозируется работа: Epic → PRD → RFC → ADR, а также прикреплённые Spec, Evidence и Note. Связи родитель/потомок определяются по полю parent во frontmatter и типизированным связям forgeplan link.

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

Ввод нового сотрудника в курс дела - «покажи мне декомпозицию»
Аудит Epic перед спринтом - просмотр всех дочерних элементов в одном представлении
Подготовка сводки по релизу - все PRD, сгруппированные по Epic
Выборочная проверка сирот (артефактов без связей) - артефакты без родителя отображаются вверху

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

Вам нужны перекрёстные связи (а не только родитель/потомок) → используйте forgeplan graph
Вам нужен порядок выполнения → используйте forgeplan order
Вам нужен плоский список → используйте forgeplan list

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

forgeplan tree [OPTIONS] [ID]

Аргументы

  [ID]  ID корневого артефакта (если пропущено, показывает все корни)

Опции

      --depth <DEPTH>  Максимальная глубина (по умолчанию: без ограничений) [default: 99]
      --json           Вывод в формате JSON
  -h, --help           Вывести справку
  -V, --version        Вывести версию

Примеры

Полный лес - каждый корневой артефакт в рабочем пространстве:

forgeplan tree

Только один Epic и всё, что под ним:

forgeplan tree EPIC-003

Поверхностный вид - только непосредственные потомки:

forgeplan tree EPIC-003 --depth 1

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

Дерево использует стандартные символы для рисования рамок. Типичный фрагмент:

EPIC-003 [active]  Search, Discovery, Intelligence
├── PRD-039 [active]  BM25 production search
│   ├── RFC-004 [active]  Layered search architecture
│   │   └── ADR-007 [active]  Choose bm25 crate v2.3.2
│   └── EVID-018 [active]  Benchmark results
└── PRD-040 [active]  Scoring intelligence
    └── RFC-005 [draft]   Graph expansion

Каждый узел показывает: <ID> [<status>] <title>. Дочерние элементы имеют отступ под своим родителем. Дочерний элемент, связанный с несколькими родителями, появляется под каждым из них - это ожидаемо и выявляет общие зависимости.

Сироты (артефакты без родителя) появляются на верхнем уровне - если вы видите PRD-007, плавающий рядом с EPIC-003, он является кандидатом на то, чтобы стать дочерним элементом существующего Epic или нового.

Как это вписывается

tree отвечает на вопрос «какова структура этого проекта?» - статическая структура. Используйте его вместе с:

graph - для произвольных типизированных связей (не только родитель/потомок)
order - когда вам нужно знать, что строить в первую очередь

См. также

forgeplan graph - полная диаграмма Mermaid
forgeplan order - топологический порядок выполнения
forgeplan blocked - что ещё не может начаться
Модель артефактов