forgeplan order

Сортирует все артефакты в топологический порядок выполнения, используя границы зависимостей (blocks, depends_on, родитель/потомок). Вывод представляет собой линеаризованный обход, подходящий для планирования спринта: “выполните PRD-002 до PRD-007, потому что PRD-007 зависит от него.”

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

Планирование спринта - правильная последовательность нескольких PRD
Аудит зависимостей - выявление отсутствующих границ, которые должны существовать
Гейт CI - прерывание сборки при обнаружении циклов зависимостей

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

Вы хотите видеть только заблокированные элементы → используйте forgeplan blocked
Вы хотите иерархию → используйте forgeplan tree
Вы хотите все границы → используйте forgeplan graph

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

forgeplan order [OPTIONS]

Опции

      --json     Вывод в формате JSON для машинной обработки
  -h, --help     Вывести справку
  -V, --version  Вывести версию

Примеры

Вывести полный топологический порядок:

forgeplan order

Передать в шаблон документа спринта:

forgeplan order --json | jq -r '.[] | "- [ ] \(.id) \(.title)"'

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

Один артефакт на строку, сначала самые ранние (разрешение конфликтов по принципу поиска в ширину):

1.  ADR-003  Files as source of truth       [active]
2.  PRD-039  BM25 production search         [active]
3.  RFC-004  Layered search architecture    [active]
4.  EVID-018 Benchmark results              [active]
5.  PRD-040  Scoring intelligence           [draft]

Столбец	Значение
Индекс	Позиция в топологическом обходе
ID	Идентификатор артефакта
Title	Краткое название
Status	`[active]`, `[draft]` и т.д. - позволяет пропускать завершённые

Если обнаружен цикл, команда завершается со статусом 1 и выводит путь цикла - исправьте проблемную границу blocks / depends_on и запустите снова.

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

order - это представление “выполнить в такой последовательности”. Используйте в паре с blocked:

order    → идеальная последовательность (игнорирует статус)
blocked  → что застряло прямо сейчас

Здоровое рабочее пространство: всё в order[0:k] находится в статусе [active] или [done], а blocked пусто.

См. также

forgeplan blocked - неразрешённые блокировщики
forgeplan tree - иерархическое представление
forgeplan graph - полный граф границ