README

# ABITS Claude Code Commands

These slash commands make it easy to generate and edit chapters with any fresh Claude Code session.

## Available Commands

### `/make-draft`
**Generate a new chapter using AI models**

```bash
/make-draft

Claude will:

1. Ask which chapter to generate
2. Check for context file (.build/contexts/{chapter}.yaml)
3. Ask which generation mode (iteration/balanced/production)
4. Generate all 4 layers
5. Combine into readable draft
6. Show you the result

/edit-draft

Shape and refine a generated chapter

/edit-draft manuscript/combined/act1_ch2.md

Claude will:

1. Read your draft and its context file
2. Ask what you want to change
3. Show you which config to update
4. Update the context YAML
5. Offer to regenerate with changes

/generate-outline

Create a bullet outline of all three acts

/generate-outline

Claude will:

1. Read plot structure and reveal sequence
2. Generate comprehensive chapter-by-chapter outline
3. Show plot beats, character arcs, and reveal timing
4. Save to docs/outline.md (or custom path)

Perfect for:

• Seeing the whole story structure at a glance
• Checking pacing and flow
• Ensuring reveals happen in the right order
• Verifying character arcs develop properly

/generate-synopsis

Create a 1-page thematic treatment

/generate-synopsis

Claude will:

1. Read themes, worldbuilding, and plot structure
2. Generate compelling 1-page treatment
3. Focus on themes/insights rather than plot summary
4. Save to docs/synopsis.md (or custom path)

Perfect for:

• Pitch documents and query letters
• Marketing copy
• Reminding yourself what the story is really about
• Capturing the philosophical/emotional essence

Daily Workflow

# Start of project: Get the big picture
/generate-outline    # See all plot beats across acts
/generate-synopsis   # Understand thematic core

# Morning: Generate new chapter
/make-draft
> act1_ch2
> balanced

# Read the draft, decide what to change
/edit-draft manuscript/combined/act1_ch2.md
> Make Edreema more cautious
> yes (regenerate)

# Iterate until happy
/edit-draft manuscript/combined/act1_ch2.md
> Add a scene where...
> yes

# After major plot changes: Regenerate planning docs
/generate-outline    # Check if beats still flow
/generate-synopsis   # Verify themes still land

# Commit when satisfied
git add .build/contexts/act1_ch2.yaml
git commit -m "act1_ch2 complete"

Key Principle

Context files are source code. Drafts are build artifacts.

• Context files (.build/contexts/*.yaml) → Version controlled
• Generated drafts (manuscript/combined/*.md) → Gitignored, disposable
• You iterate by changing context and regenerating, not editing prose directly

Cost Control

• iteration mode: FREE (Llama) or very cheap
• balanced mode: ~$0.02-0.10 per chapter (Haiku/Sonnet mix)
• production mode: ~$0.50+ per chapter (Opus/Sonnet)

Check current models and costs:

source .venv/bin/activate
python3 scripts/build.py models