Agent skill

Roadmap

by YougLin-dev in YougLin-dev/Aha-Loop

Creates and manages project roadmaps with milestones and PRD queues.

MITAuto-check passedProduct & Project Management

Install Roadmap

skills CLI
$ npx skills add YougLin-dev/Aha-Loop --skill roadmap -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install YougLin-dev/Aha-Loop roadmap --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/YougLin-dev/Aha-Loop.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/roadmap .claude/skills/roadmap && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
roadmap
GitHub stars
181
Token cost
~2.7k tokens
SKILL.md length
482 words
Files
1
Skills in repo
15
Repo updated
First seen
Licence
MIT

At a glance

Creates and manages project roadmaps with milestones and PRD queues.

  • Works in 4 steps: Analyze Requirements → Create M0 Foundation → Decompose Milestones into PRDs → …
  • : create roadmap
  • SKILL.md covers Workspace Mode Note, The Job, Milestone Strategy and PRD Decomposition, plus 7 more sections
  • Calls jq

What it does

Roadmap is an agent skill from YougLin-dev/Aha-Loop. Creates and manages project roadmaps with milestones and PRD queues. Use after architecture is defined for project planning. Triggers on: create roadmap, plan milestones, organize prds.

Its SKILL.md is about 2.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Product & Project Management, covering Project management and PRD writing. The repository describes itself as: [MVP] Aha Loop is a fully autonomous AI development system, extended from the core ideas of Ralph. It's not just an execution engine, but a complete AI development framework with… The licence is MIT.

When your agent uses it

  • : create roadmap
  • Plan milestones

Example prompts

  • “Use the roadmap skill to create and manages project roadmaps with milestones and PRD queues”
  • “/roadmap”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Analyze Requirements
  2. Create M0 Foundation
  3. Decompose Milestones into PRDs
  4. Generate PRD Files

What it can do on your machine

Read from SKILL.md and the folder at commit 8d799b2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • jq

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Roadmap loads about 2.7k tokens when it runs. Until then it costs about 48 tokens; SKILL.md has 482 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~48
When it runs · the whole SKILL.md, loaded when a task matches
~2.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from YougLin-dev/Aha-Loop at commit 8d799b2, republished under its MIT licence (© YougLin-dev). 482 words, ~2,659 tokens.

