The human-authored scope: theory-first, mid-level depth, Markdown workflows, HTML chapter subpages.
run-playbook dispatches agents in waves and tracks state on a shared to-do board.
Installs the gh aw CLI extension so the real command surface and frontmatter schema can be inspected and examples can be compiled.
Wave 0 — Design & scaffold
Turns the brief into toc.yml + outline.
Scaffolds the HTML shell + navigation.
Waves 1…N — per chapter group
Inspects the real gh aw CLI + frontmatter schema — no hallucinated syntax.
Gathers concepts from the gh-aw docs.
Fills the HTML slots and writes compilable example workflows.
Compiles every example with gh aw compile — must compile clean with no secrets.
Verdict: ACCEPT or REVISE with concrete fixes.
Each completed wave is committed, keeping a clean, auditable history.
Cross-chapter check of navigation, terminology, progression, and syntax consistency.
Verified chapters served as an interactive HTML site. Open it →
The actors (primitives)
🧭 Orchestrator prompt
The driver that runs the whole fleet in waves and tracks progress.
🏛️ Architect agent
Designs the table of contents and chapter outline from the brief.
📚 Theory researcher agent
Explains concepts grounded in the gh-aw documentation.
🔍 gh-aw explorer agent
Inspects the real gh aw CLI and frontmatter schema for the exact, real surface.
✍️ Chapter author agent
Writes chapter prose and example code into the page slots.
✅ Code verifier agent
Compiles every example until it provably compiles clean — no secrets required.
🧐 Chapter reviewer agent
Critiques for accuracy and consistency; routes fixes back to the author.
🎨 Frontend builder agent
Scaffolds and finalizes the HTML shell, navigation, and styling.
⚙️ Environment setup skill
Reproducible recipe to install the gh aw CLI extension and verify it.
🧱 Content & code rules instructions
Auto-applied conventions every chapter and example must follow.