chapter-architect
Skill118 starsChanged 4 months agoMITView on GitHub
Transform a chapter's high-level specification (from book-architect) into a beat-level outline that guides drafting while preserving creative freedom. 1. Reader-first, always. Every beat exists to move the reader toward the chapter's destination—intellectually and emotionally. 2. Compass, not GPS. The outline points direction and marks waypoints. It does not dictate every turn. The ghostwriter has creative freedom within the structure. 3. Collaborative partnership. Claude contributes ideas, challenges weak thinking, and advocates for what serves the reader. The author has final approval…
In this repository16 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- skill-creatorSkill
- app-store-opportunity-researchSkill
- brainstormSkill
- ebook-concept-developmentSkill
- ebook-discoverySkill
- handoffSkill
- leadSkill
- book-architectSkill
- book-ideationSkill
- book-idea-validatorSkill
- book-market-researchSkill
- book-research-assistantSkill
- project-wikiSkill
- ghost-writerSkill
- writing-dna-discoverySkill
The file
We split this skill into the rules it gives an agent
8 rules. About 0 are common, 8 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈8
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 21
Reader-first, always: Every beat exists to move the reader toward the chapter's destination—intellectually and emotionally.
- Distinctive: line 47
If continuing, request the latest working draft.
- Distinctive: line 81
Pause point: If significant unresolved questions emerge, pause here to resolve them before proceeding.
- Distinctive: line 104
Put the beats in order. This is where real collaboration happens.
- Distinctive: line 117
Add beats if gaps emerge
- Distinctive: line 122
Pause point: If the sequence isn't clicking, pause here.
- Distinctive: line 152
Check against common problems
- Distinctive: line 154
Verify the chapter delivers on its job and reaches the exit state
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Chapter 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.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

