# User Story: [Title]

**ID**: US-[XXX]
**Epic**: [Parent epic name/ID]
**Priority**: P0 | P1 | P2
**Status**: Backlog | In Progress | In Review | Done
**Estimate**: [S/M/L/XL or story points]
**Assignee**: [Name]

## Story

As a **[type of user]**,
I want **[some goal]**,
So that **[some reason/value]**.

## Acceptance Criteria

What must be true for this story to be "done"?

Given [context/precondition],
When [action],
Then [expected outcome].

### Specific Criteria

- [ ] Criterion 1: [Specific, testable condition]
- [ ] Criterion 2: [Specific, testable condition]
- [ ] Criterion 3: [Specific, testable condition]

## Technical Notes

Implementation considerations:

- Approach: [High-level technical approach]
- Components affected: [What needs to change]
- Dependencies: [Other stories, external systems]
- Risks: [Technical challenges]

## Definition of Done

- [ ] Code written and reviewed
- [ ] Tests written and passing
- [ ] Documentation updated
- [ ] Acceptance criteria verified
- [ ] No critical bugs remaining
- [ ] Stakeholder demo/approval

## Test Scenarios

### Happy Path
1. User does [action]
2. System responds with [result]
3. User sees [outcome]

### Edge Cases
- Edge case 1: [Description and expected behavior]
- Edge case 2: [Description and expected behavior]

### Error Handling
- Error scenario 1: [How system should respond]
- Error scenario 2: [How system should respond]

## Design/Mockups

[Link to designs, screenshots, or mockups if applicable]

## Tasks

Break down into implementation tasks:

- [ ] Task 1: [Specific implementation step]
- [ ] Task 2: [Specific implementation step]
- [ ] Task 3: [Specific implementation step]

## Dependencies

**Blocks**:
- [Story ID]: [Reason why this must complete first]

**Blocked by**:
- [Story ID]: [What we're waiting for]

**Related**:
- [Story ID]: [Related work for context]

## Questions/Notes

Open questions or important context:

- Question 1: [Need to clarify]
- Note 1: [Important context]

## References

- Spec document: [Link]
- Example: [Link to example data]
- Discussion: [Link to conversation/decision]

## History

| Date | Event | Notes |
|------|-------|-------|
| YYYY-MM-DD | Created | [Context] |
| YYYY-MM-DD | Started | [Who, what] |
| YYYY-MM-DD | Completed | [Outcome] |
