# Module Planner

> Use when a tutorial concept DAG exists and the run needs an ordered teaching plan with objectives and outputs.

- Skill: `willoscar/module-planner` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add willoscar/module-planner`
- Raw SKILL.md: https://api.skillmd.com/api/skills/willoscar/module-planner/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: WILLOSCAR (https://skillmd.com/u/willoscar)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/willoscar/module-planner

---


# Module Planner

## Triggers & routing

- **Trigger**: module plan, tutorial modules, course outline, 模块规划, module_plan.yml.
- **Use when**: tutorial 的 C2，已有 `outline/concept_graph.yml`，需要把 concept DAG 收敛成模块顺序。
- **Skip if**: 还没有 concept graph。
- **Network**: none.
- **Guardrail**: 每个模块都要有 objectives、outputs、running-example step；不要写长 prose。


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