| name | pedagogy-review |
| description | Run holistic pedagogical review on lecture slides. Checks 13 patterns: narrative arc, notation density, pacing, motivation before formalism, worked examples, fragment reveals, box hierarchy. Use when the user asks for pedagogy or teaching-quality review of slides. |
Pedagogical Review of Lecture Slides
Review the deck for teaching quality. Read-only — produce a report, do not edit files.
13 patterns to validate
- Motivation before formalism — "Why?" before "What?"
- Incremental notation — avoid 5+ new symbols on one slide
- Worked example after every definition — within 2 slides
- Progressive complexity — simple → relative → distributional
- Fragment reveals for problem → solution (sparingly)
- Standout slides at conceptual pivots
- Two-slide strategy for dense theorems
- Semantic color usage (consistent meaning)
- Box hierarchy (definition vs highlight vs key result)
- Box fatigue — max 1–2 colored boxes per slide
- Socratic embedding — 2–3 questions per lecture
- Visual-first for complex concepts
- Two-column for definition comparisons where appropriate
Deck-level checks
- Narrative arc: clear beginning/middle/end
- Pacing: density and rhythm
- Notation: consistent symbols, no sudden new notation
- Prerequisites: reasonable for audience
Save report to quality_reports/[FILENAME]_pedagogy_report.md. Present: patterns followed vs violated, deck-level assessment, top 3–5 recommendations.
