# 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] |
