User Story Template

The classic "As a / I want / so that" format with acceptance criteria, edge cases, and rough story-point sizing — ready to paste into Jira, Linear, Notion, or SprintFlint.

Download .md

# 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

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.

Given {{ initial state }}
When {{ action }}
Then {{ observable outcome }}
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)