# Known Issues

> **Instance file**: This file tracks known problems and technical debt.

---

## Active Issues

### Issue 1: [Title]

**Status**: 🔴 Open | **Priority**: High | **Since**: [DATE]

**Description**: [Detailed description of the issue]

**Workaround**: [Temporary solution if available]

**Root Cause**: [Analysis of why this happens]

---

### Issue 2: [Title]

**Status**: 🟡 In Progress | **Priority**: Medium | **Since**: [DATE]

**Description**: [Detailed description]

**Progress**: [What has been done]

---

## Resolved Issues

### [Resolved Issue Title]

**Status**: 🟢 Resolved | **Resolved**: [DATE]

**Description**: [What was the problem]

**Solution**: [How it was fixed]

**Lessons Learned**: [What we learned]

---

## Technical Debt

| Item | Priority | Effort | Description |
|------|----------|--------|-------------|
| [Debt 1] | High | [S/M/L] | [Description] |
| [Debt 2] | Medium | [S/M/L] | [Description] |

---

## Performance Issues

| Area | Current | Target | Notes |
|------|---------|--------|-------|
| [Area 1] | [Value] | [Value] | [Notes] |

---

*Last updated: [DATE]*
