roadmap

Advance a project roadmap one chunk at a time using think-and-ship MCP state.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Long-running projects lose momentum between sessions: the plan drifts from reality, reasoning behind decisions disappears, and agents redo or reverse prior work. This Skill drives an evolving roadmap stored as native state in the think-and-ship MCP server, executing one chunk end-to-end per invocation while keeping reasoning, execution, and the plan cross-referenced in a single audit trail. ## Core Features & Use Cases - Chunk execution loop: Picks the next ready chunk via roadmap_next, plans it with think_* steps, tracks execution with ship_* tasks, and verifies with real quality gates before marking it done. - Native roadmap state management: Mutates chunks with roadmap_* tools (add, update, obsolete, reprioritize proposals) and regenerates ROADMAP.md as a view, never hand-editing it. - Cross-referenced trace graph: Links chunk:, think:, task:, and check: references so every shipped change carries its motivating reasoning. - Use Case: A developer returns to a multi-session project, types /roadmap, and the agent picks the next pending chunk, explores the code with ministr, implements and verifies it, records discoveries as new backlog chunks, and emits a handoff prompt for the next session. ## Quick Start Type /roadmap in a project configured with the think-and-ship MCP server to have the agent select and ship the next ready roadmap chunk.

Frequently Asked Questions about roadmap

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

FAQPage Schema
How do I advance a project roadmap with an AI agent?▼

Invoke /roadmap in a project configured with the think-and-ship MCP server. The agent calls roadmap_next to pick the highest-priority unblocked chunk, plans it with think steps, tracks execution with ship tasks, verifies with real test and lint gates, then marks the chunk done.

What is the difference between ROADMAP.md and native roadmap state?▼

Native roadmap state in the think-and-ship MCP server is the source of truth, mutated only through roadmap_* tool calls. ROADMAP.md is a generated view produced by roadmap_export and must never be hand-edited as the plan of record.

Why does my roadmap disappear between sessions?▼

Native state persists across sessions only when the server runs with THINK_AND_SHIP_PERSIST=true; the default is in-memory only. If roadmap_status returns empty on a project with known chunks, enable persistence or check that the data directory matches.

When should I not use the /roadmap skill?▼

Do not use it for one-off tasks like fixing a single bug or adding one feature; do those directly. It is designed for sustained multi-session iteration, not one-shot implementation, initial roadmap design, or automatic committing and pushing.

Can the roadmap skill reorder priorities automatically?▼

No. roadmap_reprioritize records only a proposal with a suggested priority and reason; the server never reorders chunks on its own. Re-prioritization remains an explicit human decision, and discoveries go to backlog status.