Feature specs live in docs/features/. Each describes a feature from a product/behavior perspective — no Kotlin code blocks, no class/function names in prose.
When you modify logic in a feature area that has a corresponding doc in docs/features/:
- Update the doc to reflect the new behavior
- Update the "Last verified" date in the doc header
- Keep the Key Files table accurate (add/remove files as needed)