---
artifact: user-story
version: "1.0"
created: <YYYY-MM-DD>
status: draft
---

# User Story: [Story Title]

## Story Header

| Field | Value |
|-------|-------|
| ID | [US-XXX] |
| Title | [Brief descriptive title] |
| Persona | [User persona] |
| Priority | [P0/P1/P2] |
| Epic/Feature | [Parent feature or epic] |
| Estimate | [Story points or T-shirt size] |

## User Story Statement

**As a** [specific user persona],

**I want** [action or capability],

**so that** [benefit or value I receive].

## Context & Background

<!-- Why does this story exist? What problem does it solve? Link to PRD if available. -->

[Context explaining the user need and how this story fits into the larger feature]

## Acceptance Criteria

<!-- Use Given/When/Then format. Each criterion should be independently testable. -->

### AC-1: [Criterion Title]

**Given** [initial context or precondition]

**When** [action taken by user]

**Then** [expected outcome]

### AC-2: [Criterion Title]

**Given** [initial context or precondition]

**When** [action taken by user]

**Then** [expected outcome]

### AC-3: [Criterion Title]

**Given** [initial context or precondition]

**When** [action taken by user]

**Then** [expected outcome]

## Design Notes

<!-- Link to mockups, UX considerations, or design decisions -->

- [Design note or link to Figma]
- [UX consideration]

## Technical Notes

<!-- Implementation hints, technical constraints, or architectural considerations -->

- [Technical note]
- [Constraint or consideration]

## Dependencies

<!-- Other stories, external systems, or teams this story depends on -->

| Dependency | Type | Status |
|------------|------|--------|
| [Dependency 1] | [Story/API/Team] | [Blocked/Ready] |
| [Dependency 2] | [Story/API/Team] | [Blocked/Ready] |

## Out of Scope

<!-- Explicitly note what this story does NOT cover -->

- [Excluded item]
- [Excluded item]

## Open Questions

<!-- Unresolved questions that may affect implementation -->

- [ ] [Question 1]
- [ ] [Question 2]
