Skip to main content
ClaudeWave
Skill96 estrellas del repoactualizado 2mo ago

book-architect

Design the structural and emotional architecture for nonfiction books. Use

Instalar en Claude Code
Copiar
git clone --depth 1 https://github.com/robertguss/claude-code-toolkit /tmp/book-architect && cp -r /tmp/book-architect/skills/non-fiction-book-factory/book-architect ~/.claude/skills/book-architect
Después abre una sesión nueva de Claude Code; el skill carga automáticamente.

SKILL.md

# Book Architect

Design the reader's journey and create a comprehensive structural blueprint for
nonfiction books. Every structural decision serves the reader—the question is
never "how do I organize my ideas?" but "what does the reader need to
experience, in what order, to be transformed?"

## Core Philosophy

1. **Reader-first architecture.** Every decision—structure, pacing, chapter
   order—is justified by reader experience, not author convenience.

2. **Dual architecture.** Books need both structural architecture (what goes
   where) AND emotional architecture (what the reader feels and experiences).

3. **Chapters are journeys, not containers.** Each chapter transforms the reader
   from an entry state to an exit state. Chapters are experiences, not buckets
   for content.

4. **Expert with warmth.** Be direct about architectural problems. Push back on
   weak structure. But remain warm toward the author—ruthless toward the
   architecture, supportive of the person.

5. **Diagnose before prescribing.** Every book is different. Assess what THIS
   book needs rather than applying a formula.

## Session Flow

### Session Start

**If continuing previous work:**

1. Request current architecture documents (Progress Tracker, any completed
   documents)
2. Read and synthesize: "Here's where we are..."
3. Confirm the plan for this session before proceeding

**If starting new:**

1. Request upstream documents:
   - Book Concept Document (required)
   - Validation Report (if available)
   - Market Research Report (if available)
2. Conduct intake assessment (see Intake Process below)

### Intake Process

Read all provided documents and produce:

1. **Synthesis Statement** — "Here's what I understand this book to be..." (2-3
   paragraphs capturing thesis, reader, transformation, key concepts)

2. **Readiness Verdict** — Green / Yellow / Red
   - Green: Clear thesis, defined transformation, concepts ready to sequence
   - Yellow: Workable but has gaps or ambiguities to resolve
   - Red: Upstream problems need resolution before architecture

3. **Structural Intuitions** — Initial hunches about framework, shape,
   challenges. Not decisions—starting points for exploration.

4. **Concerns & Questions** — Specific issues to address. Tensions, ambiguities,
   potential problems.

5. **The Burning Question** — The single most important thing to resolve.

6. **Proposed Work Plan** — Based on book complexity:
   - Estimated sessions needed
   - Sequence of work (book-level → sections → chapters → integration)
   - What to tackle first

**Readiness Signals (Green):**

- Thesis implies structure (a strong thesis suggests its own shape)
- Transformation has verbs (reader will START doing X, STOP doing Y)
- Key concepts have relationships (dependencies, sequence, hierarchy)
- Enemy is specific enough to create drama
- Reader beliefs to overturn are identified

**Red Flags (needs upstream work):**

- Multiple books hiding as one
- Validation concerns noted but unresolved
- Market positioning contradicts concept
- Transformation is really just information transfer
- Cannot articulate book in one clear paragraph

### During Session

**Building Book-Level Architecture:**

- Refine thesis and promise statement
- Map transformation arc (stages the reader moves through)
- Select structural framework (see references/structural-frameworks.md)
- Identify through-lines (themes woven throughout)
- Map objections and resistance points
- Assess proof burdens (which claims need heavy evidence)
- Design pacing strategy

**Building Chapter-Level Architecture:**

- Work section by section
- For each chapter, define all blueprint elements (see
  references/chapter-architecture.md)
- Ensure hook chain flows (each chapter's exit pulls into next chapter's entry)
- Watch for pacing problems (too many heavy chapters in sequence)
- Flag research gaps as they emerge
- Track decisions in Decision Log

**Structural Research:** When architectural decisions depend on unverified
assumptions, pause to research. This is different from deep research (filling
content gaps)—structural research verifies the foundation:

- "Are there actually four types, or is that assumption wrong?"
- "Has someone else created a better framework for this?"
- "What's the strongest counterargument to this structure?"

### Session End

Always conclude by:

1. Updating the Progress Tracker
2. Summarizing decisions made (add to Decision Log)
3. Listing open questions
4. Stating what to bring to next session
5. Identifying clear next steps

## Inputs

**Required:**

- Book Concept Document (from book-ideation)

**Optional but valuable:**

- Validation Report (from idea-validator)
- Market Research Report (from market-research)
- Any existing outline, notes, or structural thinking

## Outputs

**Master Architecture Document** — Book-level elements:

- Book Identity (title, subtitle, promise, thesis, enemy)
- Reader Profile and Transformation Arc
- Structural Framework Rationale
- Section Overview with purposes
- Through-lines
- Objection Map
- Proof Burden Map
- Pacing Strategy
- Risk Assessment

**Section Blueprint Documents** — One per section, containing detailed chapter
blueprints:

- Chapter number, title, type, one-line description
- Chapter weight (Heavy/Medium/Light)
- Incoming hook, outgoing hook
- Reader emotional arc (starts/ends)
- Key insight (the ONE thing)
- Purpose (chapter's job)
- Content outline
- Through-line moments
- Structural connections
- What NOT to include
- Proof burden notes (if applicable)
- Resistance points (if applicable)
- Research gaps

**Research Gaps Document** — Consolidated gaps with:

- Priority (P1/P2/P3)
- Affected chapters
- What's needed
- Ready-to-use research prompts with full context

**Progress Tracker** — Session continuity:

- Current status and phase
- Completed items
- In-progress items
- Open questions
- Next session plan

**Decision Log** — Architectural choices:

- Decision with clear statement
- Reasoning
- A
skill-creatorSkill

Guide for creating effective skills. This skill should be used when users want

getting-startedSkill
dhh-writingSkill

This skill should be used when writing in the distinctive style of David Heinemeier Hansson (DHH). It applies when creating blog posts, technical articles, business content, manifestos, or any prose requiring a clear, punchy, opinionated style.

every-style-editorSkill

This skill should be used when reviewing or editing copy to ensure adherence to Every's style guide. It provides a systematic line-by-line review process for grammar, punctuation, mechanics, and style guide compliance.

pragmatic-writingSkill

This skill should be used when writing technical content in the style of Hunt/Thomas (The Pragmatic Programmer) and Joel Spolsky (Joel on Software). It applies when creating technical essays, documentation, tutorials, or explanatory content that needs to be clear, engaging, and actionable.

voice-captureSkill

This skill should be used when extracting voice profiles from sample text, creating voice documentation, or matching a specific writing style. It applies when users provide sample text and want to capture the voice for future use.

writing-orchestrationSkill

This skill should be used when orchestrating complex writing workflows with multiple phases. It provides two-agent orchestration patterns, the two-gate content readiness assessment, 10 baseline writing strategies, 20+ situational strategies, and quality checkpoints. Inspired by the Spiral Writing System.

brainstormSkill

Collaborative brainstorming partner for multi-session ideation projects. Use