refine-roadmap

Update roadmap.md phase statuses, exit-criteria evidence, and cross-dependency statuses.

1|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/daddia/space --skill refine-roadmap
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refine-roadmap
Source: https://github.com/daddia/space/tree/main/.agents/skills/refine-roadmap
Command: npx skills add https://github.com/daddia/space --skill refine-roadmap

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Roadmap refinement keeps delivery plans honest by updating phase status, exit-criteria evidence, cross-dependency statuses, and phase contents when sprint outcomes diverge from plan. The process does not redesign the plan; it records outcomes and appends a Refinement session section for traceability.

Core Features & Use Cases

  • Surface shipped vs not shipped, mark them as delivered or blocked, and adjust the current phase.
  • Update cross-domain dependencies and re-sequence phase plans based on new evidence.
  • Append a "Refinement session" with notes, evidence, and next steps to roadmap.md.
  • Ensure a new version is produced and last_updated is refreshed in the frontmatter.

Quick Start

Run the refine-roadmap tool against roadmap.md using sprint notes to produce a refreshed, evidence-backed roadmap.

Frequently Asked Questions about refine-roadmap

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

FAQPage Schema
How do I update a project roadmap after a sprint to reflect actual delivery progress?

You refine the roadmap by marking shipped versus not shipped items, updating phase status, and appending a Refinement session section with evidence. A new version stamp and refreshed last_updated date are produced in the frontmatter.

What is the best way to track cross-domain dependencies when sprint outcomes diverge from the plan?

Refining cross-domain dependencies involves updating their statuses and re-sequencing phase plans based on new delivery evidence. The roadmap is kept accurate by recording outcomes rather than redesigning the plan.

Do I need a specific roadmap.md format to append exit-criteria evidence and refinement notes?

Yes, you need a roadmap.md file with frontmatter and phase content. The process updates exit-criteria evidence, appends a Refinement session section, and outputs a new version stamp within that existing structure.

When should I run roadmap refinement to keep delivery plans accurate?

Run roadmap refinement after a sprint, after a phase gate, or when cross-domain dependencies shift. It uses sprint notes and optional context artifacts to produce an evidence-backed, refreshed roadmap.

Does roadmap refinement redesign the project plan when items are blocked?

No, roadmap refinement does not redesign the project plan. It records delivery outcomes by marking items as delivered or blocked, adjusting the current phase, and appending a Refinement session section for traceability.