# Critical Notes — Gotchas That Don't Fit Anywhere Else

Not decisions (architectural choices) and not regrets (rejected approaches) — these are landmines.
Non-obvious facts about how this codebase behaves that will cost you time if you don't know them.

---

| Area | Note |
|------|------|
| [module or file] | [what trips people up — be specific: symptoms, cause, how to avoid] |

---

## How to use this file

Add an entry every time you hit something that:
- Wasn't obvious from reading the code
- Cost you 20+ minutes to figure out
- Would have been instant if someone had just told you

If a gotcha costs you 20 minutes once, it should cost you 0 minutes every time after.
