# TASK-{ID}: {Title}

> **Template**: Bugfix
> **Created**: YYYY-MM-DD
> **Last Updated**: YYYY-MM-DD

---

## Status

| Field | Value |
|-------|-------|
| **State** | `pending` |
| **Priority** | P{0-3} |
| **Severity** | {critical / high / medium / low} |
| **Cell** | {backend / frontend / ux_ui} |
| **Assigned To** | {agent-id or "unassigned"} |
| **Reported By** | {agent-id / user / automated} |

## Timeline

| Milestone | Date |
|-----------|------|
| Reported | YYYY-MM-DD |
| Claimed | - |
| Root Cause Found | - |
| Fix Implemented | - |
| QA Verified | - |
| Completed | - |

---

## Bug Summary

{One sentence description of the bug}

## Severity Assessment

| Factor | Assessment |
|--------|------------|
| **User Impact** | {How many users affected? How badly?} |
| **Frequency** | {How often does it occur?} |
| **Workaround** | {Is there a workaround? What is it?} |
| **Data Impact** | {Any data loss or corruption?} |

---

## Reproduction

### Environment
- **Browser/Client**: {e.g., Chrome 120, iOS app v2.1}
- **OS**: {e.g., macOS 14.1, Windows 11}
- **User Type**: {e.g., admin, regular user}
- **Environment**: {production / staging / development}

### Steps to Reproduce
1. {Step 1}
2. {Step 2}
3. {Step 3}
4. {Observe the bug}

### Expected Behavior
{What should happen}

### Actual Behavior
{What actually happens}

### Evidence
{Screenshots, error logs, console output}

```
{Paste error messages or logs here}
```

---

## Investigation

### Root Cause
{Filled in during investigation - what's causing this bug?}

### Affected Code
{Files and functions involved}
- `path/to/file.py:line_number`
- `path/to/other_file.py:line_number`

### Related Issues
- {Link to related bugs or tasks}
- {Previous similar issues}

---

## Fix

### Approach
{How will this be fixed?}

### Changes Required
- [ ] {Change 1}
- [ ] {Change 2}
- [ ] {Change 3}

### Regression Risk
{What could break as a result of this fix?}

### Testing Plan
- [ ] {Test case 1 - verifies fix}
- [ ] {Test case 2 - checks regression}
- [ ] {Test case 3 - edge cases}

---

## Verification Criteria

- [ ] Bug no longer reproducible with original steps
- [ ] No new errors in logs
- [ ] Related functionality still works
- [ ] Tests added to prevent regression
- [ ] {Additional verification criteria}

---

## Commits

| Commit | Description | Date |
|--------|-------------|------|
| - | No commits yet | - |

---

## Quick Context Restore

**Current state**: Not started
**Investigation status**: Not started
**Root cause**: Unknown
**Fix approach**: TBD

---

## Notes

{Additional context, related issues, customer impact notes}

---

## Changelog

| Date | Agent | Change |
|------|-------|--------|
| YYYY-MM-DD | {agent} | Bug reported |