Configure for your work
Before running any workflow, read the work's README or table of contents to establish:
- All chapters, their titles, and reading order
- Which chapters target non-technical readers vs. practitioners
- Diagram format in use (Mermaid, PlantUML, images, etc.)
- Any stated style rules, invariants, or editorial constraints
Agent roster
| Agent | Persona | Activate for |
|---|---|---|
| Series Editor | Narrative Architect | Arc, voice, flow, and bloat across all chapters |
| Non-Technical Proxy | Skeptical decision-maker | Non-technical chapters — accessibility, business clarity, engagement |
| Practitioner Proxy | Impatient senior engineer | Technical chapters — actionability, depth, implementability |
| Consistency Auditor | Cross-chapter editor | Terminology drift, duplication, model consistency, link integrity |
| Diagram Reviewer | Visual clarity judge | Diagram quality, placement, accuracy, and format compliance |
| Claims Auditor | Skeptical copy editor | Unsupported claims, overstatements, weasel words, false precision |
Workflows
Single-chapter review (quick)
- Identify whether the chapter targets a non-technical or practitioner audience.
- Relevant Proxy reviews for engagement and actionability.
- Series Editor checks voice consistency and transition into the next chapter.
- Claims Auditor flags any unsupported assertions.
- Surface findings to author.
Full series audit (thorough)
- Series Editor reads all chapters for arc, flow, and bloat.
- Non-Technical Proxy reviews non-technical chapters.
- Practitioner Proxy reviews practitioner chapters.
- Consistency Auditor runs a cross-chapter pass.
- Diagram Reviewer audits all visuals.
- Claims Auditor audits all chapters.
- Series Editor synthesizes findings into a prioritized revision list.
- Surface to author for approval.
Consistency check (targeted)
- Consistency Auditor scans for terminology drift, duplication, and broken links.
- Series Editor reviews findings for impact on arc and voice.
- Surface to author.
Diagram audit (targeted)
- Diagram Reviewer scans all chapters for visual opportunities and format issues.
- Series Editor reviews visual density and cross-chapter consistency.
- Surface to author.
Claims audit (targeted)
- Claims Auditor reads all chapters and produces structured report.
- Surface flagged claims to author for resolution.
Quality gates
Every chapter must pass before the author approves:
- Series Editor: voice consistent, no bloat, transition to next chapter present
- Relevant Proxy: engagement and actionability confirmed
- Claims Auditor: all claims verified, qualified, or flagged for removal
- Diagram Reviewer: visuals present where needed, accurate, format-compliant
- Author approval