Skip to content
Content
Skill

/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?"

From plugin
robertguss-claude-code-toolkit
11629 skills7 agents4 commands
Install
$ npx -y skills add robertguss/claude-code-toolkit --skill book-architect --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/book-architect

Context preview

The summary Claude sees to decide when to auto-load this skill.

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?"

SKILL.md

book-architect.SKILL.md
name: book-architect
license: Proprietary
metadata:
  author: robertguss
  version: "1.0"
description:
  Design the structural and emotional architecture for nonfiction books. Use
  when an author has a validated book concept and needs to create the blueprint
  before drafting. Triggers include requests to structure a book, create a
  chapter outline, design a table of contents, map the reader's journey, or plan
  book organization. Requires upstream documents from book-ideation (Book
  Concept Document) and optionally from idea-validator (Validation Report) and
  market-research (Market Research Report).

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
Read more
Ships withrobertguss-claude-code-toolkit

Extend Claude Code with specialized workflows, automatic formatting, and better defaults. Skills give Claude domain expertise—brainstorming methods, documentation generation, book writing pipelines.

Get the whole plugin