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
• runningexamplesteps

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