What is the benefit of the 3-5 section limit?

By limiting the roadmap to 3-5 sections, the skill enforces the KISS (Keep It Simple, Stupid) principle. This ensures that the project remains manageable, each part is independently demonstrable, and you avoid the trap of over-planning before seeing running code.

Can I visualize the build order with this skill?

Yes, every roadmap generated includes a Mermaid dependency diagram. This provides a clear visual representation of which sections depend on others, helping you identify the best starting point for development.

How does this skill help avoid reinventing the wheel?

The skill follows the 'Iron Law' of planning only the unique parts of your project. It analyzes your foundations (like PyPortfolioOpt or other libraries) and ensures your roadmap focuses on the custom wrappers, UI, and logic you need to build on top of them.

What is the Annotation Cycle?

The Annotation Cycle is a collaborative process where you provide inline corrections and domain knowledge to a draft roadmap. This allows you to refine the plan through multiple rounds of feedback until it perfectly aligns with your vision.

Project Roadmap Architect

Name: Project Roadmap Architect
Author: peterjohn1298

bypeterjohn1298

0•

Productivity & Workflow

Transforms high-level product definitions into lean, actionable build plans focused on unique feature development.

The Project Roadmap Architect is a specialized planning skill for Claude Code designed to help developers move from a broad product vision to a concrete execution strategy. By acting as a 'Cognition Mate,' it helps identify the unique value proposition of a project and breaks it down into 3-5 manageable, buildable sections. It strictly enforces the 'Iron Law' of not reinventing existing foundations, ensuring developers focus only on what truly needs to be built. The skill produces a living roadmap.md file, complete with Mermaid dependency diagrams, facilitating an iterative annotation cycle that refines project scope through domain-specific feedback before coding begins.

Key Features

01Living Documentation: Creates a centralized roadmap.md to track build progress and manage implementation updates.

02KISS-Compliant Planning: Enforces a lean 3-5 section structure to prevent scope creep and over-engineering.

03Unique Feature Isolation: Focuses planning strictly on custom logic while leveraging existing libraries.

040 GitHub stars

05Mermaid Dependency Mapping: Automatically generates visual flowcharts to illustrate the optimal build order.

06Iterative Annotation Cycle: Supports a back-and-forth review process for refining domain knowledge and requirements.

Use Cases

01Structuring the development phases of a financial analysis tool without rebuilding core mathematical libraries.

02Defining a Minimum Viable Product (MVP) by identifying core dependencies and user-facing value.

03Translating a conceptual product overview into a technical execution plan with visual dependency graphs.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add peterjohn1298/re-underwriting-tool represent-roadmap

For use in Claude.ai and ChatGPT

Download Skill