Concept Graph (prerequisites)

Inputs

• output/TUTORIAL_SPEC.md

Outputs

• outline/concept_graph.yml

Output schema (recommended)

• nodes

  : list of

  {id, title, summary}

• edges

  : list of

  {from, to}

  meaning

  from

  is a prerequisite of

  to

• Graph should be acyclic (DAG).
• Prefer 10–30 nodes for a medium tutorial.

Workflow

1. Read

   output/TUTORIAL_SPEC.md

   and extract the concept list implied by objectives + running example.
2. Normalize each concept into a node with a stable

   id

   .
3. Add prerequisite edges and verify the graph is acyclic.
4. 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

• Add intermediate prerequisites explicitly (e.g., “data model” before “evaluation protocol”).

Issue: cycles appear (A → B → A)

• Split concepts or redefine edges so prerequisites flow in one direction.