# HoEN effort sizing taxonomy — routes agents to the correct scale by plan lifecycle stage.
# Detail definitions live in skill references; this file is the official router.

scales:
  wall_clock_tshirt:
    id: wall-clock-tshirt
    labels: [Trivial, Small, Medium, Large]
    measures: human team capacity (wall-clock, incl. tests and PR review)
    phase: [diagnose, plan]
    hoen: [1-work-backlog, 2-standards]
    maturity: experimental
    summable: false
    official: library/skills/remediation-plan/references/task-sizing.md
    invoke_when:
      - gap analysis sizing
      - remediation or production-readiness planning
      - sprint capacity and Jira story creation
      - stakeholder timeline estimates (days/weeks per phase)
    trigger_phrases:
      - remediation plan
      - production readiness plan
      - sprint planning
      - wall-clock estimate
      - Trivial Small Medium Large
    companion_types:
      - id: Decision
        purpose: gate blocked on a choice — not effort; track separately

  ai_fibonacci:
    id: ai-fibonacci
    labels: [1, 2, 3, 5, 8, 13]
    measures: relative delivery complexity under AI-assisted work
    phase: [plan, implement, cross-cutting]
    hoen: [1-work-backlog, 2-info-mgmt, 3-helpers-templates-accelerators]
    maturity: experimental
    summable: true
    official: library/skills/plan-effort-estimate/references/scale.md
    artifact_pattern: "*.effort.json"
    script: library/skills/plan-effort-estimate/scripts/summarize-effort.mjs
    invoke_when:
      - active WIP plan maintenance
      - progress summaries and percent-complete tracking
      - migration or modernisation step burn-down
    trigger_phrases:
      - effort estimate
      - Fibonacci sizing
      - plan progress summary
      - points remaining
      - percent complete

handoff:
  from: wall_clock_tshirt
  to: ai_fibonacci
  when: plan moves from draft remediation to active execution
  action: |
    Create a *.effort.json sidecar beside the plan markdown (e.g. docs/wip/<plan-slug>.effort.json).
    Re-size steps with the Fibonacci scale — do not copy T-shirt labels literally.
    Run summarize-effort.mjs for deterministic totals; paste script output into markdown tables.

# Indicative mapping only — re-size on execution; not a conversion formula.
indicative_mapping:
  - wall_clock: Trivial
    fibonacci: [1]
    notes: config, copy, single targeted change
  - wall_clock: Small
    fibonacci: [2, 3]
    notes: one branch, tight scope, straightforward tests
  - wall_clock: Medium
    fibonacci: [5]
    notes: multi-file, some design decisions
  - wall_clock: Large
    fibonacci: [8]
    notes: cross-cutting, validation gate, significant testing
  - wall_clock: "epic"
    fibonacci: [13]
    notes: reserve for epics that would stack multiple 8s