road
Installation
SKILL.md
Roadmap Skill
Tool-neutral roadmap management. A roadmap is an ordered list of Work Items (WI) pointing to specs. The spec workflow owns implementation progress; the roadmap derives automatic WI status from spec location and preserves explicit manual overrides.
When used with issue-tracking, retain links to the primary issues without mirroring their fields. Roadmap Done below describes spec-location progress; it does not authorize closing an external issue or prove its completion conditions. Tracker transitions remain with the authorized tracking owner.
When this skill activates
- A. Explicit roadmap operations —
/road <action>or natural-language phrasing for create / edit / show / sync / branch / archive (archive = plainmv). - B. Spec-change side effects (automatic) — whenever the user's action moves, creates, or deletes a spec file that a roadmap WI could reference, check every WI's
Spec:field and apply Sync rules without needing an explicit roadmap command.
Examples triggering B:
mv openspec/changes/add-auth openspec/changes/archive/→ sync WI referencing it- "I archived the add-auth change" → same
- User creates
openspec/changes/new-feature/where a WI hadSpec: TBDpointing there → prompt user to update the WI's Spec - Deleting a spec directory → do NOT auto-skip; warn the user