book-writing
Core Philosophy
Writing a non-fiction book is not expanding a 1,000-word blog post with 200 pages of repetitive filler. A book is an extended cognitive journey that fundamentally shifts how the reader perceives reality. Sustaining reader momentum across 60,000 words requires an undeniable core premise, a disciplined chapter architecture, a consistent narrative voice, and a systematic multi-pass developmental revision process.
4-Step Non-Fiction Book Crafting Architecture
Step 1: The Core Premise & Reader Contract
- The Single Organizing Idea (SOI):
- Formulate the book's foundational argument in strictly one sentence:
- Example: "Software reliability is an organizational culture problem that cannot be solved by purchasing more monitoring tools."
- If the premise requires a paragraph of explanation, the thesis is unfocused.
- The Reader Transformation Contract:
- Explicitly define: Who is the reader at Chapter 1 (Current Pain & Mental Model) vs who do they become by Chapter 10 (Transformed Capability & Worldview)?
Step 2: Macro Chapter Architecture (The 10-Chapter Arc)
- The 3-Act Non-Fiction Structure:
- Act I: The Broken Paradigm (Chapters 1–2): The status quo, why current solutions fail, the true cost of inaction.
- Act II: The New Framework (Chapters 3–7): The core methodology, core mechanisms, worked case studies, and counter-intuitive principles.
- Act III: Mastery & Implementation (Chapters 8–10): Organizational rollout, handling edge cases, future evolution.
- The Fractal Chapter Template (4,000–6,000 words):
- The Hook & Narrative Case Study (1,000 words): Human drama, visceral stakes.
- The Conceptual Breakthrough (1,500 words): The mental model and framework diagram.
- Actionable Implementation & Proof (2,000 words): Concrete steps, code/data evidence.
- Objections & Counter-Arguments (800 words): Dismantling skeptic rebuttals.
- Chapter Summary & Action Checklist (200 words).
Step 3: Sustaining Narrative Velocity & Voice
- Show vs Tell with Sensory Grounding:
- Ground abstract theories in physical reality: names, timestamps, exact dollar figures, terminal error messages, room temperatures.
- The "One Major Idea Per Chapter" Rule:
- Never introduce competing conceptual models within a single chapter. Subordinate all research and anecdotes to that chapter's primary thesis.
Step 4: The 3-Pass Revision Methodology
- Pass 1: Structural & Developmental Edit:
- Audit chapter order, identify logical gaps, cut redundant chapters entirely.
- Pass 2: The Scene & Argument Polish:
- Strengthen case study evidence; sharpen analytical frameworks.
- Pass 3: Line & Rhythm Edit:
- Read aloud to identify clumsy phrasing, varying sentence cadence and killing weak passive verbs.
Deliverable Format: Book Proposal & Architecture Blueprint (BOOK-PROPOSAL.md)
# Non-Fiction Book Proposal & Architecture: [Working Title]
## 1. Core Thesis & Target Reader
- **Working Title**: [Title: Subtitle]
- **Core Premise (1 Sentence)**: [Single organizing idea]
- **Target Audience**: [Specific professional persona, e.g. Senior Engineering Leaders]
- **Target Word Count**: 55,000 words (10 Chapters @ ~5,500 words/chapter)
## 2. Competitive Title Analysis
- *Book A (Competitor)*: Strong on theory, lacks tactical code/architecture examples.
- *Our Differentiation*: Practical engineering playbook with real post-mortems and code.
## 3. Chapter-by-Chapter Architecture
### Chapter 1: The Illusion of Microservice Velocity
- **Core Argument**: Microservices adopted prematurely introduce distributed systems latency without organizational benefits.
- **Narrative Anchor Case Study**: The 2024 Black Friday outage at [Fintech Startup].
- **Key Framework**: The Distributed Complexity Tipping Point Matrix.
### Chapter 2: The Modular Monolith Alternative
- **Core Argument**: In-process domain isolation provides microservice boundaries with zero network latency.
- **Key Framework**: The Hexagonal Architecture boundary design.
Worked Example: Technical Architecture Book Outlining
- Thesis: "Observability without automated remediations creates alert fatigue that slows incident recovery."
- Execution: Structured 8 chapters. Chapter 3 detailed a true enterprise outage where 1,400 Slack alerts fired in 3 minutes, paralyzing on-call engineers.
- Outcome: Secured literary agent and top publisher contract based on a 15-page proposal and 2 sample chapters.
Verification Checklist
Anti-Patterns
- The Blog Anthology: Stapling 15 unrelated blog posts together and calling it a book.
- Scope Explosion: Trying to explain the entire history of computing instead of solving one specific problem.
- Writing Without Outlining: Writing 30,000 words before realizing Chapter 4 contradicts Chapter 1.
1---2name: book-writing3description: Develop book-length work: premise, chapter architecture, narrative voice, and full revision. Use when structuring non-fiction books or manuscripts.4---56# book-writing78## Core Philosophy9Writing a non-fiction book is not expanding a 1,000-word blog post with 200 pages of repetitive filler. A book is an extended cognitive journey that fundamentally shifts how the reader perceives reality. Sustaining reader momentum across 60,000 words requires an undeniable core premise, a disciplined chapter architecture, a consistent narrative voice, and a systematic multi-pass developmental revision process.1011---1213## 4-Step Non-Fiction Book Crafting Architecture1415### Step 1: The Core Premise & Reader Contract161. **The Single Organizing Idea (SOI)**:17 - Formulate the book's foundational argument in strictly one sentence:18 - Example: *"Software reliability is an organizational culture problem that cannot be solved by purchasing more monitoring tools."*19 - If the premise requires a paragraph of explanation, the thesis is unfocused.202. **The Reader Transformation Contract**:21 - Explicitly define: Who is the reader at Chapter 1 (Current Pain & Mental Model) vs who do they become by Chapter 10 (Transformed Capability & Worldview)?2223### Step 2: Macro Chapter Architecture (The 10-Chapter Arc)241. **The 3-Act Non-Fiction Structure**:25 - *Act I: The Broken Paradigm (Chapters 1–2)*: The status quo, why current solutions fail, the true cost of inaction.26 - *Act II: The New Framework (Chapters 3–7)*: The core methodology, core mechanisms, worked case studies, and counter-intuitive principles.27 - *Act III: Mastery & Implementation (Chapters 8–10)*: Organizational rollout, handling edge cases, future evolution.282. **The Fractal Chapter Template (4,000–6,000 words)**:29 - *The Hook & Narrative Case Study* (1,000 words): Human drama, visceral stakes.30 - *The Conceptual Breakthrough* (1,500 words): The mental model and framework diagram.31 - *Actionable Implementation & Proof* (2,000 words): Concrete steps, code/data evidence.32 - *Objections & Counter-Arguments* (800 words): Dismantling skeptic rebuttals.33 - *Chapter Summary & Action Checklist* (200 words).3435### Step 3: Sustaining Narrative Velocity & Voice361. **Show vs Tell with Sensory Grounding**:37 - Ground abstract theories in physical reality: names, timestamps, exact dollar figures, terminal error messages, room temperatures.382. **The "One Major Idea Per Chapter" Rule**:39 - Never introduce competing conceptual models within a single chapter. Subordinate all research and anecdotes to that chapter's primary thesis.4041### Step 4: The 3-Pass Revision Methodology421. **Pass 1: Structural & Developmental Edit**:43 - Audit chapter order, identify logical gaps, cut redundant chapters entirely.442. **Pass 2: The Scene & Argument Polish**:45 - Strengthen case study evidence; sharpen analytical frameworks.463. **Pass 3: Line & Rhythm Edit**:47 - Read aloud to identify clumsy phrasing, varying sentence cadence and killing weak passive verbs.4849---5051## Deliverable Format: Book Proposal & Architecture Blueprint (`BOOK-PROPOSAL.md`)5253```markdown54# Non-Fiction Book Proposal & Architecture: [Working Title]5556## 1. Core Thesis & Target Reader57- **Working Title**: [Title: Subtitle]58- **Core Premise (1 Sentence)**: [Single organizing idea]59- **Target Audience**: [Specific professional persona, e.g. Senior Engineering Leaders]60- **Target Word Count**: 55,000 words (10 Chapters @ ~5,500 words/chapter)6162## 2. Competitive Title Analysis63- *Book A (Competitor)*: Strong on theory, lacks tactical code/architecture examples.64- *Our Differentiation*: Practical engineering playbook with real post-mortems and code.6566## 3. Chapter-by-Chapter Architecture67### Chapter 1: The Illusion of Microservice Velocity68- **Core Argument**: Microservices adopted prematurely introduce distributed systems latency without organizational benefits.69- **Narrative Anchor Case Study**: The 2024 Black Friday outage at [Fintech Startup].70- **Key Framework**: The Distributed Complexity Tipping Point Matrix.7172### Chapter 2: The Modular Monolith Alternative73- **Core Argument**: In-process domain isolation provides microservice boundaries with zero network latency.74- **Key Framework**: The Hexagonal Architecture boundary design.75```7677---7879## Worked Example: Technical Architecture Book Outlining8081- **Thesis**: "Observability without automated remediations creates alert fatigue that slows incident recovery."82- **Execution**: Structured 8 chapters. Chapter 3 detailed a true enterprise outage where 1,400 Slack alerts fired in 3 minutes, paralyzing on-call engineers.83- **Outcome**: Secured literary agent and top publisher contract based on a 15-page proposal and 2 sample chapters.8485---8687## Verification Checklist8889- [ ] Core premise is formulated in a single, falsifiable declarative sentence.90- [ ] Every chapter follows a consistent fractal structure with real case studies.91- [ ] Explicit reader transformation arc (Before vs After) is defined.92- [ ] Competitive book analysis outlines clear differentiation.93- [ ] Revision methodology includes separate structural, argument, and line editing passes.9495---9697## Anti-Patterns9899- **The Blog Anthology**: Stapling 15 unrelated blog posts together and calling it a book.100- **Scope Explosion**: Trying to explain the entire history of computing instead of solving one specific problem.101- **Writing Without Outlining**: Writing 30,000 words before realizing Chapter 4 contradicts Chapter 1.