Concept Graph (prerequisites)
Goal: represent tutorial concepts as a prerequisite DAG so modules can be planned and ordered.
Inputs
- output/TUTORIAL_SPEC.md
Outputs
- outline/concept_graph.yml
Output schema (recommended)
A minimal, readable YAML schema:
-
nodes : list of {id, title, summary}
-
edges : list of {from, to} meaning from is a prerequisite of to
Constraints:
-
Graph should be acyclic (DAG).
-
Prefer 10–30 nodes for a medium tutorial.
Workflow
-
Read output/TUTORIAL_SPEC.md and extract the concept list implied by objectives + running example.
-
Normalize each concept into a node with a stable id .
-
Add prerequisite edges and verify the graph is acyclic.
-
Write outline/concept_graph.yml .
Definition of Done
-
outline/concept_graph.yml exists and is a DAG.
-
Nodes cover all learning objectives from output/TUTORIAL_SPEC.md .
-
Node titles are specific (not “misc”).
Troubleshooting
Issue: the graph looks like a linear list
Fix:
- Add intermediate prerequisites explicitly (e.g., “data model” before “evaluation protocol”).
Issue: cycles appear (A → B → A)
Fix:
- Split concepts or redefine edges so prerequisites flow in one direction.