roadmap

Generate project roadmap JSON and task files from vision and architecture documents.

182|33|Updated Feb 1, 2026
One-click install
npx skills add https://github.com/YougLin-dev/Aha-Loop --skill roadmap-youglin-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: roadmap
Source: https://github.com/YougLin-dev/Aha-Loop/tree/main/.agents/skills/roadmap
Command: npx skills add https://github.com/YougLin-dev/Aha-Loop --skill roadmap-youglin-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Roadmap planning often relies on manual, error-prone processes to decompose vision into milestones and PRDs. This Skill automates the creation and management of project roadmaps, ensuring dependencies are respected and outputs are consistent.

Core Features & Use Cases

  • Milestone planning: Decompose visions into M0, M1, M2 milestones with clear goals and PRDs.
  • PRD generation: Break milestones into PRDs and order them by dependencies, producing a structured roadmap JSON and stub task files.
  • Output automation: Generate the roadmap in project.roadmap.json and create initial task files under tasks/

Quick Start

To start, provide the project's vision and architecture details; the Skill will read project.vision-analysis.md and project.architecture.md to produce the initial roadmap. Then you can review and iterate.

Frequently Asked Questions about roadmap

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

FAQPage Schema
How do I generate a project roadmap from an architecture document?

To generate a project roadmap, provide your vision and architecture details so the system can read project.vision-analysis.md and project.architecture.md. It then derives M0, M1, M2 milestones and outputs a structured roadmap JSON file.

How does PRD decomposition work for milestone planning?

PRD decomposition breaks down milestones into individual Product Requirement Documents. It orders these PRDs by their dependencies to ensure logical execution, generating initial stub task files alongside the roadmap JSON.

Can I automate dependency ordering when creating project milestones?

Yes, you can automate dependency ordering when creating project milestones. The system reads your architecture details, decomposes features into ordered PRDs, and ensures all dependencies are respected automatically in the output.

What files do I need to provide for automated roadmap generation?

You need to provide project.vision-analysis.md and project.architecture.md files for automated roadmap generation. The system reads these inputs to produce a project.roadmap.json file and initial task files under the tasks directory.

What is the best way to manage PRD queues for architecture-defined projects?

The best way to manage PRD queues for architecture-defined projects is to automate milestone decomposition. The system derives milestones from your vision, breaks them into dependency-ordered PRDs, and outputs a structured roadmap JSON.

Does roadmap planning work without manual milestone decomposition?

Roadmap planning works without manual milestone decomposition by reading your project vision and architecture files. It automatically derives milestone structures, generates ordered PRDs, and creates initial task files to eliminate manual errors.