# EPIC-XXX: Epic Title

> One-line summary of this epic's purpose

## Status History
<!-- machine-parseable table: directory = current status, last row = latest record -->

| Status | Date | Note |
|--------|------|------|
| active | YYYY-MM-DD | Created |
| archived | YYYY-MM-DD | All tasks done |

## Background Story

Why does this epic exist? What problem does it solve? 
What events led to its creation?

## Requirement Tree

### Theme A #status

#### User Story A1 #status
- **Trigger**: What event/feedback triggered this need?
- **Requirement**: What needs to be built?
- **Implementation**: How was it solved (high-level)?
- **Output**: Link to TASK-XXX
- **Validation**: How was it verified?

#### User Story A2 #status
...

### Theme B #status

...

## Technical Decisions

| ADR | Title | Status |
|-----|-------|--------|
| ADR-XXX | ... | ✅ Accepted |

## Related Tasks

| Task | Status | Description |
|------|--------|-------------|
| TASK-XXX | ⬜/🔄/✅ | ... |

## Lessons Learned

What did we learn from this epic?

- Technical insights:
- Process improvements:
- Things to avoid:

## Archive Criteria

When can this epic be archived?

- [ ] All tasks completed
- [ ] Validated in production/staging
- [ ] Lessons learned documented
- [ ] No outstanding issues