roadmap-run

Executes multiple roadmap chunks in one session with per-chunk gates, commits, and subsumption checks.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Running roadmap chunks one at a time misses what only exists between chunks: a landed chunk can subsume queued work, dependency satisfaction changes which chunk is ready next, and setup costs repeat. This Skill advances several roadmap chunks in a single session while preserving per-chunk atomicity — each chunk keeps its own think open/close, ship objective, quality gates, and commit. ## Core Features & Use Cases - Frontier selection: Builds a candidate set of pending, unblocked, dependency-satisfied chunks and filters out human-gated, exploratory, or backlogged work, stating every exclusion. - Between-chunk subsumption: After each chunk lands, checks whether remaining queued chunks are still necessary and obsoletes dead ones with measurement-backed reasons via roadmap_obsolete_chunk. - Explicit stop conditions: Halts the run on red gates, human decisions, scope explosion, falsified plans, budget exhaustion, or low context, and always emits a handoff prompt. - Use Case: A user types "/roadmap-run perf" to knock out the performance-related chunks; the Skill plans the ordered set, executes each under the full per-chunk contract, obsoletes two chunks made moot by a 64x-cheaper solve, and reports a ledger with commits and gate results. ## Quick Start Type /roadmap-run followed by a count, theme, chunk ids, or an until-condition to advance several roadmap chunks in one session.

Frequently Asked Questions about roadmap-run

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

FAQPage Schema
How do I run multiple roadmap chunks in one session?▼

Invoke /roadmap-run with a count, theme, explicit chunk ids, or an until-condition. The Skill selects a frontier of ready chunks, shows the plan, then executes each chunk under the full per-chunk contract with its own gates and commit.

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

/roadmap executes a single chunk, while /roadmap-run advances several chunks in one session. The run adds between-chunk work a single run cannot do: subsumption checks, frontier re-derivation, and a run-level ledger.

When should I not use /roadmap-run?▼

Do not use it for a single chunk (use /roadmap), for re-planning or re-prioritization (use /roadmap-refresh), or for large exploratory design-heavy chunks. A run is for work whose shape is already known.

What happens if a quality gate fails during a roadmap run?▼

One fix attempt is allowed; a second failure stops the run. The tree is left green or clearly broken with an explanation, and the run never stacks a new chunk's changes on a broken tree.

How does subsumption work between chunks in a run?▼

After each chunk completes, the run checks whether remaining queued chunks are still necessary. Dead chunks are obsoleted with a measurement as the reason via roadmap_obsolete_chunk, and diminished ones get updated descriptions.