Learning Roadmap Builder

# Learning Roadmap Builder

Research a skill or topic, identify prerequisites, curate the best resources, and generate a structured week-by-week study plan.

## When to Use

- "Create a roadmap to learn {skill}"
- "How should I learn machine learning from scratch?"
- "Build me a 3-month plan to learn Rust"

## Requirements

- **Brave Search MCP** for resource curation and topic research

## Workflow

### Step 1 — Define Learning Goal

- **Topic/skill** (e.g., "Kubernetes", "data science", "Spanish")
- **Current level** (complete beginner, some exposure, intermediate)
- **Goal** ("deploy apps to k8s", "pass AWS cert", "conversational fluency")
- **Time commitment** (hours per week)
- **Timeline** (4 weeks, 3 months, 6 months)
- **Learning style preference** (video, reading, hands-on projects, courses)
- **Budget** (free only, or $ for paid courses)

### Step 2 — Research Topic Structure

```
brave_web_search: "{TOPIC} learning roadmap {YEAR} beginner to advanced"
brave_web_search: "best {TOPIC} resources free courses tutorials {YEAR}"
brave_web_search: "{TOPIC} prerequisites what to learn first"
brave_web_search: "{TOPIC} common mistakes beginners learning"
```

### Step 3 — Map Prerequisites

```markdown
## Prerequisites Map

{TOPIC}
├── Prerequisite 1: {skill} — {your level: ✅ Ready / 🟡 Review / 🔴 Learn first}
├── Prerequisite 2: {skill} — {status}
└── Prerequisite 3: {skill} — {status}

### Gap Analysis
- You need to cover: {list of gaps}
- Estimated catch-up time: {X} weeks
```

### Step 4 — Curate Resources

```markdown
## Recommended Resources

### 🎓 Courses
| Resource | Type | Cost | Level | Why |
|----------|------|------|-------|-----|
| {Course 1} | Video | Free | Beginner | {reason} |
| {Course 2} | Interactive | $X/mo | Intermediate | {reason} |

### 📚 Books
| Book | Level | Why |
|------|-------|-----|
| {Book 1} | Beginner | {reason} |

### 🔧 Practice Platforms
| Platform | Type | Why |
|----------|------|-----|
| {Platform 1} | Exercises | {reason} |
```

### Step 5 — Generate Week-by-Week Plan

```markdown
# Learning Roadmap: {TOPIC}
📅 Duration: {N} weeks | ⏱️ {X} hours/week | 🎯 Goal: {GOAL}

## Phase 1: Foundations (Weeks 1-{N})

### Week 1: {Topic}
- [ ] {Resource}: Complete chapters/sections {X-Y} (~{N}h)
- [ ] {Hands-on}: {Specific exercise or mini-project}
- [ ] {Checkpoint}: Can you {specific skill test}?

### Week 2: {Topic}
- [ ] {Resource}: {Specific sections} (~{N}h)
- [ ] {Hands-on}: {Exercise}
- [ ] {Checkpoint}: {Skill test}

## Phase 2: Intermediate (Weeks {N}-{M})
...

## Phase 3: Applied (Weeks {M}-{End})
...

### 🎯 Final Milestone
- Build: {Capstone project description}
- Prove: {How to verify you've reached the goal}
```

### Step 6 — Save Roadmap

```bash
mkdir -p outputs/learning
cat > "outputs/learning/roadmap-{TOPIC}-{DATE}.md" << 'EOF'
{ROADMAP}
EOF
```

## Important Rules

- Only recommend resources that exist — verify via Brave Search
- Include free options for every paid recommendation
- Adjust pace to user's time commitment — don't overload
- Include checkpoints to verify understanding before moving on
- Recommend projects over passive consumption

## Example Prompts

- "Build me a 3-month plan to learn Kubernetes"
- "How do I go from Python beginner to building web apps?"
- "Create a study roadmap for the AWS Solutions Architect cert"