---
name: curriculum-planner
description: |
  Generates sequences of high-leverage tasks that increase understanding and improve the code. Use when:
  - "what should I work on next?" - suggests prioritized tasks
  - "create a plan for this repo" - generates a curriculum
  - "what's the roadmap?" - shows curriculum overview
  - "help me onboard to this codebase" - creates learning tasks
  - "plan a refactor" - structures improvement work
  - "prioritize these features" - organizes work into tracks
  - "make an onboarding plan" - creates a learning path
  - "create a learning path for this repo" - sequences learning tasks
  - "roadmap this refactor" - plans improvement work
  - "write the curriculum to disk" - persists plan artifacts
allowed-tools:
  - Read
  - Grep
  - Glob
  - Bash
---

# Repo Curriculum Planner

Generates structured learning/improvement plans based on repo state and session brain.

## Two Usage Modes

### Mode 1: Propose in Chat (default)

When a user asks for planning help, **propose tasks directly in the conversation** without writing files. This is the default behavior for quick suggestions.

Examples:
- "what should I work on next?" → Suggest 2-3 high-priority tasks in chat
- "what's the roadmap?" → Describe the plan conversationally
- "help me prioritize" → Discuss tradeoffs and recommend order

### Mode 2: Write Artifacts to Disk

Only write to `.claude/voyager/` when the user **explicitly asks** to persist the plan:
- "write the curriculum to disk"
- "save this plan"
- "generate curriculum files"
- "materialize the plan"

This writes:
- `.claude/voyager/curriculum.json` — structured task backlog
- `.claude/voyager/curriculum.md` — human-readable plan

## Trigger Phrases

Use this skill when you hear:
- "what should I work on next?"
- "create a plan"
- "what's the roadmap?"
- "help me onboard"
- "plan the work"
- "prioritize features"
- "what tasks remain?"
- "make an onboarding plan"
- "roadmap this refactor"

## On-Disk Plan Artifacts

When persisted, the plan lives at:
- `.claude/voyager/curriculum.json` — structured JSON with full task details
- `.claude/voyager/curriculum.md` — rendered Markdown for human review

To refresh an existing plan, run:
```bash
voyager curriculum plan
```

To preview without saving:
```bash
voyager curriculum plan --dry-run
```

## Task Structure

Each task includes:
- `id` — unique identifier (e.g., `t01`)
- `title` — short action-oriented title
- `why` — rationale for the task
- `estimated_scope` — `trivial`, `small`, `medium`, or `large`
- `acceptance_criteria` — how to know it's done
- `suggested_files` — where to look
- `commands_to_run` — verification commands
- `depends_on` — prerequisite task IDs
- `status` — `pending`, `in_progress`, `done`, or `blocked`

## Updating Task Status

Edit `curriculum.json` directly to update task status:
- Change `"status": "pending"` to `"in_progress"` when starting
- Change to `"done"` when complete

See `reference.md` for implementation details and schema reference.


---
Source attribution: zenbase-ai
Original project: https://github.com/zenbase-ai/code-voyager/blob/d8f18da12ea6ce0b9d85daf842be0732c5c33988/.claude/skills/curriculum-planner/SKILL.md
License: MIT
License information: https://opensource.org/license/mit
Original upstream instructions; downloaded from Dave AI.

## Upstream license notice

MIT License

Copyright (c) 2025 Zenbase AI

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.



# Dave AI resource metadata

Creator / publisher: zenbase-ai
Original project: https://github.com/zenbase-ai/code-voyager/blob/d8f18da12ea6ce0b9d85daf842be0732c5c33988/.claude/skills/curriculum-planner/SKILL.md
Attribution basis: Recovered original package and original project license at a pinned revision

Fields of work: Education & Research, Project & Program Management
Roles: Curriculum Designer, Project Manager, Tutor / Instructor
Specialties: Specialty not specified
Tools: Claude
Country applicability: Country not specified
Classification basis: Source catalog labels
Instruction SHA-256: 1f817a79d20b30e5801a5b3b7ad5789b48709f59c55912c697302ebd0a9f6aaf
Metadata reviewed: 2026-10-27
This metadata supersedes earlier Dave AI catalog attribution. Original instruction and supporting files are preserved.