Gotchas, learnings, and hard-won insights: the non-obvious facts that cost someone time to discover.
- One file per topic in
kebab-case, named by domain rather than by date or session (for exampleinfrastructure.md,api-quirks.md). - Entries accumulate inside the file, newest first.
- Promote an entry to
../rules/once it becomes an expected standard.
Before debugging something unfamiliar — and before re-discovering anything.