Claude Book

Claude Book Framework

A multi-agent framework for writing novels with Claude Code.

Structure

Workflow

1. Setup: Fill in bible/ with your style guide, characters, and locations
2. Plan: Write story/synopsis.md and story/plan.md
3. Initialize: Set initial state in state/template/, create symlink state/current/
4. Generate: Run orchestrator - it will:
   - Plan chapter beats (planner agent)
   - Write chapter (writer agent)
   - Run perplexity-improver to reduce cliches and AI patterns
   - Lint style (style-linter agent)
   - Review characters (character-reviewer agent)
   - Review continuity (continuity-reviewer agent)
   - Loop if issues found (max 3 iterations)
   - Update state files (create state/chapter-NN/, update symlink)
   - Append to timeline/history.md
   - Save final chapter
5. Export: Generate ebook with ebook/build-ebook.ps1

Key principles

- bible/ is read-only during generation
- state/ is versioned per chapter (state/chapter-NN/), symlink current/ points to latest
- timeline/history.md is append-only
- All agents output in .work/ for review
- Gates must pass before proceeding

Agents

Agent definitions are in .claude/agents/. Each agent has:
- YAML frontmatter (name, description, model, tools)
- Detailed instructions for its role

The orchestrator (CLAUDE.md) invokes these agents automatically.

Perplexity Improver

Reduces cliches and AI-detectable patterns by rewriting low-perplexity sentences.

Prerequisites:
- NVIDIA GPU with CUDA support (~16 GB VRAM recommended)
- uv (Python package manager)
- Default model: Ministral-3-8B

- Analyzes text using a local language model
- Identifies "suspect" sentences (too predictable)
- Rewrites them while preserving meaning
- Note: Analysis is slow (several minutes for model loading)

Use after writing a…