pedagogy-review

name	pedagogy-review
description	Run a holistic narrative review on a Quarto report or Markdown document. Checks reader prerequisites, worked examples, notation clarity, structural arc, and pacing.
disable-model-invocation	true
argument-hint	[QMD or MD filename]
allowed-tools	["Read","Grep","Glob","Write","Task"]

Pedagogical Review of a Report or Document

Perform a holistic narrative review of a Quarto report (reports/*.qmd), a replication report (quality_reports/*.md), or any document where pedagogical clarity matters (audience comprehension, motivation, worked examples, notation discipline).

Steps

1. Identify the file specified in $ARGUMENTS

   • If no argument, ask the user which file to review
   • If just a name, look in reports/, then quality_reports/, then repo root

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

   • The agent checks the standard pedagogical patterns (motivation, prerequisites, worked examples, notation consistency, narrative arc, pacing)