What is required before running the roadmap skill?

The roadmap skill requires an existing activity brief, typically generated by the discovery skill, located in your project's docs folder.

Is this skill suitable for small projects?

Yes, the skill is designed to scale down for smaller activities, providing a simplified structure without unnecessary complexity while maintaining the review safeguard.

Can the roadmap handle deadlines?

Yes, if you specify time constraints or target dates during the briefing, the skill can include 'due' fields in the waypoint metadata.

Where is the roadmap data stored?

Roadmaps are stored as JSON files in the docs/ directory, making them easy to track in version control and access via other tools.

How does the review process work?

The skill creates a 'w0' review waypoint and surfaces it to your inbox.json, blocking subsequent tasks until you have validated the plan.

Adaptive Roadmap Generator

Name: Adaptive Roadmap Generator
Author: ryanismert

byryanismert

0•

Productivity & Workflow

Transforms project briefs into structured, waypoint-based roadmaps with integrated review workflows and dependency tracking.

The roadmap skill bridges the gap between project discovery and execution by autonomously generating a strategic plan from activity briefs. It conducts an expert analysis to identify natural project phases, critical paths, and potential risks, resulting in a version-controlled JSON roadmap. Each roadmap includes specific waypoints with clear acceptance criteria and documentation stubs, while an integrated 'w0' review task ensures that human stakeholders can validate and approve the plan through a dashboard inbox before implementation begins.

Key Features

01JSON-based 'source of truth' roadmap for seamless automation and versioning

02Asynchronous review system with inbox integration for stakeholder approval

03Expert critical path analysis and project phase categorization

04Automatic generation of waypoint design stubs and documentation files

05Automated waypoint graph construction from Markdown activity briefs

060 GitHub stars

Use Cases

01Converting high-level project discovery documents into actionable implementation phases

02Managing complex dependencies and sequencing for multi-stage software development

03Creating a standardized review and approval process for project scope and strategy

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ryanismert/do-stuff-helper roadmap

For use in Claude.ai and ChatGPT