Review Draft
Comprehensive writing review using specialized critics.
Arguments
Parse from provided arguments:
- •File path: First non-flag argument (required)
- •--critics=: Comma-separated list of critics to run (default: all four)
- •
clarity- Sentence-level readability - •
narrative- Structure and argument flow - •
facts- Claim verification and citations - •
redteam- Counterexamples and objections
- •
- •--sensitivity=:
conservative|balanced|aggressive(default: balanced)
Workflow
- •Parse arguments from above
- •Validate file exists - error if not found
- •Ask for target audience using AskUserQuestion (required for all critics)
- •Create feedback directory - ensure
feedback/exists in draft's directory - •Dispatch selected critics in parallel using Task tool
- •Summarize - report completion and highlight top issue from each
Agent Dispatch
Launch agents in parallel using Task tool with these prompts:
| Critic | subagent_type | Output File |
|---|---|---|
| clarity | clarity-critic | feedback/{name}_clarity.md |
| narrative | narrative-critic | feedback/{name}_narrative.md |
| facts | fact-checker | feedback/{name}_facts.md |
| redteam | red-team | feedback/{name}_redteam.md |
Where {name} is the draft filename without extension.
Agent prompt template:
code
Review the draft at {file_path} for {audience}.
Sensitivity: {sensitivity}
Write feedback to feedback/{name}_{type}.md
Post-Review Summary
code
## Review Complete
Feedback written to `feedback/`:
{list files created}
**Start with**: {most impactful issue from any critic}
Error Handling
| Scenario | Response |
|---|---|
| File not found | Error with clear message |
| Empty file | "Nothing to review" |
| >5000 words | Proceed with truncation warning |
feedback/ missing | Create it |
| Agent fails | Report failure, continue with others |
Examples
code
/review-draft paper.md # All 4 critics /review-draft paper.md --critics=clarity # Just clarity /review-draft paper.md --critics=clarity,facts # Clarity + facts /review-draft paper.md --sensitivity=aggressive # Stricter review