book-team
v1.0.0-alpha.1
Published
A collaborative AI agent framework for book writing - from outlining to editing
Maintainers
Readme
Book Team
A collaborative AI agent framework for book writing - from outlining to editing.
Overview
Book Team provides a set of specialized AI agents that help you through every stage of writing a book, whether fiction or non-fiction. Each agent is an expert in their domain, from story structure to character development to line editing.
Installation
Book Team is available on NPM. No installation required - just run it directly in your book project directory:
npx book-team@latest installOr install globally:
npm install -g book-team
book-team installThe installer will:
- Ask for your name and book configuration
- Create
.bookteam/directory with agents and workflows - Set up
book-content/directory structure (manuscript, outlines, characters, research) - Generate initial project-overview.md for project tracking
- Install Claude Code integration
Directory Structure Created
your-book-project/
.bookteam/ # Book Team installation
_cfg/ # Configuration (preserved on updates)
core/ # Core framework
book-writing/ # Book writing module with agents
.claude/commands/ # Claude Code commands
bookteam/
book-manager.md # Launch book manager
story-architect.md # Launch story architect
character-developer.md # Launch character developer
writer.md # Launch writing assistant
book-content/ # Your book content
manuscript/ # Written chapters
outlines/ # Story/chapter outlines
characters/ # Character profiles (fiction)
research/ # Research notes (non-fiction)
project-overview.md # Project details and trackingThe Team
Universal Agents (Fiction & Non-Fiction)
=� Morgan - Book Project Manager
- Project initialization and planning
- Progress tracking and milestones
- Guidance through the writing process
= Sam - Developmental Editor
- Big-picture structural editing
- Plot/argument analysis
- Pacing and theme consistency
Riley - Line Editor
- Sentence-level prose improvement
- Voice and flow enhancement
- Show-don't-tell conversion
=� Casey - Writing Assistant
- Scene and chapter writing
- Prose composition from outlines
- Dialogue and description
Fiction-Specific Agents
=� Alex - Story Architect
- Story structure frameworks (Save the Cat, Hero's Journey, Three-Act)
- Beat sheets and plot outlines
- Scene sequences and pacing analysis
<� Jordan - Character Developer
- Character profiles and arcs
- Relationships and dynamics
- Voice and backstory development
Non-Fiction Specific Agents
- =� Taylor - Structure Consultant
- Book structure selection (How-To, Problem-Solution, Narrative)
- Chapter organization
- Content architecture
Quick Start
For Fiction Writers
Start your project:
/bookteam:book-writing:agents:book-managerRun:
*start-book-projectCreate your story structure:
/bookteam:book-writing:agents:story-architectRun:
*save-the-cat-outline(or other framework options)Develop your protagonist:
/bookteam:book-writing:agents:character-developerRun:
*create-protagonistStart writing scenes:
/bookteam:book-writing:agents:writerRun:
*write-fiction-scene
For Non-Fiction Writers
Start your project:
/bookteam:book-writing:agents:book-managerRun:
*start-book-projectChoose your structure:
/bookteam:book-writing:agents:structure-consultantRun:
*choose-nonfiction-structureCreate chapter outlines:
/bookteam:book-writing:agents:structure-consultantRun:
*chapter-breakdownStart writing:
/bookteam:book-writing:agents:writerRun:
*write-nonfiction-chapter
Workflows
Agents provide specialized workflows accessed through their menu systems:
Fiction Workflows
- Story Structure: Save the Cat (15 beats), Hero's Journey (12 steps), Three-Act Structure
- Character Development: Protagonist profiles, character arcs, relationships
- Scene Writing: Individual scenes, dialogue, opening pages
- Editing: Developmental edits, line edits, pacing analysis
Non-Fiction Workflows
- Structure: How-To, Problem-Solution, Narrative frameworks
- Organization: Chapter breakdowns, content outlines
- Writing: Chapter drafting, section writing
- Editing: Argument analysis, clarity improvements
Architecture
Book Team is built on a modular agent framework:
.bookteam/
�� core/ # Core framework
�� config.yaml # Global configuration
�� tasks/ # Workflow execution engine
�� book-writing/ # Book writing module
�� agents/ # 7 specialized agents
�� workflows/ # Guided writing workflows
�� config.yaml # Module configurationOutput Structure
Book Team organizes your content:
book-content/
�� manuscript/ # Your written chapters
�� outlines/ # Story/chapter outlines
�� characters/ # Character profiles (fiction)
�� research/ # Research notes (non-fiction)
�� project-overview.md # Project detailsStory Structure Frameworks
Save the Cat (15 Beats)
The most prescriptive framework, perfect for genre fiction. Based on Blake Snyder's screenplay method.
Key Beats: Opening Image, Catalyst, Break Into Two, Midpoint, All Is Lost, Break Into Three, Finale, Final Image
Hero's Journey (12 Steps)
Joseph Campbell's archetypal structure, great for quest narratives and transformation stories.
Key Steps: Ordinary World, Call to Adventure, Refusal, Meeting the Mentor, Crossing the Threshold, Tests, Ordeal, Reward, The Road Back, Resurrection, Return with Elixir
Three-Act Structure
Classic dramatic structure, flexible and intuitive.
Acts: Setup (25%), Confrontation (50%), Resolution (25%)
Editing Stages
Book Team follows professional editing industry standards:
- Developmental Editing - Structure, plot, character arcs, themes
- Line Editing - Sentence-level craft, voice, flow
- Copy Editing - Grammar, consistency, technical accuracy (future)
- Proofreading - Final polish (future)
Development
Prerequisites
- Node.js 18+
- npm
Install Dependencies
npm installProject Structure
BookTeam/
�� src/ # Source files for installation
�� core/ # Core framework
�� modules/
�� book-writing/ # Book writing module
�� tools/ # CLI and installer
�� book-team-npx-wrapper.js
�� cli/
�� book-team-cli.js
�� commands/ # CLI commands
�� installers/ # Installation logic
�� package.jsonLicense
MIT
Author
Created by FortLee.AI
Contributing
Issues and pull requests welcome!
