skills.rest
catlog22
catlog22COMMUNITY
Explore all skills by this author →
GitHub

roadmap-with-file

Generates strategic requirement roadmaps with iterative decomposition and machine-executable issue files.

2.1k|165|Updated Sep 7, 2025
Search Tags:#Planning#Workflow#JSONL#ROADMAP#requirement decomposition#Multi-Agent#Issue tracking
One-click install
npx skills add https://github.com/catlog22/Claude-Code-Workflow --skill roadmap-with-file
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: roadmap-with-file
Source: https://github.com/catlog22/Claude-Code-Workflow/tree/main/.codex/skills/roadmap-with-file
Command: npx skills add https://github.com/catlog22/Claude-Code-Workflow --skill roadmap-with-file

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Turning a high-level requirement into an actionable, dependency-ordered execution plan is slow and error-prone. This Skill decomposes requirements into a human-readable roadmap.md plus a machine-executable issues.jsonl, so planning output flows directly into execution pipelines without manual reformatting.

Core Features & Use Cases

  • Dual Decomposition Modes: Progressive mode (MVP → Usable → Refined → Optimized layers) for high-uncertainty work, or Direct mode (topological task sequence) for well-defined requirements, with automatic strategy recommendation based on uncertainty assessment.
  • Iterative Refinement with Decision Recording: Multi-round user feedback loops (up to 5 rounds) with cumulative context, optional web research for architecture patterns, and a structured decision trail recorded in the roadmap.
  • Issue Store Integration: Creates issues in a global .workflow/issues/issues.jsonl file with wave tags, dependencies, priorities, and lifecycle requirements, queryable via ccw issue commands and consumable by csv-wave-pipeline.
  • Use Case: Given a requirement like "Implement user authentication with OAuth and 2FA", the Skill assesses uncertainty, optionally explores the codebase via a subagent, decomposes the work into waves of issues with testable convergence criteria, refines the plan with the user, and hands off to an execution pipeline.

Quick Start

Ask the AI to plan a roadmap for your requirement, for example: run roadmap-with-file with the requirement "Implement user authentication system with OAuth and 2FA" and confirm the recommended decomposition strategy.

Frequently Asked Questions about roadmap-with-file

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

FAQPage Schema
How do I break down a software requirement into an executable roadmap?▼

Run the roadmap-with-file skill with your requirement description. It assesses uncertainty, recommends a decomposition strategy, creates issues in issues.jsonl, and produces a roadmap.md with convergence criteria and wave ordering for execution.

What is the difference between progressive and direct decomposition modes?▼

Progressive mode splits work into 2-4 layers from MVP to Optimized, suited for high-uncertainty requirements needing validation. Direct mode produces a topologically sorted task sequence with explicit inputs and outputs, best for clear requirements with confirmed technology.

Does roadmap-with-file execute code or modify project files?▼

No. It is planning-only and never executes code or modifies source files. It only writes roadmap.md in the session folder and appends issues to .workflow/issues/issues.jsonl. Execution happens separately via csv-wave-pipeline after user confirmation.

Can I resume an interrupted roadmap planning session?▼

Yes. Use the --continue or -c flag with the requirement text. The skill detects the existing session folder containing roadmap.md, loads the current state, and resumes from the phase where the session stopped.

How are roadmap issues executed after planning completes?▼

Issues are stored in .workflow/issues/issues.jsonl with wave tags and dependencies. You can inspect them with ccw issue list, manage queues with ccw issue queue commands, and hand off execution to the csv-wave-pipeline skill.

Related Skills

Explore More Software Engineering Skills→
justcyljustcyl

brainstorming

Guide teams to structure ideas into a validated design direction.

Community
Advanced
BedaBeda-GrowthBedaBeda-Growth

Wave Dispatch

Dispatch planned waves and track Jules sessions with ledger updates.

Official
Advanced
djimitdjimit
1

brainstorm

Facilitate structured brainstorming sessions for AI-assisted engineering projects.

Community
Advanced
Accelerated-InnovationAccelerated-Innovation
20

l3-implementation-plan

Generate an ordered implementation plan from a feature plan for Level 3 Spec-Driven Development.

Official
Intermediate