forgeplan progress

Анализирует списки чекбоксов (- [ ] / - [x]) внутри тел артефактов и сообщает, сколько выполнено. По соглашению, каждое функциональное требование (FR) или фаза реализации в PRD/RFC является чекбоксом - таким образом, progress отвечает на вопрос «насколько реализован этот PRD?»

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

• Ежедневные стендапы - быстрый процент выполнения для каждого PRD
• Подготовка к релизу - какие PRD ещё не выполнены на 100%
• Отчётность - передача JSON в дашборды

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

• Вам нужно качество артефакта (а не завершённость) → используйте forgeplan score
• Вам нужен сводный показатель здоровья → используйте forgeplan health

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

forgeplan progress [OPTIONS] [ID]

Аргументы

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

Опции

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

Примеры

Все артефакты, таблица по умолчанию:

forgeplan progress

Только один PRD:

forgeplan progress PRD-001

Машиночитаемый формат для дашборда:

forgeplan progress --json | jq '.[] | {id, percent}'

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

Таблица по умолчанию:

ID        KIND  PERCENT  BAR                  DONE / TOTAL
PRD-001   prd     75%    [██████████████░░░░]   6 / 8
PRD-046   prd     40%    [████████░░░░░░░░░░]   4 / 10
RFC-004   rfc    100%    [██████████████████]   5 / 5

Столбец	Значение
PERCENT	done / total в виде целого процента
BAR	18-символьный ASCII-индикатор прогресса
DONE	Количество чекбоксов - [x]
TOTAL	Количество чекбоксов - [x] + - [ ]

Артефакты без чекбоксов опускаются в представлении по умолчанию (отслеживать нечего). --json включает их с total: 0.

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

progress отслеживает выполнение. Его родственный инструмент forgeplan score отслеживает качество (R_eff + F-G-R). Здоровый PRD выполнен на 100% и имеет R_eff > 0.

progress  →  "мы закончили разработку?"
score     →  "мы ему доверяем?"
health    →  объединяет оба показателя

См. также

• forgeplan score - метрика качества R_eff
• forgeplan health - сводный показатель проекта
• forgeplan list - поиск подходящих ID