This directory contains accumulated knowledge — gotchas, non-obvious findings, and hard-won insights from development, research, debugging, and incidents.
- Knowledge entry:
docs/knowledge/{topic}.md - Examples:
docs/knowledge/infrastructure.md,docs/knowledge/api-quirks.md
- One file per topic — entries accumulate within the file over time
- Entries are listed newest first
- Use
kebab-casetopic names by domain (not by date or session)
- Capture knowledge during or after work sessions using
cmk:learn. - Browse and search entries to inform downstream work.
- Promote valuable entries to
docs/rules/when they become established standards.