Excellence Review

Run a comprehensive multi-dimensional review. Multiple agents analyze the file independently, then results are synthesized.

Format Detection

Determine file type from extension:

• .tex → Beamer LaTeX slides
• .qmd → Quarto RevealJS slides
• .typ → Typst document (slides, docs, guides, CVs)
• .py → Python script

For .typ files, also detect document type from content.

Agent Dispatch by File Type

For .tex files:

Agent	What It Checks	Report
document-auditor	Overflow, font consistency, spacing, images	[FILE]_visual_audit.md
pedagogy-reviewer	13 patterns, narrative, pacing, notation	[FILE]_pedagogy_report.md
proofreader	Grammar, typos, consistency, academic quality	[FILE]_report.md
diagram-reviewer	Label overlaps, geometric accuracy (only if TikZ present)	[FILE]_tikz_review.md
domain-reviewer	Field-specific substance (optional)	[FILE]_substance_review.md

For .qmd files:

Agent	What It Checks	Report
document-auditor	Overflow, font consistency, spacing, images	[FILE]_visual_audit.md
pedagogy-reviewer	13 patterns, narrative, pacing	[FILE]_pedagogy_report.md
proofreader	Grammar, typos, consistency	[FILE]_report.md
quality-critic	Adversarial comparison vs .tex (only if sibling exists)	[FILE]_parity_report.md

For .typ files:

Agent	What It Checks	Report
typst-reviewer	Compilation, smart defaults, component usage, visual routing	[FILE]_typst_review.md
document-auditor	Overflow, typography, component fatigue, spacing	[FILE]_visual_audit.md
proofreader	Grammar, typos, consistency	[FILE]_report.md
pedagogy-reviewer	Narrative, pacing, notation (only if slides detected)	[FILE]_pedagogy_report.md

For .py files:

Agent	What It Checks	Report
python-pro (subagent)	Code quality, style, type safety, patterns	[FILE]_python_review.md
domain-reviewer	Field-specific correctness (optional)	[FILE]_substance_review.md

Steps

1. Parse $ARGUMENTS for the filename, resolve path
2. Detect format from extension
3. Launch all applicable agents in parallel per dispatch table
4. Collect all reports from quality_reports/
5. Synthesize combined summary

Combined Summary Format

# Excellence Review: [Filename]

## Overall Quality Score: [EXCELLENT / GOOD / NEEDS WORK / POOR]

| Dimension | Agent | Critical | Major | Minor |
|-----------|-------|----------|-------|-------|
| Visual/Layout | [auditor] | N | N | N |
| Content Quality | [reviewer] | N | N | N |
| Proofreading | proofreader | N | N | N |
| [Additional] | [agent] | N | N | N |

### Critical Issues (Immediate Action Required)
### Major Issues (Next Revision)
### Recommended Next Steps

Quality Score Rubric

See typst/references/quality-gates.md for the authoritative score rubric and severity definitions.