roadmap-refresh

Researches and updates an existing project roadmap via think-and-ship MCP roadmap tools.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Project roadmaps go stale as libraries, standards, and team discoveries change, but nobody pauses implementation to re-validate the plan. This Skill runs a focused research cycle that grounds findings in the actual codebase, scans the outside world, and mutates native roadmap state so the plan reflects current reality. ## Core Features & Use Cases - Research-driven refresh: Picks a scope (a phase, area, or technology), grounds assumptions in the code with ministr, then researches current best practices and library status with serpapi before proposing changes. - Surgical roadmap mutations: Updates stale descriptions, adds newly discovered backlog chunks, marks obsolete items, records re-prioritization proposals for user review, and logs refresh provenance via roadmap_* tools. - Reasoning trace: Records mandatory think_* steps (open, synthesis, close) so every roadmap change is traceable to the research that motivated it. - Use Case: After a major chunk ships, run a refresh on the next phase to verify the chosen WebSocket library is still maintained, add newly discovered work to the backlog, and surface re-prioritization proposals before more code lands. ## Quick Start Type /roadmap-refresh with an optional topic such as a phase name or technology area to research and update that part of the project roadmap.

Frequently Asked Questions about roadmap-refresh

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

FAQPage Schema
How do I update a stale project roadmap with research?▼

Invoke /roadmap-refresh with an optional topic like a phase or technology area. It grounds assumptions in the codebase with ministr, researches current practices with serpapi, then applies surgical mutations to native roadmap state via roadmap_* tools.

What is the difference between /roadmap and /roadmap-refresh?▼

/roadmap advances the plan by implementing one chunk, while /roadmap-refresh pauses implementation to research and reshape the roadmap itself. The refresh never writes code; it only mutates roadmap state and proposes re-prioritization.

Can roadmap-refresh reorder roadmap priorities automatically?▼

No. It records re-prioritization proposals via roadmap_reprioritize with a suggested priority and reason, but the server does not reorder anything. The user reviews and decides on each proposal in the final report.

What happens if the serpapi research server is unavailable?▼

The skill warns the user explicitly and continues with a code-only refresh grounded in ministr. It flags the gap in the final report and suggests re-running when serpapi is back, since external research is load-bearing for this skill.

Does roadmap-refresh work without an existing roadmap?▼

No. If roadmap_status returns zero chunks, it tells the user and suggests /roadmap, which can seed native state from an existing ROADMAP.md or bootstrap a fresh roadmap. This skill never creates a roadmap from scratch.