devils-advocate
Devil's Advocate Review
Critically examine a slide deck and challenge its design with 5-7 specific pedagogical questions.
Philosophy: "We arrive at the best possible presentation through active dialogue."
Setup
- Read the target file (the lecture being challenged)
- Read the knowledge base in
.claude/rules/for notation conventions and narrative arc - If applicable, read adjacent lectures for narrative continuity
Challenge Categories
Generate 5-7 challenges from these categories:
1. Ordering Challenges
"Could students understand this better if we showed X before Y?"
2. Prerequisite Challenges
"Do students have the background for this notation at this point?"
3. Gap Challenges
"Should we include an intuitive example before this formal proof?"
4. Alternative Presentation Challenges
"Here are 2 other ways to visualize/present this concept."
5. Notation Conflict Challenges
"This symbol conflicts with earlier lecture usage."
6. Cognitive Load Challenges
"This slide has too many new symbols. Can we split?"
7. Book Vision Challenges
"If this becomes a book chapter, does this section stand alone?"
Output Format
# Devil's Advocate: [Lecture Title]
## Challenges
### Challenge 1: [Category] — [Short title]
**Question:** [The specific pedagogical question]
**Why it matters:** [What could go wrong]
**Suggested resolution:** [Specific action]
**Slides affected:** [Numbers or titles]
**Severity:** [High / Medium / Low]
[Repeat for 5-7 challenges]
## Summary Verdict
**Strengths:** [2-3 things done well]
**Critical changes:** [0-2 changes before teaching]
**Suggested improvements:** [2-3 nice-to-have changes]
Principles
- Be specific: Reference exact slides and notation
- Be constructive: Every challenge has a suggested resolution
- Be honest: If the deck is good, say so
- Prioritize: Notation conflicts > missed metaphors
- Think like a student: Where do they get lost?
More from pedrohcgs/claude-code-my-workflow
data-analysis
End-to-end R data analysis pipeline — exploration → cleaning → regression → publication-ready tables and figures. Use when user says "analyze this dataset", "run a regression on X", "explore this CSV", "full analysis workflow", "get me summary stats and a regression", or points at a `.csv`/`.rds`/`.dta` and asks for empirical results. Produces numbered R scripts in `scripts/R/` and outputs to `scripts/R/_outputs/`.
27proofread
Read-only proofreading pass over lecture `.tex` or `.qmd` files. Checks grammar, typos, overflow, terminology consistency, and academic writing quality; produces a report without editing. Use when user says "proofread", "check for typos", "look for grammar issues", "copy-edit this", "any writing errors?", or before a lecture release.
27create-lecture
Create a new Beamer lecture `.tex` from source papers and materials, with notation consistency checks and the project's preamble wired in. Use when user says "create a lecture on X", "new lecture from these papers", "start a deck on topic Y", "scaffold a new Beamer file", "build me a lecture from these PDFs". Scaffolds the full deck — NOT for compiling existing `.tex` (use `/compile-latex`).
27review-paper
Comprehensive manuscript review covering argument structure, econometric specification, citation completeness, and potential referee objections
25lit-review
Structured literature search + synthesis with citation extraction, thematic clustering, and gap identification. Use when user says "find papers on X", "do a lit review", "what's the literature on...", "summarize what we know about...", "where's the gap in this field", "review recent work on Y". Produces a written review with BibTeX-ready citations. Uses WebSearch/WebFetch for recent work.
24pedagogy-review
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.
23