docs-roadmap-notes
Installation
SKILL.md
Rule
When a design deliberately stops short of the "obviously better" version, write down the gap as a roadmap note with three parts — not a vague TODO, not silence:
## Roadmap: <the deferred improvement>
The natural next step is <what it would look like>. Deferred because:
- <concrete reason 1 — a real cost, not "not done yet">
- <concrete reason 2>
When <the trigger condition>, <what changes and what doesn't need to>.
A real example: