roadmap-sk

Advances roadmap chunks derived from Spec Kit spec, plan, and tasks artifacts.

1|Updated Aug 15, 2026
One-click install
npx skills add https://github.com/AlrikOlson/think-and-ship --skill roadmap-sk-alrikolson
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: roadmap-sk
Source: https://github.com/AlrikOlson/think-and-ship/tree/main/crates/think-and-ship/skills/roadmap-sk
Command: npx skills add https://github.com/AlrikOlson/think-and-ship --skill roadmap-sk-alrikolson

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? In a Spec Kit (speckit) project, the spec already contains prioritized, independently-testable user stories, yet roadmaps are often maintained as separate free-form prose that drifts from the SDD artifacts. This Skill derives the roadmap directly from specs/<feature>/spec.md, plan.md, and tasks.md, so each chunk, its acceptance criteria, and its verification gates stay auditable against the spec. ## Core Features & Use Cases - Spec-driven bootstrap: Converts each prioritized user story (P1, P2, ...) into one roadmap chunk with acceptance scenarios, priorities, and dependencies, plus cross-cutting chunks pulled from plan.md and research.md. - Portable speckit detection: Resolves script flavor, command separator, feature numbering, and hooks from .specify/ config instead of hardcoding paths, and falls back to plain /roadmap in non-speckit projects. - Three-gate verification: Requires the project's real test/lint commands, quickstart.md scenarios, and speckit analyze plus constitution checks before a chunk can be marked done. - Use Case: In a repo with .specify/ and specs/001-cli-tool/spec.md, run /roadmap-sk to bootstrap a roadmap from the spec's user stories, then advance one chunk per invocation through the specify → plan → tasks → implement → analyze pipeline. ## Quick Start Type /roadmap-sk in a speckit-initialized repository to bootstrap or advance the roadmap one chunk at a time.

Frequently Asked Questions about roadmap-sk

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I advance a roadmap in a Spec Kit project?▼

Run /roadmap-sk in a repo containing a .specify directory. It probes feature state with the check-prerequisites script, starts the next pending chunk, runs the needed speckit pipeline steps, and gates completion on tests, quickstart scenarios, and analyze.

How does roadmap-sk bootstrap a roadmap from a spec?▼

It reads specs/<feature>/spec.md and maps each prioritized user story to one chunk, using story priority for chunk priority and acceptance scenarios for acceptance criteria. It also adds cross-cutting chunks from plan.md and research.md, then stops for user review.

Does roadmap-sk work in projects without Spec Kit?▼

Yes. When .specify/ is absent, it says so once and falls back to plain /roadmap behavior with free-form chunks. It does not fabricate SDD artifacts in projects that do not use them.

What verification gates must pass before a chunk is done?▼

Three gates: the project's real test and lint commands run via ship_check so exit codes are captured, the quickstart.md scenarios for the chunk, and speckit analyze plus a constitution check recorded as review checks. A failed required gate means the chunk is not done.

When should I not use roadmap-sk?▼

Do not use it for one-off tasks, bulk implementation of multiple chunks in one invocation, or as a replacement for specify and clarify when authoring specs. It advances exactly one chunk per invocation and degrades to /roadmap outside speckit projects.