book-architect

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).

56 stars

Best use case

book-architect is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

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).

Teams using book-architect should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/book-architect/SKILL.md --create-dirs "https://raw.githubusercontent.com/robertguss/claude-code-toolkit/main/skills/non-fiction-book-factory/book-architect/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/book-architect/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How book-architect Compares

Feature / Agentbook-architectStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

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).

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

SKILL.md Source

# 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
- Alternatives considered
- Confidence level
- Dependencies
- Revisit triggers

## Readiness Criteria

Architecture is complete when:

1. Master Architecture Document is finalized
2. All Section Blueprints are complete with every field filled
3. Hook chain flows end-to-end
4. Pacing shows intentional rhythm (no accidental slog zones)
5. Every chapter has a distinct key insight (no duplicated jobs)
6. All P1 research gaps are documented with prompts
7. Stress test passes (can articulate reader journey in one paragraph, each
   chapter earns the next)
8. Author confirms this is the book they want to write

## Handoff

Completed architecture feeds:

- **research-assistant** — Uses Research Gaps Document to fill content gaps
- **draft-coach** — Uses Section Blueprints to guide chapter-by-chapter drafting

## References

Load as needed based on the work at hand:

- `references/structural-frameworks.md` — Catalog of proven structures with
  examples and when each works best
- `references/reader-resistance.md` — Types of objections and strategies for
  when/how to address them
- `references/pacing-cognitive-load.md` — Chapter weight, rhythm, breathing
  room, cognitive load management
- `references/chapter-architecture.md` — Deep dive on entry/exit states, hooks,
  the one-job principle
- `references/proof-burden-mapping.md` — Which claims need what level of
  evidence
- `references/question-chain.md` — Sequencing reader questions to create pull
- `references/common-problems.md` — Architectural antipatterns and how to fix
  them

## Templates

Output document templates in `assets/templates/`:

- `master-architecture-template.md`
- `section-blueprint-template.md`
- `research-gaps-template.md`
- `progress-tracker-template.md`
- `decision-log-template.md`

Related Skills

chapter-architect

56
from robertguss/claude-code-toolkit

Plan and architect a single chapter at beat-level granularity. Use when you have a chapter from the Architecture Document and need to create a detailed outline before drafting. Produces a Chapter Outline Document for use by draft-coach or ghostwriter.

book-research-assistant

56
from robertguss/claude-code-toolkit

Plan, orchestrate, and validate deep research for nonfiction books. Use when an author has completed book architecture and needs to fill research gaps before outlining chapters. Triggers include requests to plan research, generate research prompts, validate research quality, or prepare for drafting. This skill does everything around deep research—planning, prompting, validating, synthesizing—but the actual research execution happens externally via Claude and Gemini deep research. Requires upstream documents from book-architect (Research Gaps Document, Master Architecture Document, Section Blueprints) and book-ideation (Book Concept Document).

book-market-research

56
from robertguss/claude-code-toolkit

Assess commercial viability of book concepts for Amazon KDP self-publishing. Use when the user has a Book Concept Document and wants to understand market demand, competition, pricing, and positioning before committing to write. Produces a Market Research Report with viability scorecard and Go/No-Go recommendation. Works standalone (commercial analysis only) or after idea-validator (integrated assessment). Nonfiction only.

book-ideation

56
from robertguss/claude-code-toolkit

Develop raw book ideas into structured nonfiction book concepts. Use when the user wants to develop a book idea, has brainstorm documents to refine into a book concept, wants to articulate a book's thesis/promise/reader/transformation, or needs to prepare a book concept for validation and market research. Nonfiction only. Produces a Book Concept Document with all elements needed for downstream skills (idea-validator, market-research, book-architect).

book-idea-validator

56
from robertguss/claude-code-toolkit

Stress-test book concepts against existing research before committing to architecture. Use when the user has a Book Concept Document ready for validation, wants to verify their thesis is defensible, needs to understand the competitive intellectual landscape, or wants honest assessment of their idea's strengths and weaknesses. Produces a Validation Report that informs the Go/No-Go decision. Nonfiction only.

app-growth-playbook

56
from robertguss/claude-code-toolkit

Generate platform-specific, actionable growth playbooks for mobile apps. Use when planning a Product Hunt launch, creating TikTok/Reels content strategies, setting up Apple Search Ads campaigns, preparing App Store featuring submissions, building referral loops, designing email/push re-engagement campaigns, writing Reddit launch posts, or creating content marketing plans for app growth. Provides templates, scripts, timing guides, and step-by-step processes — not generic advice.

ebook-discovery

56
from robertguss/claude-code-toolkit

Surface ebook ideas you didn't know you had. Use when ready to discover what ebooks might be hiding in your content, expertise, or thinking. Supports both content-rich creators (blog posts, videos, newsletters) and those with unpublished expertise. Produces a curated list of ebook candidates ready for Concept Development. Handles multi-session discovery with living documents.

ebook-concept-development

56
from robertguss/claude-code-toolkit

Develop ebook ideas into structured concepts ready for architecture. Use when the user has an ebook idea (from a brainstorm document, existing content to repurpose, a book section to extract, or a fresh concept) and wants to develop it into a clear, validated concept. Produces an Ebook Concept Document with reader, transformation, promise, content source, scope/format, and key topics. Handles multi-session development with living documents.

writing-dna-discovery

56
from robertguss/claude-code-toolkit

Capture a writer's voice DNA through collaborative interview and sample analysis. Use when someone wants to document their writing voice for use with a ghost writer skill. Produces a Voice DNA Document with patterns, anti-patterns, and actionable guidance. Handles one register/mode per session, supports refinement over time.

ghost-writer

56
from robertguss/claude-code-toolkit

Produce first drafts that match a writer's authentic voice using their Voice DNA Document. Consumes DNA documents from writing-dna-discovery skill. Generates 2 meaningfully different drafts with headlines, confidence assessment, decision notes, and DNA refinement suggestions. Collaborative partner that evaluates, pushes back, and advocates for quality. Handles blog posts, essays, newsletters, and more.

paywall-pricing-optimizer

56
from robertguss/claude-code-toolkit

Design effective paywalls, structure subscription tiers, and optimize pricing for mobile apps. Covers monetization model selection, paywall screen design, pricing psychology, A/B testing strategy, and RevenueCat/StoreKit/Google Billing integration. Use when the user wants to monetize an app, design a paywall, choose between subscription vs one-time purchase, set pricing tiers, improve conversion rates, plan pricing experiments, or integrate in-app purchases. Triggers on "design my paywall", "how should I price my app", "subscription tiers", "monetization strategy", "paywall copy", "free trial length", "RevenueCat setup", "improve paywall conversion".

mobile-app-launch-checklist

56
from robertguss/claude-code-toolkit

Comprehensive step-by-step launch checklist for shipping mobile apps to the iOS App Store and Google Play Store. Covers pre-submission preparation, store asset creation, build and submission, launch day execution, and post-launch monitoring. Use when the user wants to launch a mobile app, prepare for App Store or Google Play submission, create a launch plan, review submission requirements, or ensure nothing is missed before releasing an app. Triggers on "launch checklist", "app submission", "prepare for launch", "app store submission", "google play submission", "ready to ship", "pre-launch review", "launch day plan".