Skip to content

docs: add epic t-shirt sizing guide to CLAUDE.md#172

Merged
noahwhite merged 2 commits intodevelopfrom
feature/epic-tshirt-sizing-guide
Feb 18, 2026
Merged

docs: add epic t-shirt sizing guide to CLAUDE.md#172
noahwhite merged 2 commits intodevelopfrom
feature/epic-tshirt-sizing-guide

Conversation

@noahwhite
Copy link
Owner

@noahwhite noahwhite commented Feb 18, 2026

Summary

  • Clarifies that t-shirt sizes represent complexity/uncertainty rather than duration
  • Adds complexity indicators table explaining what each size means
  • Provides planning guidelines derived from historical velocity (not prescriptive targets)

Changes

Size Complexity Typical Time Mapping
Small (S) Well-understood, minor dependencies, low risk 1-2 sprints (2-4 weeks)
Medium (M) Standard feature, some integration, moderate unknowns 3-4 sprints (1.5-2 months)
Large (L) Complex logic, multiple team touchpoints, significant risk 1 full quarter (~3 months)
Extra Large (XL) Cross-departmental, massive architectural shifts Multiple quarters (needs breakdown)

Test plan

  • Documentation renders correctly in GitHub
  • Sizing guide is clear and actionable

@noahwhite noahwhite self-assigned this Feb 18, 2026
Clarifies that t-shirt sizes represent complexity/uncertainty rather than
duration, while providing planning guidelines derived from historical velocity.

- Small: well-understood, single focus area, ~1 cycle
- Medium: some unknowns, 2-3 focus areas, ~1-2 cycles
- Large: significant unknowns, multiple phases, ~2-3 cycles
Updates t-shirt sizing guide with:
- Small (S): 1-2 sprints, well-understood, low risk
- Medium (M): 3-4 sprints, moderate unknowns
- Large (L): 1 quarter, complex, significant risk
- Extra Large (XL): multiple quarters, needs breakdown
@noahwhite noahwhite force-pushed the feature/epic-tshirt-sizing-guide branch from 1372974 to bbb982b Compare February 18, 2026 16:13
@noahwhite noahwhite merged commit 6d7321f into develop Feb 18, 2026
6 checks passed
@noahwhite noahwhite deleted the feature/epic-tshirt-sizing-guide branch February 18, 2026 16:16
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.

1 participant

Comments