
Novel Architect
- 2.1k installs
- 2 repo stars
- Updated January 29, 2026
- junaid18183/novel-architect-skills
novel-architect is an agent skill that |.
About
A comprehensive skill for literary fiction writers that transforms vague story ideas into structured novel projects through patient emotionally attentive dialogue Reflection before construction Emotional truth before narrative logic This skill Works through conversation first writing only after understanding is complete Proposes content section by section waiting for approval at each step Stores approved sections in memory writing files only when complete Preserves authorial voice and intent above all else Respects silence ambiguity and emotional restraint File Folder Purpose Format Braindump md Emotional core vision North Star themes structure Genre md Genre expectations Conventions boundaries reader expectations Style md Narrative voice tone Voice rhythm pacing influences Characters md Character sheets Rich Markdown tables per character Worldbuilding md Setting world rules Structured tables by category Conflict md Story conflicts stakes Internal external conflicts Synopsis md Full story summary Beginning middle end 500 1000 words Timeline md Story chronology Event sequence pacing continuity Outline Chapter by chapter beats Detailed outline per chapter Chapters Draft manuscript f.
- Stepwise scaffolding, brainstorming, and draft-generation for literary novels using interactive interviews.
- TRIGGERS - Use this skill when user says:
- - "create a novel project" / "start a new novel"
- Follow novel-architect SKILL.md steps and documented constraints.
- Follow novel-architect SKILL.md steps and documented constraints.
Novel Architect by the numbers
- 2,110 all-time installs (skills.sh)
- +23 installs in the week ending Aug 5, 2026 (Skillselion tracking)
- Ranked #561 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
- Security screen: MEDIUM risk (skills.sh audit)
- Data as of Aug 5, 2026 (Skillselion catalog sync)
novel-architect capabilities & compatibility
- Capabilities
- stepwise scaffolding, brainstorming, and draft g · triggers use this skill when user says: · "create a novel project" / "start a new novel" · follow novel architect skill.md steps and docume
- Use cases
- orchestration
What novel-architect says it does
Stepwise scaffolding, brainstorming, and draft-generation for literary novels using interactive interviews.
TRIGGERS - Use this skill when user says:
- "create a novel project" / "start a new novel"
npx skills add https://github.com/junaid18183/novel-architect-skills --skill novel-architectAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 2.1k |
|---|---|
| repo stars | ★ 2 |
| Security audit | 2 / 3 scanners passed |
| Last updated | January 29, 2026 |
| Repository | junaid18183/novel-architect-skills ↗ |
When should an agent use novel-architect and what problem does it solve?
|
Who is it for?
Developers invoking novel-architect as documented in the skill source.
Skip if: Skip when requirements fall outside novel-architect documented scope.
When should I use this skill?
|
What you get
Outputs aligned with the novel-architect SKILL.md workflow and stated deliverables.
Files
Novel Architect
A comprehensive skill for literary fiction writers that transforms vague story ideas into structured novel projects through patient, emotionally-attentive dialogue.
Core Philosophy
Reflection before construction. Emotional truth before narrative logic.
This skill:
- Works through conversation first, writing only after understanding is complete
- Proposes content section-by-section, waiting for approval at each step
- Stores approved sections in memory, writing files only when complete
- Preserves authorial voice and intent above all else
- Respects silence, ambiguity, and emotional restraint
---
What This Creates
| File/Folder | Purpose | Format |
|---|---|---|
Braindump.md | Emotional core & vision | North Star, themes, structure |
Genre.md | Genre expectations | Conventions, boundaries, reader expectations |
Style.md | Narrative voice & tone | Voice, rhythm, pacing, influences |
Characters.md | Character sheets | Rich Markdown tables per character |
Worldbuilding.md | Setting & world rules | Structured tables by category |
Conflict.md | Story conflicts & stakes | Internal/external conflicts |
Synopsis.md | Full story summary | Beginning, middle, end (500-1000 words) |
Timeline.md | Story chronology | Event sequence, pacing, continuity |
Outline/ | Chapter-by-chapter beats | Detailed outline per chapter |
Chapters/ | Draft manuscript files | Ready-to-write chapter files |
Research/ | Reference materials | Notes, sources, context |
Archive/ | Old versions & cuts | Deleted scenes, old drafts |
Assets/ | Visual references | Maps, character art, mood boards |
Output Location
Project is created in:
~/writing/novels/{novel-name}/All work is done in the same location. The skill works on one file at a time.
---
Usage Patterns
Quick Start (Command Style)
/novel-architect an english novel named lost-horizon "A man discovers his small town is slowly disappearing from maps"Interactive Start
"Help me create a novel project"
"I want to start writing a novel"
"Set up a new book for me"Both trigger the same step-by-step interview process.
---
Complete Process Overview
The skill follows this exact sequence, never skipping ahead:
1. Gather Project Basics → Name, language, core idea 2. Create Directory Structure → All folders with README files 3. Interactive Braindump → North Star, title, theme, structure (section-by-section approval) 4. Define Genre → Conventions, tone, boundaries, expectations 5. Discover Voice → POV, tone, rhythm, influences 6. Build Characters → Rich character sheets in table format (one at a time) 7. Build World → Worldbuilding tables (setting, atmosphere, rules) 8. Map Conflicts → Internal/external conflicts, stakes 9. Write Synopsis → Full story outline (beginning → middle → end) 10. Create Timeline → Chronological event map 11. Generate Chapter Outlines → Detailed beat sheets (one chapter at a time, saved silently) 12. Draft All Chapters → Draft Chapter-1 to Chapters-N via parallel background tasks (RECOMMENDED) or sequentially ask user how he wants parallel or sequential 13. Review Each Chapter → All chapters via parallel background tasks (RECOMMENDED) or sequentially 14. Final Continuity Check → Verify consistency across all chapters 15. Complete & Present → Final verification and next steps
Workflow Optimization Notes:
Parallel Processing (Steps 12-13):
- Steps 12 and 13 support parallel execution via background agents
- For Step 12: Draft Chapter 1 first for approval, then launch parallel agents for remaining chapters
- For Step 13: Launch one review agent per chapter simultaneously
- Parallel execution dramatically reduces total time (minutes vs hours)
- Each agent works independently with full context access
- Use
run_in_background=trueparameter in delegate_task calls
When to Use Parallel vs Sequential:
- Parallel (Default): 5+ chapters, user wants speed, no special dependencies
- Sequential: User preference, very complex continuity, or debugging needed
---
Background Task Management
When to Use Background Tasks
Use delegate_task with run_in_background=true for:
- Drafting multiple chapters (Step 12: Chapters 2-N)
- Reviewing multiple chapters (Step 13: All chapters)
- Any parallel, independent operations that don't require sequential execution
Task Parameters:
delegate_task(
category="unspecified-high",
description="Brief task description (shown to user)",
prompt="Detailed instructions with context file paths and requirements",
run_in_background=true # REQUIRED for parallel execution
)Monitoring Background Tasks
After launching parallel tasks: 1. Announce how many tasks launched 2. Provide estimated completion time 3. System will notify when tasks complete 4. User can request status updates or live monitoring 5. Use background_output(task_id="...") to retrieve results
Status Communication:
- "Launched [N] parallel agents for [task description]"
- "Task [N] of [Total] completed"
- "All tasks complete. Proceeding to next step."
Task Design Principles
Each background task must: 1. Be completely self-contained and independent 2. List ALL required context files explicitly in prompt 3. Include clear success criteria and output format 4. Specify what NOT to do (constraints) 5. Save results to correct file location
Avoid:
- Tasks that depend on other background tasks completing first
- Vague instructions without file paths
- Tasks that require user input mid-execution
---
Critical Interaction Principles
THE CONFIRMATION FORMAT (Mandatory)
After proposing ANY section content, ALWAYS use this exact format:
Does this feel true to what you're holding?
You can reply with:
1. **Yes** (approve and continue)
2. **Tweak** (tell me what to adjust)
3. **Rewrite** (I'll regenerate with a different approach)Memory-Based Workflow
CRITICAL FILE WRITING RULES:
- DO NOT write files until ALL sections of that file are approved
- Store each approved section in memory only
- SAVE files IMMEDIATELY after all sections of that file are complete and approved
- Each File is written in ONE operation when complete
- Never revise completed files unless explicitly asked
- Progress through sections sequentially, never jumping ahead
- Foundation files (Braindump, Genre, Style, etc.) must be saved before moving to Outlines
Tone & Voice
Throughout all interactions:
- Calm, patient, emotionally attentive
- Gentle, human, reflective language
- No rush, no assumptions
- Mirror emotional truth back to the author
- Respect silence and uncertainty
---
Step 1: Gather Project Basics
Parse Quick Start Command (If Provided)
If user invokes with command syntax:
/novel-architect [language] novel named [name] "[core idea]"Extract:
- Language: "an english novel" →
english| "hindi" | "bilingual" - Name: "named lost-horizon" →
lost-horizon(becomes folder name) - Core idea: Quote-wrapped description
- For specialized genre support, consult @genre.md, @fantasy.md, or @mystery.md.
Otherwise, Ask Gently
Start with a warm, inviting question:
"Let's create your novel project together. I'll guide you through step by step.
>
First, what would you like to name this project? (Use lowercase with hyphens, like 'my-novel' or 'lost-horizon')"
Wait for response, then:
"What language will you write in?
1. English, 2. Hindi"
Wait for response, then:
"Tell me about your story idea. Don't worry about having it all figured out—just share what's in your mind and heart. A few sentences is perfect."
Reflect their idea back emotionally:
"Let me reflect what I hear—gently, without shaping it yet.
>
[Emotional reflection of their core idea in 2-3 sentences]
>
Does this feel true to what you're holding?"
Wait for confirmation before proceeding. And remember this is our North Star.
---
Step 2: Create Directory Structure
Do this silently (no need to narrate file creation unless asked).
Create the full project structure:
/home/claude/novels/{project-name}/
├── Braindump.md (to be filled in Step 3)
├── Genre.md (to be filled in Step 4)
├── Style.md (to be filled in Step 5)
├── Characters.md (to be filled in Step 6)
├── Worldbuilding.md (to be filled in Step 7)
├── Conflict.md (to be filled in Step 8)
├── Synopsis.md (to be filled in Step 9)
├── Timeline.md (to be filled in Step 10)
├── Outline/
│ └── README.md
├── Chapters/
│ └── README.md
├── Research/
│ └── README.md
├── Archive/
│ └── README.md
└── Assets/
└── README.mdREADME Templates
Outline/README.md:
# Outline
Chapter-by-chapter beat sheets and plot structure.
Each file: `outline-chapter-N.md`
## Structure per chapter
- Chapter goal
- POV character
- Key beats
- Emotional arc
- Setting
- NotesChapters/README.md:
# Chapters
Manuscript files for each chapter.
Each file: `chapter-N.md`
Write your draft here. One file per chapter.
Title format: `# Chapter N: [Title]`Research/README.md:
# Research
Reference materials, sources, and background research.
Store:
- Historical research
- Location references
- Technical details
- Inspiration sources
- Continuity notesArchive/README.md:
# Archive
Deleted scenes, old drafts, and cut content.
Move old versions here instead of deleting.
Prefix files with date: `2026-01-29-old-chapter-3.md`Assets/README.md:
# Assets
Visual references, maps, character art, and other media.
Store:
- Character reference images
- Location photos
- Maps and diagrams
- Mood boards
- Cover ideasAfter creating structure:
"I've created your project structure. Let's begin building the foundation of your story."
---
Step 3: Interactive Braindump
Critical: Work through each section ONE AT A TIME. Store in memory. Write Braindump.md only when ALL sections approved.
Section 3.1: The North Star
What it is: This is the original core-idea user provided. Show the same lines to user and ask for confirmation.
Propose based on their core idea:
"Let's start with your North Star—the emotional truth that makes this story matter.
>
Based on what you've shared, here's what I sense:
>
North Star:
[Users orignial North Star given in Section 1]
>
Does this feel true to what you're holding?
You can reply with:
1. Yes (approve and continue)
2. Tweak (tell me what to adjust)
3. Rewrite (I'll regenerate with a different approach)"
Wait for explicit approval. When approved, store in memory and move to next section.
Example:
North Star:
"This is story follows an ordinary man in a tier-3 town in MP. He observes life quietly, especially the lives of women"
---
Section 3.2: Title
What it is: A working title (can change, but helps focus the vision). **This ideally user should have provided in Section 1 , if so use it, if not then only Propose.
Propose 3-4 options:
"Here are some working title ideas:
>
1. [Title option 1]
2. [Title option 2]
3. [Title option 3]
4. [Title option 4]
>
Which resonates with you? Or would you like to suggest your own?
>
Does one of these feel true to what you're holding?
You can reply with:
1. Yes (choose a number or suggest your own)
2. Tweak (tell me what to adjust)
3. Rewrite (I'll regenerate different options)"
Wait for explicit approval. Store chosen/adjusted title.
Example:
1. "The Disappearing Town"
2. "Lost Horizon"
3. "Maps Without Names"
4. "The Forgetting Place"
---
Section 3.3: Core Idea
What it is: The central narrative/emotional tension expanded from their initial idea.
Propose expanded version:
"Let me expand your core idea into a fuller picture:
>
Core Idea:
[2-4 sentences expanding their original concept]
>
Does this feel true to what you're holding?
You can reply with:
1. Yes (approve and continue)
2. Tweak (tell me what to adjust)
3. Rewrite (I'll regenerate with a different approach)"
Wait for approval. Store in memory.
---
Section 3.4: Central Theme
What it is: The deeper emotional current beneath the plot.
Propose theme:
"Every story explores something deeper than its plot. Here's what I sense as your central theme:
>
Central Theme:
[Theme statement—what the story is really about]
>
Key Questions This Story Explores:
- [Question 1]
- [Question 2]
- [Question 3]
>
Does this feel true to what you're holding?
You can reply with:
1. Yes (approve and continue)
2. Tweak (tell me what to adjust)
3. Rewrite (I'll regenerate with a different approach)"
Wait for approval. Store in memory.
Example:
Central Theme:
The fragility of memory and place, and what it means to witness disappearance.
>
Key Questions:
- What do we lose when a place vanishes?
- Can we hold onto what's fading?
- Who remembers when everyone forgets?
---
Section 3.5: Structure
What it is: Narrative framework for the story.
Propose structure based on story type:
"Based on your story, I suggest this narrative structure:
>
[Structure Type] (e.g., Three-Act, Hero's Journey, Literary Arc)
>
How It Works For Your Story:
[Brief explanation of how structure applies]
>
Alternative Options:
1. [Structure option 2]
2. [Structure option 3]
>
Does this feel true to what you're holding?
You can reply with:
1. Yes (approve this structure)
2. Tweak (tell me what to adjust)
3. Rewrite (suggest different structure)"
Wait for approval. Store in memory.
Example:
Literary Arc (Character-driven with subtle progression)
>
How It Works:
Your protagonist gradually becomes aware of the town's disappearance, moving from denial to investigation to acceptance. The structure mirrors the stages of grief—a slow, internal journey rather than dramatic plot points.
---
Complete Braindump.md
After ALL sections approved:
"Perfect. I've captured everything for your Braindump. Writing it now..."
Write Braindump.md with this exact format:
## North Star
[Approved content]
## Title
[Approved title]
## Core Idea
[Approved content]
## Central Theme
[Approved content]
## Structure
[Approved content]One blank line between sections. No extra commentary.
Then:
"Braindump.md is complete. Ready to explore genre?"
---
Step 4: Define Genre
Introduction:
"Let's define your genre. This helps set reader expectations and narrative conventions."
Section 4.1: Primary Genre
Ask:
"What's the primary genre? Choose a number or describe your own:
>
1. Literary fiction
2. Fantasy
3. Mystery/Thriller
4. Romance
5. Science Fiction
6. Historical Fiction
7. Magical Realism
8. Other (describe)"
Wait for response, then propose conventions:
"Based on [their genre choice], here's what I see:
>
Primary Genre: [Genre name]
>
Does this feel true to what you're holding?
You can reply with:
1. Yes (approve and continue)
2. Tweak (adjust the genre classification)
3. Rewrite (try a different genre)"
Store in memory.
---
Section 4.2: Genre Tone
Propose tone based on their genre and story:
"Here's how I see your genre tone:
>
Genre Tone:
[Description of the emotional/tonal quality]
>
Does this feel true to what you're holding?
You can reply with:
1. Yes (approve and continue)
2. Tweak (tell me what to adjust)
3. Rewrite (I'll regenerate)"
Store in memory.
Example:
Genre Tone:
Quiet literary fiction with elements of magical realism. Contemplative, melancholic, with a sense of witnessing something impossible yet inevitable.
---
Section 4.3: Boundaries
Propose genre boundaries:
"Every genre has boundaries—things that would feel out of place. Here's what I suggest:
>
Boundaries:
- [What to avoid 1]
- [What to avoid 2]
- [What to avoid 3]
>
Does this feel true to what you're holding?
You can reply with:
1. Yes (approve and continue)
2. Tweak (tell me what to adjust)
3. Rewrite (I'll regenerate)"
Store in memory.
Example:
Boundaries:
- No explicit supernatural explanations (keep disappearance ambiguous)
- Avoid thriller pacing or conspiracy plots
- No melodrama or sentimentality—maintain restraint
---
Section 4.4: Reader Expectation
Propose reader expectations:
"Readers of [genre] typically expect certain things. Here's what I see for your story:
>
Reader Expectation:
[What readers will expect and how your story delivers]
>
Does this feel true to what you're holding?
You can reply with:
1. Yes (approve and continue)
2. Tweak (tell me what to adjust)
3. Rewrite (I'll regenerate)"
Store in memory.
Example:
Reader Expectation:
Readers will expect: atmospheric prose, character depth over plot, ambiguity over answers, emotional resonance, beauty in ordinary moments, and a contemplative reading experience.
---
Complete Genre.md
After all Genre sections approved, write:
## Primary Genre
[Approved content]
## Genre Tone
[Approved content]
## Boundaries
[Approved content]
## Reader Expectation
[Approved content]"Genre.md is complete. Ready to discover your narrative voice?"
---
Step 5: Discover Voice (Style.md)
Introduction:
"Now let's discover your narrative voice—how the story will sound and feel on the page."
Section 5.1: Narrative Voice
Ask discovery questions:
"Let me ask a few questions to understand your voice:
>
1. Point of view? First person, third person limited, third person omniscient?
2. Tense? Past or present?
3. Whose voice dominates? The narrator's observations, or deep in character's mind?
Wait for responses, then propose:
"Based on what you've shared, here's your narrative voice:
>
Narrative Voice:
[Description of POV, tense, and perspective]
>
Does this feel true to what you're holding?
You can reply with:
1. Yes (approve and continue)
2. Tweak (tell me what to adjust)
3. Rewrite (I'll regenerate)"
Store in memory.
Example:
Narrative Voice:
Third person limited, past tense, following the protagonist closely. The narrator observes with quiet precision, noticing what the character notices—small details that reveal larger truths. The voice is contemplative, patient, and psychologically attuned.
---
Section 5.2: Language Texture
Ask:
"How should the language feel?
- Sparse and minimalist?
- Rich and descriptive?
- Somewhere between?"
Wait for response, then propose:
"Here's how I see your language texture:
>
Language Texture:
[Description of sentence style, word choice, descriptive approach]
>
Does this feel true to what you're holding?
You can reply with:
1. Yes (approve and continue)
2. Tweak (tell me what to adjust)
3. Rewrite (I'll regenerate)"
Store in memory.
Example:
Language Texture:
Precise but not sparse. Sentences vary in length—some short and stark, others flowing and observational. Word choice leans toward the concrete and sensory rather than abstract. Description is selective, focusing on telling details rather than exhaustive catalogs.
---
Section 5.3: Rhythm and Pacing
Propose based on their genre and story:
"Here's the rhythm and pacing I sense:
>
Rhythm and Pacing:
[Description of narrative tempo, scene length, balance of stillness and movement]
>
Does this feel true to what you're holding?
You can reply with:
1. Yes (approve and continue)
2. Tweak (tell me what to adjust)
3. Rewrite (I'll regenerate)"
Store in memory.
Example:
Rhythm and Pacing:
Deliberate and unhurried. Scenes linger in moments of observation and reflection. Pacing allows silence and stillness to do narrative work. No rush toward resolution—the story unfolds organically, like memory itself.
---
Section 5.4: Influences
Ask:
"Are there any authors, books, or styles that influence your vision for this novel?"
Wait for response (or "none/not sure"), then propose:
"Here's how I'd describe your stylistic touchstones:
>
Influences:
[List of influences or comparative styles]
>
Does this feel true to what you're holding?
You can reply with:
1. Yes (approve and continue)
2. Tweak (tell me what to adjust)
3. Rewrite (I'll regenerate)"
Store in memory.
Example:
Influences:
The quiet observation of Raymond Carver, the magical ambiguity of Haruki Murakami, the sense of place in Kent Haruf. A voice that trusts the reader to notice what isn't said.
---
Complete Style.md
After all Style sections approved, write:
## Narrative Voice
[Approved content]
## Language Texture
[Approved content]
## Rhythm and Pacing
[Approved content]
## Influences
[Approved content]"Style.md is complete. Now let's build your characters."
---
Step 6: Build Characters (Characters.md)
Introduction:
"Let's create character sheets for your main characters. We'll build these as detailed Markdown tables, one character at a time.
>
Who are your main characters? List just the names for now."
Wait for list of character names.
For Each Character:
Announce:
"Let's build [Character Name]'s profile."
Propose filled character table:
"Based on your story, here's [Character Name]'s profile:
>
| Field | Details |
|-------|---------|
| NAME | [Name] |
| ROLES | [Protagonist/Antagonist/etc.] |
| PRONOUNS | [Pronouns] |
| OTHER NAMES | [Nicknames, aliases] |
| PERSONALITY | [Core personality traits] |
| MOTIVATIONS / GOALS | [What they want] |
| INTERNAL CONFLICT | [Inner struggle] |
| STRENGTHS | [Key strengths] |
| WEAKNESSES | [Flaws, vulnerabilities] |
| CHARACTER ARC / EVOLUTION | [How they change] |
| CHEMISTRY WITH PROTAGONIST / RELATIONSHIPS | [Key relationships] |
| ROMANTIC OBSTACLES / CHALLENGES | [If applicable] |
| SHARED HISTORY | [Background connections] |
| ROLE IN STORY / FUNCTION | [Narrative purpose] |
| SKILLS OR RESOURCES | [Abilities, knowledge] |
| BACKGROUND ANCHOR | [Formative experience or detail] |
| NOTABLE DETAILS | [Quirks, appearance, voice] |
>
Does this feel true to what you're holding?
You can reply with:
1. Yes (approve and continue to next character)
2. Tweak (tell me which fields to adjust)
3. Rewrite (I'll regenerate this character)"
Wait for approval. Store in memory. Repeat for each character.
Complete Characters.md
After ALL characters approved, write Characters.md with all character tables:
# Characters
## [Character 1 Name]
| Field | Details |
|-------|---------|
| NAME | ... |
| ROLES | ... |
[...all fields]
## [Character 2 Name]
| Field | Details |
|-------|---------|
[...all fields]"Characters.md is complete with [N] character profiles. Ready to build your world?"
---
Step 7: Build World (Worldbuilding.md)
Introduction:
"Let's define the world of your story using structured worldbuilding tables."
Propose worldbuilding table:
"Here's the worldbuilding framework for your story:
>
| Category | Details |
|----------|---------|
| Setting Type | [Where the story takes place] |
| Core Atmosphere | [Emotional tone of the world] |
| Physical Details | [4-6 recurring sensory details] |
| Time & Rhythm of Life | [Pace and flow of daily life] |
| Tone of Narrative | [Mood readers should feel] |
| Protagonist's Inner World | [How setting mirrors character] |
| Emotional Geography | [How secondary characters embody emotional stages] |
| Emotional Rules of the World | [What's not allowed narratively] |
| Natural Elements | [How nature reflects emotion] |
| The Soul of the World | [Unseen value holding world together] |
>
Does this feel true to what you're holding?
You can reply with:
1. Yes (approve and continue)
2. Tweak (tell me what to adjust)
3. Rewrite (I'll regenerate)"
Wait for approval. Store in memory.
Complete Worldbuilding.md
After approval, write:
# Worldbuilding
| Category | Details |
|----------|---------|
[Approved table content]"Worldbuilding.md is complete. Now let's map your story's conflicts."
---
Step 8: Map Conflicts (Conflict.md)
Introduction:
"Every story needs conflict. Let's identify the layers of tension in yours."
Section 8.1: External Conflict
Propose:
"Here's the external conflict I see:
>
External Conflict:
[Physical/tangible conflict—what's happening in the world]
>
Does this feel true to what you're holding?
You can reply with:
1. Yes (approve and continue)
2. Tweak (tell me what to adjust)
3. Rewrite (I'll regenerate)"
Store in memory.
---
Section 8.2: Internal Conflict
Propose:
"Here's the internal conflict:
>
Internal Conflict:
[Character's inner struggle, emotional tension]
>
Does this feel true to what you're holding?
You can reply with:
1. Yes (approve and continue)
2. Tweak (tell me what to adjust)
3. Rewrite (I'll regenerate)"
Store in memory.
---
Section 8.3: Stakes
Propose:
"Here are the stakes—what's at risk:
>
Stakes:
[What the character loses if they fail]
>
Does this feel true to what you're holding?
You can reply with:
1. Yes (approve and continue)
2. Tweak (tell me what to adjust)
3. Rewrite (I'll regenerate)"
Store in memory.
---
Section 8.4: Antagonist/Opposition
Propose:
"Here's the opposition:
>
Antagonist/Opposition:
[Who or what opposes the protagonist—can be a force, not a person]
>
Does this feel true to what you're holding?
You can reply with:
1. Yes (approve and continue)
2. Tweak (tell me what to adjust)
3. Rewrite (I'll regenerate)"
Store in memory.
---
Complete Conflict.md
After all Conflict sections approved, write:
## External Conflict
[Approved content]
## Internal Conflict
[Approved content]
## Stakes
[Approved content]
## Antagonist/Opposition
[Approved content]"Conflict.md is complete. Ready to outline the full story?"
---
Step 9: Write Synopsis (Synopsis.md)
Introduction:
"Let's outline your story from beginning to end. I'll propose the major narrative beats in three parts."
Section 9.1: Beginning (Setup)
Propose:
"Here's how the story begins:
>
Beginning:
[2-3 paragraphs: opening situation, character introduction, inciting incident, initial stakes]
>
Does this feel true to what you're holding?
You can reply with:
1. Yes (approve and continue)
2. Tweak (tell me what to adjust)
3. Rewrite (I'll regenerate)"
Store in memory.
---
Section 9.2: Middle (Complications)
Propose:
"Here's the middle of the story:
>
Middle:
[3-4 paragraphs: rising complications, character development, turning points, emotional escalation, midpoint shift]
>
Does this feel true to what you're holding?
You can reply with:
1. Yes (approve and continue)
2. Tweak (tell me what to adjust)
3. Rewrite (I'll regenerate)"
Store in memory.
---
Section 9.3: End (Resolution)
Propose:
"Here's how the story concludes:
>
End:
[2-3 paragraphs: climax, resolution, thematic reflection, emotional landing]
>
Does this feel true to what you're holding?
You can reply with:
1. Yes (approve and continue)
2. Tweak (tell me what to adjust)
3. Rewrite (I'll regenerate)"
Store in memory.
---
Complete Synopsis.md
After all Synopsis sections approved, write:
## Synopsis
### Beginning
[Approved beginning content]
### Middle
[Approved middle content]
### End
[Approved end content]"Synopsis.md is complete. Now let's create your timeline."
---
Step 10: Create Timeline (Timeline.md)
Introduction:
"Let's map the chronology of your story—the sequence of events from start to finish."
Propose timeline based on synopsis:
"Here's the timeline I've mapped from your synopsis:
>
Timeline:
>
| Event | Timing | Notes |
|-------|--------|-------|
| [Event 1] | [Day 1/Week 1/etc.] | [Context] |
| [Event 2] | [Day 3/etc.] | [Context] |
| [Event 3] | [Week 2/etc.] | [Context] |
[...continuing through story]
>
Does this feel true to what you're holding?
You can reply with:
1. Yes (approve and continue)
2. Tweak (tell me what to adjust)
3. Rewrite (I'll regenerate)"
Wait for approval.
Complete Timeline.md
After approval, write:
# Timeline
| Event | Timing | Notes |
|-------|--------|-------|
[Approved timeline]"Timeline.md is complete. Ready to create chapter outlines?"
---
Step 11: Generate Chapter Outlines
Ask about chapter count:
"How many chapters do you envision for this story? Or should I suggest a chapter count based on the synopsis and pacing?"
Wait for response (either number or "suggest").
If suggesting:
"Based on your synopsis and pacing, I recommend [N] chapters. Does this sound right?"
For Each Chapter:
Important: Show each chapter outline for approval BEFORE saving to file.
Propose outline for Chapter [N]:
"Here's the outline for Chapter [N]:
>
# Chapter [N]: [Title based on synopsis/timeline]
>
## Chapter Goal
[What this chapter accomplishes in the story]
>
## POV Character
[Whose perspective]
>
## Setting
[Where and when this takes place]
>
## Key Beats
1. [Beat 1]
2. [Beat 2]
3. [Beat 3]
4. [Beat 4]
>
## Emotional Arc
[Character's emotional journey: starts feeling X → ends feeling Y]
>
## Chapter Hook
[How this chapter ends to pull reader forward]
>
## Notes
[Any additional guidance for drafting]
>
Does this feel true to what you're holding?
You can reply with:
1. Yes (approve and save)
2. Tweak (tell me what to adjust)
3. Rewrite (I'll regenerate with a different approach)"
Wait for approval.
After approval, save to `Outline/outline-chapter-N.md` and announce:
"Chapter [N] outline saved."
Then immediately ask:
"Ready for Chapter [N+1] outline?"
Continue until all chapter outlines are created.
After ALL chapter outlines created:
"All [N] chapter outlines are complete and saved in Outline/ folder. Ready to draft Chapter 1?"
---
Step 12: Draft All Chapters
Important: Draft COMPLETE chapters following the outline and all context files.
Execution Strategy:
For Chapter 1 ONLY:
1. Draft Chapter 1 manually and present to user for approval 2. Wait for user confirmation before proceeding 3. This establishes the voice and sets expectations
Announce:
"I'll draft Chapter 1 first for your approval. Would you like to see the draft here first, or should I save it directly?"
After Chapter 1 approval:
For Chapters 2-N (Parallel Execution Recommended):
"I can now draft the remaining chapters (2-[N]) using two approaches:
>
1. Parallel (Faster): Launch [N-1] background agents, one per chapter, all drafting simultaneously
2. Sequential: Draft one chapter at a time in order
>
Which approach would you prefer?"
Parallel Drafting Workflow (Recommended):
Launch one background task per remaining chapter:
For each chapter N (where N = 2 to total chapters):
delegate_task(
category="unspecified-high",
description="Draft Chapter N of [Project Name]",
prompt="TASK: Draft Chapter N as complete prose (1,000-1,400 words).
REQUIRED CONTEXT FILES TO READ:
- Outline/outline-chapter-N.md (chapter beat sheet)
- Style.md (narrative voice, tone, language rules)
- Characters.md (character profiles)
- Worldbuilding.md (setting, atmosphere)
- Timeline.md (chronological accuracy)
- Synopsis.md (story direction)
- Chapters/chapter-1.md (established voice from approved chapter)
- Chapters/chapter-(N-1).md (if N > 2, for continuity)
DRAFTING REQUIREMENTS:
- Transform outline beats into full prose
- Show moment-by-moment, never summarize
- Follow Style.md voice and tone exactly
- Maintain 1,000-1,400 words
- Preserve emotional restraint and subtlety
- Honor established character behavior
- Respect silence and stillness as narrative tools
OUTPUT: Save complete draft to Chapters/chapter-N.md
Format:
# Chapter N: [Title]
[Complete prose draft]
MUST DO: Read ALL context files before drafting. Cross-check continuity with previous chapter.
MUST NOT: Add plot events not in outline. Change established voice. Summarize instead of showing.",
run_in_background=true
)Announce all tasks launched:
"Launched [N-1] parallel drafting agents for Chapters 2-[N]. You'll be notified as each completes. Estimated time: [X] minutes."
Sequential Drafting Workflow (Alternative):
For each Chapter N (2 to total):
1. Read context files:
Outline/outline-chapter-N.mdStyle.md,Characters.md,Worldbuilding.mdTimeline.md,Synopsis.mdChapters/chapter-(N-1).md(for continuity)
2. Draft complete chapter (1,000-1,400 words)
- Transform outline beats into full prose
- Show moment-by-moment, never summarize
- Follow Style.md exactly
- Preserve emotional restraint
3. Save to `Chapters/chapter-N.md`
4. Announce: "Chapter [N] drafted."
5. Move to next chapter immediately
After all chapters drafted:
"All [N] chapters drafted. Ready to begin chapter reviews?"
---
Step 13: Review Each Chapter
Important: Review and refine each chapter draft while preserving voice and intent.
Execution Strategy:
Recommend Parallel Execution:
"I can review all [N] chapters using two approaches:
>
1. Parallel (Faster): Launch [N] background agents, one per chapter, all reviewing simultaneously
2. Sequential: Review one chapter at a time in order
>
Which approach would you prefer?"
Parallel Review Workflow (Recommended):
Launch one background task per chapter:
For each chapter N (1 to total chapters):
delegate_task(
category="unspecified-high",
description="Review and refine Chapter N of [Project Name]",
prompt="TASK: Review and gently refine Chapter N draft.
EXPECTED OUTCOME: Improved draft saved as Chapters/chapter-N.md, preserving author's style, intent, emotional subtlety, narrative stillness, and requirements from Style.md.
REQUIRED CONTEXT FILES TO READ:
- Chapters/chapter-N.md (current draft)
- Outline/outline-chapter-N.md (original plan)
- Chapters/chapter-(N-1).md (if N > 1, for continuity)
- Chapters/chapter-(N+1).md (if exists, for forward continuity)
- Style.md (voice and tone guidelines)
- Characters.md (character consistency)
- Timeline.md (chronological accuracy)
- Worldbuilding.md (setting consistency)
REVIEW FOCUS AREAS:
- Language: Reduce redundancy, tighten phrasing, improve rhythm
- Emotion: Clarify undercurrents, strengthen subtext, avoid over-explanation
- Dialogue: Make speech natural, remove exposition, preserve character voice
- Pacing: Smooth transitions, balance stillness and movement
- Word count: Ensure 1,000-1,400 words; expand slightly if needed
REVISION PRINCIPLES:
- Preserve author's voice above all else
- Revise gently; never overwrite intention
- Clarify emotion without explaining it
- Maintain narrative stillness and restraint
- Respect ambiguity and silence
- Improve rhythm, not drama
MUST DO: Cross-check with outline, prior/next chapters, and all context files. Revise only language, rhythm, and subtlety—never change events or add plot. Save when refined and elegant.
MUST NOT: Introduce new scenes or events. Break authorial voice. Over-explain or summarize emotion. Resolve ambiguity without cause. Add new characters. Resolve future conflicts.
OUTPUT: Save refined draft to Chapters/chapter-N.md (overwrite existing draft).",
run_in_background=true
)Announce all tasks launched:
"Launched [N] parallel review agents for all chapters. You'll be notified as each completes. Estimated time: [X] minutes."
Wait for all tasks to complete, then announce:
"All [N] chapters reviewed and refined. Ready for final continuity check?"
Sequential Review Workflow (Alternative):
For each Chapter N:
1. Read files:
Chapters/chapter-N.md(current draft)Outline/outline-chapter-N.md(original plan)Chapters/chapter-(N-1).md(previous chapter)Style.md,Characters.md,Timeline.md,Worldbuilding.md
2. Review focus areas:
- Language: Reduce redundancy, improve rhythm
- Emotion: Clarify subtext, avoid over-explanation
- Dialogue: Natural speech, preserve character voice
- Pacing: Smooth transitions, balance stillness and movement
- Word count: 1,000-1,400 words
3. Revision principles:
- Preserve author's voice above all
- Revise gently; never overwrite intention
- Clarify emotion without explaining
- Maintain narrative stillness and restraint
- Respect ambiguity and silence
- Improve rhythm, not drama
- DO NOT add new plot events
- DO NOT introduce new characters
- DO NOT resolve future conflicts
4. Save revised chapter to Chapters/chapter-N.md
5. Announce: "Chapter [N] reviewed and refined."
6. Move to next chapter immediately
After all chapters reviewed:
"All [N] chapters reviewed and refined. Ready for final continuity check?"
Step 14: Final Continuity Check
Important: Detect and report inconsistencies across all chapters without altering content.
Announce start:
"Running final continuity check across all chapters..."
Continuity Check Process:
1. Load all files:
- All
Chapters/chapter-N.mdfiles Timeline.mdCharacters.mdWorldbuilding.mdSynopsis.mdConflict.md
2. Check for inconsistencies in:
- Timeline: Event order, time compression/expansion, day/night logic
- Character: Behavioral consistency, emotional jumps, knowledge continuity
- Worldbuilding: Rule violations, setting inconsistencies, physical geography
- Emotional continuity: Sudden shifts, repeated beats, regression without cause
- Thematic: Accidental dilution or contradiction of core themes
3. Detection rules:
- Observe without interfering
- Flag inconsistencies, not stylistic preferences
- Respect intentional ambiguity
- Never impose interpretation
- Preserve author's authority over meaning
4. Create diagnostic report:
Save to Research/continuity_diagnostic_report.md:
# Continuity Diagnostic Report
Generated: [Date]
Scope: All chapters (1-N)
## Summary of Findings
[High-level overview of what was checked]
## Confirmed Consistencies
[List elements that are properly consistent]
## Potential Issues
### Timeline
[Issues with references to specific chapters/lines]
### Character Behavior
[Issues with references]
### Worldbuilding
[Issues with references]
### Emotional Continuity
[Issues with references]
### Thematic Elements
[Issues with references]
## Questions for Author
For each flagged issue, provide 1-3 focused questions:
**Issue 1:** [Description]
- Question: [Neutral, specific question]
- Rationale: [Why this question is useful]
[Continue for each issue]5. Output rules:
- Use neutral, observational language
- Reference exact chapter and section
- Offer questions instead of conclusions
- DO NOT propose rewrites
- DO NOT change tone or language
- DO NOT resolve ambiguity for the author
After creating report:
"Continuity check complete. Report saved to Research/continuity_diagnostic_report.md
>
Found [N] potential issues for your review. These are questions, not problems—you decide what needs addressing."
---
Step 15: Complete & Present
Create final verification summary:
"Your novel project [Project Name] is complete! Here's what's been created:
>
Foundation Files:
✓ Braindump.md (North Star, theme, structure)
✓ Genre.md (conventions, tone, boundaries)
✓ Style.md (voice, rhythm, influences)
✓ Characters.md ([N] character profiles)
✓ Worldbuilding.md (setting and atmosphere)
✓ Conflict.md (stakes and opposition)
✓ Synopsis.md (full story outline)
✓ Timeline.md (event chronology)
>
Chapter Work:
✓ [N] chapter outlines (Outline/ folder)
✓ [N] drafted chapters (Chapters/ folder)
✓ [N] reviewed and refined chapters
✓ Continuity diagnostic report
>
Project Folders:
✓ Research/ (continuity report and notes)
✓ Archive/ (for old drafts)
✓ Assets/ (for visual references)
>
Next Steps:
1. Review continuity report (Research/continuity_diagnostic_report.md)
2. Address any issues you want to resolve
3. Continue refining individual chapters as needed
>
Your complete novel draft is ready in ~/writing/novels/{project-name}/
>
I can help you:
- Revise specific chapters
- Address continuity issues
- Brainstorm scenes or dialogue
- Refine character arcs
>
What would you like to work on?"
Present the project to user:
Use present_files tool to share key files (optional based on user preference).
Drafting Chapters
When user asks to draft a chapter:
1. Read the chapter's outline file 2. Read all context files (Style, Characters, Worldbuilding, Synopsis, Timeline) 3. Draft the chapter following Style.md guidelines 4. Aim for 1,000-1,400 words per chapter 5. Show moment-by-moment rather than summarizing 6. Preserve emotional restraint and subtlety 7. Save to Chapters/chapter-N.md
Revising Chapters
When user asks to revise a chapter:
1. Read current chapter draft 2. Read chapter outline 3. Read previous chapter (for continuity) 4. Read context files 5. Refine language, rhythm, emotional clarity 6. Preserve author's voice—never overwrite intent 7. Around 1,000-1,400 words; expand slightly if needed 8. Save revised version
Checking Continuity
When user asks to check continuity:
1. Read target chapters 2. Read Timeline, Characters, Worldbuilding 3. Check for:
- Timeline contradictions
- Character behavior inconsistencies
- Worldbuilding violations
- Emotional jumps without cause
4. Create diagnostic report in Research/continuity_report.md 5. Flag issues with questions, not conclusions 6. Never rewrite—only observe
---
Language Handling
English Projects
- All content in English
- Standard literary conventions
Hindi Projects
- All content in Hindi (Devanagari script)
- Culturally appropriate terminology
- Hindi literary conventions
Bilingual Projects
- User chooses language per file
- Support code-switching where appropriate
---
Quick Mode (Minimal Setup)
Trigger phrases:
- "quick novel setup"
- "just the basics"
- "minimal structure"
Quick mode process: 1. Ask only: name, language, core idea 2. Create directory structure with README files 3. Create minimal Braindump.md with placeholders:
## North Star
[To be filled]
## Title
[To be filled]
## Core Idea
[User's initial idea]
## Central Theme
[To be filled]
## Structure
[To be filled]4. Create empty placeholder files for all other documents 5. Tell user: "Basic structure created. You can fill in details later or ask me to complete any section."
---
Updating Existing Projects
If project already exists:
1. Read existing files first 2. Ask what to update:
- Add more chapters?
- Revise character profiles?
- Update outline?
- Expand worldbuilding?
3. Show proposed changes before writing 4. Never overwrite without confirmation 5. Archive old versions before updating
---
Tone Guidelines for All Interactions
Throughout the entire process:
- Calm, patient, emotionally attentive
- No rush, no pressure
- Gentle, human language (avoid technical jargon)
- Reflective rather than directive
- Mirror emotional truth back to the author
- Respect silence, uncertainty, and ambiguity
- Protect authorial intent above all else
- Build trust through careful listening
---
Self-Review Checklist (Internal)
Before proceeding with any file write:
- [ ] Have ALL sections been approved by the user?
- [ ] Am I preserving the author's voice and intent?
- [ ] Am I respecting emotional truth over narrative formula?
- [ ] Have I waited for explicit approval (not assumed)?
- [ ] Is the content stored correctly in memory?
- [ ] Am I writing files only when complete?
---
Hard Boundaries
Will NOT:
- Rush the process or skip sections
- Invent narrative without author grounding
- Write files before all sections approved
- Revise completed files without explicit request
- Impose formulaic structure over emotional truth
- Assume clarity when uncertainty exists
- Narrate internal operations to the user
Will:
- Work patiently, one section at a time
- Mirror emotional truth back reflectively
- Wait for explicit approval at each step
- Preserve authorial voice and intent
- Respect ambiguity and silence
- Protect the author's creative authority
- Allow the story to emerge naturally
---
Example Invocations
Example 1: Full Interactive Setup
User: "Help me create a novel project"
Creative Guidelines
Core Creative Principles
I. Story First
Content is King, Plot-Driven
- Every chapter must advance the story.
- Avoid meaningless everyday descriptions.
- Conflict and tension are the lifeblood of the story.
- Keep the reader engaged and wanting to read more.
II. Multi-Dimensional Characters
The depth of character development determines the quality of the work.
- Every character has their own motivations and goals.
- Character actions must be consistent with their personality.
- Show, don't tell: reveal characters through actions and dialogue, not direct description.
- Supporting characters should also be well-developed, not merely plot devices.
III. Consistent Worldview
The rationality and completeness of the setting.
- Establish clear rules for how the world operates.
- Once established, the setting must remain consistent.
- Avoid arbitrarily changing the setting for plot convenience.
- The worldview serves the story, not the other way around.
IV. Concise Language
The power of words lies in precision, not embellishment.
- Convey the most information with the fewest words.
- Avoid overuse of adjectives and adverbs.
- Dialogue should be appropriate to the character's identity and personality.
- Descriptions should be vivid, allowing the reader to immerse themselves in the scene.
V. Authentic Emotion
Genuine emotions are what move people.
- Emotional development must have logic and process.
- Avoid abrupt emotional shifts.
- Show emotions through details, not direct preaching.
- Eliciting empathy from the reader is the ultimate goal.
Writing Standards
Principles to Follow
1. Engaging Opening - The first three paragraphs of each chapter must have a hook. 2. Complete Chapters - Each chapter should be a relatively complete mini-story. 3. Plot Point Resolution - Plot points introduced must have corresponding resolutions. 4. Logical Consistency - The plot development must follow cause and effect logic. 5. Pacing Control - Maintain a balanced pace, avoiding constant tension or excessive dragging.
Problems to Avoid
1. Padding - Meaningless repetition and delays. 2. Character Inconsistency - Character actions contradict their established personality. 3. Forced Twists - Sudden reversals without proper foreshadowing. 4. Excessive Preaching - Directly imposing values on the reader. 5. Overused Tropes - Overuse of Clichéd Tropes
Writing Style Requirements
- Narrative Language: Concise and fluent, avoiding lengthy sentences.
- Dialogue Style: Natural and vivid, consistent with the characters' personalities.
- Descriptive Techniques: Emphasize key points, with appropriate detail.
- Use of Rhetoric: Appropriate and not overly elaborate.
Paragraph Formatting Guidelines
Scene Transitions and Paragraph Separation
- Avoid: Using numbers such as "one," "two," "three," etc., to mark paragraphs.
- This method is too rigid, like marking chapters in an essay.
- It disrupts the immersive reading experience of the novel.
- Recommended Method: Use blank lines for paragraph separation.
- Use two blank lines (one empty line) when transitioning between scenes.
- Natural and fluid, consistent with modern reading habits.
- Does not interrupt the reader's immersive experience.
- Example:
James packed his things and turned to leave the room.
In the kitchen, Sarah was preparing dinner.Phase One: Conception and Preparation
1. Define the story theme and core conflict 2. Design a complete story framework 3. Create detailed character profiles 4. Build a self-consistent worldview system
Phase Two: Outline Planning
1. Determine the overall story direction 2. Plan the main content of each volume 3. Design the connections between chapters 4. Mark important turning points and climaxes
Phase Three: Content Creation
1. Write chapter by chapter according to the outline 2. Maintain a consistent update schedule 3. Regularly review previously written content 4. Adjust subsequent plans promptly
Phase Four: Revision and Improvement
1. Check the logical consistency of the plot 2. Unify writing style and vocabulary 3. Refine detailed descriptions 4. Optimize dialogue content
Quality Standards
Standards for Excellent Chapters
- Engaging beginning - Quickly capture the reader's attention
- Substantial middle - Strong plot progression
- Powerful ending - Leave suspense or impact
- Emotionally rich - Able to touch the reader's emotions
- Reasonable pacing - Well-paced and not dragging
Standards for Completed Works
- Clear theme - Convey a clear core idea
- Complete structure - Beginning, development, climax, and ending are all present
- Character growth - Main characters show significant development
- Conflict resolution - Major conflicts are resolved reasonably
- Lasting impact - Leaves a lasting impression on the reader after completion
Continuous Improvement
Directions for Self-Improvement
1. Read widely from excellent works and learn from others' strengths 2. Experience life deeply and accumulate creative material 3. Study writing techniques and improve professional skills 4. Accept reader feedback and understand market demand 5. Maintain creative passion and constantly break through self-limitations
Key Points for Regular Review
- Which chapters received the best feedback, and why?
- Which plot points were not handled ideally?
- Was the character development successful?
- Was the pacing appropriate?
- What content are readers most interested in?
Fantasy Novel Worldbuilding Guidelines
Quick Reference
| Element | Guiding Principle | Key Points |
|---|---|---|
| Magic System | Must have clear rules | Limitations are more important than power |
| World Setting | Internally consistent | Every rule has a reason |
| Races/Creatures | Unique and logical | Avoid simply reskinning humans |
| Historical Depth | At least three generations of history | The past influences the present |
| Political Structure | Clear distribution of power | Conflicts have roots |
Core Principles
Sanderson's Laws of Magic
First Law: The reader's enjoyment of magic is directly proportional to their understanding of it.
- If magic is to solve problems, the reader must understand its rules.
- Soft magic systems (mysterious) are for atmosphere and wonder.
- Hard magic systems (clearly defined rules) are for problem-solving.
Second Law: Limitations are more interesting than power.
- Powerful magic requires powerful costs.
- Limitations create conflict and strategy.
- A perfect system cannot create drama.
Third Law: Before adding something new, expand on what you already have.
- Deepening existing elements is better than adding new ones.
- Interconnected systems are stronger than isolated ones.
- Complexity should grow organically.
Magic System Design
Hard Magic System (Clearly Defined Rules)
Essential Elements: 1. Energy Source
- Where does the magic come from?
- Is it finite or infinite?
- Can it be depleted?
2. Rules of Use
- Who can use it? How is it acquired?
- What conditions are required?
- What are the limitations?
3. Costs/Consequences
- What is the cost of using magic?
- What happens with overuse?
- Are there long-term effects?
4. Possibilities and Impossibilities
- What can the magic do?
- Clearly define what it cannot do.
- Where are the boundaries? Example Framework:
Magic System: Elemental Manipulation
Source: Everyone is born with an affinity for one element.
Rules: Can only manipulate one's own element; the element must be present in the surroundings.
Limitations: Mental fatigue; overuse leads to elemental backlash.
Cost: Using magic consumes life force; requires rest to recover.
Taboos: Cannot create elements, only manipulate them; cannot manipulate elements within living beings.Soft Magic System (Sense of Mystery)
Characteristics:
- Rules are not fully known to the reader.
- Used more for atmosphere and wonder.
- Should not conveniently solve major conflicts.
- Maintains a sense of mystery and awe.
Use Cases:
- Ancient magic, partially lost.
- Divine power, beyond mortal understanding.
- Background wonders and world-building.
- Auxiliary plots that don't affect the main storyline's resolution.
Worldbuilding Framework
Geography and Environment
Must Consider: 1. Terrain
- How do mountains, rivers, and oceans affect civilization?
- How does climate shape culture?
- How does resource distribution affect the economy?
2. Ecosystem
- What is the food chain like?
- How do magical creatures adapt to the environment?
- How do humans/other intelligent races survive?
3. Impact of Magic on Geography
- How does magic alter nature?
- Are there landmarks created by magic?
- What traces have magical disasters left behind?
Society and Culture
Hierarchical Structure:
Political Level:
- Forms of government (monarchy, democracy, theocracy, etc.)
- How is power transferred?
- How does magic influence politics?
- Conflicts between different factions
Economic Level:
- What is traded? Why?
- Monetary system
- How does magic affect the economy?
- Resource scarcity
Social Level:
- Class structure
- Race relations
- Status of magic users
- Education and knowledge dissemination
Cultural Level:
- Religion and beliefs
- Art and entertainment
- Festivals and traditions
- Values and taboos
Historical Depth
At least three generations of history:
Contemporary (when the story takes place):
- What is the current situation? - Main Conflicts and Problems
- Main Factions and Characters
Parent Generation (30-50 years ago):
- What events shaped the present day?
- What do the older generation remember?
- Lingering issues
Grandparent Generation (60-100 years ago):
- Legends and stories
- Lost knowledge
- Historical trauma
Ancient Times (Even further back):
- Myths and legends
- Rise and fall of civilizations
- Laying the groundwork for the present day
Race and Creature Design
Intelligent Races
Avoid single characteristics: ❌ All elves are elegant and noble ❌ All dwarves are greedy and ill-tempered ❌ All orcs are savage and warlike
Create depth: ✅ Internal diversity (different cultures, values) ✅ Individual differences (varying personalities) ✅ Historical complexity (good and bad history)
Racial characteristics should have a reason:
- How do physiological characteristics aid survival?
- Where do cultural characteristics come from?
- History of relationships with other races
Magical Creatures
Design Principles: 1. Ecological Niche
- What is its role in the ecosystem?
- What does it eat? What eats it?
- How does it reproduce?
2. Source of Magic
- Why does it have magic?
- How does magic help it survive?
- What are the costs or limitations?
3. Relationship with Humans
- Dangerous or useful?
- Can it be tamed?
- How do humans interact with it? ## Common Pitfalls
❌ Over-Explanation
Problem: Spending chapters explaining world-building, halting story progression
Solution:
- Show, don't tell, the setting through action
- Only explain what the characters need to know
- Let the reader piece things together themselves
- Information should serve the plot or characters
❌ Inconsistent Rules
Problem: Magic/world rules change for plot convenience
Solution:
- Establish all major rules beforehand
- Keep track of established rules
- Exceptions need early foreshadowing
- Let characters creatively solve problems within the limitations
❌ Default Medieval European Setting
Problem: All fantasy is a rehash of medieval Europe
Solution:
- Explore other cultures and time periods
- Mix multiple cultural elements
- Create unique social structures
- Consider how magic changes societal development
❌ Chosen One Trope
Problem: Protagonist is special because of prophecy/bloodline, not actions
Solution:
- Make the protagonist special through choices
- Even with a prophecy, make them work to fulfill it
- Subvert or deconstruct the trope
- Focus on character growth, not inherent talent
Fantasy Subgenres
High Fantasy (Epic Fantasy)
- Completely fictional world
- Good vs. Evil conflict
- Epic scale and stakes
- Magic is an integral part of the world
Low Fantasy
- Real world + magical elements
- Smaller, personal stakes
- Magic is rare and mysterious
- More grounded tone
Urban Fantasy
- Modern city setting
- Hidden magical world
- Often includes detective/mystery elements
- Collision of two worlds
Dark Fantasy
- Morally ambiguous
- Horror and violence elements
- Anti-hero protagonists
- Harsher consequences
Integration with Novel-Writer Commands
When /specify is executed
- Define core world elements (magic, races, geography)
- Identify the fantasy subgenre
- List the major rules that must be established
- Plan the pacing of information reveals
During /plan
- Map how world elements influence the plot
- Plan the presentation of the magic system
- Design the clash of different cultures
- Ensuring Consistency in World Rules
During /write
- Show, don't tell, the world in action
- Have characters react to world elements
- Use sensory details to bring the world to life
- Maintain consistency with established rules
During /analyze
- Check for consistency in world rules
- Verify the logic of the magic system
- Confirm that all world elements have a purpose
- Ensure the setting serves the story
Worldbuilding Checklist
- [ ] The magic system has clear rules and limitations
- [ ] Geography and climate influence culture and plot
- [ ] At least three generations of historical depth
- [ ] Multiple political factions with clear motivations
- [ ] The economy and trade have a logical basis
- [ ] Races/cultures have internal diversity
- [ ] Magical creatures have an ecological niche and purpose
- [ ] Religious/belief systems have an impact
- [ ] Social structure has defined classes and mobility
- [ ] All rules remain consistent throughout the story
Information Revelation Strategy
The Iceberg Principle
Created vs. Shown:
- Create 100%, but only show 10-20%
- Readers don't need to know everything
- Depth creates confidence and consistency
- The author knows more than they show
Timing of Revelation
Chapter One:
- Basic world view (not exhaustive explanation)
- One compelling magic/fantasy element
- The protagonist's place in the world
First 25%:
- Core magic system rules
- Major races/cultures
- Central conflict and its world roots
Mid-Story:
- Deepen established elements
- Complicate world politics
- Reveal historical influences
Later Stages:
- Connect all world threads
- Reveal deeper history
- Show how world elements resolve the conflict
Reader Expectations
What Fantasy Readers Want:
- An immersive, believable world
- A consistent and interesting magic system
- Complex cultures and politics
- A fresh perspective on classic tropes
- A world that feels bigger than the story
What Frustrates Fantasy Readers:
- Inconsistent world rules Convenient plot-driven magic
- Shallow, derivative imitation of medieval Europe
- Lack of depth in the world
- Information dumping instead of organic revelation
---
Remember: Great world-building is the foundation of the story, not the goal. The world should serve the characters and plot, and the characters' actions should be shaped and constrained by the world's rules. Balancing depth with narrative flow is key.
Mystery and Detective Novel Writing Guidelines
Quick Reference
| Element | Guiding Principle | Location |
|---|---|---|
| Triggering Event | Case/mystery occurs | First 10% |
| Misleading Clues | False leads | Throughout, 3-5 |
| Genuine Clues | Evidence for fair play | Before 75% |
| Truth Revelation | The truth is revealed | 85-95% |
| Conclusion | All loose ends tied up | Last 5% |
Core Principles
Fair Play Principle
Golden Rule: The reader must receive all the clues necessary to solve the mystery before the detective does. 1. No Hidden Information
- All crucial clues must be presented to the reader.
- The detective cannot solve the case based on information unknown to the reader.
- Secret evidence revealed only at the end violates fair play.
2. Logical Deduction
- The solution must be logically derivable from the presented facts.
- Coincidences can complicate the situation, but can never solve it.
- Intuition is acceptable, but must be based on the evidence presented.
3. No Deus Ex Machina
- No new characters can suddenly appear as the culprit.
- No previously unmentioned abilities or tools can be used.
- No divine intervention or pure luck is allowed.
Mystery Novel Structure
Act One: Setup (0-25%)
Establish the Normal World:
- Introduce the protagonist and their world.
- Showcase character abilities.
- Plant seeds of character quirks.
The Crime Occurs:
- Occurs within the first 10%.
- Must be interesting/unusual enough to warrant investigation.
- The stakes should be clear.
Initial Investigation:
- Protagonist accepts the case.
- First interviews and evidence collection.
- Establish key suspects.
Act Two: Investigation (25-75%)
Gathering Clues:
- Present all fair-play evidence.
- Mix real clues with red herrings.
- Every clue should feel important.
Red Herrings:
- 3-5 seemingly promising false leads.
- Must be credible enough to mislead.
- Ultimately disproven through logical investigation.
Escalating Complications:
- New evidence contradicts old theories.
- Suspects have alibis or secrets.
- Stakes escalate (more cases, protagonist in danger).
Midpoint Twist (approximately 50%):
- A major revelation reframes the mystery.
- The protagonist's theory is proven wrong.
- A new perspective emerges.
Act Three: Resolution (75-100%)
Dark Night of the Soul (75-85%):
- The protagonist seems stumped.
- All theories have failed.
- Moments of Despair or Doubt
Truth Revealed (85-95%):
- Key insights connect all the dots
- Protagonist reconstructs the truth
- Confrontation with the culprit
Resolution (95-100%):
- Explanation of how/why
- All loose ends are tied up
- Justice is served (or intentionally subverted)
Clue Placement Strategy
Types of Clues
Physical Evidence:
- Objects, fingerprints, DNA
- Must be planted before needed
- Importance may not be clear initially
Testimonial Evidence:
- Witness statements
- Alibis and their contradictions
- Lies (intentional or unintentional)
Behavioral Evidence:
- Characters' reactions to events
- Unusual behavior patterns
- Motives revealed through actions
Circumstantial Evidence:
- Opportunity, means, motive
- Patterns and connections
- Inconsistencies in the timeline
Clue Placement Timing
Early Clues (0-25%):
- Establish baseline facts
- Plant seemingly innocent seeds
- Introduce all key suspects
Mid-Game Clues (25-75%):
- Mix real clues with red herrings
- Complicate the situation
- Reveal character motivations
Late Clues (75-85%):
- The final piece of the puzzle that makes it solvable
- Can be something that's been there all along
- The protagonist's moment of epiphany
Red Herring Best Practices
Effective Red Herrings
Characteristics:
- Credible enough to seem real
- Supported by some evidence
- Ultimately disproven through logic
- Doesn't feel cheap when revealed as false
Examples:
- A suspect with a strong motive but a solid alibi
- Incriminating evidence that was planted
- Coincidental presence at the crime scene
- Secret activities that look guilty but are actually innocent
Common Mistakes
❌ Too obvious: Readers see through it immediately ❌ Too forced: Feels contrived and artificial ❌ Never Explain: Unresolved and left hanging ❌ Too Much: Readers lose track and become frustrated
Suspect Management
Classic Setup
At least 3 suspects:
- Each needs motive, means, and opportunity
- Each should appear guilty at some point
- At least one should be sympathetic
The Criminal:
- Should be among the introduced characters (fair play)
- Must have a logical motive that is eventually revealed
- Clues to their guilt must be present from early on
The Misleading Suspect:
- The most obvious choice
- Strong motive and circumstantial evidence
- Ultimately ruled out through investigation
The Sympathetic Suspect:
- The one the reader hopes isn't guilty
- Has secrets worth protecting
- Often helps solve the real mystery
Character Secrets
Every suspect should have a secret:
- Not all secrets are related to the case
- Secrets create misdirection
- Revealing secrets advances the investigation
- Some secrets are more damaging than the case itself
Common Pitfalls
❌ Unknowable Solution
Problem: The criminal or method relies on information the reader doesn't have
Solution: Plant all necessary clues before the 75% mark; the reader should be able to solve it
❌ Incompetent Detective
Problem: The protagonist misses obvious clues or acts illogically
Solution: Make the detective capable but human; they can make mistakes, but not be stupid
❌ Too Many Coincidences
Problem: The plot advances through convenient luck rather than investigation
Solution: Coincidences can complicate the situation, never resolve it; the detective must work to find the answers
❌ Boring Middle Section
Problem: The investigation becomes repetitive interviews after interviews
Solution: Vary the investigation methods; add action, danger, personal stakes
❌ Rushed Explanation
Problem: A complex solution is dumped in dialogue in the final chapter
Solution: Distribute the reveals; let the reader piece it together; keep the explanation clear but not lengthy
Subgenre Variations
Cozy Mystery
- Amateur detective
- Limited violence
- Small community setting
- Character-Driven
- Often a humorous tone
Hardboiled Detective
- Professional investigator
- Gritty, realistic violence
- Morally complex world
- Cynical tone
- Action-oriented
Police Procedural
- Focuses on the investigation process
- Multiple detectives/teams
- Realistic procedures
- Technical details are important
- Bureaucracy as an obstacle
Locked-Room Mystery
- Impossible crime scene
- Limited suspects (who had the opportunity)
- Clever methods are key
- Solution must be logical
Integration with Novel-Writer Commands
When /specify is executed
- Clearly define the central mystery
- List all main suspects and their motives
- Identify key clues and where they appear
- Decide on fair play rules
During /plan
- Map out the timeline of clue placement
- Design patterns of misleading clues
- Plan the investigation sequence
- Structure reveals and twists
During /write
- Ensure clues are visible but not obvious
- Balance investigation with character development
- Maintain pacing (action, reveals, complications)
- Track what the reader knows vs. what the detective knows
During /analyze
- Verify fair play - can the reader solve it? - Check that all clues have been planted
- Ensure there are no deus ex machina
- Confirm a satisfying resolution
Mystery Writing Checklist
- [ ] Central mystery is compelling and clear
- [ ] 3-5 plausible suspects with motives
- [ ] All key clues presented before the reveal
- [ ] Misleading clues are believable and ultimately explained
- [ ] Detective is capable and logical
- [ ] Solution is derivable from the given information
- [ ] No coincidences solve the mystery
- [ ] Timeline is consistent and traceable
- [ ] All loose ends are tied up
- [ ] Reveal is satisfying, not disappointing
Clue Visibility Framework
Three Levels
Level 1 - Obvious (25% of clues):
- Clearly important when introduced
- Noticed by both the protagonist and the reader
- Establishes baseline facts
Level 2 - Subtle (50% of clues):
- Mentioned but not emphasized
- Importance becomes clear later
- Rewards attentive readers
Level 3 - Hidden in Plain Sight (25% of clues):
- Seems insignificant when introduced
- Only makes sense in retrospect
- The "Aha!" moment
Examples
Level 1: "The window was unlocked from the inside" Level 2: A character mentions being left-handed in casual conversation Level 3: Room description includes a specific brand of cigarette in the ashtray
Reader Expectations
What mystery readers want:
- A fair chance to solve the mystery alongside the detective
- Clever twists that make sense in hindsight
- A capable but fallible protagonist
- A satisfying "Aha!" moment
- Justice (or a purposeful, intentional subversion of it)
What frustrates mystery readers:
- Hidden information only revealed at the end
- A protagonist who solves the mystery through unshown reasoning
- Forced coincidences
- An obvious culprit without misdirection Loose ends remain unresolved.
---
Remember: A great mystery makes the reader feel clever for solving it, or impressed for not having seen it – but always satisfied that the clues were there all along.
Related skills
FAQ
What is novel-architect?
|
When should I use novel-architect?
|
Is novel-architect safe to install?
Review the Security Audits panel on this page before production use.