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.