mcpField
M
module-planner

module-planner

github.com/willoscarProductivity51741 installsUpdated 3w ago
Repository

About module-planner

module-planner turns a concept graph into an ordered, teachable module plan for later tutorial stages. It specifies objectives, outputs, and running-example steps for each module.

Key features

  1. 01Orders concepts by dependency
  2. 02Groups concepts into modules
  3. 03Sets measurable module objectives
  4. 04Defines outputs and example steps

Use cases

  1. 01Plan tutorial modules from an existing concept graph
  2. 02Create a module plan for later tutorial stages

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/willoscar/research-units-pipeline-skills --skill module-planner

After installing, type/module-plannerin Claude Code to confirm it loaded.

Bundled filesscripts/run.py

Details

From the project README

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

Comments

Markdown supported