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).
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?"
Reader-first architecture. Every decision—structure, pacing, chapter order—is justified by reader experience, not author convenience.
Dual architecture. Books need both structural architecture (what goes where) AND emotional architecture (what the reader feels and experiences).
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.
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.
Diagnose before prescribing. Every book is different. Assess what THIS book needs rather than applying a formula.
If continuing previous work:
If starting new:
Read all provided documents and produce:
Synthesis Statement — "Here's what I understand this book to be..." (2-3 paragraphs capturing thesis, reader, transformation, key concepts)
Readiness Verdict — Green / Yellow / Red
Structural Intuitions — Initial hunches about framework, shape, challenges. Not decisions—starting points for exploration.
Concerns & Questions — Specific issues to address. Tensions, ambiguities, potential problems.
The Burning Question — The single most important thing to resolve.
Proposed Work Plan — Based on book complexity:
Readiness Signals (Green):
Red Flags (needs upstream work):
Building Book-Level Architecture:
Building Chapter-Level Architecture:
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:
Always conclude by:
Required:
Optional but valuable:
Master Architecture Document — Book-level elements:
Section Blueprint Documents — One per section, containing detailed chapter blueprints:
Research Gaps Document — Consolidated gaps with:
Progress Tracker — Session continuity:
Decision Log — Architectural choices:
Architecture is complete when:
Completed architecture feeds:
Load as needed based on the work at hand:
references/structural-frameworks.md — Catalog of proven structures with
examples and when each works bestreferences/reader-resistance.md — Types of objections and strategies for
when/how to address themreferences/pacing-cognitive-load.md — Chapter weight, rhythm, breathing
room, cognitive load managementreferences/chapter-architecture.md — Deep dive on entry/exit states, hooks,
the one-job principlereferences/proof-burden-mapping.md — Which claims need what level of
evidencereferences/question-chain.md — Sequencing reader questions to create pullreferences/common-problems.md — Architectural antipatterns and how to fix
themOutput document templates in assets/templates/:
master-architecture-template.mdsection-blueprint-template.mdresearch-gaps-template.mdprogress-tracker-template.mddecision-log-template.mdGenerate or edit images via Gemini 3 Pro Image (Nano Banana Pro).
Batch-generate images via OpenAI Images API. Random prompt sampler + `index.html` gallery.
Generate spectrograms and feature-panel visualizations from audio with the songsee CLI.
Extract frames or short clips from videos using ffmpeg.
Search GIF providers with CLI/TUI, download results, and extract stills/sheets.
Category:media-generate