---
title: Lessons
description: Things that burned us — don't repeat
created: "{{date}}"
project: "{{project_name}}"
---

# Lessons

Things that went wrong. Logged immediately. Never repeated.

## Format

```
### YYYY-MM-DD — <what happened>
- **Context**: circumstances
- **Impact**: what went wrong / cost
- **Lesson**: the rule to follow next time
```

---

## Meta-lessons (always apply)

- When producing content for a page/UI: read the EXISTING file entirely BEFORE rewriting. Never regenerate from blank.
- Dates absolute (ISO 8601 `YYYY-MM-DD`), never relative.
- Never commit without explicit user permission.

---

<!-- Lessons will be appended below by BMAD+ agents -->