---
name: willoscar/module-planner
source: https://app.decimal.ai/s/willoscar-module-planner@1/SKILL.md
source_sha256: b533adeaa9a0
---

# Module Planner

Turns the concept graph into the teachable module sequence used by later tutorial stages.

## Input

- `outline/concept_graph.yml`

## Output

- `outline/module_plan.yml`

## Contract

The module plan must define:
- ordered `modules`
- `id`, `title`
- `objectives`
- `concepts`
- `outputs`
- `running_example_steps`

## Script boundary

`scripts/run.py` should:
- topologically order concepts
- cluster them into coherent modules
- attach measurable objectives and concrete outputs

Keep graph traversal and clustering heuristics in shared tutorial tooling, not in the wrapper script.

## Acceptance

- `outline/module_plan.yml` exists
- every concept node is covered by at least one module
- every module has objectives and outputs

## Non-goals

- source grounding audit
- exercise writing
- tutorial drafting