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 = plain mv).
  • 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 had Spec: TBD pointing there → prompt user to update the WI's Spec
  • Deleting a spec directory → do NOT auto-skip; warn the user

Sync rules

Installs
16
Repository
noih/dev-skills
First Seen
Apr 24, 2026