# Lessons Learned (Root)

Shared learnings applicable to all subprojects. Subprojects have their own LESSONS.md.

---

## Format

```
### [TAG] Short Title
**Problem**: What went wrong
**Investigation**: What was tried
**Root Cause**: Why it happened
**Solution**: How it was fixed
**Keywords**: searchable terms
```

Tags: [BUG], [CONFIG], [API], [LOGIC], [INTEGRATION]

---

<!-- Add lessons that apply to multiple subprojects below -->