## Context

[Problem description - what user pain or business need does this address?]

**Current Issues:**
- [Issue or limitation 1]
- [Issue or limitation 2]

---

## User Story

**As a** [specific user role]
**I want to** [specific goal or action]
**So that** [concrete benefit or outcome]

**Example Scenario:**
[Real-world scenario where this feature would be used]

---

## Acceptance Criteria

### Must Have
- [ ] [Specific, measurable criterion 1]
- [ ] [User can perform X action and see Y result]
- [ ] [System behaves correctly when Z happens]
- [ ] [Error handling: System shows helpful message when...]

### Should Have
- [ ] [Nice-to-have enhancement]

### Won't Have (Out of Scope)
- [Explicitly excluded functionality]

### Tests
- [ ] Tests written for core functionality
- [ ] Edge cases and error scenarios covered
- [ ] All tests passing

### Documentation
- [ ] Code documented (comments on complex logic)
- [ ] Knowledge base updated (if significant decisions/patterns)
- [ ] Context files updated (if architecture changes)
- [ ] N/A - No significant documentation needed

---

## Technical Notes

### Implementation Approach
[High-level description of how this will be built]

**Key Technical Decisions:**
1. [Decision 1 and rationale]
2. [Decision 2 and rationale]

### Components Needed
**New:**
- `ComponentName` - [What it does]

**Modify:**
- `ExistingComponent` - [What changes needed]

### Data Model
```typescript
// Schema changes if any
// OR: No data model changes required
```

### API Endpoints
- `POST /api/endpoint` - [Description]
- OR: No new endpoints required

---

## Dependencies

**Required Before Starting:**
- [Feature or system that must exist first]
- OR: No dependencies - can start immediately

**Enables Future Work:**
- [Feature that depends on this being complete]

---

## Design Reference
<!-- Add Figma links as attachments -->

---

_Created: YYYY-MM-DD_