# Lessons Learned

Canonical path: `specs/lessons-learned.md`

**Usage:**
- Plan agent: read at session start before designing the approach.
- Build agent: read at session start; append a new entry after each successful build.

---

## Entry Format

```
## YYYY-MM-DD — Short Title

**Context:** What project / phase / feature this happened in.
**Issue:** What went wrong or was surprising.
**Resolution:** What fixed it.
**Takeaway:** The rule or pattern to carry forward.
```

---

<!-- append new entries above this line -->
