User Story Template

# User Story — {{ TITLE }}

> **As a** {{ user role }},
> **I want** {{ outcome }},
> **so that** {{ benefit }}.

## Context

Why does this matter now? Link the supporting data, customer quote, or strategic doc.

-

## Acceptance criteria

Use Given / When / Then format. Each criterion must be independently testable.

1. **Given** {{ initial state }}
   **When** {{ action }}
   **Then** {{ observable outcome }}

2. **Given** ___
   **When** ___
   **Then** ___

## Edge cases & non-goals

- Edge case:
- Out of scope:

## Rough sizing

| Size | Story points | Indicator |
|---|---|---|
| XS | 1 | < half a day, no unknowns |
| S  | 2 | < 1 day, well understood |
| M  | 3 | 1-2 days, minor unknowns |
| L  | 5 | 2-4 days, real complexity |
| XL | 8 | needs splitting before commit |

**Estimated:** _____

## Definition of done

- [ ] Acceptance criteria all met
- [ ] Tests added / updated
- [ ] Reviewed and merged
- [ ] Deployed (or behind a flag)

## Links

- Designs:
- Related tickets:
- Spec / RFC:

---

Story points explained: https://sprintflint.com/glossary/story-points
User stories explained: https://sprintflint.com/glossary/user-story