pedagogy-review

name	pedagogy-review
description	Holistic pedagogical review of a lecture deck (`.qmd` or `.tex`). Checks narrative arc, prerequisite assumptions, worked examples, notation clarity, and deck-level pacing. Use when user says "pedagogy review", "does this teach well?", "is the flow right?", "will students follow?", "review the narrative", or before teaching a deck for the first time. Read-only; produces a report.
argument-hint	[QMD or TEX filename]
allowed-tools	["Read","Grep","Glob","Write","Task"]

Pedagogical Review of Lecture Slides

Perform a comprehensive pedagogical review.

Steps

1. Identify the file specified in $ARGUMENTS

   • If no argument, ask user which lecture to review
   • If just a name, look in Quarto/ or Slides/

2. Launch the pedagogy-reviewer agent with the full file path

   • The agent checks 13 pedagogical patterns
   • Performs deck-level analysis (narrative arc, pacing, visual rhythm, notation)
   • Considers student perspective (prerequisites, objections)

3. The agent produces a report saved to: quality_reports/[FILENAME_WITHOUT_EXT]_pedagogy_report.md

4. Present summary to user: