module-planner

Plan tutorial modules from a concept graph, including module objectives and sequencing, saving as `outline/module_plan.yml`. **Trigger**: module plan, tutorial modules, course outline, 模块规划, module_plan.yml. **Use when**: tutorial pipeline 的结构阶段（C2），已有 `outline/concept_graph.yml`，需要把概念依赖转成可教学的模块序列。 **Skip if**: 还没有 concept graph（先跑 `concept-graph`）。 **Network**: none. **Guardrail**: 每模块明确 objectives + outputs（最好含 running example 步骤）；避免 prose 段落。

Stars 377

Forks 25

Install this agent skill to your Project

npx add-skill https://github.com/WILLOSCAR/research-units-pipeline-skills/tree/main/.codex/skills/module-planner

SKILL.md

Module Planner

Goal: turn a concept DAG into a teachable module sequence with clear objectives and outputs.

Inputs

outline/concept_graph.yml

Outputs

outline/module_plan.yml

Output schema (recommended)

modules: ordered list of modules
- id, title
- objectives (3–6 measurable bullets)
- concepts (node ids from outline/concept_graph.yml)
- outputs (what the learner produces)
- running_example_steps (optional but recommended)

Workflow

Read outline/concept_graph.yml and topologically sort concepts.
Cluster concepts into modules (keep module scope coherent; avoid “misc”).
For each module:
- write measurable objectives
- define concrete outputs (code/artifact)
- specify how the running example advances
Write outline/module_plan.yml.

Definition of Done

outline/module_plan.yml exists and modules are ordered by prerequisites.
Every module has objectives + outputs.
Every concept node from outline/concept_graph.yml is covered by at least one module.

Troubleshooting

Issue: modules are too many / too granular

Fix:

Merge adjacent modules with shared prerequisites; target ~5–12 modules for most tutorials.

Issue: objectives are not verifiable