phase-roadmap-builder

Generates multi-phase roadmap specs with dependency DAGs and interface-freeze gates for downstream planning.

2|1|Updated Jun 25, 2026
One-click install
npx skills add https://github.com/Consiliency/agent-harness --skill phase-roadmap-builder-consiliency
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: phase-roadmap-builder
Source: https://github.com/Consiliency/agent-harness/tree/main/phase-loop-skills/phase-roadmap-builder
Command: npx skills add https://github.com/Consiliency/agent-harness --skill phase-roadmap-builder-consiliency

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? Turning a conversation, architecture discussion, or markdown spec into a structured, machine-validated multi-phase roadmap is error-prone and inconsistent. This Skill produces versioned specs/phase-plans-v<N>.md roadmap files that downstream planning skills can parse directly, with enforced structure, unique phase aliases, and an acyclic dependency DAG. ## Core Features & Use Cases - Roadmap creation and append modes: Create a new versioned roadmap or append phases to an existing one without rewriting prior phases, preserving alias namespaces per roadmap file. - Parallelization-maximizing decomposition: Applies heuristics that minimize serial phases, split work into parallel lanes and sibling phases, and define narrow interface-freeze gates (IF-0-<ALIAS>-<N>) that unblock downstream work early. - Mechanical validation: Runs phase-loop validate-roadmap to check stable headings, unique aliases, DAG acyclicity, gate reconciliation, and lane-count hints before handoff. - Use Case: After an architecture discussion about refactoring a monorepo, invoke this Skill to produce specs/phase-plans-v1.md with phased objectives, exit criteria, dependency DAG, and verification commands, then hand off each phase to a lane-level planning skill. ## Quick Start Ask the assistant to turn the current conversation or a named markdown spec into a phased roadmap saved as specs/phase-plans-v1.md.

Frequently Asked Questions about phase-roadmap-builder

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

FAQPage Schema
How do I turn a spec or conversation into a multi-phase roadmap?▼

Invoke the roadmap builder with an optional markdown spec path; it reads the spec, AGENTS.md, and existing roadmaps, then writes specs/phase-plans-v<N>.md with phases, a dependency DAG, and verification commands. It validates the result with phase-loop validate-roadmap before handoff.

How do I add phases to an existing phase-plans roadmap?▼

Run the skill against the existing specs/phase-plans-v*.md file; append mode reads current aliases, phase numbers, and gates, then adds only new phases without rewriting prior ones. New initiatives should start a new versioned roadmap instead of appending.

When should I use a phase roadmap versus a single detailed plan?▼

Use the roadmap builder for multi-phase initiatives spanning interface freezes and parallel workstreams. For a single bounded change, use the plan-detailed skill instead, since roadmap structure adds overhead without benefit.

Why does roadmap validation fail on my phase headings?▼

The validator parses headings by regex: each must be '### Phase N — <Name> (<ALIAS>)' with an alphanumeric uppercase alias and nothing after the closing parenthesis. A malformed heading drops the whole phase, causing cascading alias and DAG errors, so fix headings first.

Can the roadmap builder run tests or builds while planning?▼

No. During planning-only roadmap creation it must not execute test suites, builds, formatters, or migrations. It captures end-to-end verification commands in the roadmap's Verification section without running them.