forgeplan estimate

forgeplan estimate преобразует функциональные требования и фазы реализации артефакта в число, обозначающее трудозатраты. Он считывает сложность каждого элемента (числа Фибоначчи 1/2/3/5/8/13) и умножает её на профиль грейда из вашей конфигурации - junior, middle, senior, principal или AI - для каждой предметной области (backend/frontend/devops/ai_ml). Сверху добавляются накладные расходы на ревью и запас прочности, поэтому на выходе получается реалистичное число для планирования, а не лучший сценарий.

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

• Планирование спринта: оценивайте каждый кандидат PRD/RFC, чтобы он соответствовал пропускной способности (≈40–50% от номинальной).
• Проверка пропускной способности перед началом Epic - это 2 недели или 2 месяца?
• Делегирование коллеге по команде - --grade middle, чтобы увидеть, как задача выглядит для него.
• Планирование агентов - --grade ai, чтобы получить ускоренный путь с помощью AI (множитель ×0.03–0.4).

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

• Для Note или ProblemCard - у них нет структуры FR/Phase для оценки.
• В качестве контракта - оценки предназначены для планирования, а не для обещаний. Откалибруйте с помощью calibrate-estimate постфактум.

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

forgeplan estimate [OPTIONS] <ID>

Аргументы

  <ID>  ID артефакта для оценки

Опции

      --grade <GRADE>            Переопределить грейд для всех элементов (junior|middle|senior|principal|ai)
      --my-grade                 Использовать профиль грейда из конфигурации (с учётом предметной области)
      --llm-score                Использовать оценку сложности на основе LLM вместо эвристики, основанной на правилах
      --complexity <COMPLEXITY>  Ручное переопределение сложности: FR-001=5,FR-002=3 (числа Фибоначчи: 1,2,3,5,8,13)
      --json                     Вывод в формате JSON для машинной обработки
  -h, --help                     Вывести справку
  -V, --version                  Вывести версию

Примеры

Оценка PRD для вашего собственного профиля грейда

forgeplan estimate PRD-001 --my-grade

Вывод:

PRD-001 - Auth System
  FR-001  login flow          complexity=5  senior  → 6h
  FR-002  session refresh     complexity=3  senior  → 3h
  FR-003  logout              complexity=2  senior  → 1h
  Subtotal:    10h
  Review:      +20%   → 2h
  Safety:      +15%   → 1.5h
  Total: 13.5h senior  (≈ 2 days)

Сравнение человеческого и AI-помощного пути

forgeplan estimate PRD-001 --grade senior
forgeplan estimate PRD-001 --grade ai

Строка AI использует множители ×0.03–0.4 в зависимости от типа элемента; используйте оба числа, чтобы решить, когда выполнять работу самостоятельно, а когда делегировать агенту.

Ручное переопределение сложности

forgeplan estimate PRD-001 --complexity FR-001=8,FR-002=2

Используйте, когда эвристика неверно оценивает сложность (например, «простое» FR скрывает миграцию).

Оценка с помощью LLM

forgeplan estimate PRD-001 --llm-score

Просит настроенный LLM оценить сложность каждого FR. Медленнее, но улавливает семантические нюансы, которые пропускает механизм правил.

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

Строка	Что она показывает
строка для каждого FR	сложность (числа Фибоначчи) × множитель грейда = часы на элемент
Подытог	сумма часов на элементы
Ревью	+20% накладных расходов на циклы ревью (состязательная ревью, аудит)
Запас	+15% буфер на непредвиденные обстоятельства
Итого	реалистичное число для планирования спринта

Красный флаг: общая сумма более 40 часов - рассмотрите возможность разделения PRD или увеличения глубины.

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

route → new → validate → estimate → sprint commit → code → calibrate-estimate

Внесите общую сумму в пропускную способность вашего спринта (senior разработчик, планирующий с 50% загрузкой, имеет около 20 «часов оценки» в неделю). После завершения спринта calibrate-estimate покажет, насколько точной была оценка.

См. также

• forgeplan calibrate - калибровка глубины, влияет на масштаб оценки
• forgeplan calibrate-estimate - точность оценки после спринта
• forgeplan route - роутинг по глубине перед оценкой
• Калибровка глубины
• Обзор CLI