Skip to content

docs: add effort calibration table from historical PR data (#596)#613

Open
ohdearquant wants to merge 2 commits into
stagingfrom
show/issue-resolve-v2/effort-calibrate
Open

docs: add effort calibration table from historical PR data (#596)#613
ohdearquant wants to merge 2 commits into
stagingfrom
show/issue-resolve-v2/effort-calibrate

Conversation

@ohdearquant
Copy link
Copy Markdown
Owner

Summary

  • Calibration table mapping S/M/L/XL effort buckets to observed changed-file and line-count ranges
  • Data source: last 100 merged PRs, Jenks natural-breaks clustering
  • 3+ historical examples support each bucket
  • Outliers documented with reasoning
  • Methodology and usage guidance included

Closes #596

Test plan

  • docs-only change — no code affected
  • Internal critic APPROVE (CRIT:0 MAJ:0 MIN:2)
  • All bucket statistics independently recomputed and verified

🤖 Generated with Claude Code

@ohdearquant ohdearquant changed the base branch from main to staging May 31, 2026 18:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

chore(planning): calibrate S M L XL effort estimates against historical PR sizes

1 participant