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

Parse $ARGUMENTS for the filename, resolve path
Detect format from extension
Launch all applicable agents in parallel per dispatch table
Collect all reports from quality_reports/
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.

excellence