chapter-architect
Scannednpx machina-cli add skill robertguss/claude-code-toolkit/chapter-architect --openclawChapter Architect
Transform a chapter's high-level specification (from book-architect) into a beat-level outline that guides drafting while preserving creative freedom.
Core Philosophy
-
Reader-first, always. Every beat exists to move the reader toward the chapter's destination—intellectually and emotionally.
-
Compass, not GPS. The outline points direction and marks waypoints. It does not dictate every turn. The ghostwriter has creative freedom within the structure.
-
Collaborative partnership. Claude contributes ideas, challenges weak thinking, and advocates for what serves the reader. The author has final approval on all decisions.
-
Intent over prescription. Each beat captures why it exists, not just what it contains. This enables intelligent adaptation during drafting.
-
Emotional arc matters. Track not just where the reader is intellectually, but how they feel at each stage of the journey.
Session Flow
This skill is session-flexible. Simple chapters may complete in one session. Complex chapters may need natural pause points with thinking time between.
Session Start
-
Identify context:
- New chapter or continuing a previous session?
- If continuing, request the latest working draft.
-
Gather inputs:
- Architecture Document (chapter specification)
- Research Dossier (chapter's section)
- Book Concept Document (reader, promise, voice)
- Any author notes on this chapter
-
Confirm which chapter we're architecting and surface the key specs:
- Chapter number and working title
- Chapter's job
- Reader entry state
- Reader exit state
- Key concepts to cover
- Bridge from previous / to next chapter
Phase 1: Orient
Review inputs together. Surface any tensions, questions, or issues.
Key questions to explore:
- Is this a standard chapter or special type? (introduction, conclusion,
case-study, etc.)
- If special type, read
references/special-chapter-types.md
- If special type, read
- Is the research sufficient? Any gaps?
- Are there competing ways to approach this chapter?
- What's the emotional shape of this chapter? (tension→release,
confusion→clarity, etc.)
- Reference
references/emotional-arc-patterns.mdas needed
- Reference
Claude's role: Surface concerns, ask probing questions, identify what's unclear or underdeveloped.
Pause point: If significant unresolved questions emerge, pause here to resolve them before proceeding.
Phase 2: Brainstorm Beats
Generate candidate beats without worrying about sequence yet.
Process:
- Review the beat vocabulary together
- Read
references/beat-vocabulary.md
- Read
- Generate possible beats—both author and Claude contribute
- Consider opening options
- Reference
references/opening-strategies.md
- Reference
- Consider closing options
- Reference
references/closing-strategies.md
- Reference
- Capture all candidates without judging yet
Claude's role: Actively contribute beat ideas, not just record. Suggest moves the author might not have considered. Ask "what about a beat that does X?"
Phase 3: Sequence and Debate
Put the beats in order. This is where real collaboration happens.
Process:
- Propose an initial sequence
- Walk through the reader's experience: "They arrive here, then this happens, now they feel..."
- Debate ordering decisions:
- Does the counterargument come before or after the main case?
- Where does the reader need relief or breathing room?
- What must be established before something else can land?
- Identify which beats are load-bearing (structural, can't move) vs. flexible
- Cut beats that aren't earning their place
- Add beats if gaps emerge
Claude's role: Advocate for what serves the reader. Push back when a sequence feels off. Offer alternatives with reasoning.
Pause point: If the sequence isn't clicking, pause here. Complex chapters may need marinating time.
Phase 4: Flesh Out Beats
For each beat in the final sequence, define:
- Beat name and type (from vocabulary)
- What happens (loosely described—compass, not GPS)
- Reader destination (intellectual and emotional—this is non-negotiable)
- Key material (specific pointers to research, quotes, examples)
- Load-bearing flag (yes/no—can this beat be moved or cut?)
- Notes (anything the ghostwriter should know)
Special attention: Opening and closing beats get deeper treatment.
- Reference
references/opening-strategies.mdandreferences/closing-strategies.md - Articulate why this opening/closing works
- Note what to avoid
- Identify specific hooks, callbacks, or images to consider
Phase 5: Review and Finalize
Stress-test the complete arc before producing the document.
Process:
- Claude walks through the reader's experience aloud—beat by beat, tracking intellectual and emotional state
- Check against common problems
- Read
references/common-chapter-problems.md
- Read
- Verify the chapter delivers on its job and reaches the exit state
- Confirm the bridge to the next chapter works
- Final author approval
Only after approval: Produce the Chapter Outline Document using the template.
- Use
assets/templates/chapter-outline-template.md
Session End
- Produce the versioned Chapter Outline Document (v1, v2, etc.)
- Summarize any open questions or flags for the ghostwriter
- Confirm next steps:
- Ready for drafting? → Handoff to draft-coach or ghostwriter
- Need another session? → Note where to resume
Inputs
| Document | Source | Purpose |
|---|---|---|
| Architecture Document | book-architect | Chapter's job, entry/exit states, key concepts, bridges |
| Research Dossier | research-assistant | Evidence, examples, quotes organized by chapter |
| Book Concept Document | book-ideation | Reader, promise, thesis, voice, author angle |
| Author notes | Author | Any existing thoughts, fragments, or constraints |
Outputs
Chapter Outline Document containing:
- Chapter Context (job, entry/exit states, connections, emotional arc, tone notes)
- Reader Journey Walkthrough (prose narrative of the experience)
- Beat Sequence (detailed breakdown of each beat)
- Opening and Closing Deep Dives (expanded treatment)
See assets/templates/chapter-outline-template.md for exact format.
Readiness Criteria
Before handoff, confirm:
- All beats have clear reader destinations (intellectual and emotional)
- Load-bearing beats are flagged
- Key material is curated and pointed to for each beat
- Opening and closing have deep-dive treatment
- Reader journey walkthrough captures the chapter's feel
- The chapter delivers on its job and exit state
- Bridge to next chapter is clear
- Author has approved the outline
Handoff
The Chapter Outline Document feeds into:
draft-coach— if author is writing and wants feedbackghostwriter(modal) — if Claude is drafting and author approves
The ghostwriter also receives the full Research Dossier for the chapter, with the outline's key material pointers as primary guidance.
Source
git clone https://github.com/robertguss/claude-code-toolkit/blob/main/skills/non-fiction-book-factory/chapter-architect/SKILL.mdView on GitHub Overview
Chapter Architect turns a chapter's high-level specification into a beat-level outline that guides drafting while preserving creative freedom. It outputs a Chapter Outline Document for draft-coach or ghostwriter, emphasizing reader-first structure, directional guidance, collaboration, and explicit intent behind each beat.
How This Skill Works
Inputs (Architecture Document, Research Dossier, Book Concept Document, and author notes) are reviewed in Phase 1 Orient to surface tensions. In Phase 2 Brainstorm Beats, candidate beats and opening/closing options are generated. Phase 3 Sequence and Debate orders beats, differentiates load-bearing from flexible elements, and produces a finalized Chapter Outline Document for drafting.
When to Use It
- You have a chapter specification in the Architecture Document and need a detailed beat-level outline before drafting.
- You want to surface tensions, gaps, or emotional shape early to guide writing.
- You need to generate multiple candidate beats and opening/closing options before sequencing.
- You’re collaborating with a ghostwriter or draft-coach and require a formal Chapter Outline Document.
- You want a plan that emphasizes intent and emotional arc while preserving the author's creative freedom.
Quick Start
- Step 1: Gather inputs — Architecture Document, Research Dossier, Book Concept Document, and author notes; confirm which chapter to architect.
- Step 2: Run Phase 1 Orient to surface tensions and questions; then proceed to Phase 2 Brainstorm Beats to generate candidate beats and options.
- Step 3: Run Phase 3 Sequence and Debate to order beats, identify load-bearing elements, and produce the final Chapter Outline Document for drafting.
Best Practices
- Start with the chapter's key specs: number, working title, job, entry/exit states, key concepts, and transitions.
- Use the beat vocabulary and reference materials to ensure consistent terminology.
- Capture why each beat exists (intent) and how it moves the reader emotionally, not just what it contains.
- Differentiate between load-bearing beats and flexible beats, and plan where the author needs breathing room.
- Surface tensions and questions early; include a pause point if significant issues remain.
Example Use Cases
- Chapter 4 in a non-fiction design book: converts a high-level architecture into beats that guide an intro, proof points, and a takeaway, ensuring a clear emotional arc.
- A case-study chapter where competing approaches are weighed; the outline captures the main argument, counterargument, and reader relief.
- Intro chapter that defines reader expectations and promises, with explicit entry/exit states and an opening hook.
- Closing chapter designed to bridge to the next chapter, with a concluding beat that reinforces the book's promise.
- A collaborative ghostwriter handoff where the Chapter Outline Document is produced and reviewed for alignment.