maestro-roadmap

Generate a phased roadmap from requirements into CSV and Markdown outputs.

511|63|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/catlog22/Maestro-Flow --skill maestro-roadmap
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maestro-roadmap
Source: https://github.com/catlog22/Maestro-Flow/tree/main/.codex/skills/maestro-roadmap
Command: npx skills add https://github.com/catlog22/Maestro-Flow --skill maestro-roadmap

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates turning ambiguous or file-backed requirements into a structured, phased roadmap so teams can move from idea to executable plan without manual decomposition or ad-hoc guessing.

Core Features & Use Cases

  • Two-wave CSV pipeline: parallel analysis agents assess scope, risk, and dependencies, followed by a single assembly agent that synthesizes findings into a roadmap with phases, milestones, and success criteria.
  • Interactive refinement and graceful degradation: supports up to three user refinement rounds, an auto-confirm mode to skip interaction, and a degraded assembly mode if analysis agents fail.
  • Traceable outputs and discovery board: writes master tasks.csv, results.csv, discoveries.ndjson, context.md, and .workflow/roadmap.md for auditability and downstream automation.
  • Use Case: convert a product requirement or brainstorm session into a prioritized, dependency-aware multi-phase plan ready for sprint planning.

Quick Start

Generate a phased roadmap for "Implement user authentication with OAuth and 2FA" and write outputs to the .workflow directory.

Frequently Asked Questions about maestro-roadmap

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

FAQPage Schema
How do I generate a phased roadmap from natural-language requirements?

To generate a phased roadmap from natural-language requirements, provide your project artifacts or brainstorm text. The system uses parallel analysis agents to assess scope, risk, and dependencies, then synthesizes a structured plan with phases, milestones, and success criteria.

What is the best way to convert brainstorm sessions into a dependency-aware product plan?

Converting brainstorm sessions into a dependency-aware product plan is done via a two-wave CSV pipeline. It decomposes inputs into a structured roadmap with traceable outputs like tasks.csv, discoveries.ndjson, and roadmap.md.

Can I automate software planning without manual decomposition?

Yes, you can automate software planning without manual decomposition by applying multi-agent orchestration. It analyzes repository signals and requirements to output a CSV-driven plan ready for sprint planning.

Does the roadmap generation pipeline support interactive refinement?

The roadmap generation pipeline supports interactive refinement with up to three user rounds and an auto-confirm mode. If analysis agents fail, it uses a degraded assembly mode to ensure continuous plan generation.

What file formats are output by the multi-agent roadmap planning process?

The multi-agent roadmap planning process outputs CSV files for tasks and results, an append-only discoveries.ndjson protocol, context.md, and a final roadmap.md. These are written to the .workflow directory for auditability.

Why does roadmap assembly fail if analysis agents encounter errors?

Roadmap assembly fails if analysis agents encounter errors because the sequential assembly agent depends on prev_context. However, it features a degraded assembly mode to gracefully handle failures and still produce a roadmap.