# Known Bugs and Solutions

This document tracks bugs encountered during development and their solutions.

---

## Active Bugs

*No active bugs at this time.*

---

## Resolved Bugs

### BUG-001: [Template]

**Date Discovered:** YYYY-MM-DD
**Date Resolved:** YYYY-MM-DD
**Severity:** Critical | High | Medium | Low

**Symptoms:**
- What the user experiences

**Root Cause:**
- Technical explanation of why it happens

**Solution:**
```python
# Code fix or configuration change
```

**Prevention:**
- How to prevent this in the future

---

## Bug Template

```markdown
### BUG-XXX: [Short Description]

**Date Discovered:** YYYY-MM-DD
**Date Resolved:** YYYY-MM-DD (or "In Progress")
**Severity:** Critical | High | Medium | Low

**Symptoms:**
- [Observable behavior]

**Root Cause:**
- [Technical explanation]

**Solution:**
[Code or config fix]

**Prevention:**
- [Testing, linting, or process changes]
```
