create-roadmap

Create Roadmap

Plan what to build next. AI suggests items based on your goals and context, you refine and prioritize.

---

Purpose

• Transform vague goals into concrete BUILD items
• Prioritize by impact and dependencies
• Create a living document that guides your Nexus work

Output: 01-memory/roadmap.yaml

---

Pre-Execution

Load context for personalization:

from pathlib import Path

# Check for existing context
goals_path = Path("01-memory/goals.md")
context_path = Path("01-memory/input/_analysis/analysis-summary.md")

has_goals = goals_path.exists()
has_context = context_path.exists()

if has_goals:
    goals_content = goals_path.read_text()

if has_context:
    context_content = context_path.read_text()

---

Workflow

Step 1: Understand Current State

Display:

CREATE ROADMAP
----------------------------------------------------

Let's plan what you'll build.

I'll suggest items based on:
  [[OK]] Your goals (01-memory/goals.md)
  [[OK]/[FAIL]] Context analysis (if uploaded)
  [[OK]/[FAIL]] Existing builds

You decide:
  - What to include
  - Priority order
  - How many items

---

Step 2: Gather Preferences

Use AskUserQuestion:

Question 1: "How far ahead do you want to plan?"
Options:
- "Just the next step" - 1-2 items, immediate focus
- "This week/sprint" - 3-5 items, short-term
- "This month" - 5-8 items, medium-term
- "Full vision" - 8+ items, comprehensive

Question 2: "What matters most right now?" (multiSelect: true)
Options (DYNAMIC based on goals):
- "{Pain point 1 from goals}"
- "{Pain point 2 from goals}"
- "Quick wins - build momentum"
- "Foundation - set up properly first"
- "Revenue/results - prioritize impact"

---

Step 3: Generate Suggestions

AI generates roadmap items based on:

• User's goal from goals.md
• Context insights (if available)
• User's planning horizon preference
• User's priority preference

Item types:

Type	Description
BUILD	Finite work with deliverables
SKILL	Repeatable workflow to create
INTEGRATION	External tool to connect