scriptorium

Reference guide for the EPUB build pipeline toolchain. Use when: understanding what external tools are needed, asking why Mermaid or code blocks are rendered the way they are, troubleshooting EPUB rendering issues, or deciding whether to install mmdc. Covers mmdc, Puppeteer, highlight.js, and Node.js built-ins — what each tool does, what problem it solves, and when it is required vs optional.

Full specification for all 12 agents in the scriptorium framework. Use when: asking what a specific agent does, writing a prompt to invoke an agent, configuring file pointers for an agent, understanding agent personas, asking about the Orchestrator/Architect/Researcher/Writer/ Reviewer roles, or troubleshooting unexpected agent output. Includes persona, model type, inputs, outputs, example invocation prompts, and key constraints for each agent.

Guide for the scriptorium multi-agent framework for writing technical books about open-source source code. Use when: starting a new book writing project, understanding the system architecture, asking what scriptorium is or does, deciding which agent or phase to use, getting a quick-start setup guide, or understanding the hub-spoke design and file pointer mechanism.

Reference guide for filling in all 8 scriptorium project templates: source-map, outline, style-guide, glossary, metaphor-registry, chapter-summary, checkpoint, and audit-log. Use when: setting up a new book project, filling out any template file, asking what goes in a specific template field, creating project configuration for a new technical book topic, or understanding the role of each shared resource file.

Step-by-step execution guide for the scriptorium 5-phase book production pipeline. Use when: running any phase (1 through 5), orchestrating chapter production, managing parallel review steps (R1+R2+R3 simultaneous), handling recovery after interruption, understanding completion markers, debugging a stalled pipeline, or knowing the exact file inputs and outputs for each step. Covers DAG dependency management and the chapter batch parallelization strategy.