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:

Installs
7
First Seen
Sep 22, 2026