task icon Task

Visualize Roadmap

Requirements
Existing roadmap content (paste, describe, or reference session file). Optional: diagram style preference (Gantt, timeline, or flowchart).
2

Gather the roadmap content to visualize:

If user hasn't provided roadmap details, ask for:

  • Strategic themes (3-5 major areas)
  • Key initiatives per theme
  • Timeframe information (Now/Next/Later OR Q1/Q2/Q3/Q4 OR specific dates)
  • Any dependencies between initiatives

Clarify diagram type preference:

  • Gantt chart: Best for showing duration, dependencies, and parallel work streams
  • Timeline: Best for milestones and sequential events
  • Flowchart: Best for showing dependencies and decision points
3

Convert the roadmap into Mermaid diagram syntax.

FOR GANTT CHARTS (most common for roadmaps):

gantt
    title [Product/Team] Roadmap
    dateFormat YYYY-MM-DD
    section [Theme Name]
        [Initiative]: [status], [id], [start], [duration]

Status options: done, active, crit (critical path)
Use "after [id]" for dependencies

FOR TIMELINE (milestone-focused):

timeline
    title [Product] Roadmap
    section [Timeframe]
        [Date/Quarter] : [Milestone]

FOR NOW/NEXT/LATER (use flowchart):

flowchart LR
    subgraph Now
        A[Initiative 1]
        B[Initiative 2]
    end
    subgraph Next
        C[Initiative 3]
    end
    subgraph Later
        D[Initiative 4]
    end

Show the generated Mermaid code to user for review before rendering.

5

Confirm the diagram was saved successfully. Offer to:

  • Adjust the layout or styling
  • Add or remove initiatives
  • Create a different diagram type for the same roadmap
  • Export the Mermaid code for use in documentation
                    To run this task you must have the following required information:

> Existing roadmap content (paste, describe, or reference session file). Optional: diagram style preference (Gantt, timeline, or flowchart).

If you don't have all of this information, exit here and respond asking for any extra information you require, and instructions to run this task again with ALL required information.

---

You MUST use a todo list to complete these steps in order. Never move on to one step if you haven't completed the previous step. If you have multiple read steps in a row, read them all at once (in parallel).

Add all steps to your todo list now and begin executing.

## Steps

1. [Read Roadmap Guide]: Read the documentation in: `./skills/sauna/[skill_id]/references/product.roadmap.guide.md` (Understand roadmap structure for accurate visualization)

2. Gather the roadmap content to visualize:

If user hasn't provided roadmap details, ask for:
- Strategic themes (3-5 major areas)
- Key initiatives per theme
- Timeframe information (Now/Next/Later OR Q1/Q2/Q3/Q4 OR specific dates)
- Any dependencies between initiatives

Clarify diagram type preference:
- **Gantt chart**: Best for showing duration, dependencies, and parallel work streams
- **Timeline**: Best for milestones and sequential events
- **Flowchart**: Best for showing dependencies and decision points


3. Convert the roadmap into Mermaid diagram syntax.

FOR GANTT CHARTS (most common for roadmaps):
```
gantt
    title [Product/Team] Roadmap
    dateFormat YYYY-MM-DD
    section [Theme Name]
        [Initiative]: [status], [id], [start], [duration]
```

Status options: done, active, crit (critical path)
Use "after [id]" for dependencies

FOR TIMELINE (milestone-focused):
```
timeline
    title [Product] Roadmap
    section [Timeframe]
        [Date/Quarter] : [Milestone]
```

FOR NOW/NEXT/LATER (use flowchart):
```
flowchart LR
    subgraph Now
        A[Initiative 1]
        B[Initiative 2]
    end
    subgraph Next
        C[Initiative 3]
    end
    subgraph Later
        D[Initiative 4]
    end
```

Show the generated Mermaid code to user for review before rendering.


4. [Gather Requirements for Generate Mermaid Diagram] The next step has the following requirements: "Description of what to visualize OR raw Mermaid syntax. Optional: diagram type preference (flowchart, sequence, class, etc.), title for the diagram.". Search the user's data for this information or ask them directly if needed. Do not proceed until you have this information.

5. [Execute Generate Mermaid Diagram Task]: Spawn a subagent and provide it with the requirements gathered above and instructions to read `./skills/sauna/[skill_id]/references/recipes/media.mermaid.generate.md` for its task list

6. Confirm the diagram was saved successfully. Offer to:
- Adjust the layout or styling
- Add or remove initiatives
- Create a different diagram type for the same roadmap
- Export the Mermaid code for use in documentation