Download SKILL.mdSave it as .claude/skills/roadmap/SKILL.md (or your agent's skills folder).
name
roadmap
description
Creates and manages project roadmaps with milestones and PRD queues. Use after architecture is defined for project planning. Triggers on: create roadmap, plan milestones, organize prds.

Roadmap Skill

Plan project execution by creating milestones and organizing PRDs into an executable queue.

Workspace Mode Note

When running in workspace mode, all paths are relative to .aha-loop/ directory:

  • Vision analysis: .aha-loop/project.vision-analysis.md
  • Architecture: .aha-loop/project.architecture.md
  • Roadmap: .aha-loop/project.roadmap.json
  • PRD files: .aha-loop/tasks/

The orchestrator will provide the actual paths in the prompt context.


The Job

  1. Read project.vision-analysis.md and project.architecture.md
  2. Decompose project into milestones
  3. Break each milestone into PRDs
  4. Order PRDs by dependencies
  5. Output project.roadmap.json
  6. Generate initial PRD files in tasks/

Milestone Strategy

Standard Milestone Structure
MilestoneFocusGoal
M0: FoundationProject scaffolding, CI/CD, toolingDevelopment environment ready
M1: MVPCore features onlyMinimal usable product
M2: EssentialImportant featuresFeature-complete for basic use
M3: EnhancedNice-to-have featuresPolished product
M4: OptimizationPerformance, UX polishProduction-ready
Milestone Sizing

Each milestone should:

  • Be completable in a reasonable timeframe
  • Have 3-7 PRDs (avoid too many or too few)
  • Deliver tangible, testable value
  • Build on previous milestones

PRD Decomposition

From Features to PRDs

For each milestone, break down features into PRDs:

Milestone: M1 - MVP
├── PRD-001: Project Scaffolding
├── PRD-002: Database Schema
├── PRD-003: Core Data Models
├── PRD-004: Basic API Endpoints
└── PRD-005: Minimal UI
PRD Sizing

Each PRD should:

  • Take 1-5 Aha Loop iterations (5-25 stories)
  • Focus on one coherent feature area
  • Be independently testable
  • Not depend on unfinished PRDs
PRD Ordering

Order PRDs by dependencies:

  1. Infrastructure first - Project setup, database, auth
  2. Backend before frontend - APIs before UI that uses them
  3. Core before optional - Must-have before nice-to-have
  4. Data before presentation - Models before views

Roadmap JSON Structure

json
{
  "version": 1,
  "projectName": "[From vision]",
  "status": "in_progress",
  "currentMilestone": "M1",
  "currentPRD": "PRD-002",
  "createdAt": "[timestamp]",
  "updatedAt": "[timestamp]",
  "milestones": [
    {
      "id": "M0",
      "title": "Foundation",
      "description": "Project setup and development environment",
      "status": "completed",
      "completedAt": "[timestamp]",
      "prds": [
        {
          "id": "PRD-001",
          "title": "Project Scaffolding",
          "description": "Initialize project structure, dependencies, and tooling",
          "status": "completed",
          "prdFile": "tasks/prd-scaffolding.md",
          "stories": 5,
          "completedAt": "[timestamp]"
        }
      ]
    },
    {
      "id": "M1",
      "title": "MVP",
      "description": "Minimum viable product with core functionality",
      "status": "in_progress",
      "prds": [
        {
          "id": "PRD-002",
          "title": "Database Schema",
          "description": "Design and implement database schema",
          "status": "in_progress",
          "prdFile": "tasks/prd-database.md",
          "stories": 8,
          "dependsOn": ["PRD-001"]
        },
        {
          "id": "PRD-003",
          "title": "Core API",
          "description": "Implement core API endpoints",
          "status": "pending",
          "prdFile": "tasks/prd-core-api.md",
          "stories": 12,
          "dependsOn": ["PRD-002"]
        }
      ]
    },
    {
      "id": "M2",
      "title": "Essential Features",
      "description": "Complete essential features for basic use",
      "status": "pending",
      "prds": []
    }
  ],
  "changelog": [
    {
      "timestamp": "[timestamp]",
      "action": "created",
      "description": "Initial roadmap created from vision and architecture"
    }
  ]
}

Roadmap Creation Process

Step 1: Analyze Requirements

From vision analysis, categorize features:

markdown
## Feature Categories

### M1: MVP (Must ship)
- [Feature 1]
- [Feature 2]

### M2: Essential (Should ship)
- [Feature 3]
- [Feature 4]

### M3: Enhanced (Nice to ship)
- [Feature 5]
Step 2: Create M0 Foundation

Every project starts with M0:

markdown
## M0: Foundation PRDs

### PRD-001: Project Scaffolding
- Initialize project with chosen tech stack
- Set up directory structure
- Configure linting and formatting
- Set up basic CI (if applicable)
- Create initial README

### PRD-002: Development Environment
- Database setup (if applicable)
- Environment configuration
- Development scripts
- Basic testing infrastructure
Step 3: Decompose Milestones into PRDs

For each milestone after M0:

  1. List all features for this milestone
  2. Group related features
  3. Order by dependencies
  4. Create PRD for each group
  5. Estimate stories per PRD
Show full SKILL.md (186 more words)Show less
Step 4: Generate PRD Files

For each PRD, create a stub file in tasks/:

markdown
# PRD: [Title]

**ID:** PRD-XXX
**Milestone:** M[N]
**Status:** Pending

## Overview

[Brief description from roadmap]

## Context

[How this relates to previous PRDs and the overall project]

## Goals

- [Goal 1]
- [Goal 2]

## User Stories

[To be generated when this PRD becomes active]

## Dependencies

- PRD-XXX: [What it depends on]

## Acceptance Criteria

- [ ] [High-level criterion]
- [ ] [Another criterion]

---

*This PRD will be fully expanded when it becomes the active PRD.*

Dynamic Roadmap Updates

When to Update Roadmap

The roadmap should be updated when:

  1. PRD Completed - Mark as complete, update timestamps
  2. New Requirement Discovered - Add new PRD
  3. Scope Change - Modify or remove PRDs
  4. Better Approach Found - Restructure PRDs
  5. Milestone Complete - Update status, move to next
Update Process
json
{
  "changelog": [
    {
      "timestamp": "2026-01-29T12:00:00Z",
      "action": "prd_completed",
      "prdId": "PRD-002",
      "description": "Database schema implemented"
    },
    {
      "timestamp": "2026-01-29T14:00:00Z",
      "action": "prd_added",
      "prdId": "PRD-007",
      "description": "Added caching layer PRD based on performance research"
    }
  ]
}
Automatic Triggers

The orchestrator should trigger roadmap review:

  • After each PRD completion
  • After each milestone completion
  • When significant learnings are recorded
  • When errors repeatedly occur

Integration with Orchestrator

Orchestrator Reads
bash
# Get current PRD
jq '.currentPRD' project.roadmap.json

# Get PRD file path
jq -r '.milestones[].prds[] | select(.id == "PRD-002") | .prdFile' project.roadmap.json
Orchestrator Updates

After PRD completion:

bash
# Update PRD status
jq '.milestones[].prds[] |= if .id == "PRD-002" then .status = "completed" else . end' project.roadmap.json

PRD Queue Management

Getting Next PRD
python
# Pseudocode for finding next PRD
def get_next_prd(roadmap):
    for milestone in roadmap.milestones:
        if milestone.status == "completed":
            continue
        for prd in milestone.prds:
            if prd.status == "pending":
                if all_dependencies_complete(prd):
                    return prd
    return None  # All complete or blocked
Handling Blocked PRDs

If a PRD's dependencies aren't met:

  1. Skip to next available PRD
  2. If no PRDs available, report blocking issue
  3. Consider if dependencies need reprioritization

Example Roadmap

Project: Personal Finance Tracker (from vision example)

json
{
  "version": 1,
  "projectName": "Finance Tracker",
  "status": "in_progress",
  "currentMilestone": "M0",
  "currentPRD": "PRD-001",
  "milestones": [
    {
      "id": "M0",
      "title": "Foundation",
      "status": "in_progress",
      "prds": [
        {
          "id": "PRD-001",
          "title": "SvelteKit Project Setup",
          "description": "Initialize SvelteKit project with TypeScript, Tailwind, PWA support",
          "status": "in_progress",
          "prdFile": "tasks/prd-project-setup.md",
          "stories": 6
        }
      ]
    },
    {
      "id": "M1",
      "title": "MVP - Core Expense Tracking",
      "status": "pending",
      "prds": [
        {
          "id": "PRD-002",
          "title": "Data Layer",
          "description": "Implement IndexedDB with Dexie for expense storage",
          "status": "pending",
          "prdFile": "tasks/prd-data-layer.md",
          "stories": 8,
          "dependsOn": ["PRD-001"]
        },
        {
          "id": "PRD-003",
          "title": "Quick Expense Entry",
          "description": "Fast expense input form (< 5 seconds goal)",
          "status": "pending",
          "prdFile": "tasks/prd-expense-entry.md",
          "stories": 10,
          "dependsOn": ["PRD-002"]
        },
        {
          "id": "PRD-004",
          "title": "Expense List View",
          "description": "View and manage recorded expenses",
          "status": "pending",
          "prdFile": "tasks/prd-expense-list.md",
          "stories": 8,
          "dependsOn": ["PRD-002"]
        }
      ]
    },
    {
      "id": "M2",
      "title": "Reports & PWA",
      "status": "pending",
      "prds": [
        {
          "id": "PRD-005",
          "title": "Monthly Reports",
          "description": "Auto-generated monthly expense reports",
          "status": "pending",
          "prdFile": "tasks/prd-reports.md",
          "stories": 10,
          "dependsOn": ["PRD-003", "PRD-004"]
        },
        {
          "id": "PRD-006",
          "title": "PWA Offline Support",
          "description": "Full offline capability with service worker",
          "status": "pending",
          "prdFile": "tasks/prd-pwa.md",
          "stories": 8,
          "dependsOn": ["PRD-002"]
        }
      ]
    }
  ]
}

Checklist

Before completing roadmap:

  • All milestones defined with clear goals
  • PRDs created for at least M0 and M1
  • Dependencies between PRDs mapped
  • PRD stub files created in tasks/
  • Roadmap JSON validates
  • Current milestone and PRD set correctly
  • Changelog initialized
  • Saved to project.roadmap.json

© YougLin-dev, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/roadmap of YougLin-dev/Aha-Loop.

Open the folder on GitHubat commit 8d799b2

Compare with similar skills

Roadmap next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Roadmap compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Roadmap this skillYougLin-dev/Aha-Loop181—~2.7kAutomated safety check: PassMIT
CCPM Project Managementautomazeio/ccpm8.4k—~1.1kAutomated safety check: PassMIT
Project Planneradrianpuiu/claude-skills-marketplace1001 repos~6kAutomated safety check: PassNone
Shep Workstreamsshep-ai/shep264—~2.5kAutomated safety check: PassMIT
App Spec Packagerinstructa/agent-skills139—~1.5kAutomated safety check: PassNone
Fireauto Project Guideimgompanda/fireauto140—~674Automated safety check: PassMIT

Similar skills

  • Runs a spec-driven workflow from PRD to epic to GitHub issues to parallel agents, with status, standup and blocked-work reports from bundled scripts.

    8.4k GitHub stars~1.1k tokensUpdated 6 mo ago
    Product & Project ManagementAuto-check passed
  • Project Planner

    adrianpuiu/claude-skills-marketplace

    Comprehensive project planning and documentation generator for software projects.

    100 GitHub starsUsed in 1 repo~6k tokens
    Product & Project ManagementAuto-check passed
  • Shep Workstreams

    shep-ai/shep

    A skill your agent uses when a large body of work (a version milestone, an epic, a roadmap, a set of PRDs/design docs) needs to be broken into parallel workstreams and executed with the shep CLI.

    264 GitHub stars~2.5k tokensUpdated 2 days ago
    Product & Project ManagementAuto-check passed
  • App Spec Packager

    instructa/agent-skills

    A skill your agent uses when the user wants to turn an application, product, startup idea, SaaS, mobile app, web app, API, AI product, or internal tool into a production-ready Markdown specification…

    139 GitHub stars~1.5k tokensUpdated 9 days ago
    Product & Project ManagementAuto-check passed
  • Fireauto Project Guide

    imgompanda/fireauto

    프로젝트 생성, 마일스톤 관리, 태스크 추적이 필요할 때 사용하세요. An agent skill from imgompanda/fireauto.

    140 GitHub stars~674 tokensUpdated 6 mo ago
    Product & Project ManagementAuto-check passed
  • Auto

    udecode/kitcn

    Autonomous kitcn supervisor for sweep, clean, full, design, milestone, PRD, timed, and review-until work.

    450 GitHub stars~4.7k tokensUpdated 6 days ago
    Product & Project ManagementAuto-check passed

More from YougLin-dev/Aha-Loop

All 15 skills in this repo
  • God Member

    YougLin-dev/Aha-Loop

    Defines God Committee member behavior and responsibilities with oversight authority.

    181 GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed
  • Architect

    YougLin-dev/Aha-Loop

    Designs system architecture and selects technology stack based on vision analysis.

    181 GitHub stars~2.2k tokensUpdated 8 mo ago
    Auto-check passed
  • Doc Review

    YougLin-dev/Aha-Loop

    Reviews and cleans up outdated documentation. An agent skill from YougLin-dev/Aha-Loop.

    181 GitHub stars~1.5k tokensUpdated 8 mo ago
    Auto-check passed
  • God Consensus

    YougLin-dev/Aha-Loop

    Guides God Committee members through consensus-building for collective decisions.

    181 GitHub stars~2k tokensUpdated 8 mo ago
    Auto-check passed
  • God Intervention

    YougLin-dev/Aha-Loop

    Guides God Committee members through executing interventions.

    181 GitHub stars~2.3k tokensUpdated 8 mo ago
    Auto-check passed
  • Parallel Explore

    YougLin-dev/Aha-Loop

    Guides parallel exploration of multiple implementation approaches using git worktrees.

    181 GitHub stars~1.9k tokensUpdated 8 mo ago
    Auto-check passed

Questions about Roadmap

What does Roadmap do?

Creates and manages project roadmaps with milestones and PRD queues. Roadmap is an agent skill from YougLin-dev/Aha-Loop. Creates and manages project roadmaps with milestones and PRD queues.

When should I use Roadmap?

Roadmap fits situations like: : create roadmap; plan milestones.

How do I install Roadmap in Claude Code?

Run `npx skills add YougLin-dev/Aha-Loop --skill roadmap -a claude-code`. Or copy the skill folder (.agents/skills/roadmap in YougLin-dev/Aha-Loop) into .claude/skills/roadmap in your project. Claude Code loads it when a task matches its description.

How do I install Roadmap in Codex?

Run `npx skills add YougLin-dev/Aha-Loop --skill roadmap -a codex`. Or copy the skill folder (.agents/skills/roadmap in YougLin-dev/Aha-Loop) into .agents/skills/roadmap in your project. Codex loads it when a task matches its description.

Can I use Roadmap in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add YougLin-dev/Aha-Loop --skill roadmap -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/roadmap, .gemini/skills/roadmap, .github/skills/roadmap and .opencode/skills/roadmap in your project.

What does Roadmap need to run?

Going by SKILL.md and its folder, Roadmap needs the command-line tools its instructions call (jq). Our summary lists: Python 3.

Does Roadmap access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Roadmap safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Roadmap use?

Roadmap is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Roadmap use?

About 2.7k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Roadmap?

Skills that share tags, products or a category with Roadmap: CCPM Project Management (automazeio/ccpm, 8.4k stars), Project Planner (adrianpuiu/claude-skills-marketplace, 100 stars), Shep Workstreams (shep-ai/shep, 264 stars) and App Spec Packager (instructa/agent-skills, 139 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Roadmap?

YougLin-dev (a GitHub user) maintains it in YougLin-dev/Aha-Loop, which has 181 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on February 3, 2026.

Source: YougLin-dev/Aha-Loop on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.