Roadmap Planning
Use this skill to transform broad objectives into clear, prioritized roadmaps connected to the executable backlog.
Initial context received via slash: $ARGUMENTS
If
is filled, use as starting point (e.g., intake, initiative list, period).
If empty, ask for the roadmap objective.
Language
Write the artifact in the user's language. If the user communicates in Portuguese, write in Portuguese with correct grammar and accents. If in English, write in English. When in doubt, ask the user which language to use. Templates are in English — translate headers and content to match.
When to use
Roadmap is defined by trajectory complexity, not by duration. Use this skill when 2+ apply:
- Multiple initiatives/phases need sequencing (can't all run in parallel)
- Decisions today affect future decisions (local optimization can become tech debt)
- Stakeholders need to see the whole journey before approving individual steps
- External dependencies (other teams, vendors, deadlines)
- Total complexity exceeds what fits in a single epic
A 4-week initiative with 5 sequenced phases also benefits from a roadmap — don't dismiss it as "too short".
When NOT to use
- Isolated, self-contained initiative (single epic covers it)
- Single epic with no ramifications — go straight to
- Team already has the trajectory clear in mind and no stakeholder needs the map
Scope (types of roadmap)
- Trajectory roadmap: multi-phase initiative with dependencies between phases (any duration)
- Initiative roadmap: phases, stories, unblocks, and delivery order for a named initiative
- Quarterly roadmap: direction alignment, period objectives, and macro priorities (one specific type — not the only one)
Operating rules
- Roadmap must focus on results and capabilities, not extensive technical lists.
- Every roadmap item must indicate expected value, dependencies, and progress signal.
- The roadmap must show what is a commitment, what is a risk, and what is outside the period.
- Whenever possible, each initiative should point to a corresponding epic.
How to build a trajectory roadmap (default)
- Declare the overarching objective of the journey.
- List 2-5 phases or initiatives (sequenced or parallel).
- Order by dependency and value — make sequencing explicit.
- For each phase: expected outcome, dependencies, progress signal, risks.
- Register what is a commitment, what is a risk, and what is out of scope.
- Validate that the narrative is observable and stakeholder-ready.
How to build a quarterly roadmap (specific type)
Same as above, with period objective (quarter) as the time boundary.
Use when stakeholders expect a period-based view (common for product/exec audiences).
How to build a roadmap by epic
- Declare the epic objective.
- Define phases or delivery waves.
- Relate stories by phase.
- Make unblocks, risks, and intermediate validations explicit.
- Confirm that the roadmap guides execution without replacing plans.
Where to save
- Initiative/trajectory roadmap:
planning/<initiative>/roadmap.md
- Quarterly roadmap:
planning/roadmaps/Q<N>-YYYY.md
Collaborative work
When the team has 2+ developers, the roadmap should:
- Identify parallel tracks (e.g., Backend, Frontend, AI Engineering) so devs can work simultaneously
- Define interface contracts between tracks to minimize blocking
- Show which stories/phases can run in parallel in the timeline
- Ask about team size and composition during roadmap creation
Chaining
At the end of the roadmap, offer
only :
- "Do you want me to run to decompose the first initiative into stories?"
Important: The roadmap identifies initiatives at a macro level. Each initiative should be decomposed via
before execution.
Template
Use
~/.agents/templates/roadmap.md
as base.
Relationship with the flow
mermaid
flowchart LR
A["/agile-intake"] --> B["/agile-roadmap"]
B --> C["/agile-epic"]
C --> D["/agile-story"]
D --> E[execution]
E --> F["/agile-status"]
This skill connects strategy and execution. For decomposition, use
. For execution planning, use
.