forgeplan calibrate-estimate

forgeplan calibrate-estimate завершает цикл forgeplan estimate. Вы передаёте фактические часы, затраченные на артефакт, и команда сообщает, насколько сильно оценка отклонилась - по грейду, по FR и в целом. Со временем это учитывается в вашей конфигурации grade_profile, что делает оценки более точными.

Без калибровки оценки незаметно отклоняются: вы думаете, что вы «сеньор в бэкенде», но постоянно превышаете оценку на 50%. Эта команда выявляет этот разрыв, чтобы вы могли скорректировать множитель, а не только свою интуицию.

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

• Конец спринта: запускайте для каждого закрытого PRD/RFC, чтобы создать набор данных для калибровки.
• После неожиданности (значительное превышение/недовыполнение) - немедленная обратная связь, пока контекст свеж.
• Ежеквартальный обзор - агрегируйте вывод --json, чтобы настроить estimate.grade_profile в конфигурации.
• Бенчмаркинг нового профиля грейдов - сравнение фактических показателей с различными предположениями о грейдах.

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

• В середине спринта для незавершённого артефакта - фактические данные должны быть окончательными.
• Для артефактов без элементов FR/Phase - первоначальная оценка была предположением, а не моделью.

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

forgeplan calibrate-estimate [OPTIONS] --actual-hours <ACTUAL_HOURS> <ID>

Аргументы

  <ID>  ID артефакта для калибровки

Опции

      --actual-hours <ACTUAL_HOURS>  Фактически затраченные часы
      --grade <GRADE>                Грейд для сравнения (junior, mid, senior). По умолчанию - общий балл
  -h, --help                         Вывести справку
  -V, --version                      Вывести версию

Примеры

Калибровка одного PRD после закрытия спринта

forgeplan calibrate-estimate PRD-001 --actual-hours 18

Вывод:

PRD-001 - Auth System
  оценочно (senior):    13.5ч
  фактически:           18.0ч
  отклонение:           +33.3%  (превышение)
  вердикт:              оценка занижена - скорректировать множитель senior backend на +15%

Сравнение с другим грейдом

forgeplan calibrate-estimate PRD-001 --actual-hours 18 --grade middle

Вывод:

оценочно (middle):   22.0ч
фактически:          18.0ч
отклонение:          -18.2%  (недовыполнение)
вердикт:             вы справились между middle и senior в этом случае

Агрегация по всему спринту

for id in PRD-001 PRD-002 PRD-003; do
  forgeplan calibrate-estimate "$id" --actual-hours "$(cat actuals/$id.txt)"
done

Передайте результаты в скрипт для расчёта среднего отклонения по грейду/домену и предложения новых множителей для .forgeplan/config.yaml.

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

Диапазон отклонения	Интерпретация
в пределах ±15%	оценка точна - настройка не требуется
+15% … +40%	оценка занижена - увеличьте множитель грейда
> +40%	ошибка в глубине, а не в оценке - эскалировать
-15% … -40%	оценка завышена - уменьшите множитель
< -40%	объём был сокращён или оценка завышена

Отслеживайте отклонение по доменам (backend, frontend, devops, ai_ml). Один PRD - это шум; десять PRD - это сигнал.

Как это вписывается в рабочий процесс

закрытие спринта → calibrate-estimate (для каждого артефакта) → настройка grade_profile → следующий спринт точнее

Представьте это как телеметрию для вашей собственной оценки. CLI не настраивает конфигурацию автоматически - вы просматриваете отклонение и решаете, что изменить.

См. также

• forgeplan estimate - оценка, с которой производится калибровка
• forgeplan config - где находится grade_profile
• Единый рабочий процесс - ритуалы закрытия спринта
• Обзор CLI