The Project
Archon is an open-source harness-building system for AI coding agents with 21k+ GitHub stars. The project needed an onboarding guide that could help new users get productive quickly. I wrote the Book of Archon — a 10-chapter guide that was submitted via PR, accepted by the maintainers, and now serves as the project’s official user guide.What I Delivered
1. 10-Chapter Onboarding Guide
User guide covering installation through advanced agent configuration. Structured to get users productive quickly while providing depth for advanced use cases. Result: archon.diy2. Adversarial Quality Workflow
Built this documentation using a custom Writer Agent vs. Attacker Agent pipeline:- The Attacker Agent challenged every factual claim
- The Writer Agent had to defend or revise
- Quality gates set at 7/10+ before content could advance
10 Chapters
Complete onboarding guide accepted as the project’s official documentation.
Adversarial QA
Writer vs. Attacker workflow with 7/10+ quality gates. Every claim tested.
20k+ Stars
Official docs for a major open source project.
Merged via PR
Submitted, reviewed, and accepted by the Archon maintainers.
The Methodology
For the Book of Archon, I developed a full methodology for AI-assisted documentation production. The approach:- Human writes the PRD — detailed spec with structure, voice, terminology, acceptance criteria
- Workflow executes against spec — 31-node Directed Acyclic Graph (DAG) with per-chapter validation gates
- AI drafts each section — consistent execution against the blueprint
- Human edits and approves — judgment, polish, nuance
The same approach works for other large documentation projects. Constrain the AI with detailed specs, then let it generate against those constraints.
Tech Stack
Claude Agents SDK · YAML Workflows · Pydantic AI · Markdown · Git/GitHub