pedagogy-review

name	pedagogy-review
description	Run holistic pedagogical review on academic slides and educational documents. Checks narrative arc, student prerequisites, worked examples, notation clarity, and deck pacing. Supports .tex, .qmd, and .typ slide decks.
argument-hint	[QMD or TEX filename]
allowed-tools	["Read","Grep","Glob","Write","Task"]

Pedagogical Review of Slides and Educational Documents

Perform a comprehensive pedagogical review. Supports Beamer (.tex), Quarto (.qmd), and Typst (.typ) slide decks.

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:

   • Patterns followed vs violated (out of 13)
   • Deck-level assessments
   • Critical recommendations (top 3-5)

Important Notes

• This is a read-only review — no files are edited
• Focuses on pedagogy not visual layout (use /visual-audit for that)
• For a combined review, use /slide-excellence instead