Răsfoiți Sursa

chore: remove docs from tracking, archive locally

Ma 7 luni în urmă
părinte
comite
56f3bbdb19

+ 1 - 0
.gitignore

@@ -12,3 +12,4 @@ _tmp_*
 test-project/
 .venv*/
 .gstack/
+docs/

+ 0 - 2277
docs/english-locale-research.md

@@ -1,2277 +0,0 @@
-# InkOS English Locale — Comprehensive Writing Research
-
-This document contains all research needed to build an English prompt set for InkOS, targeting English web fiction platforms (Royal Road, Kindle Unlimited, Scribble Hub). It synthesizes genre conventions, craft rules, AI-detection patterns, and audit dimensions for automated novel writing system instruction.
-
----
-
-## 1. Genre Profiles (Complete)
-
-English web fiction has a fundamentally different genre landscape from Chinese platforms. The following 10 genres represent the core taxonomy.
-
-### 1.1 LitRPG (Literary Role-Playing Game)
-
-**Genre ID**: `litrpg`
-
-**Reader Contract**: "I want to watch a character grow stronger through quantified, visible progression. I expect clear game mechanics, consistent system rules, and the satisfaction of seeing numbers improve. The system itself should be a character—rule-based, logical, and internally consistent."
-
-**Hard Rules (Break These and Readers Leave)**
-1. System consistency—once established, rules cannot change arbitrarily. Readers will catch violations reliably.
-2. Visible progression—stats, levels, and skill acquisitions must be apparent. Hiding them frustrates readers.
-3. Meaningful power curves—progression feels earned, not arbitrary. Too-fast = boring; too-slow = abandoned.
-4. No unexplained power jumps—character growth must follow established system logic.
-5. Respect reader game knowledge—many readers have played actual RPGs and identify broken mechanics immediately.
-
-**Sub-Types**
-
-**Crunchy vs. Lite LitRPG**
-- **Crunchy**: Data-heavy, detailed stat sheets, complex skill trees, spreadsheet-like presentation. Appeals to seasoned gamers.
-- **Lite/Creamy**: Minimal mechanics, narrative focus over numbers, accessible to non-gamers. Mechanics serve story.
-- Reader self-selection is stark: readers often select *only* "crunchy town-builders" or "lite progression."
-
-**VR vs. Real-World LitRPG**
-- **VR**: Characters enter game worlds via headsets/pods. Clear separation between real and virtual.
-- **Real-World/System Apocalypse**: Game mechanics invade Earth. All survival has mechanical weight.
-
-**Solo vs. Guild vs. Town-Building**
-- **Solo**: Single protagonist grinding and growing alone.
-- **Guild**: Focus on party dynamics, team progression, faction politics.
-- **Town-Building**: Base-building as primary mechanic. MC builds and manages structures, NPCs, economies.
-
-**Other Sub-Types**
-- Crafting-focused (blacksmithing, alchemy, cooking, enchanting as primary class)
-- Deckbuilding (characters collect and duel with card decks)
-- Harem (romance subplot with multiple love interests; contentious subgenre with explicit reader tagging)
-
-**System Design Fundamentals**
-
-**Stat Architecture**
-- Systems typically include core stats (Strength, Dexterity, Intelligence, Constitution, Wisdom, Charisma) or custom variations.
-- Derivative stats (HP, Mana) should depend on primary stats logically (e.g., HP = CON × Level).
-- Successful systems maintain numerical consistency across entire narrative using spreadsheets.
-
-**Skill Acquisition and Progression**
-- Skills progress through tiers: Apprentice → Journeyman → Master, unlocking higher-tier abilities.
-- Experience requirements follow exponential decay (like WoW) or linear progression with milestone spikes.
-- Each skill unlock should feel *earned*, tied to genuine risk/sacrifice/problem-solving, not free gifts.
-
-**Progression Curves** (Four Main Patterns)
-1. **Linear**: Steady, slow growth. Grounded and realistic but can feel grindy.
-2. **Exponential Decay**: Fast early levels, slowing dramatically. Matches MMO expectations.
-3. **Milestone-Based**: Clear stages (Beginner → Base Class → Advanced Class → Tiers). Transitions have power spikes.
-4. **Ranked Tiers**: Discrete jumps between ranks (Iron → Bronze → Silver → Gold) with exponential gains at each step.
-
-**Critical Progression Rule**: Test pacing by ensuring Book 3 MC decisively defeats Book 1 version but not so overwhelmingly challenges feel trivial.
-
-**Presenting System UI in Prose**
-
-**Blue Box Method** (Most Common)
-- Use code block formatting (Royal Road tables, monospace blocks).
-- Appears after action/revelation, not mid-scene.
-- Example: `[Status: Level 12 acquired] Strength: 14 → 15 Dexterity: 12 → 13`
-
-**System Voice/Personality**
-- Give the system character: formal, archaic, playful, or clinical tone.
-- Consistent phrasing becomes part of worldbuilding.
-- Example: System always says "Quest Accepted" vs. "Task Logged" signals flavor.
-
-**Narrative Integration**
-- Describe stats in narration first (audiobook-friendly, immersive).
-- Include full stat sheet for readers who want details.
-- Avoid info-dumping during action scenes.
-
-**Key Principle**: Stat blocks should interrupt narrative tension minimally. Use them to punctuate moments of achievement.
-
-**Common Mistake**: "Blue Box Madness"—stats every chapter, stat dumps pages long. Save reveals for meaningful moments.
-
-**Beloved Tropes**
-- Underdog rises to power
-- Unique class/skill only protagonist can access
-- Mentor relationship with skilled NPC
-- Discovery of hidden skill/talent
-- Breaking through level caps and power thresholds
-- First level feels weak but rewarding
-
-**Tired Tropes to Avoid**
-- Instant mastery—character acquires skill and immediately excels
-- Secret ancient power—protagonist finds item/skill no one else thought to use
-- Overpowered main character—starting too strong removes tension
-- Harems—if included without character work, feel tacked on
-- Chosen one narrative—especially tied to destiny rather than earned power
-- System message overload—too many stat dumps break immersion
-- Poor female portrayal—women as "perfect girlfriend" or "sickly daughter"
-
-**Pacing and Chapter Structure**
-
-**Typical Royal Road Pacing**
-- Chapter length: 2.8k–3.5k words is sweet spot (depends on stat density)
-- Release schedule: 2–5 chapters/week (2k word chapters) or 1/week (4–8k chapters)
-- Chapter structure: Opening hook/recap → Action/exploration/character moment → System interaction/stat gain → Cliffhanger/transition
-
-**Progression Pacing**
-- Early chapters: frequent level-ups and stat increases (every 1–3 chapters)
-- Mid-story: level-ups every 5–10 chapters, harder to achieve
-- Late story: tier/rank transitions spaced far apart, each representing massive growth
-
-**Common Mistakes That Tank LitRPG Stories**
-1. Author doesn't know the system—making up mechanics as you go
-2. Info-dump syndrome—explaining system rules at length instead of revealing organically
-3. Stats ≠ character development—numbers going up is hollow without emotional weight
-4. Poor editing—grammar, spelling errors "absolutely KILLING this genre"
-5. Uninteresting MC vs. detailed world—elaborate system, bland protagonist
-6. Lack of stakes—progression without risk/difficulty
-7. Unexplained power scaling—character gets stronger but readers can't track why
-8. Boring skill descriptions—abilities need flavor, not just mechanical output
-
-**Example Stories**
-- **Dungeon Crawler Carl** (Matt Dinniman): Linear progression, stats tied to survival, sparse stat blocks, professional audio production, 280,000+ RR ratings
-- **He Who Fights with Monsters** (Shirtaloon): Ranked tier system, unique hybrid cultivation/LitRPG mechanics, strong character voice
-- **Awaken Online** (Travis Bagwell): VR LitRPG with villain-protagonist, player freedom, nearly 1M copies sold
-- **The Wandering Inn** (pirateaba): Portal fantasy/isekai LitRPG, system focuses on Classes/Skills/Levels for character storytelling, 16+ million words
-- **Primal Hunter** (Zogarth): System apocalypse, archer/hunter with specific identity, 11,000+ monthly patrons
-
----
-
-### 1.2 Progression Fantasy
-
-**Genre ID**: `progression`
-
-**Core Definition**: A fantasy subgenre centered on protagonist's *intentional and quantifiable* increase in power, skill, or magical ability. The journey of growth is the primary narrative driver. Unlike LitRPG, explicit game mechanics (stats, levels) are optional; the focus is on structured, visible advancement.
-
-**Key Distinction from LitRPG**
-- **Progression Fantasy**: No game UI required. Power growth through mystical training, cultivation, martial arts, or magical cultivation. Uses words like "Rank," "Stage," "Cultivation Level."
-- **LitRPG**: Game mechanics and notifications are essential parts of reading experience.
-- **Overlap**: All LitRPG is technically progression fantasy, but not all progression fantasy is LitRPG.
-
-**Reader Contract**: "Show me a protagonist learning, training, struggling to grow stronger. I want clear milestones, earned power gains, and visible transformation. The protagonist should feel fundamentally different between Act 1 and Act 3."
-
-**Hard Rules**
-1. Progress must be quantifiable—even without explicit numbers, use measurable advancement (Stage 3 cultivator, Master swordsman).
-2. No power loss—progress loss scares off readers more than virtually anything else.
-3. Clear power tiers—readers use these to understand world power levels. Once established, tier progression must follow logic.
-4. Earned growth—power gains must connect to effort, sacrifice, or problem-solving.
-5. Book-to-book comparison—Book 3 protagonist should decisively defeat Book 1 version.
-
-**Three Major Styles**
-
-**Eastern-Style (Xianxia/Wuxia Foundation)**
-- Cultivation through meditation, qi manipulation, internal energy
-- Emphasis on philosophy, enlightenment, Buddhist/Taoist concepts
-- Often includes immortality seeking, heavenly tribulations
-- Example: *Cradle* (western interpretation of eastern concepts)
-
-**Western-Style Progression Fantasy**
-- Borrows cultivation mechanics but strips traditional Chinese cultural trappings
-- Magic systems with Western naming conventions (Copper → Iron → Jade → Gold instead of Qi Condensation → Core Formation)
-- Academy settings, mentorship, adventuring parties
-- Example: *Warformed: Stormweaver*
-
-**LitRPG-Adjacent**
-- Uses explicit game mechanics but emphasizes growth journey over system mechanics
-- Blurs line between progression fantasy and LitRPG
-
-**Power System Design Principles**
-
-**Tier/Rank Systems** (Common Patterns)
-- **Color Tiers**: White (beginner) → Yellow → Orange → Red → Gold (master)
-- **Metal Tiers**: Copper → Iron → Bronze → Silver → Gold
-- **Cultivation Stages**: Foundation → Golden Core → Immortal Ascension
-- **Letter Ranks**: F (weakest) → E → D → C → B → A → S → SS
-
-Each tier should represent *meaningful* power difference. Characters at different tiers shouldn't compete directly. Physical transformations signal mental ones: eye color, hair color, wings, horns manifest at specific tiers.
-
-**Quantifiable Advancement** (Methods Without Explicit Numbers)
-- Technique mastery (bronze-level sword strikes vs. silver-level)
-- Capacity increase (can hold more mana, sustain spells longer)
-- Spiritual attribute development (sensitivity to magic, intuition)
-- Combat capability (can fight and win against tier X enemies)
-
-**Training Arcs vs. Individual Breakthroughs**
-- **Montage Risk**: Training montages can feel rushed. Readers want *some* individual training scenes showing struggle, failure, epiphanies.
-- **Breakthrough Scenes**: When protagonist achieves tier advancement, deserves a scene showing struggle, breakthrough, transformation.
-- **Best Practice**: Mix montages (covering weeks) with 1–2 detailed breakthrough scenes per tier.
-
-**Maintaining Tension as MC Gets Stronger**
-
-**Problem Scaling**
-- Introduce enemies/challenges that scale faster or introduce different threat types
-- Strongest threat need not be physical: political, magical, spiritual, temporal
-- Example: *Cradle*—as Lindon grows, new factions and cultivation sects present equal or greater challenge
-
-**Internal Struggle Escalation**
-- Power doesn't solve everything. New power unlocks new problems (pride, responsibility, temptation, enemies).
-- Emotional stakes must rise with power stakes.
-
-**Shifting Power Hierarchies**
-- Early story: MC is underdog among peers
-- Mid-story: MC becomes formidable but others advance too
-- Late story: MC among strongest but faces tier-transcending threats
-
-**Beloved Tropes**
-- Underdog from weak background
-- Mentor relationship and eventual transcendence of mentor
-- Breakthrough moments with dramatic transformation
-- Accumulation of techniques and power combinations
-- Rivalry with peer who also progresses
-- Discovery of unique cultivation path/technique
-- Facing the impossible and barely succeeding through growth
-
-**Tired Tropes to Avoid**
-- Instant power-up—finding an item that grants instant power
-- Bloodline awakening without buildup—protagonist suddenly has latent power
-- Training montage only—readers want at least some detailed training scenes
-- Arbitrary advancement blocks—rules feeling like artificial gates
-- Power that doesn't solve problems—progression should open new story paths
-
-**Pacing Expectations**
-- **Tier advancement**: Every 2–4 chapters early (rapid growth, high-stakes breakthroughs)
-- **Mid-story**: Every 8–15 chapters (growth slowing, advancement harder)
-- **Late-story**: Every 20+ chapters (major tier jumps, rare and climactic)
-
-**Chapter Structure**
-- Training/learning moment
-- Application/combat testing
-- Breakthrough trigger
-- Advancement scene or cliffhanger
-
-**Example Stories**
-- **Cradle** (Will Wight): Western cultivation with clear tier system (Copper → Iron → Jade → Gold → Underlord). Lindon starts as "runt," cast out for weakness. New York Times bestseller.
-- **Defiance of the Fall** (TheFirstDefier): System apocalypse progression fantasy with xianxia elements. 20+ million RR views.
-- **He Who Fights with Monsters** (Shirtaloon): Hybrid cultivation/LitRPG with ranked advancement and strong character voice.
-
----
-
-### 1.3 System Apocalypse
-
-**Genre ID**: `system-apocalypse`
-
-**Core Definition**: A game-like system appears in the world during an apocalyptic event, forcing characters to adapt to new reality where magic, levels, quests, and game mechanics are real. Combines LitRPG mechanics with survival fiction.
-
-**Reader Contract**: "The world has fundamentally changed. I want to see how people adapt to supernatural/magical reality, balance survival with power fantasy, and build new society from collapse."
-
-**Hard Rules**
-1. Day Zero must matter—the inciting incident should change everything permanently. No reverting to old world.
-2. Survival pressure early—early chapters must establish genuine danger. Readers want to feel stakes.
-3. System integration must be logical—system arrival should have in-world explanation (however vague).
-4. Real-world consistency—if system arrives on Earth, maintain real geography, real consequences.
-
-**The "Day Zero" Opening and Conventions**
-
-**Common Patterns**
-1. Sudden integration—system appears with notification. Protagonist suddenly sees HUD, stats, quests. World immediately transforms.
-2. Tutorial phase—first days/weeks are "tutorial," gentler challenges, gradual escalation.
-3. Societal collapse—governments fall, infrastructure breaks, civilization shatters. Survivors must organize.
-4. Factions form—within hours/days, groups form: government remnants, criminal networks, system cults, military consolidation.
-
-**Critical Moment** (Chapters 1–3): Establish:
-- How normal person reacts to system appearance
-- First death or near-death (establishes real stakes)
-- Understanding that old rules are gone
-
-**Balancing Survival with Power Fantasy**
-
-**Early Story (Chapters 1–30)**
-- Focus: Survival, resource gathering, learning system mechanics
-- Power fantasy is muted; MC is weak, struggles with level 1–5 monsters
-- Readers want desperation, not dominance
-
-**Mid-Story (Chapters 30–100+)**
-- Focus: Growing stronger, claiming territory, power politics
-- MC becomes formidable but faces tier-scaled challenges
-- Power fantasy increases; survival becomes strategic
-
-**Late-Story**
-- Focus: Societal rebuilding, faction wars, world-scale threats
-- MC is powerful but not unstoppable; challenges are existential/political
-
-**Key Balance Technique**: Introduce *new* threat types as MC grows. Example: MC defeats zombies/low-tier monsters but discovers intelligent predators, rival factions, interdimensional invasions.
-
-**Societal Collapse Portrayal**
-
-**Essential Elements**
-1. Infrastructure failure—food, water, electricity, medicine stop
-2. Government vacuum—official structures collapse or fracture. Martial law or warlordism emerges.
-3. Human behavior spectrum—some help, some exploit, some break. Avoid binary good/evil.
-4. Resource scarcity—water, ammunition, medical supplies, safe shelter drive conflict
-
-**Tropes**
-- **Safe house**: Temporary refuge offering physical safety and mental reprieve. Often marks turning points.
-- **Journey**: Group traveling through devastated landscape toward goal. Allows full-range encounters.
-- **Survivor guilt/hope tension**: Characters wrestle between despair and reason to rebuild.
-
-**Faction Building and Politics**
-
-**Faction Types**
-- Military/government remnants (organized, disciplined, possibly authoritarian)
-- Criminal networks (exploit chaos, control black markets, prey on weak)
-- Cults (worship the system, may sacrifice followers)
-- Survival communities (towns banding together, often democratic)
-- Warlords/strongmen (charismatic leaders claiming territory)
-- Isolationists (avoid society, set up hidden communities)
-
-**Political Complexity**
-- Factions should have competing interests, not all evil/good
-- MC becomes political player: making alliances, enemies, navigating complex webs
-- Readers enjoy intrigue and political depth
-
-**Integration of Real-World and Fantasy Elements**
-
-**Grounding Techniques**
-- Name real locations (if MC is in USA, mention states, cities)
-- Acknowledge real infrastructure (highways, power lines, hospitals are now dangerous/ruined)
-- Use real weapons/survival skills: firearms, first aid, agriculture, carpentry matter
-- Maintain daylight cycles, weather, seasons
-
-**Tech Integration**
-- Survivors try to use old-world tech: vehicles (fuel issues), weapons (ammo), medicine
-- Show why tech fails in magical world or doesn't; internal consistency matters
-- Hybrids interesting: magic-powered vehicles, guns enhanced with spells
-
-**Pacing and Chapter Structure**
-- **Early (Chapters 1–15)**: Integration, confusion, first dangers. Shorter chapters (2–3k).
-- **Mid (Chapters 15–50+)**: Learning system, power-up, establishing base. Varied length.
-- **Late**: Expansion, war, existential threats. Can sustain longer chapters.
-
-**Example Stories**
-- **Defiance of the Fall** (TheFirstDefier): System apocalypse with cultivation elements. MC alone in wilderness. 20+ million RR views.
-- **The Primal Hunter** (Zogarth): Office worker thrust into system apocalypse tutorial. Character development and progression focus.
-
----
-
-### 1.4 Dungeon Core
-
-**Genre ID**: `dungeon-core`
-
-**Core Definition**: Protagonist is a dungeon, dungeon core, or magical construct bound to a location. Cannot leave but can reshape surroundings, create minions, set traps, grow stronger. Often pseudo-LitRPG with base-building management gameplay.
-
-**Reader Contract**: "I want to experience strategic base-building and optimization. I accept non-human POV and limited mobility in exchange for interesting economic systems, trap design, and creature management. The dungeon itself is the protagonist."
-
-**Hard Rules**
-1. Immobility is feature, not bug—dungeon can't go on adventures. Tension comes from what threatens the core.
-2. Consequence for strategic failure—if dungeon designs trap poorly or creates weak minions, adventurers will punish it.
-3. Core is vulnerable—the core itself must be protected. This is central tension.
-4. POV clarity—reader must understand dungeon's sensory/cognitive limitations.
-
-**Non-Human POV Challenges**
-
-**Sensory Limitations**
-- Dungeon can't leave. Limited direct sensory input.
-- Often "feels" through mana flows, monster senses, vibrations in dungeon structure.
-- Dungeon learns about outside world through adventurers, scouts, or other means.
-
-**Solution**: Split POV or relay POV.
-- Primary POV: Dungeon core (strategic, omniscient within dungeon)
-- Secondary POV: Adventurer, NPC, or dungeon minion exploring dungeon (reader's ground-level perspective)
-
-This 50/50 split helps readers stay grounded in familiar human experience while experiencing dungeon's alien perspective.
-
-**Cognitive Differences**
-- Dungeon thinks slower (no human-speed consciousness)
-- Dungeon might experience time differently (seasons pass in what feels like days)
-- Dungeon has no human emotions (or slowly develops them)
-
-**Base-Building Narrative Mechanics**
-
-**Resource Management in Prose**
-Instead of showing spreadsheets:
-- Describe dungeon's mana reserves and regen rate
-- Show cost/benefit of spawning creatures or enchanting rooms
-- Create scarcity: dungeon must choose between defense, expansion, treasure hoarding
-
-**Example Progression**
-- **Early**: Simple dungeon, 3–4 rooms, basic traps, weak monsters. Dungeon learns system.
-- **Mid**: Expanding territory, specialized rooms (library, forge, breeding), sophisticated trap combinations.
-- **Late**: Sprawling complex, hundreds of minions, political relationships with other dungeons/factions, regional economic impact.
-
-**Trap and Creature Design**
-- Readers enjoy reading about creative dungeon design
-- Each room/trap/creature should feel *purposeful*
-- Show dungeon learning: "Adventurers bypassed the arrow trap by..." → "Next iteration adds reinforced walls"
-
-**Creating Tension When MC is a Building**
-
-**External Threat**
-- Adventurer parties seeking treasure or to kill dungeon
-- Rival dungeons competing for territory/resources
-- Natural disasters threatening dungeon stability
-- Government/military wanting to control dungeon
-
-**Internal Tension**
-- Resource scarcity: not enough mana to do everything
-- Minion rebellions or dissatisfaction
-- Dungeon's own curiosity/ambition creating danger
-- Moral conflicts (dungeon kills adventurers; is dungeon evil?)
-
-**Progression Tension**
-- Dungeon can grow stronger, but with vulnerability windows
-- Dungeon evolution/tier advancement creates periods of weakness
-- New abilities come with new risks
-
-**POV Management Best Practices**
-
-**Single Dungeon POV** (Harder)
-- Keep readers inside dungeon's perspective only
-- Show external events through dungeon's limitations (hearing screams, sensing mana disturbances)
-- Risk: readers feel trapped/limited
-- Successful example: internal monologue and dungeon learning from observer NPCs
-
-**Split POV** (Easier for Beginners)
-- Alternate: Dungeon core chapters → Adventurer/NPC exploration chapters
-- 50/50 split works well
-- Adventurer chapters ground reader in familiar human perspective and build suspense
-
-**Relay POV**
-- Dungeon learns through minions' senses/reports
-- Requires clear communication/understanding mechanism between dungeon and creatures
-- Creates filter between dungeon and reader
-
-**Avoiding Common Pitfalls**
-1. Lone-wolf dungeon—dungeon interacts only with adventurers. Add dialogue and NPC relationships.
-2. Overemphasis on adventurer POV—if 70%+ is adventurers, it's not dungeon core.
-3. No consequence for design failures—make dungeon learn and adapt.
-4. Reader annoyance with inability—make dungeon's strategic position interesting, not frustrating.
-
-**Example Stories**
-- **Dungeon Born** (Dakota Krout): First in Divine Dungeon series. Dungeon learns and grows, creating increasingly sophisticated challenges.
-- **Rise of a Rogue Dungeon** (Royal Road): Focuses on dungeon's relationships with creatures and region.
-
-**Chapter Structure**
-- **Dungeon POV chapters**: 2–3k words. Internal monologue, planning, resource management, strategy.
-- **Adventurer POV chapters**: 2–3k words. Exploration, discovery, combat, adaptation.
-- **Alternating pattern**: Works well. Ends dungeon chapter on suspense (adventurers approaching); ends adventurer chapter revealing dungeon's plan.
-
----
-
-### 1.5 Tower Climber
-
-**Genre ID**: `tower-climber`
-
-**Reader Contract**: "I want vertical progression through clearly defined floors/biomes. Each floor is a distinct challenge. Difficulty tiers are transparent. The protagonist climbs toward a known goal at the summit."
-
-**Hard Rules**
-1. Each floor must be materially different—not just cosmetic reskinning
-2. Floor difficulty escalates predictably—readers should understand power requirements
-3. Clear "summit" goal—readers need to know what success looks like
-4. Progression is vertical, not horizontal—climber doesn't go sideways
-
-**Chapter Structure**
-- Floor introduction (new challenges, environmental detail)
-- Exploration and problem-solving
-- Confrontation with floor's challenge (boss, puzzle, trial)
-- Advancement to next floor
-
-**Example Stories**
-- Tower climbing is common on Royal Road, often combined with LitRPG or progression fantasy
-
----
-
-### 1.6 Cozy Fantasy / Slice-of-Life
-
-**Genre ID**: `cozy`
-
-**Core Definition**: Fantasy fiction emphasizing hope, kindness, empathy, and community. Features characters in everyday magical routines, slice-of-life elements, and low-stakes conflict. Often single-location settings (small town, inn, shop). Focus on relationships: family, found family, friendship.
-
-**Reader Contract**: "I want comfort, warmth, and emotional connection. I'm not seeking danger or high stakes. Show me characters helping each other, building community, experiencing wonder in small magical moments. This is a refuge, not a battlefield."
-
-**Hard Rules**
-1. No genre bait-and-switch—if you promise cozy, don't introduce world-ending threat or graphic violence
-2. Low stakes can still engage—conflict can exist but avoid existential threats
-3. Emotional arcs over action arcs—character development happens through emotional breakthroughs
-4. Community as character—setting and community are as important as individual protagonist
-5. Hope must be present—even sad moments don't end in despair
-
-**What Makes Cozy Fiction Work**
-
-**Essential Elements**
-1. Comforting details—food (tea, baked goods), comfortable spaces, sensory warmth
-2. Character kindness—characters help without extensive cost/trauma. Goodness is rewarded.
-3. Found family—strong relationship bonds
-4. Slow pacing—space for character moments, reflection, small conversations
-5. Wonder without danger—magic exists and is beautiful but not inherently threatening
-
-**Tone**
-- Conversational, intimate
-- Humor is gentle, not cruel
-- Authorial voice is warm, even when describing conflict
-
-**Low-Stakes Conflict That Still Engages**
-
-**Types of Conflict**
-- Personal growth—character struggling with self-doubt, past trauma, learning to trust
-- Community problem—town needs harvest before winter, shop struggling, neighborhood conflict
-- Relationship tension—misunderstanding between friends, unresolved feelings, communication breakdown
-- Small danger—monster in the woods (not extinction-level threat), wild magic accident
-- Moral dilemma—choosing between loyalties, ethical quandary with no perfect answer
-
-**Key Principle**: Stakes are high *emotionally* but not existentially. Character failing matters because they care, not because world ends.
-
-**Slice-of-Life vs. Cozy Fantasy Spectrum**
-
-**Slice-of-Life Heavy**
-- Minimal plot. Emphasis on daily routines, small discoveries, character observation.
-- Some readers want *no* conflict at all
-- Risk: feels static or dull if no arc exists
-
-**Cozy Fantasy with Plot**
-- Clear character/community arc, gentle resolution
-- Small conflicts woven through
-- Most successful cozy fantasies blend both: slice-of-life texture with emotional throughline
-
-**Best Practice**: Define upfront what "cozy" means for your story. Advertise accurately to manage reader expectations.
-
-**Emotional Arcs in Cozy Fantasy**
-
-**Character Arc Example**
-- **Start**: Character isolated, grieving, or self-doubting
-- **Journey**: Small community interactions, gradual opening to hope
-- **Climax**: Emotional breakthrough (not battle)
-- **Resolution**: Character healed/transformed, integrated into community
-
-**Community Arc Example**
-- **Start**: Community divided, struggling, or disconnected
-- **Journey**: Characters working together on small problem
-- **Climax**: Community rallies, realizes strengths in unity
-- **Resolution**: Stronger bonds, shared purpose, renewed hope
-
-**Beloved Tropes**
-- Found family
-- Small-town charm and quirky characters
-- Magical apprenticeship/learning craft
-- Healing through relationships and community
-- Discovering hidden talents/purpose
-- Cozy mystery elements (gentle puzzle-solving)
-- Holiday/seasonal celebrations bringing community together
-
-**Tired Tropes to Avoid**
-- Manic pixie dream character—quirky character exists only to change protagonist
-- Nostalgic falseness—romanticizing "simpler time"
-- Conflict resolution without work—problems solve themselves
-- Shallow diversity—token diverse character with no depth
-
-**Pacing Expectations**
-- Slow, meditative pacing: 2–3k chapters, weekly updates
-- Space for reflection: character has time to think, feel, process
-- Seasonal/cyclical structure: calendar-based (winter chapter, spring chapter) works well
-
-**Chapter Structure**
-- Quiet opening (character in routine or reflection)
-- Small event or interaction
-- Character's internal response/growth moment
-- Gentle transition to next scene
-- Soft ending (not cliffhanger; sense of peace or hope)
-
-**Example Stories**
-- **The City We Became** (N.K. Jemisin): Urban fantasy with love and community at heart
-- Indie cozy fantasy web serials on Royal Road emphasizing tea shops, bakeries, magical crafts
-
----
-
-### 1.7 Cultivation (Western)
-
-**Genre ID**: `cultivation`
-
-**Reader Contract**: "Eastern-inspired but adapted for Western audience. Meditation, martial arts, spiritual levels. I want clear cultivation stages, earned power through discipline, philosophical depth."
-
-**Hard Rules**
-1. Cultivation must feel like *work*—not instant or easy
-2. Breakthrough moments should be dramatic—these mark major transitions
-3. Spiritual/philosophical elements matter—meditation and inner balance are as important as power
-4. Martial integration—cultivation often combines with martial arts or combat training
-
-**Typical Cultivation Progression**
-- Qi Foundation / Energy Gathering
-- Qi Condensation / Core Formation
-- Immortal Ascension
-- Tribulation / Transcendence
-
-**Examples**
-- *Cradle* series often classified as progression fantasy but has cultivation elements
-
----
-
-### 1.8 Sci-Fi / Space Opera
-
-**Genre ID**: `sci-fi`
-
-**Core Definition**: Space-based or futuristic fiction with science-based worldbuilding. **Hard sci-fi** emphasizes scientific accuracy and explanation of mechanics. **Space opera** prioritizes epic scale and human drama over scientific accuracy.
-
-**Reader Contract**
-
-**Hard Sci-Fi**: "Explain the science. I want plausible physics, technology consistency, and logical consequences of scientific principles. Handwave nothing; build the world on real science (or clear extensions of it)."
-
-**Space Opera**: "Give me epic scale, grand conflicts, and compelling characters. Science is backdrop; human drama is foreground. Don't worry about whether FTL is physically possible; focus on the story."
-
-**Hard Rules**
-
-**Hard Sci-Fi**
-1. Scientific consistency—physics and tech must follow established rules
-2. Logical consequences—technology has realistic limitations and side effects
-3. Explanation expected—readers want to understand *how* things work
-4. Accuracy matters—get the science right or handwave it clearly
-
-**Space Opera**
-1. Epic scale—settings spanning planets/systems/galaxies. Civilizations clash.
-2. Human drama—personal stories, political intrigue, character arcs drive story
-3. Science can be soft—FTL, hyperdrives, teleports are "good enough"
-4. Action and grandeur—epic space battles, first contact, exploration
-
-**Tech Consistency Rules**
-
-**Soft Sci-Fi Worldbuilding**
-- Create internally consistent universe with its own laws of physics
-- Allow divergences from reality (time travel, FTL) but rules must be consistent
-- Focus on *human experience* of living with technology
-
-**Example**: If robots can't feel emotion, they don't aid protagonist out of principle. If AI can be enslaved, show the moral implications. Rules matter.
-
-**Tech as Extension of Rules**
-- Every technology should have limitations
-- Introduce problems that technology *can't* solve (corruption, emotion, nature, human greed)
-- Technology solves old problems; new technologies create new ones
-
-**Space Opera Conventions**
-
-**Epic Scale**
-- Settings span star systems to galaxies
-- Civilizations and empires with histories and politics
-- Grand conflicts: nations at war, first contact, existential threats
-
-**Political Complexity**
-- Factions with competing interests
-- Diplomacy as important as combat
-- Intrigue and betrayal common
-
-**Exploration and Discovery**
-- Unknown worlds, alien species, new phenomena
-- Sense of wonder and vastness
-
-**Military/Adventure Focus**
-- Space battles, starship crews, adventuring parties
-- Character-driven action
-
-**Reader Expectations**
-
-**Hard Sci-Fi Readers Want**:
-- Believable worldbuilding
-- Accurate technology/physics explanations
-- Logical problem-solving
-- Science as character (challenges drive plot)
-
-**Space Opera Readers Want**:
-- Epic scope and grand conflicts
-- Memorable characters and relationships
-- Sense of wonder
-- Action and adventure
-- Politics and intrigue
-
-**Example Stories**
-- **Of Blood and Stardust** (Royal Road): Military hard sci-fi space opera
-- **Final War: Hetairoi** (Royal Road): Progression + hard sci-fi + mecha space opera
-
----
-
-### 1.9 Romantasy / Romance
-
-**Genre ID**: `romantasy`
-
-**Core Definition**: Fantasy fiction where romance is a significant/primary plot driver. Reader expectations depend on which of two types:
-- **Fantasy Romance**: Romance is the focus; HEA/HFN ending mandatory.
-- **Romantic Fantasy**: Fantasy plot is primary; romance is significant subplot; HEA/HFN not guaranteed.
-
-**Reader Contract (Depends on Type)**
-
-**Fantasy Romance**: "The romance is the story. I want to see two characters fall in love against obstacles, with emotional depth and sexual/romantic tension. I expect a satisfying ending where they end up together."
-
-**Romantic Fantasy**: "The story has a significant love arc, but the external plot is primary. I expect beautiful romantic moments and character chemistry, but the ending is determined by story logic, not romance requirements."
-
-**Hard Rules**
-
-**Universal to Both**
-1. Chemistry must be earned—readers need to understand why characters care for each other
-2. Love interest must drive transformation—significantly causes/contributes to protagonist's growth
-3. Emotional honesty—inner feelings must be shown, not told
-4. Conflict must be real—easy romance is boring
-
-**Fantasy Romance-Specific**
-- HEA/HFN is *required*. Readers feel betrayed if romance ends ambiguously or tragically.
-- Romance scenes take significant page time (not just epilogue)
-- Internal conflict (emotional journey) is as important as external conflict
-
-**Romantic Fantasy-Specific**
-- HEA/HFN is *not* required. Story logic determines ending.
-- Romance thread is woven through but secondary to plot
-- Reader cares about both relationship *and* external stakes equally
-
-**Expected Tropes (Beloved)**
-
-**Enemies to Lovers**
-- Two characters start at odds: opposition, misunderstanding, or genuine enmity
-- Forced proximity (war, quest, captivity) requires interaction
-- Gradual understanding and attraction as they see past first impressions
-- Slow-burn chemistry with banter and tension
-- Works exceptionally well in fantasy: nations at war, spy dynamics, magical opposition
-
-**Fated Mates/Chosen One**
-- Characters magically bonded or destined for each other
-- Internal recognition of connection
-- Both resist, then accept fate
-- Can feel contrived if not grounded in character choice and emotional growth
-
-**Forbidden Love**
-- Social/magical barrier preventing relationship: class difference, species difference, magic/no-magic, enemy factions
-- Conflict comes from external pressure, not character incompatibility
-- Relationship must prove worth the cost
-
-**Second Chance/Forced Proximity**
-- Characters separated or estranged, forced to reconcile through circumstance
-- History adds depth and pain to reconciliation
-- Excellent for character depth (readers see how much they've changed)
-
-**Love Triangle**
-- Two love interests, protagonist must choose
-- Risky: readers often resent love triangles; only works if both are genuinely compelling
-- Must be resolved decisively, not dragged out
-
-**Character Chemistry Techniques**
-
-**Show Attraction Subtly**
-- Physical description notices: dimples, the way someone laughs, how they move
-- Small touches that linger slightly longer
-- Involuntary reactions: heartbeat increase, breath catching, blushing
-
-**Banter and Wit**
-- Clever dialogue showing mutual understanding
-- Characters who make each other laugh or challenge each other intellectually
-- Verbal sparring that masks attraction (enemies-to-lovers especially)
-
-**Vulnerability Moments**
-- Characters showing weakness or fear to each other
-- Sharing secrets or past trauma
-- Comforting each other (non-romantic, then gradually romantic)
-
-**Shared Goals/Values**
-- Characters discover common purpose
-- Working together toward goal reveals compatibility
-- Seeing how partner handles conflict/makes decisions
-
-**Heat Levels and Reader Expectations**
-
-**Heat Level Spectrum**
-1. **Sweet (Fade-to-Black)**: Kissing, maybe embracing. Sex happens off-page. Suitable for YA, general audiences.
-2. **Warm (Mild Sensual)**: On-page kissing with description. Beginning of sexual activity described. Fades to black.
-3. **Sensual (Moderate Heat)**: Full sexual scenes on-page. Flowery/poetic language, not crude. 1–2 sex scenes, focus on emotion.
-4. **Spicy (Explicit)**: Multiple explicit sex scenes. Coarse language acceptable. Clear anatomical descriptions. 2–4+ sex scenes per book.
-5. **Erotic (Very Explicit)**: Sex scenes frequent and detailed. BDSM, kink, non-standard sexual activities. Sexual content is primary plot driver.
-
-**Critical Rule**: Communicate heat level clearly in blurb/cover. Readers self-select. Mislabeling causes reviews from disgruntled readers.
-
-**Romance Integration with Fantasy Elements**
-
-**World-Building Strategy**
-- Use fantasy setting to *complicate* romance (species difference adds real tension)
-- Or use setting to create *opportunities* for romance (war forces proximity, magic enables bonding, politics separates lovers)
-- World should not feel like afterthought to romance
-
-**Magic and Romance Intersection**
-- Magic systems can enable intimacy (magic bonds, soul connections, sensing mana intertwining)
-- Or prevent it (magic and romance are separate, magic warns of danger)
-- Cultural magic can influence relationship: some cultures encourage arranged bonds, others forbid cross-species love
-
-**Action Sequences and Romance**
-- Action scenes should show relationship dynamics, not pause romance
-- Fighting together reveals trust, compatibility, how partners support each other
-- Sexual tension can heighten during/after action (adrenaline, relief at survival, protective instincts)
-
-**Pacing**
-- **Fantasy Romance**: Heavy romance focus early, building to consummation/climax around 60–75%. Resolution after romance is established.
-- **Romantic Fantasy**: Romance subplot woven through action plot. Key romantic moments at act breaks. Romance resolution aligned with plot resolution.
-
-**Example Stories**
-- **Swordheart** (Elizabeth Bear): Romantic fantasy with complex antagonists and emotional depth
-- Indie romantasy web serials on Royal Road emphasizing enemies-to-lovers and character chemistry
-
----
-
-### 1.10 Isekai / Portal Fantasy
-
-**Genre ID**: `isekai`
-
-**Reader Contract**: "MC transported to another world. Establish new world rules fast. I want to see how MC adapts, what advantages/disadvantages their origin gives them, and the clash of cultures."
-
-**Hard Rules**
-1. Avoid "tutorial town"—50 pages hitting rats kills engagement
-2. Establish world rules quickly—by chapter 3, readers should understand this world's basic operating system
-3. Fish-out-of-water perspective matters—show MC's cultural shock and adaptation
-4. New world feels real—consistent geography, politics, cultures, not just backdrop
-
-**Opening Conventions**
-- Transportation event (summoning, reincarnation, falling through portal)
-- Brief real-world grounding (who was MC before?)
-- Arrival in new world and immediate disorientation
-- Meeting first guide/NPC to explain world
-- First concrete goal in new world
-
-**Beloved Elements**
-- Cultural fish-out-of-water comedy and drama
-- MC bringing real-world skills/knowledge that apply surprisingly
-- Learning new world's magic/systems
-- Building relationships with new world characters
-- Clash between MC's home culture and new world values
-
-**Common Mistakes**
-- Treating new world as just like Earth
-- MC treating new world culture as quaint/inferior
-- No real consequence for cultural misunderstandings
-- Pacing too slow in "culture learning" phase
-
----
-
-## 2. Core Writing Rules (Universal)
-
-These are universal rules across all English genres. They map to the Chinese system's `buildCoreRules()`.
-
-### 2.1 Structural Rules
-
-1. **Write in English. Vary sentence length**—Mix short punchy sentences with longer flowing ones.
-2. **Target 2,000-4,000 words per chapter**—Web serial sweet spot. Consistency matters.
-3. **Every planted hook must be resolved**—No dangling threads from foreshadowing or promised mysteries.
-4. **Only reference necessary context**—Don't mechanically repeat what's already established.
-
-### 2.2 Character Rules
-
-- **Consistency**: Behavior driven by "past experience + current interests + core personality." Never break character without cause.
-- **Dimensionality**: Core trait + contrasting detail = real person. Perfect characters are failed characters.
-- **No puppets**: Side characters must have independent motivation and agency. MC's strength comes from outmaneuvering smart people, not steamrolling idiots.
-- **Voice distinction**: Different characters must speak differently—vocabulary, sentence length, slang, verbal tics.
-- **Relationship logic**: Any relationship change (alliance, betrayal, submission) must be set up by events and motivated by interests.
-
-### 2.3 Narrative Technique
-
-- **Show, don't tell**: Convey through action and sensory detail, not exposition. Character ambition and values expressed through behavior, not declared.
-- **Sensory grounding**: Each scene includes 1-2 sensory details (sight, sound, smell, touch, taste) beyond the visual.
-- **Chapter hooks**: Every chapter ending needs a hook—question, reveal, threat, promise—to pull reader into next chapter.
-- **Information layering**: Basic worldbuilding emerges through action. Key lore revealed at plot-critical moments. Never dump paragraphs of exposition.
-- **Description serves narrative**: Environment descriptions set mood or foreshadow. One line is enough. No decorative purple prose.
-- **Downtime earns its place**: Quiet scenes must plant hooks, advance relationships, or build contrast for upcoming conflict. Pure filler is padding.
-
-### 2.4 Logic / Consistency
-
-- **Three-question self-check**: For every plot beat, ask: "Why would they do this?" "Does this serve their interests?" "Is this consistent with their character?"
-- **Information boundary check**: Antagonists cannot act on information they couldn't possess.
-- **Event-driven change**: If MC saves someone, there must be a reason. If the villain relents, they must have been cornered.
-- **Scene transitions**: No teleporting. If a character was at location A, show or acknowledge travel to location B.
-- **Every paragraph earns its place**: Each paragraph must deliver new information, shift attitude, or change stakes. No empty cycling.
-
-### 2.5 Language Constraints
-
-- **Sentence variety**: Alternate long and short sentences. Never start three consecutive sentences with the same word or structure.
-- **Verb-driven prose**: Lead with strong verbs and concrete nouns. Limit adjectives to 1-2 per sentence—make them precise.
-- **Specific group reactions**: Don't write "everyone gasped." Write one or two specific characters' physical reactions.
-- **Emotion through detail**: ✗ "He felt furious." → ✓ "He crushed the cup in his hand. Hot tea ran through his fingers, but he didn't flinch."
-- **No meta-narration**: Never break the fourth wall or use author-commentary voice.
-
----
-
-## 3. Anti-AI Rules (Iron Laws)
-
-This is the most critical section for English. AI patterns in English are different from Chinese.
-
-### 3.1 Iron Laws (English)
-
-**[IRON LAW 1] The narrator never tells the reader what to conclude.**
-If the reader can infer intent from action, the narrator must not state it.
-- ✗ "He realized this was the most important battle of his life."
-- ✓ Just write the battle—let the stakes speak.
-
-**[IRON LAW 2] No analytical/report language in prose.**
-Banned terms in narrative text: "core motivation," "information asymmetry," "strategic advantage," "calculated risk," "optimal outcome," "key takeaway," "it's worth noting," "it's important to remember."
-
-Character inner monologue must sound like thought, not a briefing document.
-- ✗ "His core motivation was survival."
-- ✓ "He needed to get out. That was it. Everything else was noise."
-
-**[IRON LAW 3] AI-tell words are rate-limited.**
-The following words/phrases must not appear more than once per 3,000 words total:
-- delve, tapestry, testament, intricate, pivotal, vibrant, embark, comprehensive, nuanced, landscape (metaphorical), realm (metaphorical), foster, underscore, navigate (metaphorical)
-- "it's worth noting," "a testament to," "the intricacies of," "navigating the complexities"
-
-When limit is hit, replace with concrete specific language.
-
-**[IRON LAW 4] No repetitive image/sensation cycling.**
-If the same metaphor domain appears twice (e.g., "fire coursed through his veins"), the third occurrence MUST switch to a new image or new information. No spinning in place.
-
-**[IRON LAW 5] Six-step psychology is an internal planning tool only.**
-Terms like "current situation," "core motivation," "information boundary," "personality filter" appear only in PRE_WRITE_CHECK reasoning, never in the actual chapter text.
-
-**[IRON LAW 6] Ban the "Not X; Y" construction.**
-AI overuses: "It wasn't fear. It was something deeper." / "This was no mere sword. This was a promise."
-- Limit to once per chapter max.
-- Rewrite as direct statement.
-
-**[IRON LAW 7] Ban lists of three in descriptive prose.**
-AI defaults to triplet constructions: "ancient, terrible, and vast" / "courage, determination, and sacrifice."
-- Limit to once per 2,000 words.
-- Use pairs or single precise words instead.
-
-### 3.2 Anti-AI Example Table
-
-#### Emotion
-| AI Pattern | Human Version | Key |
-|---|---|---|
-| He felt a surge of anger. | He slammed the table. The water glass toppled and neither of them moved to catch it. | Action externalizes emotion |
-| She was overwhelmed with sadness. | She held the phone with both hands, knuckles white, the text on screen swimming. | Physical detail replaces label |
-| A chill of fear ran down his spine. | The hair on his arms stood up. His feet felt nailed to the floor. | Sensory specifics convey fear |
-
-#### Transitions
-| AI Pattern | Human Version | Key |
-|---|---|---|
-| However, things were not as simple as they seemed. | Yeah, right. Nothing's ever that easy. | Character voice replaces narrator hedge |
-| Consequently, he decided to take action. | He stood up and kicked the chair aside. | Delete causal connectors; show the action |
-| It was at that moment he realized the truth. | (Delete this sentence. The truth is in what follows.) | Don't announce revelations |
-
-#### Filter Words
-| AI Pattern | Human Version | Key |
-|---|---|---|
-| He saw a shadow move across the wall. | A shadow slid across the wall. | Remove "he saw" — put reader directly in the scene |
-| She felt the cold wind on her face. | Cold wind bit her cheeks. | Remove "she felt" — describe the sensation directly |
-| He noticed that the door was open. | The door was open. | Remove "he noticed" — just state the fact |
-| He realized she was lying. | Her story didn't add up. The dates were wrong. | Replace "realized" with evidence that leads reader there |
-
-#### Dialogue Tags
-| AI Pattern | Human Version | Key |
-|---|---|---|
-| "I won't do it," she exclaimed defiantly. | "I won't do it." She crossed her arms. | Use "said" or action beat. Kill adverb + fancy tag combos. |
-| "Interesting," he mused thoughtfully. | "Interesting." He turned the coin over in his fingers. | Action beats > dialogue tags for showing character |
-| "We need to go now!" he urged desperately. | "Now." He grabbed her arm and pulled. | Urgency through brevity and action, not tag |
-
-#### Narrator Stance
-| AI Pattern | Human Version | Key |
-|---|---|---|
-| It was clear that the enemy had underestimated him. | (Just show the enemy's surprise through their reaction.) | "It was clear" = author lecturing |
-| This would prove to be a turning point in his journey. | (Delete — let the reader feel the weight through events.) | Don't pre-announce significance |
-| Little did he know, danger lurked around the corner. | (Delete — just write the danger arriving.) | Dramatic irony through structure, not narrator wink |
-
----
-
-## 4. AI-Tell Word List (English)
-
-Comprehensive list for the post-write validator (equivalent to Chinese 转折/惊讶标记词).
-
-### 4.1 Tier 1 — Hard Flags (almost always AI when overused)
-- delve, tapestry, testament, intricate, pivotal, vibrant, comprehensive, nuanced
-- embark (on a journey), foster, underscore, landscape (metaphorical), realm (metaphorical)
-- "a testament to," "the intricacies of," "navigating the complexities of"
-- "it's worth noting," "it's important to remember," "it bears mentioning"
-
-### 4.2 Tier 2 — Soft Flags (natural in moderation, suspicious in clusters)
-- bolstered, crucial, emphasizing, enhance, enduring, highlighting, showcasing
-- arguably, notably, moreover, furthermore, nevertheless
-- "at its core," "in essence," "on a deeper level"
-- "quiet determination," "steely resolve," "a knowing smile"
-
-### 4.3 Tier 3 — Fiction-Specific AI Patterns
-- "Not X; Y" construction (overused comparative)
-- Lists of three in descriptive prose
-- "Something shifted in his/her eyes"
-- "The air crackled with tension/energy/power"
-- "A silence hung between them"
-- "His/her blood ran cold"
-- "A predatory smile/grin"
-- "The weight of [abstract noun] settled on his/her shoulders"
-- "He/she let out a breath he/she didn't know he/she was holding"
-- Excessive em-dash usage (three or more per 1,000 words)
-- Alternating between purple literary prose and flat cliché sentences (the "two-mode" tell)
-
-### 4.4 Rate Limits (Post-Write Validator)
-- Tier 1 words: max 1 per 3,000 words combined
-- Tier 2 words: max 3 per 3,000 words combined
-- Tier 3 patterns: max 2 per chapter
-- Filter words (saw, felt, noticed, realized, heard, knew, watched, seemed): max 5 per 1,000 words
-
----
-
-## 5. Prose Craft Rules (for Audit Dimensions)
-
-### 5.1 Show Don't Tell
-
-**Core Principle**: Use sensory details and action rather than direct statements to allow readers to experience the story themselves.
-
-**Specific Implementation**:
-- Build understanding through concrete details and character behavior, not through explanatory text
-- Include sensory information: what characters see, hear, smell, taste, feel
-- Demonstrate emotion through physical reactions and dialogue
-- Use specific actions that reveal character, motivation, and emotional state
-
-**Example from Stephen King's Method**: Instead of "Brady is really pissed off about the detective's message," show Brady saying something between a whisper and a growl, striding in an unsteady circle, yanking his hair so hard his eyes water, kicking his chair, hunching over like a vulture.
-
-**When Telling Is Acceptable**: Exposition at the story's beginning, after major reveals where certain details simply need clear statement, or when time constraints require narrative shortcuts. Must be used sparingly and deliberately.
-
-**Audit Implications**: Detect excessive exposition dumps and emotional declarations that tell rather than show. Flag scenes where emotion or character state is stated directly without supporting action or dialogue.
-
-### 5.2 Active vs. Passive Voice
-
-**Target Ratio**: Aim for approximately 80% active voice, 20% passive voice (though this should be flexible).
-
-**When to Use Active Voice**:
-- Creates directness and clarity
-- Builds reader connection to POV character
-- Demonstrates character agency and forward momentum
-- Generally preferred in genre fiction (fantasy, sci-fi, thrillers)
-
-**When Passive Voice Works**:
-- **Mystery/Suspense**: Conceals information the author wants to withhold
-- **Creating Emphasis**: When the action or recipient matters more than the actor
-- **Mood and Tone**: Can create desired atmospheric effects
-- **Dialogue**: Characters may naturally use passive constructions based on voice
-
-**Audit Implications**: Detect overuse of passive voice (>25% of sentences). Flag passive voice in action sequences or dialogue-heavy scenes unless intentional for mystery effect.
-
-### 5.3 Adverb Usage: The Stephen King Rule and Exceptions
-
-**Stephen King's Principle**: "I believe the road to hell is paved with adverbs, and I will shout it from the rooftops."
-
-**Core Rule**: Minimize adverbs (words ending in -ly) because they tell rather than show—they express doubt in your ability to write strong verbs.
-
-**Specific Applications**:
-
-**Dialogue Tags: CRITICAL**
-- ✗ Wrong: "said angrily," "whispered softly," "laughed happily"
-- ✓ Right: Use stronger verbs instead ("snapped," "whispered," "chuckled")
-- ✓ Better: Show emotion through dialogue content itself and action beats
-
-**Narrative Prose**: Minimize but don't eliminate. Choose strong verbs instead.
-- ✗ Wrong: "He walked slowly across the room."
-- ✓ Right: "He shuffled across the room."
-
-**King's Philosophy**: Adverbs suggest the writer lacks trust in readers' ability to understand action without explanation, or hasn't built sufficient context for readers to infer meaning.
-
-**Exceptions**: Use adverbs only rarely and strategically—when a specific modifier truly adds irreplaceable meaning and can't be expressed through verb choice.
-
-**Audit Implications**: Flag excessive adverbs (>3 per 500 words in narrative, any in dialogue tags). Detect adverbs in dialogue tags as automatic red flags.
-
-### 5.4 Said-Bookism and Dialogue Tags
-
-**The Invisibility of "Said"**: The word "said" is practically invisible to readers. The brain glosses over it instantly, allowing readers to stay immersed in dialogue.
-
-**Why Fancy Dialogue Tags Fail**:
-- Alternative verbs (exclaimed, declared, announced, insisted, asked) subtly jar readers out of the dialogue
-- They draw attention to the narrator's word choice rather than the character's voice
-- They interrupt story immersion
-
-**Professional Standards**:
-- Use "said" and "asked" as defaults
-- Replace some tags entirely with action beats (physical actions showing how something is said)
-- If emotion/tone isn't clear from dialogue content and context, the dialogue itself needs rewriting, not a fancy tag
-
-**Example Fix**:
-- ✗ Wrong: "I hate this," she said angrily.
-- ✓ Right: "I hate this." She slammed the door.
-
-**Audit Implications**: Flag dialogue tags other than "said" and "asked" as violations. Detect adverbs in dialogue tags as automatic failures. Encourage action beats over dialogue tags.
-
-### 5.5 Purple Prose Detection
-
-**Definition**: Overly elaborate, self-indulgent writing that prioritizes the sound of words and ornate descriptions over clarity and pacing.
-
-**Red Flag Characteristics**:
-- Excessive adjectives modifying nouns
-- Multisyllabic, flowery language that calls attention to itself
-- Exaggerated metaphors and similes
-- Long, winding sentences that obscure meaning
-- Overwrought emotional descriptions
-- Language feels melodramatic or divorced from the story's needs
-
-**Examples of Purple Prose**:
-- "Her laughter was a symphony of spring rain, golden sunlight, and wind in the trees." (Better: "Her laughter was like a rain shower—quick and unexpected.")
-- "The tall, brooding, mysterious stranger walked solemnly and silently across the desolate, fog-laced, moonlit street." (Better: "The stranger drifted down the fog-laced street, quiet and unreadable.")
-- "He was consumed by a soul-crushing, bone-deep anguish that shattered him into a million irreparable fragments." (Better: "His gut dropped—and kept dropping. He sank to his knees, tried to speak, but what could he say?")
-
-**Root Causes**:
-- Weak verb choices compensated for with adjectives
-- Unclear story logic compensated for with lyrical language
-- Attempting to sound literary rather than telling the story effectively
-
-**Audit Implications**: Detect clusters of 3+ adjectives modifying single nouns, elaborate metaphors that overshadow action, ornate language that obscures meaning. Flag inconsistency between prose style and genre expectations (flowery prose in action-heavy sci-fi).
-
-### 5.6 Filter Words
-
-**Definition**: Unnecessary words that separate reader from character experience, creating distance between the reader's experience and the character's POV.
-
-**Common Filter Words**: assumed, believed, considered, decided, felt, heard, knew, looked, noticed, observed, perceived, realized, revealed, saw, seemed, sounded, thought, understood, watched, wondered.
-
-**Why They Weaken Writing**: Filter words add an extra layer of narration between reader and character consciousness, reducing immediacy and deep POV.
-
-**Examples and Fixes**:
-- "She noticed two snakes fighting in the rocks." → "In the rocks, two snakes were fighting."
-- "He heard footsteps in the hall." → "Footsteps echoed down the hall."
-- "She felt light-headed and gripped the door frame." → "Light-headed, she gripped the door frame."
-- "He saw the gun in her hand." → "The gun was in her hand."
-
-**When They're Acceptable**: Rarely. Sometimes a filter phrase's simplicity is the right choice if removing it creates awkwardness, but this should be exceptional.
-
-**Audit Implications**: Detect filter words, especially in first-person or deep third-person POV. Flag filter word usage >1 per 500 words. In deep POV sections, filter words are particularly problematic.
-
-### 5.7 Sentence-Level Rhythm and Structure Variation
-
-**Core Principle**: Monotonous sentence structure creates monotonous reading. Vary sentence length and structure to create rhythm that engages readers.
-
-**Fundamental Technique**: Mix short and long sentences.
-- **Short sentences**: Create pace, urgency, emphasis, impact
-- **Long sentences**: Slow pace, allow complexity, build atmosphere
-- **Medium sentences**: Balance and flow
-
-**Application to Genre Fiction**:
-- **Action scenes**: Predominately short-to-medium sentences create speed and tension
-- **Dialogue scenes**: Varied lengths reflect natural conversation rhythm
-- **Introspection**: Longer sentences can show character processing, but vary throughout
-- **Quiet moments**: Short sentences can paradoxically create tension through restraint
-
-**Rhythm Techniques**:
-- Vary sentence length systematically, not randomly
-- Use parallel structure for emphasis or connection
-- Employ repetition strategically for rhythm and memorability
-- Use punctuation to guide pacing and emphasis
-
-**Effect on Reader**: Rhythm paces the reader, emphasizes ideas, creates mood, and maintains engagement.
-
-**Audit Implications**: Detect paragraphs where all sentences are roughly the same length. Flag action scenes dominated by long sentences. Detect monotonous rhythm in dialogue. Check that pacing (sentence length) matches scene intensity.
-
-### 5.8 Paragraph Structure by Scene Type
-
-**Principle**: Paragraph breaks are tools for controlling pacing.
-
-**Short Paragraphs**:
-- Create faster visual pace
-- Make eyes move down page quickly
-- Best for: action scenes, dialogue with tension, rising stakes
-- Effect: reader perceives speed and momentum
-
-**Long Paragraphs**:
-- Slow visual pace
-- Allow detailed exploration
-- Best for: introspection, world-building, description, emotional depth
-- Effect: contemplative mood, thoughtfulness
-
-**Dialogue Heavy Scenes**:
-- Break up long dialogue exchanges with physical action or internal thought
-- Use the Rule of Three: after three lines of dialogue, insert a beat of action/emotion/narration or switch speaker
-
-**Genre Expectations**:
-- **Action/Thriller**: Frequent paragraph breaks, mostly short paragraphs
-- **Fantasy**: Balanced, varied—short for action, longer for world detail
-- **Web Serial**: Very short paragraphs (cliffhangers every 1,500–2,000 words), frequent breaks for pacing
-
-**Audit Implications**: Flag excessive paragraph length in action scenes. Detect long stretches of dialogue without breaks or action beats. Check paragraph structure matches scene intensity and genre conventions.
-
----
-
-## 6. Scene Craft
-
-### 6.1 Scene Structure: Goal-Conflict-Disaster / Reaction-Dilemma-Decision
-
-**Framework Origin**: Developed by Dwight V. Swain in "Techniques of the Selling Writer."
-
-**THE SCENE (Action)**:
-
-**Goal**:
-- Characters have scene-level objectives distinct from the overall plot goal
-- The goal drives action forward
-- Creates clarity about what's at stake in this moment
-
-**Conflict**:
-- Series of obstacles preventing the character from reaching the goal
-- Tests the character's determination
-- Shows how badly the character wants the goal
-- Builds momentum and reader engagement
-
-**Disaster**:
-- Failure to achieve the goal
-- Not necessarily catastrophic, but significant enough to change future outcomes
-- Has stakes and consequences
-- Creates the "page-turner" effect
-
-**THE SEQUEL (Reaction)**:
-
-**Reaction**:
-- Character absorbs and processes the disaster's emotional impact
-- Shows how the disaster affects the character
-- Gives emotional weight to story events
-- Creates space for character humanity
-
-**Dilemma**:
-- Presents the question: "What do I do now?"
-- Shows the character's options and their costs
-- Builds tension through uncertainty
-- Raises stakes for next action
-
-**Decision**:
-- Character makes a choice among options
-- Becomes proactive again (not passive)
-- Leads directly to the next scene's goal
-- Creates momentum
-
-**Momentum Building**: These elements chain together—disaster leads to reaction, reaction to dilemma, dilemma to decision, decision to new goal, creating an engine that drives readers through the story.
-
-**Audit Implications**: Check scenes have clear goals. Detect scenes with no conflict or stakes. Flag scenes ending in success without consequences (no disaster). Verify reaction sequences exist after major events. Check decision/choice drives next scene.
-
-### 6.2 Scene Transitions and White Space
-
-**Transition Types**:
-- **No transition**: Scene continues naturally in same location/time
-- **White space**: Blank line break indicating time/location shift
-- **Narrative bridge**: Brief transitional prose explaining time/location shift
-- **Chapter break**: Major structural transition
-
-**White Space Function**:
-- Signals passage of time or change of location
-- Gives readers breathing room
-- Prevents "white room syndrome" (feeling of floating in undefined space)
-- Creates pacing through visual breaks
-
-**Best Practices**:
-- Use white space for obvious transitions (time/location changes)
-- Vary transition methods to avoid monotony
-- Ensure reader always knows where/when scene is set
-- Use transitions to control pacing (frequent transitions = faster feel; fewer = slower)
-
-**Audit Implications**: Check scenes have clear setting/time establishment. Flag scenes that seem to exist in undefined space. Verify transitions match story pacing needs.
-
-### 6.3 Action Scene Pacing and Clarity
-
-**Key Elements**: Goals, Pacing, Clarity, Character
-
-**Clarity First**:
-- Readers must understand what's happening
-- Avoid confusing or over-complicated choreography
-- Visualize the scene completely before writing
-- Use clear cause-and-effect
-- Simpler action sequences are often more gripping than complex ones
-
-**Sentence Structure for Action**:
-- **Short and medium sentences**: Build pace and excitement
-- **Avoid hundred-word sentences**: Kills momentum
-- **Fragment usage**: Sparingly, for impact
-- **Adjective/adverb usage**: Ruthlessly eliminate; find strong verbs and nouns instead
-
-**Visual Layout**:
-- Blank space on page creates impression of fast pace
-- Smaller paragraphs make eyes move down page faster
-- Dense paragraphs slow reading
-
-**Character and Stakes**:
-- Show internal reaction of active character
-- Readers care about characters; action without emotional investment feels hollow
-- High stakes make action meaningful
-- Character emotion creates tension readers feel
-
-**Pacing Rhythm**:
-- Vary pace: scene after scene of breakneck action becomes tedious
-- Predictable patterns (slow/fast/slow/fast) also weaken
-- Mix in moments of reflection between action peaks
-- Physical and emotional arcs should complement each other
-
-**Audit Implications**: Flag overly complex action descriptions. Check action scenes don't average >15 words per sentence. Verify character perspective and emotion present in action. Detect action scenes with no stakes or character investment.
-
-### 6.4 Dialogue Scene Construction and Beats
-
-**Understanding Beats**:
-- Beats are the smallest units of structure that push narrative forward
-- Can include actions, events, emotional shifts, or conversations
-- Represent micro-level action/reaction between characters
-- Prevent "floating head syndrome" (dialogue with no grounding)
-
-**Action Beats**:
-- Insert physical action, gesture, or environmental interaction between dialogue lines
-- Break monotony of dialogue-only exchanges
-- Show character reaction non-verbally
-- Add setting detail and grounding
-- Example: "I can't do this anymore." She buried her head in her hands.
-
-**The Rule of Three**:
-- Whenever a character speaks three lines of dialogue, switch speaker, insert an action beat, show emotion, or use brief narration
-- Prevents long unbroken dialogue blocks
-- Maintains reader's sense of visual/physical reality
-
-**Talking Heads Problem**:
-- Dialogue with no action, setting, or non-verbal reaction
-- Readers can't visualize scene or characters
-- Lacks grounding in physical reality
-- Feels like screenplay rather than novel prose
-
-**Dialogue Construction Requirements**:
-- Each exchange must turn the beats of the scene
-- Must sound like natural talk
-- Should reveal character, advance plot, or both
-- Must include sensory grounding and physical presence
-
-**Audit Implications**: Flag long dialogue exchanges without action beats or setting details. Detect scenes that could be "talking heads." Verify action beats use varied verbs and create character understanding.
-
-### 6.5 Fight Scene Writing
-
-**Core Tension**: Mechanics of fights are often boring; the experience is vivid and terrifying. Good writing transforms mechanical action into gripping experience.
-
-**Clarity Over Choreography**:
-- Readers must understand what's happening (priority #1)
-- Over-detailed choreography confuses and slows pace
-- Detailed step-by-step feels mechanical, not gripping
-- Focus on key movements and character reactions
-
-**Visceral, Sensory Language**:
-- Sounds: impacts, grunts, gasps, silence
-- Smells: blood, sweat, fear
-- Tactile: impact on body, pain, exhaustion
-- Emotional: fear, adrenaline, desperation
-- Make reader *feel* the fight, not just see it
-
-**Pacing Structure**:
-- Short to medium-length sentences work best
-- Complement swift nature of battle
-- Build pace and tension
-- Avoid long, complex sentences that slow reading
-
-**Character and Stakes**:
-- Fight scenes without character work feel hollow
-- Readers must know what losing means
-- High stakes make tension matter
-- Show protagonist's limitations and vulnerabilities
-
-**Rhythm and Variation**:
-- Don't sustain maximum intensity throughout
-- Mix moments of intensity with brief pauses
-- Show character fatigue and recovery
-- Create emotional climax, not just physical action
-
-**Audit Implications**: Check fight scenes are visually clear. Detect over-complicated choreography. Verify sensory language present. Check stakes are established. Flag fight scenes without character perspective.
-
-### 6.6 Emotional and Quiet Scenes
-
-**Principle**: Stillness can be loaded with emotion, meaning, and tension—but only if you charge it properly.
-
-**Building Emotional Weight in Stillness**:
-- Know what's at stake beneath the calm
-- Emotion must show through nonverbal communication
-- Body language, micro-reactions, tiny movements are gold
-- Show what character won't or can't say
-
-**Techniques**:
-
-**Controlled Emotion**:
-- Express strong feeling through implication rather than declaration
-- Show how emotion alters behavior, environment, pacing, dialogue
-- Pressure building is more powerful than emotion venting immediately
-- Restraint often feels heavier than explosion
-
-**Prose Structure**:
-- Keep prose lean; let each line land
-- Avoid over-explaining
-- Use white space as friend
-- Short paragraphs and intentional line breaks
-- Silence and stillness are active, not passive
-
-**Nonverbal Elements**:
-- Dialogue with room to breathe
-- Fractured sentences showing disrupted thinking
-- Sensory detail: temperature, texture, light
-- Physical positioning and distance between characters
-
-**Transformation Requirement**:
-- Even if scene is physically still, something must shift
-- Realization, decision, loss, intimacy, understanding
-- Best quiet moments are transformational
-- Show change in character's emotional or psychological state
-
-**Audit Implications**: Check quiet scenes aren't emotionally flat. Verify nonverbal communication shows emotion without stating it. Detect over-explaining. Flag scenes without transformation or emotional arc.
-
----
-
-## 7. Character Craft
-
-### 7.1 Deep POV and Character Voice
-
-**Definition of Deep POV**: Most intimate, closest writing style where reader experiences story as if inside the character—feeling what they feel, experiencing what they experience, hearing their thoughts, without distance.
-
-**Creating Deep POV**:
-- Character's immediate sensory perceptions and reactions
-- Character's internal thoughts and emotional responses
-- Character's interpretation of events (not omniscient narrator's)
-- Filter out authorial distance
-- Immerse reader in character's moment-to-moment experience
-
-**Character Voice Components**:
-- **Sentence structure**: Reflects how character thinks and speaks
-- **Vocabulary**: Reveals education, background, region
-- **Rhythm and accent**: Distinctive speech patterns
-- **What character notices**: Emphasizes their priorities and concerns
-- **What character omits or avoids thinking about**: Shows internal conflict
-- **Personal opinions and biases**: Reveals character worldview
-
-**First-Person Voice**:
-- Narrator voice carries throughout
-- Every word reflects character's perspective
-- Personality shines through word choice and rhythm
-- Readers know character intimately through voice
-
-**Third-Person Deep POV**:
-- Narrative uses third person but filtered through character's perception
-- Narrator adopts character's vocabulary and syntax
-- Character's internal voice becomes the prose voice
-- Maintains emotional intimacy despite third person
-
-**Establishing Voice Quickly**:
-- Characters should be distinguishable by voice alone
-- Readers should know POV character from random page opening
-- Voice consistency across scene/chapter
-- Assessment words reveal character desire/fear ("probably," "fortunately," "weirdly," "disastrously")
-
-**Audit Implications**: Check voice is consistent within character's POV. Detect authorial intrusion (narrator voice differs from character voice). Verify character voice is distinct if multiple POV characters. Flag filter words as distance-creating.
-
-### 7.2 Head-Hopping and POV Breaks
-
-**Definition**: Jumping from one character's head to another's within the same passage—typically mid-scene or mid-chapter, not at scene/chapter breaks.
-
-**Why It's Problematic**:
-- Breaks immersion—hauls readers out of narrative
-- Reader loses sense of whose story it is
-- Creates confusion about perspective
-- Reminds readers they're "being told" a story
-- Breaks reader trust in author's authority
-
-**How It Happens**:
-- POV switches within scene without clear break
-- Revealing one character's thoughts immediately followed by another's
-- Shifting to external description that narrator couldn't access
-- Revealing information no POV character could know
-
-**Professional Standards**:
-- Multiple POV characters are acceptable
-- Switch only at scene breaks or chapter breaks
-- Scene has one POV character throughout
-- If switching POV characters, use clear structural signals (chapter break, section break)
-
-**Detection and Fixing**:
-- Color-code scenes by POV during revision
-- Use writing software (Scrivener, Dabble) to tag POV
-- Keep POV log during drafting
-- Check each paragraph for POV consistency
-- Verify all thoughts/internal reactions belong to current POV character
-
-**Audit Implications**: Flag POV shifts within scenes without breaks. Detect thoughts/knowledge that don't belong to current POV character. Verify clear structure when switching POV characters.
-
-### 7.3 Character Motivation and Agency
-
-**Character Agency Definition**: Character's ability to make decisions and affect the story; has own motivations; is active more than reactive; pushes plot more than plot pushes them.
-
-**Passive vs. Active Protagonists**:
-- **Passive**: Go with flow, make no decisions, don't affect story, always one step behind
-- **Active**: Make story what it is, drive narrative forward, make meaningful choices
-
-**Agency Components**:
-
-**Motivation (Motive)**:
-- What character wants
-- Why they want it
-- Must be something they'll take risks to get
-- Should connect to main story goals
-
-**Capacity**:
-- Character must have ability to pursue the goal
-- Doesn't mean guaranteed success, but means they can try meaningfully
-- Includes skills, resources, willingness, determination
-
-**Goals and Choices**:
-- Scene-level goals drive immediate action
-- Story-level goals drive overall arc
-- Character must make consequential choices
-- Choices drive story forward
-
-**Overcoming Passivity**:
-- Give character strong goal connected to main story
-- Ensure character has motivation to chase it
-- Character must take action and make decisions in pursuit of goal
-- Create situations where character's agency matters
-
-**Audit Implications**: Verify protagonist has clear motivation. Check character has capacity to pursue goals. Flag passive protagonists who let plot happen to them. Detect scenes where character makes no meaningful choices.
-
-### 7.4 Character Voice Consistency and Differentiation
-
-**Establishing Voice Quickly**:
-- Characters should be distinguishable by voice alone (vocabulary, sentence length, verbal tics)
-- Readers should know POV character from random page opening
-- Voice consistency across scene/chapter
-
-**Voice Differentiation Methods**:
-- Vocabulary level (educated vs. street)
-- Sentence length (terse vs. verbose)
-- Verbal tics and catchphrases (used sparingly)
-- What they notice (a thief spots exits; a merchant spots goods)
-- How they process stress (humor, anger, withdrawal, analysis)
-
-**Audit Implications**: Verify all characters don't sound like author or each other. Check vocabulary matches character background. Flag inconsistent voice within same character's POV.
-
----
-
-## 8. Dialogue Craft
-
-### 8.1 Natural Dialogue Rules
-
-**Core Principle**: Dialogue is heartbeat of fiction, breathing life into characters and driving narrative forward.
-
-**Observational Techniques**:
-- Listen to real conversations
-- Note quirks, filler words, rhythms
-- Observe how people talk in different contexts
-- Notice ebb and flow, interjections, interruptions, unfinished sentences
-- Pay attention to regional differences, age-based speech, education markers
-
-**Building Character Voice**:
-- Understand character's personality, education, background, age
-- Vocabulary reveals education level ("gonna" vs. "going to"; "ain't" vs. "isn't")
-- Word choice reflects region
-- Slang and dialect reveal group membership
-- Speech patterns reflect mental state
-
-**Testing Dialogue**:
-- Read aloud to check natural flow
-- Hearing words helps identify awkward phrasing, unnatural rhythm
-- Reveals inconsistencies in character voice
-- Easier to spot overused phrases when heard
-
-**Purpose and Function**:
-- Dialogue must do work: reveal character, convey information, show plot happening
-- Each conversation should reveal something about characters or advance plot
-- Dialogue shouldn't exist just to move exposition
-
-**Avoiding Common Errors**:
-- Don't have all characters sound like author
-- Don't give every character complex speech patterns (some characters speak simply)
-- Don't use dialogue for information that's better in narration
-- Don't write how people actually talk (ums, ahs, false starts) constantly—suggest it, don't replicate it
-
-**Audit Implications**: Check dialogue sounds natural when read aloud. Verify character voices are distinct. Detect all characters sounding similar. Check dialogue serves plot/character purpose.
-
-### 8.2 Subtext in Dialogue
-
-**Definition**: The conflict between what's said aloud versus what character is thinking, feeling, wanting, or hiding.
-
-**Importance**: Strong dialogue is supported by subtext; surface meaning differs from underlying truth.
-
-**Creating Subtext**:
-- **Evasion**: Character says one thing while implying another
-- **Contradiction**: Actions/thoughts contradict dialogue
-- **Hesitation**: Pauses, fragments, avoiding direct answer
-- **Coded language**: Saying something innocuous while meaning something else
-- **Disagreement between words and emotion**: Saying positive things with angry tone
-
-**Mismatch Between Dialogue and Action/Thought**:
-- Character says "I'm fine" while shaking
-- Character claims happiness while hunched and quiet
-- Character agrees while jaw clenches
-- Character swears they don't care while eyes betray them
-
-**Achieving Subtext**:
-- Don't state hidden emotion directly
-- Show through nonverbal cues
-- Use action beats to reveal what words hide
-- Let readers infer underlying truth
-- Create gap between surface and depth
-
-**Example**:
-- Surface dialogue: "That's wonderful. I'm happy for you."
-- Subtext shown through: Flat tone, looking away, fingers clenching, hesitation before response
-
-**Audit Implications**: Check dialogue has underlying meaning beyond surface words. Verify subtext shown through action beats and tone, not stated. Detect flat dialogue without hidden layers.
-
-### 8.3 Banter and Humor
-
-**Banter Definition**: Quick, witty dialogue exchange showing character rapport and intellectual compatibility.
-
-**Creating Effective Banter**:
-- Characters understand each other—they can finish each other's thoughts
-- Humor reveals character intelligence and personality
-- Banter shows relationship dynamics without exposition
-- Works especially well for enemies-to-lovers (sexual tension through verbal sparring)
-
-**Humor in Dialogue**:
-- Character humor reveals voice and personality
-- Humor can be dark, witty, physical, or self-deprecating—match character
-- Timing is crucial (banter-heavy dialogue loses punch if every line is a quip)
-- Balance humor with serious moments or it becomes exhausting
-
-**Audit Implications**: Check banter doesn't overshadow plot. Verify humor matches character voice. Detect forced quips that seem out of character.
-
-### 8.4 Dialogue Tags vs. Action Beats
-
-**Understanding the Difference**:
-
-**Dialogue Tags**:
-- "he said," "she asked," "they replied"
-- Identify speaker
-- Most effective when invisible
-
-**Action Beats**:
-- Character performs action while speaking
-- Shows how something is said through action
-- Reveals character, emotion, physicality
-- Breaks up dialogue blocks visually
-
-**Why Action Beats Work Better Than Fancy Tags**:
-- Fancy tags draw attention ("she exclaimed," "he declared")
-- Action beats show rather than tell emotion
-- Create visual variety
-- Ground dialogue in physical reality
-- Show character behavior revealing inner state
-
-**Examples**:
-- Tag: "I hate this," she said angrily.
-- Action beat: "I hate this." She slammed the door.
-
-- Tag: "Where are you going?" he asked nervously.
-- Action beat: "Where are you going?" He fumbled for his keys, missing twice before getting them right.
-
-**Rules for Action Beats**:
-- Use varied verbs (not just "she did X")
-- Action should reflect emotional state and character
-- Action can show setting detail
-- Don't use action beats artificially
-- Use enough to break up dialogue; not so much it bogs down pacing
-
-**Audit Implications**: Check dialogue uses "said/asked" rather than fancy tags. Detect long stretches of dialogue without action beats. Verify action beats use varied verbs and reveal character.
-
----
-
-## 9. Audit Dimensions (English Adaptations)
-
-Many Chinese dimensions carry over directly. These are the ones that need English-specific changes or are new to English.
-
-### 9.1 Dimensions That Change Significantly
-
-| Dimension | Chinese | English Adaptation | Notes |
-|----------|---------|-------------------|-------|
-| 语言流畅度 | 句式重复/"了"字连用 | Sentence variety, filter word density, passive voice ratio (target <20%), adverb density | Chinese checks "了" overuse; English checks "-ly" adverb overuse and passive voice |
-| AI味检测 | 仿佛/不禁/宛如 | Tier 1-3 AI-tell word clusters (see section 4) | Completely different word lists |
-| 题材疲劳词 | Per-genre Chinese clichés | Per-genre English clichés (see below) | Need new cliché lists per genre |
-| 对话真实度 | 说话风格区分 | Said-bookism check (fancy dialogue tags), adverb-tag combos, talking-head syndrome | English has its own dialogue craft rules |
-| 代入感/沉浸 | 五感描写 | Filter word check (he saw/she felt/he noticed), POV consistency, head-hopping detection | English "deep POV" is a key craft concept |
-
-### 9.2 Genre-Specific Fatigue Words
-
-**LitRPG / Progression Fantasy:**
-- "A notification appeared" (overused system interaction)
-- "His eyes widened" (overused surprise)
-- "Power surged through him" (generic power-up)
-- "He smirked" (overused facial expression)
-- "Time seemed to slow" (overused combat moment)
-- "A new skill had been acquired" (passive system notification)
-- "He could feel himself getting stronger" (tell, not show)
-
-**System Apocalypse:**
-- "The world had changed" (overused post-apocalypse opener)
-- "Survival of the fittest" (cliché philosophy)
-- "He had to get stronger, fast" (generic urgency)
-- "Trust was a luxury" (tired cynicism)
-
-**Cozy / Slice-of-Life:**
-- "A warm feeling spread through his chest" (overused warmth)
-- "Home. He was finally home." (overused arrival)
-- "The aroma of fresh bread filled the air" (generic comfort)
-
-**Romance / Romantasy:**
-- "Her heart raced/skipped a beat" (overused physical reaction to attraction)
-- "A flutter in her stomach" (overused nervous attraction)
-- "He couldn't look away" (overused attraction description)
-- "Chemistry crackled between them" (overused sexual tension)
-
----
-
-## 10. Chapter Structure Conventions
-
-### 10.1 Web Serial Chapter Structure (Royal Road / KU)
-
-| Element | Chinese Web Novel | English Web Serial |
-|---------|------------------|-------------------|
-| Chapter length | 2,000-4,000 chars | 2,000-4,000 words |
-| Opening | Hook within first 3 paragraphs | Hook within first 3 paragraphs (same) |
-| POV | Usually third-person limited | First-person (most popular for LitRPG/progression) or third-person limited |
-| Tense | Past tense | Past tense (present tense occasionally for first-person) |
-| Chapter ending | Cliffhanger/hook | Hook but NOT always cliffhanger — "soft hooks" (unanswered question, new information, emotional shift) preferred over constant danger cliffhangers |
-| Stat/System UI | N/A | Use sparingly — milestone snapshots, not every-chapter dumps. Format in monospace/code blocks. |
-| Author's Note | Rarely | Common at end of chapter (keep out of word count) |
-
-### 10.2 The "First 5 Chapters" Rule
-
-English web serial readers decide within 5 chapters whether to continue. These chapters must:
-1. Introduce the MC with a clear personality voice (not a blank slate)
-2. Establish the core genre promise (if LitRPG, show the system by chapter 2-3)
-3. Present a concrete problem or goal
-4. Minimize characters (2-3 max)
-5. Skip prologue/backstory dumps — start in action or consequence
-
-### 10.3 Hooks and Engagement
-
-Web serial readers expect every chapter click to be "earned." Best practices:
-- End chapters at a point of new information or raised stakes, not after resolution
-- Don't overuse danger cliffhangers — they exhaust readers. Mix with:
-  - Mystery hooks (new information raises questions)
-  - Promise hooks (MC commits to a plan the reader wants to see executed)
-  - Relationship hooks (dynamic shifts between characters)
-  - Revelation hooks (reader learns something the MC doesn't, creating dramatic irony)
-
-### 10.4 POV Conventions
-
-**First Person** (dominant in LitRPG / Progression)
-- MC's voice must be distinct and consistent — vocabulary, humor, worldview
-- Inner monologue should sound like actual thought, not narration
-- ✗ "I assessed the tactical situation and determined my optimal course of action."
-- ✓ "Two exits. One guard on the left, half asleep. The window was my best bet."
-- Limit self-aware commentary ("I'm not going to lie, that hurt" is fine once; not every page)
-- First-person does NOT mean the narrator describes their own appearance in mirrors
-
-**Third Person Limited**
-- Stay in one POV per scene. Head-hopping between characters mid-scene breaks immersion.
-- Deep third-person: describe only what the POV character would notice and in the way they would describe it
-- A scholar character notices different details than a street fighter
-
-### 10.5 Stat Block / System UI Formatting (for LitRPG)
-
-When the story includes game-like system elements, format them distinctly from prose:
-
-**Stat Blocks** (use sparingly)
-```
-╔══════════════════════╗
-║  Name: Kai Ashford   ║
-║  Level: 14           ║
-║  Class: Stormcaller  ║
-║  HP: 340/340         ║
-║  MP: 180/210         ║
-╚══════════════════════╝
-```
-
-**Notifications** (inline)
-> **[System]** Skill acquired: *Minor Flame Ward* (Rank F)
-
-**Rules for System UI**
-1. Show full stat blocks only at major milestones (level-up, class change, arc end)
-2. Inline notifications only when narratively significant
-3. Never end a chapter with a stat dump
-4. System text should have its own "voice" — terse, mechanical, possibly with personality
-5. MC's reaction to system text matters more than the text itself
-
----
-
-## 11. Pre-Write Checklist (English Version)
-
-Maps to Chinese `buildPreWriteChecklist()`. The checklist structure stays the same, content adapts:
-
-### 11.1 PRE_WRITE_CHECK Format
-
-```
-=== PRE_WRITE_CHECK ===
-OUTLINE_ANCHOR: [Which plot node from the volume outline does this chapter advance?]
-GENRE_PROMISE: [What genre expectation does this chapter fulfill? (e.g., meaningful power-up, system reveal, character growth)]
-HOOK_RESOLUTION: [Which pending hooks from previous chapters are addressed?]
-NEW_HOOKS: [What new hooks will this chapter plant?]
-POV_CHARACTER: [Whose perspective? What's their current emotional state?]
-SIX_STEP_PSYCHOLOGY:
-  - Situation: [What does the POV character face right now?]
-  - Motivation: [What do they want most? What do they fear?]
-  - Information: [What do they know? What are they wrong about?]
-  - Personality: [How does their personality shape their response?]
-  - Choice: [What will they do?]
-  - Expression: [How will they show it — body language, voice, action?]
-PACING_NOTE: [Is this chapter action/tension/quiet/transition? How does it fit the arc rhythm?]
-WORD_TARGET: [2,000-4,000 words]
-TENSION_CHECK: [Does this chapter escalate stakes or raise new questions?]
-CHARACTER_CHECK: [Does this chapter reveal something about the POV character not previously known?]
-ANTI_AI_CHECK: [No Tier 1 AI words > 1 per 3,000? No repetitive metaphors? No "not X; Y" constructions > 1? No lists of three > 1 per 2,000?]
-```
-
----
-
-## 12. Common Mistakes to Detect
-
-### 12.1 Head-Hopping
-Jumping between characters' thoughts within a scene without clear breaks. Breaks immersion; confuses whose story it is.
-
-### 12.2 Info Dumps / "As You Know Bob"
-Characters explain information they would naturally know, just so reader learns it. Unnatural and breaks dialogue.
-
-Example:
-- ✗ "As you know, Bob, the system arrived three years ago and changed everything."
-- ✓ Cut this entirely, reveal through action or let reader infer.
-
-### 12.3 Deus Ex Machina
-Sudden solution to problem that wasn't set up or earned. Reader feels cheated.
-
-Example:
-- ✗ MC is trapped, suddenly discovers an escape route that was never mentioned before.
-- ✓ Plant the escape route earlier so reader could theoretically predict it.
-
-### 12.4 Mary Sue / Gary Stu
-Perfect character with no flaws, who is always right, never fails, is loved by everyone.
-
-Red flags:
-- Character has no genuine weaknesses
-- Character never loses a conflict
-- Side characters exist only to admire main character
-- Character doesn't grow/change (no arc)
-
-### 12.5 Plot Armor
-Character survives situations that would kill ordinary people through authorial fiat, not established mechanics or ingenuity.
-
-Example:
-- ✗ MC falls off a cliff, survives with no explanation.
-- ✓ MC either trained for falls, has armor, or the fall wasn't as high as implied.
-
-### 12.6 Talking Heads
-Dialogue with no action, setting detail, or character grounding. Feels like screenplay, not novel.
-
-Fix:
-- Add action beats
-- Ground in sensory detail
-- Show character body language
-- Include physical reaction to dialogue
-
-### 12.7 White Room Syndrome
-Scene exists in undefined, featureless space. Reader can't visualize setting.
-
-Example:
-- ✗ They stood and talked for hours. (Where? What does it look like? Can they see anything?)
-- ✓ They stood in the tavern corner, the smell of spilled beer and woodsmoke thick around them. The bartender glanced at them occasionally but minded his business.
-
-### 12.8 Protagonist Without Agency
-Character is passive, reacts to events, doesn't make meaningful choices, plot happens *to* them rather than through them.
-
-Fix:
-- Give character clear motivation/goal
-- Character makes consequential choices
-- Character's actions drive plot forward
-- Character faces real obstacles, not trivial ones
-
-### 12.9 Consistency Violations
-Character behaves inconsistently with established personality/abilities without justification.
-
-Example:
-- MC is established as cautious, but then takes reckless action without motivation.
-- System is established as consistent, but then breaks its own rules for plot convenience.
-
-### 12.10 Purple Prose / Over-Description
-Flowery, overwrought descriptions that prioritize sound over clarity and pacing.
-
-Example:
-- ✗ "The crystalline azure sky, resplendent with golden rays of scintillating sunlight, stretched across the vast, boundless expanse, evoking sensations of profound sublimity and ethereal wonder."
-- ✓ "The sky was clear and bright."
-
----
-
-## 13. Serial Fiction-Specific Considerations
-
-### 13.1 Episodic Structure
-- Thrive in serialized markets
-- Cliffhangers every 1,500–2,000 words standard
-- Word count consistency important (readers expect similar episode lengths)
-- Each installment has mini-arc while contributing to larger narrative
-
-### 13.2 Reader Retention Principles
-- Episode-level resolution crucial (readers return when feeling rewarded, not stalled)
-- Cliffhangers effective but not always dramatic
-- Can be emotional cliffhangers (investing in character struggle)
-- Unresolved questions keep readers curious
-- Physical peril, plot twists, personal decisions all work as cliffhangers
-
-### 13.3 Planning and Structure
-- Some form of outline necessary for multi-episode stories
-- Working with multiple storylines stretched over episodes requires game plan
-- Each installment should resolve something while opening new questions
-- Pacing differs from completed novel (slower burn acceptable in serial)
-
-### 13.4 Reader Experience
-- Readers develop habit of checking for new chapters
-- Consistent publication schedule matters
-- They remember details across gaps between episodes
-- Emotional investment builds over time
-
----
-
-## 14. Synthesis: The Five Pillars of English Web Fiction Quality
-
-Based on all research, the following five pillars define quality English web fiction:
-
-### Pillar 1: Internal Consistency
-- Systems/magic/rules follow their own logic, never breaking established rules for plot convenience
-- Characters behave consistent with established personality (with earned development)
-- World details remain consistent across narrative
-- Reader can trust the author to follow the rules
-
-### Pillar 2: Earned Progression and Stakes
-- Character growth is earned through struggle, sacrifice, or clever strategy
-- Power-ups and achievements have meaningful cost
-- Success has weight because failure had real consequences
-- Reader feels protagonist *earned* victories, not stumbled into them
-
-### Pillar 3: Character-Driven Narrative
-- Characters are intelligent, multi-dimensional, with genuine agency
-- Plot happens *through* character choices and actions, not *to* them
-- Side characters have independent motivation and presence
-- Reader cares about people first, systems second
-
-### Pillar 4: Clarity and Immersion
-- Reader always knows where/when they are (no white room syndrome)
-- Action is clear and visualizable
-- POV is consistent and deep
-- Reader stays immersed through clear prose, not jarred by authorial intrusion
-
-### Pillar 5: Engagement and Pacing
-- Each chapter has a hook—question, revelation, emotional shift, or raised stakes
-- Pacing varies (action, quiet moments, exposition) to maintain rhythm
-- Reader feels compelled to read the next chapter
-- Scene structure follows goal-conflict-disaster/reaction-dilemma-decision
-
----
-
-## 15. Sources
-
-### Genre Research
-- [Strategies For Success Releasing LitRPG Stories On Royal Road](https://johnchampaign.com/2024/01/29/strategies-for-success-releasing-litrpg-stories-on-royal-road/)
-- [Royal Road Forum: Difference between progression fantasy and litrpg](https://www.royalroad.com/forums/thread/156327)
-- [Royal Road Forum: LitRPG Think Tank](https://www.royalroad.com/forums/thread/100306)
-- [LitRPG Power Arc Analysis by C.R. Rowenson](https://crrowenson.com/case-studys/litrpg-power-arc-analysis-case-studies/)
-- [How to Write LitRPG - LitRPG Reads](https://litrpgreads.com/blog/litrpg/how-to-write-litrpg-integrating-game-systems-into-your-story-without-losing-readers)
-- [Blue Box Madness - Joi Massat](https://jmassat.com/2024/02/13/blue-box-madness-or-the-dark-side-of-writing-litrpgs/)
-
-### Craft and Writing Instruction
-- Stephen King, "On Writing"
-- Brandon Sanderson Writing Lectures
-- Writing Excuses Podcast
-- Mythcreants Writing Craft Guides
-- Robert McKee, "Story"
-- Dwight V. Swain, "Techniques of the Selling Writer"
-
-### AI Detection and Anti-Slop
-- [How to Identify AI-Written Web Fiction](https://recordcrash.substack.com/p/how-to-identify-ai-written-web-fiction)
-- [Plus AI: Most Overused ChatGPT Words](https://plusai.com/blog/the-most-overused-chatgpt-words)
-- [Why Does ChatGPT "Delve" So Much? (ACL 2025)](https://aclanthology.org/2025.coling-main.426/)
-- [Royal Road Forum: AI-Generated Stories Detection](https://www.royalroad.com/forums/thread/163455)
-- [Mythcreants: Nine Reasons to Reject AI Slop](https://mythcreants.com/blog/dont-fall-for-ai-nine-reasons-for-writers-to-reject-slop/)
-
-### Publishing and Platform Research
-- [LitRPG Reads: LitRPG in 2026 vs 2016](https://litrpgreads.com/blog/litrpg/litrpg-novels-2026-vs-litrpg-books-in-2016-what-a-decade-changed)
-- [Level Up Publishing: How to Write LitRPG](https://www.levelup.pub/how-to-write-litrpg)
-- [Royal Road: What Makes a Good LitRPG](https://www.royalroad.com/forums/thread/97990)
-- [Royal Road: Chapter Length Discussions](https://www.royalroad.com/forums/thread/103370)
-
----
-
-## Appendix A: Reddit & Community-Sourced Supplements (March 2026)
-
-The following material was gathered from Reddit (r/litrpg, r/progressionfantasy, r/writing, r/royalroad), Royal Road forums, Goodreads discussions, and key blog posts from genre authors (Andrew Rowe, etc.). It supplements the main research sections above.
-
-### A.1 LitRPG — Reader Pet Peeves & Community Consensus
-
-**System Design (from Royal Road forums & Goodreads polls)**
-- "People don't need to know how every aspect of the system works by chapter 10." Integrate system info through character dialogue with natural breaks and humor, not dense exposition blocks.
-- Generic systems kill reader retention — ~20% of readers abandon after 3 chapters due to boring mechanics. Add distinctive features (high pain percentages, hyper-realism, transferable knowledge).
-- Use mathematical formulas for stat calculations and maintain them in spreadsheets. Example: `(Level × 100) + (10 × VIT) = MaxHP` with class modifiers and racial traits.
-- Make the game "playable" — readers should think "I'd actually play this." Include system updates/patches to refresh mechanics.
-- "If it is a game or has a system, it is going to have an order to it." Everything should be explainable, even if details are withheld for reveals.
-
-**Common Reader Complaints (from Goodreads LitRPG Forum polls)**
-- Info-dumping system details at every opportunity
-- "Big blue stat blocks" that don't add narrative value — readers want systems interwoven into story, not spreadsheet dumps
-- MCs succeeding because they discover what millions of players obviously would have found
-- All races/NPCs acting like modern humans instead of reflecting their cultures
-- MCs breaking the entire game system without consequences
-
-**Contributor Tips**
-- Give races and NPCs distinct personalities reflecting their culture/religion
-- Include "what if" scenarios: magic-immune enemies, legendary classes that are actually weak (farmer/sculptor), cursed weapons
-- Consider player ecosystems — if a broken build exists, other players would have found it first
-- Not all LitRPGs need deep mechanics — some work better with light system references
-
-### A.2 Progression Fantasy — Andrew Rowe's Framework (Expanded)
-
-**Three Progression Styles** (from "Distinctions in Progression Fantasy Styles"):
-1. **Numeric Levels**: Numbered advancement (Level 1-99). Impact depends on granularity — 1-20 system makes each level significant; systems reaching thousands dilute individual importance.
-2. **Titled Levels**: Named tiers like "Copper → Iron → Jade → Gold" (Cradle). More thematic, requires broader power gaps between stages.
-3. **Relative Progress**: Growth shown through character comparison rather than absolute measurement (Mother of Learning, Mage Errant).
-
-**Power Differential Design**:
-- **Large Gaps**: Satisfying power fantasy but risks making supporting characters irrelevant. "Punching above weight" can feel cheap.
-- **Moderate Gaps (~1.5-2x per level)**: Arcane Ascension model. Lower-level characters can compete under specific circumstances. Best for group stories.
-- **Asynchronous Scaling**: Different attributes improve at different rates. Guardians gain strength; Menders don't. Maintains specialization value.
-
-**Critical Advice from Andrew Rowe**:
-- "If a character jumps from Level 1 to Level 99 in a single book, that doesn't really serve the same purpose." The journey IS the appeal.
-- "The feeling that power increases are being earned" is essential. Gifts/luck-based progression feels unsatisfying.
-- "Other People Should be Competent and Believable." Supporting characters shouldn't seem incompetent.
-- "Adding something new to a character's list of abilities is more interesting than just a straight power increase." New abilities > stat boosts.
-- "If progression exists, your antagonists may also be progressing." Creates unique challenges.
-- Be extremely careful giving out super speed, teleportation, and time travel — they trivialize obstacles.
-- "Avoid doing things like that" when introducing progression mechanics that characters then ignore without reason.
-
-**Progress Loss**: Most readers strongly dislike losing advancement. Even resets (roguelikes, time loops) should involve knowledge retention. Permanent losses alienate audiences unless narratively justified.
-
-**Organic vs. "Cheats"**:
-- Organic: Normal advancement rate (Forge of Destiny, Arcane Ascension). Grounded but slower.
-- Cheats: Unique advantages accelerating progression (Iron Prince's 20x faster growth, time chambers, exclusive classes). Some readers demand cheats; others prefer organic.
-
-### A.3 AI Writing Detection — Extended Tell List
-
-**From "How to Identify AI-Written Web Fiction" (Makin/RecordCrash)**:
-
-Macro-level patterns:
-- Repetitive sentence structures ("the droning sound") that human writers naturally vary
-- Tonal oscillation: swings between "long, heavy comparisons, then short lines that sound like stock phrases"
-- Lack of stylistic evolution — maintains mechanical consistency rather than developing organic variation
-
-Micro-level tells:
-- **Negation constructions**: Overuse of "not X; Y" structures (e.g., "It was no current. It was a summons")
-- **Lists of three**: Excessive triplet enumeration ("a geometry of madness, a wound in the fabric of what is, older than law and time")
-- **Blocky dialogue**: Conversations separate dialogue, exposition, and narration into discrete chunks rather than weaving them
-- **Punctuation quirks**: Heavy emdash usage → newer models substitute semicolons/commas with similar syntactic patterns
-- **Metaphor saturation**: Multiple descriptors targeting single concepts in final sentences (tryhard density)
-- **Eyeball kicks**: Overly specific sensory descriptions disconnected from narrative purpose
-
-**Extended AI Overused Word List** (from GitHub gist + Plus AI research):
-
-Tier 1 — Instant Red Flags (>100x human frequency):
-delve, tapestry, testament, camaraderie (162x), palpable (95x), underscore, intricate, intricacies, vibrant, beacon, meticulous, meticulously, embark, gossamer, crucible, labyrinth, indelible, unwavering, whimsical, virtuoso
-
-Tier 2 — Strong Signals:
-bolster, bustling, championing, commendable, compelling, cutting-edge, daunting, enigma, enlightening, exemplified, foster, multifaceted, nuanced, profound, resonates, reverberate, spearheaded, symphony, transcended, transformative, treasure trove, unveil
-
-Tier 3 — Structural Phrases:
-"a testament to", "at the end of the day", "deep dive", "dive into", "drill down", "fear not", "game changer", "hustle and bustle", "important to note", "it's worth noting that", "key insights", "little did", "shed light", "that being said", "unique blend"
-
-**Fiction-Specific AI Patterns** (beyond word-level):
-- "Every time ChatGPT tries to write a grief scene, it sounds like a Hallmark card"
-- Character name "Elara" appears suspiciously often
-- "Barely above a whisper" and "otherworldly glow" as default descriptions
-- "Gray goo" storytelling: technically competent yet emotionally disengaged
-- Monotone, uninspired prose with imprecise wording
-- Excessive exposition causing pacing issues and tonal misalignment
-
-### A.4 Deep POV — 17-Point Framework (Lisa Hall-Wilson)
-
-Key practical takeaways for InkOS English prompts:
-
-1. Deep POV is a strategic tool, not for entire manuscripts — blend with other techniques for pacing
-2. Every word originates from the character's perspective with zero narrator intrusion
-3. Remove filter words: "thought", "knew", "realized", "wished", "saw", "heard", "felt"
-4. Goes beyond emotion words — includes description choices, word selection, what the character notices/ignores
-5. Character voice prominence — every word reflects worldview, prejudices, priorities
-6. Best applied during revision (Phase 2 settlement in InkOS terms)
-7. Information access limitations create natural tension — readers know only what POV character knows
-8. Works across most genres (romance, mystery, suspense, fantasy)
-9. Emotion writing is the hardest part — layering emotional complexity authentically = mastery
-10. "Show don't tell" intensified — not just actions but what the character perceives and ignores
-
-### A.5 Royal Road — Rising Stars Strategy & Serial Fiction Mechanics
-
-**Launch Mechanics**:
-- Need 20k words minimum for Rising Stars eligibility
-- Most authors dump first 10 chapters on day one, one hour apart
-- Once on RS, you're there for max 30 days
-- For a "true blue RS run," have 60 chapter backlog (10 day-one + 30 daily + 20 buffer)
-- Algorithm relies on snowball of views in first few days → RS amplifies into avalanche
-
-**Traffic Sources** (from Top 25 RS author):
-- Ads: ~700 users (1.7% CTR)
-- Shoutouts: ~500 users (free)
-- RS visibility: ~400 users
-- Main page: ~200 users
-- Favorites and follows rank higher than reviews for algorithm
-
-**Consistency is Everything**:
-- Most common schedule: Monday/Wednesday/Friday
-- Daily releases show seriousness and build initial readership fast
-- Extremely short chapters (1,000-1,500 words) allow daily releases without burnout
-
-**Community Building**:
-- Name your fanbase
-- Respond to every comment
-- Gamify with progress bars and milestone-based bonus chapters
-- Ask readers for input on story decisions
-
-**Reader Segmentation**:
-- Some won't read until massive chapter count exists
-- Others only read completed stories
-- Many prefer ongoing serials with consistent updates
-
-### Sources (Appendix A)
-
-- [Andrew Rowe: Writing Progression Fantasy](https://andrewkrowe.wordpress.com/2019/03/02/writing-progression-fantasy/)
-- [Andrew Rowe: Distinctions in Progression Fantasy Styles](https://andrewkrowe.wordpress.com/2022/11/04/distinctions-in-progression-fantasy-styles/)
-- [Royal Road Forums: Sharing LitRPG Tips and Tricks](https://www.royalroad.com/forums/thread/100248)
-- [Royal Road Forums: Top 25 Rising Stars — Lessons Learned](https://www.royalroad.com/forums/thread/148967)
-- [Royal Road Forums: How to Land on Rising Stars](https://www.royalroad.com/forums/thread/141030)
-- [Goodreads: LitRPG Reader Problem Poll](https://www.goodreads.com/topic/show/19548378)
-- [How to Identify AI-Written Web Fiction (RecordCrash/Makin)](https://recordcrash.substack.com/p/how-to-identify-ai-written-web-fiction)
-- [ChatGPT Overused Words — GitHub Gist](https://gist.github.com/chrisgherbert/c734ec50ae464135be57cd03b84281f9)
-- [Plus AI: Most Overused ChatGPT Words](https://plusai.com/blog/the-most-overused-chatgpt-words)
-- [Lisa Hall-Wilson: 17 Things About Deep POV](https://lisahallwilson.com/17-things-to-know-about-deep-pov/)
-- [Royal Road Forums: What's a Good Release Schedule](https://www.royalroad.com/forums/thread/155967)
-
-## Appendix B: Extended Research — Reddit, AI Communities & Practitioner Blogs (March 2026)
-
-Sources: r/ClaudeAI, r/writing, r/selfpublish, r/NovelAI, r/Sudowrite, r/ChatGPT, Royal Road forums, Kindlepreneur, NovelMage, CRAFT Literary, RecordCrash Substack, SFF Chronicles, Roll for Narrative.
-
-### B.1 Active English Communities for AI Fiction Writing
-
-**Reddit — AI-focused writing communities:**
-- **r/ClaudeAI** — Active discussion of Claude for long-form fiction, system prompts, and project-based workflows
-- **r/NovelAI** — Dedicated to NovelAI tool (proprietary "Kayra" model, custom AI Modules trained on specific genres/authors, uncensored output)
-- **r/Sudowrite** — Sudowrite users sharing fiction workflows (Story Bible feature, trained on published novels not Wikipedia)
-- **r/ChatGPT** — Broad AI discussion, includes fiction writing threads; model limitations discussion
-- **r/selfpublish** — Practical AI integration; 60/40 split favoring AI use; focus on Kindle/RR publishing
-- **r/writing** — General writing community; hybrid AI approach most praised; "bouncing ideas off a limitless co-writer"
-- **r/rational** — Rational fiction community; intelligent characters solving problems with creative applications of knowledge
-- **r/HFY** (Humanity, Fuck Yeah) — Speculative fiction community with AI protagonist discussions
-
-**Reddit — Genre communities:**
-- **r/litrpg** — Genre-specific discussion, reader complaints, trope analysis
-- **r/progressionfantasy** — Craft advice, what readers hate, pacing rules
-- **r/Fantasy** — Broader fantasy discussion including web fiction
-- **r/royalroad** — Platform-specific strategy, release schedules, reader engagement
-
-**Non-Reddit communities:**
-- **Royal Road Forums** — Most authoritative source for serial fiction craft; cliffhanger techniques, Rising Stars strategy, genre expectations
-- **Scribble Hub Forum** — Secondary web fiction platform; LitRPG approach advice
-- **SFF Chronicles** — Serious discussion of why writing LitRPG is harder than people think
-- **Sufficient Velocity / SpaceBattles** — Quest fiction and rational fiction communities
-- **Goodreads LitRPG Forum** — Reader polls on common problems; consumer perspective
-
-### B.2 Claude-Specific Fiction Writing Workflow (from Kindlepreneur & NovelMage)
-
-**7-Step Claude Novel Process (Kindlepreneur):**
-1. **Brainstorm** — "Give me [N] high-concept pitches for a bestselling [GENRE] story with a unique twist"
-2. **Synopsis** — 3-act structure synopsis with detailed beat breakdown
-3. **Characters & Worldbuilding** — Character profiles + city/location/map documents uploaded to Claude Project
-4. **Outline** — Expand synopsis using preferred structure (Hero's Journey, Save the Cat, etc.)
-5. **Story Beats** — 12+ action beats per chapter; **use proper nouns instead of pronouns** for clarity
-6. **Style Guide** — "First person past POV, show don't tell, deep POV" as foundational instruction
-7. **Prose Generation** — Write 2-3 beats at a time with full context (genre, tone, POV, setting, characters)
-
-**Key insight**: Claude's 200K-token context window allows uploading entire outlines + character bibles + previous chapters simultaneously.
-
-**NovelMage Anti-Generic Strategies:**
-- Upload writing samples to train on your unique style preferences
-- Use "Writer's Voice" features to ensure suggestions feel authentically yours
-- Maintain comprehensive character/world databases (Codex Systems) for consistency
-- Plan sessions beforehand to eliminate blank-page paralysis
-
-### B.3 What Reddit Says Works vs. Fails in AI Fiction
-
-**What Works (from r/writing, r/selfpublish, r/ChatGPT):**
-- **Pre-draft assistance**: Test plot twists and thematic comparisons before writing
-- **Scene scaffolding**: AI generates rough dialogue that writer substantially revises
-- **Comparative generation**: Produce multiple AI versions of same scene, cherry-pick strongest elements
-- **Lightweight editing**: Simplify overwritten passages during revision
-- **"Three endings" technique**: "I let ChatGPT write my chapter ending three different ways so I could pick the best one"
-- **Constraints > freedom**: "When Claude has specific rules, it follows them and output sounds human. When it can write 'anything,' it writes nothing memorable."
-
-**What Fails (community consensus):**
-- **Emotional flatness**: "Every time ChatGPT tries to write a grief scene, it sounds like a Hallmark card"
-- **Repetitive patterns**: Models loop ideas and add excessive exposition, creating pacing issues
-- **Generic prose**: "Technically competent, yet emotionally disengaged" without strong direction
-- **"AI tone"**: "Clean but not convincing" — lacks the small redundancies, rhythm, and phrasing humans use
-- **Default telling**: "ChatGPT defaults to telling over showing because it's responding to a prompt directly; by design, it cannot be oblique or indirect"
-- **Purple prose gravity**: Models favor ornate language requiring explicit "simplify" prompts
-
-### B.4 Show Don't Tell — AI's Core Weakness (from CRAFT Literary)
-
-**The fundamental problem**: AI tools "cannot produce the kind of subtlety, nuance, and intentional obliqueness that characterizes our best prose."
-
-**Bad (AI-typical)**:
-> "A peaceful day at a pond is a serene and tranquil experience, where nature's beauty unfolds before your eyes."
-
-This summarizes rather than shows. Tells readers what to feel instead of presenting specific sensory details.
-
-**Actionable Rules for InkOS Prompts:**
-1. **Select details intentionally** — Include only specifics that serve both plot and deeper significance
-2. **Omit direct answers** — Use subtext in dialogue; characters need not directly respond to each other
-3. **Leverage silence** — "The scene's poignancy lies in the space between the characters' lines"
-4. **Embed meaning implicitly** — Let details speak for themselves rather than explaining significance
-5. **Avoid summary language** — Don't articulate emotions or themes; illustrate through action
-6. **Choose surprising adjectives** — Instead of "gentle breeze," use unexpected modifiers unique to your scene
-
-### B.5 LitRPG Writing — Extended Craft Rules (from Roll for Narrative, SFF Chronicles, Royal Road)
-
-**Core Principle**: "Once you introduce a system, you don't just write a story anymore; you start managing an economy, a physics model and emotions at the same time."
-
-**Stats as Seasoning, Not the Meal:**
-- ❌ "Strength +3, Dexterity +2"
-- ✅ "He swung harder than before, his strike landing with enough force to send the goblin skidding backward"
-
-**System Consistency Trap**: "Every single gain, loss, reward, punishment, shortcut, loophole, and emotional beat must be consistent. Readers watch your math, logic, and consequences."
-
-**Spreadsheet Fiction Warning**: "If your protagonist spends more time explaining their inventory than actually using it, you might be entering spreadsheet fiction."
-
-**Character Stakes > Numbers**: Give characters personal stakes — their arc should be more than getting to max level. Choices should matter. "The +5 Sword belonged to Meredith's father. Should I keep it knowing I'd stolen something that wasn't mine?"
-
-**The Lived-In World Test**: NPCs should have independent agendas. "A blacksmith argues with suppliers about prices; an innkeeper funds a rebellion—neither involves the hero directly."
-
-**Pacing Rules:**
-- Don't hand out power for free — Demon Lord should be Chapter 5+ victory, not Chapter 2
-- Compress grinding efficiently: "Three days of training later, my legs felt like lead, but my dodges were faster"
-- Interrogate every mechanic: Does this choice advance the story? If a skill upgrade doesn't mean something for character development, strategy, or challenges, there are no stakes
-
-### B.6 Serial Fiction Chapter Endings (from Royal Road Forums)
-
-**Five Cliffhanger Techniques:**
-1. **Raise stakes or questions** — End on heightened peril or new mysteries
-2. **Close calls** — Near misses, foiled plans, almost reunions
-3. **Interrupt key moments** — Stop right before confession, kiss, or confrontation
-4. **Reversals** — A victory becomes a defeat unexpectedly
-5. **End on dialogue** — Halt a tense conversation on a dramatic line
-
-**Critical Balance**: "If you have a cliffhanger every chapter, it's the same as not having them at all." Overuse diminishes impact.
-
-**Soft Hooks vs. Hard Cliffhangers**: Not every chapter needs danger — unanswered questions, new information, and emotional shifts work as engagement drivers without artificial tension.
-
-**Platform-Specific Warning**: Cliffhangers frustrate readers when chapters release infrequently. Pair cliffhanger intensity with release schedule reliability.
-
-### B.7 Progression Fantasy — Andrew Rowe Extended (from blog posts)
-
-**Magic System Specialization**: Characters should progress differently. Rather than Dragon Ball Z's approach (overall power increases everything uniformly), separate advancement in speed, strength, and resilience. Example: "Keras' 'Body of Stone' technique makes him stronger and more resilient, but at a cost to his speed."
-
-**Meaningful Weaknesses**: Must be relevant to combat style. "Physical weakness as a wizard has to be fairly extreme for it to serve as a major detriment." Avoid immediately solving weaknesses — they should represent long-term development goals.
-
-**Emotional Catharsis Power-Ups**: Can work (Stormlight Archives, Sailor Moon) when properly set up beforehand, but feel "super cheesy if it feels arbitrary and unearned."
-
-**Society-Level Power Application**: "Any Power Available to Society Should be Applied by Society." If resurrection exists, important people ensure access. Teleportation revolutionizes trade. Elemental magic transforms agriculture. Address how existing power structures utilize abilities.
-
-**The Options Principle**: "Adding something new to a character's list of abilities that they can actively take advantage of is more interesting than just a straight power increase." A conditional backstab attack engages readers more than "+2% critical hit rate."
-
-### B.8 AI Detection Extended — Structural Patterns (from RecordCrash, CRAFT, Reddit)
-
-**Machine Voice Rhythms**: Inconsistent cadence between "loquacious ponderous similes and tiny sentences made out of cliches" — artificial alternation rather than organic style development.
-
-**Contextual Poisoning**: Once AI reaches a "local minimum of samey cliches," it won't self-correct. Human writers instinctively vary word choices when noticing repetition; AI has the opposite instinct.
-
-**Character Name "Elara"**: Appears suspiciously often in AI fiction. Also watch for: Kael, Lyra, Theron, Seraphina.
-
-**Default Descriptions to Ban**: "barely above a whisper," "otherworldly glow," "eyes that held/held the weight of," "a dance of [noun]," "the air crackled with"
-
-**"Gray Goo" Storytelling**: Technically competent yet emotionally disengaged. The prose equivalent of watching a movie with the sound off — all the visual information is there but none of the feeling.
-
-### Sources (Appendix B)
-
-- [Kindlepreneur: How to Write a Book in Claude](https://kindlepreneur.com/claude-ai/)
-- [NovelMage: Claude 4 for Writers](https://novelmage.com/blog/claude-4-for-writers-the-complete-ai-writing-assistant-guide-that-actually-works)
-- [CRAFT Literary: Show Don't Tell — What AI Can't Do](https://www.craftliterary.com/2025/03/26/show-dont-tell-what-ai-cant-do/)
-- [Roll for Narrative: How to Write LitRPG Without Losing the Plot](https://rollfornarrative.parrydox.com/p/4thewriters-how-to-write-litrpg-without)
-- [Royal Road Forums: The Art of the Cliffhanger](https://www.royalroad.com/forums/thread/131550)
-- [Royal Road Forums: Overdoing the Mini Cliffhanger](https://www.royalroad.com/forums/thread/104367)
-- [John Champaign: Strategies for Success on Royal Road](https://johnchampaign.com/2024/01/29/strategies-for-success-releasing-litrpg-stories-on-royal-road/)
-- [Reddit/ResizeMyImg: Writing a Novel with AI in 2025](https://resizemyimg.com/blog/writing-a-novel-with-ai-in-2025-what-works-what-fails-and-real-reddit-writers-feedback-on-using-chatgpt-or-similar-models/)
-- [Andrew Rowe: Writing Progression Fantasy](https://andrewkrowe.wordpress.com/2019/03/02/writing-progression-fantasy/)
-- [SFF Chronicles: Why Writing LitRPG Is Harder Than People Think](https://www.sffchronicles.com/threads/590319/)
-- [RecordCrash: How to Identify AI-Written Web Fiction](https://recordcrash.substack.com/p/how-to-identify-ai-written-web-fiction)
-- [Write With AI Substack: 9 Claude Writing Tips](https://writewithai.substack.com/p/9-chatgpt-and-claude-writing-tips)
-
----
-
-**Document Version**: 1.2
-**Last Updated**: March 2026
-**Status**: Complete synthesis for InkOS English prompt development (Appendix A: Reddit/community sources, Appendix B: Extended AI community + practitioner research)
-
-This research document is intended to serve as the authoritative foundation for building InkOS's English prompt system. All sections are comprehensive enough to inform automated writing instruction, quality audit dimensions, and anti-AI detection protocols.

+ 0 - 111
docs/plans/2026-03-19-system-stability-design.md

@@ -1,111 +0,0 @@
-# System Stability Repair Design
-
-## Goal
-
-Repair the concrete runtime defects found in the review without broad refactors, keeping each fix isolated enough to land as a separate commit.
-
-## Scope
-
-This repair covers six behaviorally distinct problems:
-
-1. Non-atomic book locking and scheduler reentrancy
-2. Revision pipeline inconsistency after spot-fix and mismatch between final chapter text and truth files
-3. Agent model override client cache reusing the wrong API key/client
-4. Daemon startup leaving stale PID files on failure
-5. `inkos studio` always launching through `tsx`, even for built JavaScript entries
-6. Import resume reporting incorrect counts and totals
-
-Out of scope:
-
-- New features
-- CLI UX redesign
-- Packaging/cache-permission issues unrelated to application logic
-- Large changes to prompt structure or truth-file schema
-
-## Approaches Considered
-
-### Option A: Single broad “stability sweep”
-
-Fix all issues in one pass with one integration-heavy commit.
-
-Pros:
-
-- Fastest to code
-- Can share setup changes across files
-
-Cons:
-
-- Hard to review
-- Hard to bisect if any regression lands
-- Violates the requested per-fix submission style
-
-### Option B: Minimal targeted repairs per defect cluster
-
-Treat each defect cluster as its own TDD cycle with narrow tests and separate commits.
-
-Pros:
-
-- Matches the requested workflow
-- Keeps regression surface small
-- Makes each behavior change auditable
-
-Cons:
-
-- More commits
-- Some repeated test/setup work
-
-Recommendation: Option B.
-
-## Selected Design
-
-### 1. Concurrency and scheduling
-
-Replace the lock’s check-then-write pattern with atomic file creation semantics so only one writer can claim the lock. Add scheduler-side reentrancy protection so a long write cycle cannot overlap with the next timer tick. The lock remains file-based and local to the project; no external coordination is introduced.
-
-### 2. Revision consistency
-
-Use the latest working chapter content as the baseline for follow-up spot-fix revisions instead of falling back to the original draft. When final content changes, recompute and persist truth-file outputs from the final chapter text so chapter summaries and state-adjacent artifacts stay aligned with what was actually written to disk.
-
-### 3. Model override routing
-
-Strengthen the per-agent client cache key so distinct credentials and stream settings do not collapse into the same cached client. Preserve reuse where the effective transport config is identical.
-
-### 4. Daemon startup cleanup
-
-Ensure `inkos up` removes its PID file whenever startup aborts before the scheduler becomes healthy. Keep existing shutdown cleanup behavior.
-
-### 5. Studio launcher
-
-Detect whether the chosen entrypoint is TypeScript or JavaScript and launch with `npx tsx` only for TypeScript. Built JavaScript should run directly with `node`.
-
-### 6. Import resume accounting
-
-Return and log counts for the chapters actually processed during a resumed import, while preserving `nextChapter` semantics based on the full imported corpus.
-
-## Testing Strategy
-
-Each repair starts with a failing automated test:
-
-- `StateManager` tests for concurrent lock acquisition
-- `Scheduler` tests for interval overlap behavior
-- `PipelineRunner` tests for revision baseline selection, truth-file sync, and import resume counters
-- `PipelineRunner` unit test for model override cache isolation
-- CLI command tests for daemon PID cleanup and studio launcher command selection
-
-Verification after each batch:
-
-- Targeted package tests
-- Relevant typecheck if touched APIs change
-- Final full `pnpm test` and `pnpm typecheck`
-
-## Commit Plan
-
-Planned commits:
-
-1. `docs: add system stability repair design and plan`
-2. `fix: make book locking atomic and scheduler non-reentrant`
-3. `fix: keep revision outputs consistent with final chapter text`
-4. `fix: isolate agent override clients by effective config`
-5. `fix: clean stale pid files when daemon startup fails`
-6. `fix: launch studio with node for built javascript`
-7. `fix: report resumed imports using processed chapter counts`

+ 0 - 225
docs/plans/2026-03-19-system-stability-implementation-plan.md

@@ -1,225 +0,0 @@
-# System Stability Repair Implementation Plan
-
-> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
-
-**Goal:** Repair the reviewed runtime defects with isolated TDD-driven fixes and separate commits.
-
-**Architecture:** Keep the existing architecture intact and apply narrow behavior corrections at the lock, scheduler, pipeline, and CLI edges. Each task adds a failing test first, implements the smallest fix that passes, and lands in its own commit.
-
-**Tech Stack:** TypeScript, Node.js, Vitest, Commander, pnpm workspaces
-
----
-
-### Task 1: Atomic Locking And Non-Reentrant Scheduling
-
-**Files:**
-- Modify: `packages/core/src/__tests__/state-manager.test.ts`
-- Modify: `packages/core/src/pipeline/scheduler.ts`
-- Create/Modify: `packages/core/src/__tests__/scheduler.test.ts`
-- Modify: `packages/core/src/state/manager.ts`
-
-**Step 1: Write the failing tests**
-
-- Add a lock race test that starts two acquisitions at once and expects only one success.
-- Add a scheduler test that triggers overlapping timer ticks and expects only one write cycle to run at a time.
-
-**Step 2: Run tests to verify they fail**
-
-Run: `pnpm --filter @actalk/inkos-core test -- --runInBand src/__tests__/state-manager.test.ts src/__tests__/scheduler.test.ts`
-
-Expected: failures showing concurrent lock acquisition and/or overlapping cycle execution.
-
-**Step 3: Write minimal implementation**
-
-- Switch lock creation to atomic open/write semantics.
-- Track in-flight write/radar cycles and skip/reject reentry while a cycle is already running.
-
-**Step 4: Run tests to verify they pass**
-
-Run the same targeted test command and confirm green.
-
-**Step 5: Commit**
-
-```bash
-git add packages/core/src/state/manager.ts packages/core/src/pipeline/scheduler.ts packages/core/src/__tests__/state-manager.test.ts packages/core/src/__tests__/scheduler.test.ts
-git commit -m "fix: make book locking atomic and scheduler non-reentrant"
-```
-
-### Task 2: Revision Consistency With Final Chapter Text
-
-**Files:**
-- Create/Modify: `packages/core/src/__tests__/pipeline-runner.test.ts`
-- Modify: `packages/core/src/pipeline/runner.ts`
-
-**Step 1: Write the failing tests**
-
-- Test that the second spot-fix revision uses the already-fixed content as input.
-- Test that persisted truth-file outputs match the final revised chapter rather than the original writer output.
-
-**Step 2: Run tests to verify they fail**
-
-Run: `pnpm --filter @actalk/inkos-core test -- src/__tests__/pipeline-runner.test.ts`
-
-Expected: assertions showing stale baseline use and stale truth-file writes.
-
-**Step 3: Write minimal implementation**
-
-- Feed the current `finalContent` into follow-up revision.
-- Persist truth-file outputs derived from the final content path.
-
-**Step 4: Run tests to verify they pass**
-
-Run the same targeted test file and confirm green.
-
-**Step 5: Commit**
-
-```bash
-git add packages/core/src/pipeline/runner.ts packages/core/src/__tests__/pipeline-runner.test.ts
-git commit -m "fix: keep revision outputs consistent with final chapter text"
-```
-
-### Task 3: Agent Override Client Cache Isolation
-
-**Files:**
-- Modify: `packages/core/src/__tests__/pipeline-runner.test.ts`
-- Modify: `packages/core/src/pipeline/runner.ts`
-
-**Step 1: Write the failing test**
-
-- Add a test showing two overrides with the same base URL but different credential/env settings must not reuse the same cached client.
-
-**Step 2: Run test to verify it fails**
-
-Run: `pnpm --filter @actalk/inkos-core test -- src/__tests__/pipeline-runner.test.ts`
-
-Expected: failure proving the same client instance is reused incorrectly.
-
-**Step 3: Write minimal implementation**
-
-- Expand the cache key to cover the effective transport/auth config that determines client identity.
-
-**Step 4: Run test to verify it passes**
-
-Run the same targeted test file and confirm green.
-
-**Step 5: Commit**
-
-```bash
-git add packages/core/src/pipeline/runner.ts packages/core/src/__tests__/pipeline-runner.test.ts
-git commit -m "fix: isolate agent override clients by effective config"
-```
-
-### Task 4: Daemon PID Cleanup On Startup Failure
-
-**Files:**
-- Modify: `packages/cli/src/__tests__/cli-integration.test.ts` or add focused daemon command test
-- Modify: `packages/cli/src/commands/daemon.ts`
-
-**Step 1: Write the failing test**
-
-- Simulate a startup failure after PID creation and assert the PID file is removed.
-
-**Step 2: Run test to verify it fails**
-
-Run: `pnpm --filter @actalk/inkos test -- src/__tests__/cli-integration.test.ts`
-
-Expected: PID file remains after a failed startup.
-
-**Step 3: Write minimal implementation**
-
-- Wrap startup cleanup so the PID file is removed on failed boot paths.
-
-**Step 4: Run test to verify it passes**
-
-Run the same targeted CLI test and confirm green.
-
-**Step 5: Commit**
-
-```bash
-git add packages/cli/src/commands/daemon.ts packages/cli/src/__tests__/cli-integration.test.ts
-git commit -m "fix: clean stale pid files when daemon startup fails"
-```
-
-### Task 5: Studio Launcher Runtime Selection
-
-**Files:**
-- Create/Modify: `packages/cli/src/__tests__/studio.test.ts`
-- Modify: `packages/cli/src/commands/studio.ts`
-
-**Step 1: Write the failing tests**
-
-- Test that a `.ts` entry launches through `npx tsx`.
-- Test that a `.js` entry launches through `node`.
-
-**Step 2: Run tests to verify they fail**
-
-Run: `pnpm --filter @actalk/inkos test -- src/__tests__/studio.test.ts`
-
-Expected: built JavaScript path still routes through `tsx`.
-
-**Step 3: Write minimal implementation**
-
-- Factor command selection from entrypoint extension and use the proper runtime.
-
-**Step 4: Run tests to verify they pass**
-
-Run the same targeted test file and confirm green.
-
-**Step 5: Commit**
-
-```bash
-git add packages/cli/src/commands/studio.ts packages/cli/src/__tests__/studio.test.ts
-git commit -m "fix: launch studio with node for built javascript"
-```
-
-### Task 6: Resume Import Accounting
-
-**Files:**
-- Modify: `packages/core/src/__tests__/pipeline-runner.test.ts`
-- Modify: `packages/core/src/pipeline/runner.ts`
-
-**Step 1: Write the failing test**
-
-- Add a resume import test that starts from a later chapter and asserts `importedCount` and `totalWords` reflect only processed chapters in that run.
-
-**Step 2: Run test to verify it fails**
-
-Run: `pnpm --filter @actalk/inkos-core test -- src/__tests__/pipeline-runner.test.ts`
-
-Expected: return values count the whole corpus instead of the resumed slice.
-
-**Step 3: Write minimal implementation**
-
-- Track processed chapter count and processed-word total separately from full corpus size.
-
-**Step 4: Run test to verify it passes**
-
-Run the same targeted test file and confirm green.
-
-**Step 5: Commit**
-
-```bash
-git add packages/core/src/pipeline/runner.ts packages/core/src/__tests__/pipeline-runner.test.ts
-git commit -m "fix: report resumed imports using processed chapter counts"
-```
-
-### Task 7: Final Verification
-
-**Files:**
-- No code changes expected
-
-**Step 1: Run full verification**
-
-Run:
-
-```bash
-pnpm typecheck
-pnpm test
-```
-
-Expected: all targeted fixes pass together. If the packaging test still fails due to local npm cache permissions, note that explicitly and verify all application-level tests separately.
-
-**Step 2: Summarize final state**
-
-- Record commit list
-- Record any environment-specific residual issue

+ 0 - 1577
docs/raw-craft-rules.md

@@ -1,1577 +0,0 @@
-Excellent. I now have comprehensive research across all the major craft topics. Let me compile a structured research report.
-
----
-
-## COMPREHENSIVE RESEARCH REPORT: ENGLISH FICTION CRAFT RULES FOR QUALITY AUDITING
-
-### EXECUTIVE SUMMARY
-
-This report documents professional English creative writing craft rules used by editors, writing teachers, and experienced authors to evaluate fiction quality. The research covers genre fiction (fantasy, sci-fi, web serials) and is intended to inform quality audit dimensions for an automated novel-writing system. Sources include industry-standard craft books, professional writing resources, podcasts, and editorial guidance from platforms like Mythcreants, Writing Excuses, and major authors.
-
----
-
-## 1. PROSE CRAFT RULES
-
-### 1.1 Show Don't Tell
-
-**Core Principle**: Use sensory details and action rather than direct statements to allow readers to experience the story themselves.
-
-**Specific Implementation**:
-- Build understanding through concrete details and character behavior, not through explanatory text
-- Include sensory information: what characters see, hear, smell, taste, feel
-- Demonstrate emotion through physical reactions and dialogue
-- Use specific actions that reveal character, motivation, and emotional state
-
-**Example from Stephen King's Method**: Instead of "Brady is really pissed off about the detective's message," show Brady saying something between a whisper and a growl, striding in an unsteady circle, yanking his hair so hard his eyes water, kicking his chair, hunching over like a vulture.
-
-**When Telling Is Acceptable**: Exposition at the story's beginning, after major reveals where certain details simply need clear statement, or when time constraints require narrative shortcuts. Must be used sparingly and deliberately.
-
-**Audit Implication**: Detect excessive exposition dumps and emotional declarations that tell rather than show. Flag scenes where emotion or character state is stated directly without supporting action or dialogue.
-
----
-
-### 1.2 Active vs. Passive Voice
-
-**Target Ratio**: Aim for approximately 80% active voice, 20% passive voice (though this should be flexible).
-
-**When to Use Active Voice**:
-- Creates directness and clarity
-- Builds reader connection to POV character
-- Demonstrates character agency and forward momentum
-- Generally preferred in genre fiction (fantasy, sci-fi, thrillers)
-
-**When Passive Voice Works**:
-- **Mystery/Suspense**: Conceals information the author wants to withhold
-- **Creating Emphasis**: When the action or recipient matters more than the actor
-- **Mood and Tone**: Can create desired atmospheric effects
-- **Dialogue**: Characters may naturally use passive constructions based on voice
-
-**Audit Implication**: Detect overuse of passive voice (>25% of sentences). Flag passive voice in action sequences or dialogue-heavy scenes unless intentional for mystery effect.
-
----
-
-### 1.3 Adverb Usage: The Stephen King Rule and Exceptions
-
-**Stephen King's Principle**: "I believe the road to hell is paved with adverbs, and I will shout it from the rooftops."
-
-**Core Rule**: Minimize adverbs (words ending in -ly) because they tell rather than show—they express doubt in your ability to write strong verbs.
-
-**Specific Applications**:
-
-**Dialogue Tags**: CRITICAL—Never use adverbs in dialogue tags.
-- Wrong: "said angrily," "whispered softly," "laughed happily"
-- Right: Use stronger verbs instead ("snapped," "whispered," "chuckled")
-- Better: Show emotion through dialogue content itself and action beats
-
-**Narrative Prose**: Minimize but don't eliminate. Choose strong verbs instead.
-- Wrong: "He walked slowly across the room."
-- Right: "He shuffled across the room."
-
-**King's Philosophy**: Adverbs suggest the writer lacks trust in readers' ability to understand action without explanation, or hasn't built sufficient context for readers to infer meaning.
-
-**Exceptions**: Use adverbs only rarely and strategically—when a specific modifier truly adds irreplaceable meaning and can't be expressed through verb choice.
-
-**Audit Implication**: Flag excessive adverbs (>3 per 500 words in narrative, any in dialogue tags). Detect adverbs in dialogue tags as automatic red flags.
-
----
-
-### 1.4 Said-Bookism and Dialogue Tags
-
-**The Invisibility of "Said"**: The word "said" is practically invisible to readers. The brain glosses over it instantly, allowing readers to stay immersed in dialogue.
-
-**Why Fancy Dialogue Tags Fail**: 
-- Alternative verbs (exclaimed, declared, announced, insisted, asked) subtly jar readers out of the dialogue
-- They draw attention to the narrator's word choice rather than the character's voice
-- They interrupt story immersion
-
-**Professional Standards**:
-- Use "said" and "asked" as defaults
-- Replace some tags entirely with action beats (physical actions showing how something is said)
-- If emotion/tone isn't clear from dialogue content and context, the dialogue itself needs rewriting, not a fancy tag
-
-**Example Fix**:
-- Wrong: "I hate this," she said angrily.
-- Right: "I hate this." She slammed the door.
-
-**Audit Implication**: Flag dialogue tags other than "said" and "asked" as violations. Detect adverbs in dialogue tags as automatic failures. Encourage action beats over dialogue tags.
-
----
-
-### 1.5 Purple Prose Detection
-
-**Definition**: Overly elaborate, self-indulgent writing that prioritizes the sound of words and ornate descriptions over clarity and pacing.
-
-**Red Flag Characteristics**:
-- Excessive adjectives modifying nouns
-- Multisyllabic, flowery language that calls attention to itself
-- Exaggerated metaphors and similes
-- Long, winding sentences that obscure meaning
-- Overwrought emotional descriptions
-- Language feels melodramatic or divorced from the story's needs
-
-**Examples of Purple Prose**:
-- "Her laughter was a symphony of spring rain, golden sunlight, and wind in the trees." (Better: "Her laughter was like a rain shower—quick and unexpected.")
-- "The tall, brooding, mysterious stranger walked solemnly and silently across the desolate, fog-laced, moonlit street." (Better: "The stranger drifted down the fog-laced street, quiet and unreadable.")
-- "He was consumed by a soul-crushing, bone-deep anguish that shattered him into a million irreparable fragments." (Better: "His gut dropped—and kept dropping. He sank to his knees, tried to speak, but what could he say?")
-
-**Root Causes**:
-- Weak verb choices compensated for with adjectives
-- Unclear story logic compensated for with lyrical language
-- Attempting to sound literary rather than telling the story effectively
-
-**Audit Implication**: Detect clusters of 3+ adjectives modifying single nouns, elaborate metaphors that overshadow action, ornate language that obscures meaning. Flag inconsistency between prose style and genre expectations (flowery prose in action-heavy sci-fi).
-
----
-
-### 1.6 Filter Words
-
-**Definition**: Unnecessary words that separate reader from character experience, creating distance between the reader's experience and the character's POV.
-
-**Common Filter Words**: assumed, believed, considered, decided, felt, heard, knew, looked, noticed, observed, perceived, realized, revealed, saw, seemed, sounded, thought, understood, watched, wondered.
-
-**Why They Weaken Writing**: Filter words add an extra layer of narration between reader and character consciousness, reducing immediacy and deep POV.
-
-**Examples and Fixes**:
-- "She noticed two snakes fighting in the rocks." → "In the rocks, two snakes were fighting."
-- "He heard footsteps in the hall." → "Footsteps echoed down the hall."
-- "She felt light-headed and gripped the door frame." → "Light-headed, she gripped the door frame."
-- "He saw the gun in her hand." → "The gun was in her hand."
-
-**When They're Acceptable**: Rarely. Sometimes a filter phrase's simplicity is the right choice if removing it creates awkwardness, but this should be exceptional.
-
-**Audit Implication**: Detect filter words, especially in first-person or deep third-person POV. Flag filter word usage >1 per 500 words. In deep POV sections, filter words are particularly problematic.
-
----
-
-### 1.7 Sentence-Level Rhythm and Structure Variation
-
-**Core Principle**: Monotonous sentence structure creates monotonous reading. Vary sentence length and structure to create rhythm that engages readers.
-
-**Fundamental Technique**: Mix short and long sentences.
-- **Short sentences**: Create pace, urgency, emphasis, impact
-- **Long sentences**: Slow pace, allow complexity, build atmosphere
-- **Medium sentences**: Balance and flow
-
-**Application to Genre Fiction**:
-- **Action scenes**: Predominately short-to-medium sentences create speed and tension
-- **Dialogue scenes**: Varied lengths reflect natural conversation rhythm
-- **Introspection**: Longer sentences can show character processing, but vary throughout
-- **Quiet moments**: Short sentences can paradoxically create tension through restraint
-
-**Rhythm Techniques**:
-- Vary sentence length systematically, not randomly
-- Use parallel structure for emphasis or connection
-- Employ repetition strategically for rhythm and memorability
-- Use punctuation to guide pacing and emphasis
-
-**Effect on Reader**: Rhythm paces the reader, emphasizes ideas, creates mood, and maintains engagement.
-
-**Audit Implication**: Detect paragraphs where all sentences are roughly the same length. Flag action scenes dominated by long sentences. Detect monotonous rhythm in dialogue. Check that pacing (sentence length) matches scene intensity.
-
----
-
-### 1.8 Paragraph Structure for Genre Fiction
-
-**Principle**: Paragraph breaks are tools for controlling pacing.
-
-**Short Paragraphs**:
-- Create faster visual pace
-- Make eyes move down page quickly
-- Best for: action scenes, dialogue with tension, rising stakes
-- Effect: reader perceives speed and momentum
-
-**Long Paragraphs**:
-- Slow visual pace
-- Allow detailed exploration
-- Best for: introspection, world-building, description, emotional depth
-- Effect: contemplative mood, thoughtfulness
-
-**Dialogue Heavy Scenes**:
-- Break up long dialogue exchanges with physical action or internal thought
-- Use the Rule of Three: after three lines of dialogue, insert a beat of action/emotion/narration or switch speaker
-
-**Genre Expectations**:
-- **Action/Thriller**: Frequent paragraph breaks, mostly short paragraphs
-- **Fantasy**: Balanced, varied—short for action, longer for world detail
-- **Web Serial**: Very short paragraphs (cliffhangers every 1,500–2,000 words), frequent breaks for pacing
-
-**Audit Implication**: Flag excessive paragraph length in action scenes. Detect long stretches of dialogue without breaks or action beats. Check paragraph structure matches scene intensity and genre conventions.
-
----
-
-## 2. SCENE CRAFT
-
-### 2.1 Scene Structure: Goal-Conflict-Disaster / Reaction-Dilemma-Decision
-
-**Framework Origin**: Developed by Dwight V. Swain in "Techniques of the Selling Writer."
-
-**THE SCENE (Action)**:
-
-**Goal**: 
-- Characters have scene-level objectives distinct from the overall plot goal
-- The goal drives action forward
-- Creates clarity about what's at stake in this moment
-
-**Conflict**:
-- Series of obstacles preventing the character from reaching the goal
-- Tests the character's determination
-- Shows how badly the character wants the goal
-- Builds momentum and reader engagement
-
-**Disaster**:
-- Failure to achieve the goal
-- Not necessarily catastrophic, but significant enough to change future outcomes
-- Has stakes and consequences
-- Creates the "page-turner" effect
-
-**THE SEQUEL (Reaction)**:
-
-**Reaction**:
-- Character absorbs and processes the disaster's emotional impact
-- Shows how the disaster affects the character
-- Gives emotional weight to story events
-- Creates space for character humanity
-
-**Dilemma**:
-- Presents the question: "What do I do now?"
-- Shows the character's options and their costs
-- Builds tension through uncertainty
-- Raises stakes for next action
-
-**Decision**:
-- Character makes a choice among options
-- Becomes proactive again (not passive)
-- Leads directly to the next scene's goal
-- Creates momentum
-
-**Momentum Building**: These elements chain together—disaster leads to reaction, reaction to dilemma, dilemma to decision, decision to new goal, creating an engine that drives readers through the story.
-
-**Audit Implication**: Check scenes have clear goals. Detect scenes with no conflict or stakes. Flag scenes ending in success without consequences (no disaster). Verify reaction sequences exist after major events. Check decision/choice drives next scene.
-
----
-
-### 2.2 Scene Transitions and White Space
-
-**Transition Types**:
-- **No transition**: Scene continues naturally in same location/time
-- **White space**: Blank line break indicating time/location shift
-- **Narrative bridge**: Brief transitional prose explaining time/location shift
-- **Chapter break**: Major structural transition
-
-**White Space Function**:
-- Signals passage of time or change of location
-- Gives readers breathing room
-- Prevents "white room syndrome" (feeling of floating in undefined space)
-- Creates pacing through visual breaks
-
-**Best Practices**:
-- Use white space for obvious transitions (time/location changes)
-- Vary transition methods to avoid monotony
-- Ensure reader always knows where/when scene is set
-- Use transitions to control pacing (frequent transitions = faster feel; fewer = slower)
-
-**Audit Implication**: Check scenes have clear setting/time establishment. Flag scenes that seem to exist in undefined space. Verify transitions match story pacing needs.
-
----
-
-### 2.3 Action Scene Pacing and Clarity
-
-**Key Elements**: Goals, Pacing, Clarity, Character
-
-**Clarity First**:
-- Readers must understand what's happening
-- Avoid confusing or over-complicated choreography
-- Visualize the scene completely before writing
-- Use clear cause-and-effect
-- Simpler action sequences are often more gripping than complex ones
-
-**Sentence Structure for Action**:
-- **Short and medium sentences**: Build pace and excitement
-- **Avoid hundred-word sentences**: Kills momentum
-- **Fragment usage**: Sparingly, for impact
-- **Adjective/adverb usage**: Ruthlessly eliminate; find strong verbs and nouns instead
-
-**Visual Layout**:
-- Blank space on page creates impression of fast pace
-- Smaller paragraphs make eyes move down page faster
-- Dense paragraphs slow reading
-
-**Character and Stakes**:
-- Show internal reaction of active character
-- Readers care about characters; action without emotional investment feels hollow
-- High stakes make action meaningful
-- Character emotion creates tension readers feel
-
-**Pacing Rhythm**:
-- Vary pace: scene after scene of breakneck action becomes tedious
-- Predictable patterns (slow/fast/slow/fast) also weaken
-- Mix in moments of reflection between action peaks
-- Physical and emotional arcs should complement each other
-
-**Audit Implication**: Flag overly complex action descriptions. Check action scenes don't average >15 words per sentence. Verify character perspective and emotion present in action. Detect action scenes with no stakes or character investment.
-
----
-
-### 2.4 Dialogue Scene Construction and Beats
-
-**Understanding Beats**:
-- Beats are the smallest units of structure that push narrative forward
-- Can include actions, events, emotional shifts, or conversations
-- Represent micro-level action/reaction between characters
-- Prevent "floating head syndrome" (dialogue with no grounding)
-
-**Action Beats**:
-- Insert physical action, gesture, or environmental interaction between dialogue lines
-- Break monotony of dialogue-only exchanges
-- Show character reaction non-verbally
-- Add setting detail and grounding
-- Example: "I can't do this anymore." She buried her head in her hands.
-
-**The Rule of Three**:
-- Whenever a character speaks three lines of dialogue, switch speaker, insert an action beat, show emotion, or use brief narration
-- Prevents long unbroken dialogue blocks
-- Maintains reader's sense of visual/physical reality
-
-**Talking Heads Problem**:
-- Dialogue with no action, setting, or non-verbal reaction
-- Readers can't visualize scene or characters
-- Lacks grounding in physical reality
-- Feels like screenplay rather than novel prose
-
-**Dialogue Construction Requirements**:
-- Each exchange must turn the beats of the scene
-- Must sound like natural talk
-- Should reveal character, advance plot, or both
-- Must include sensory grounding and physical presence
-
-**Audit Implication**: Flag long dialogue exchanges without action beats or setting details. Detect scenes that could be "talking heads." Verify action beats use varied verbs and create character understanding.
-
----
-
-### 2.5 Fight Scene Writing
-
-**Core Tension**: Mechanics of fights are often boring; the experience is vivid and terrifying. Good writing transforms mechanical action into gripping experience.
-
-**Clarity Over Choreography**:
-- Readers must understand what's happening (priority #1)
-- Over-detailed choreography confuses and slows pace
-- Detailed step-by-step feels mechanical, not gripping
-- Focus on key movements and character reactions
-
-**Visceral, Sensory Language**:
-- Sounds: impacts, grunts, gasps, silence
-- Smells: blood, sweat, fear
-- Tactile: impact on body, pain, exhaustion
-- Emotional: fear, adrenaline, desperation
-- Make reader *feel* the fight, not just see it
-
-**Pacing Structure**:
-- Short to medium-length sentences work best
-- Complement swift nature of battle
-- Build pace and tension
-- Avoid long, complex sentences that slow reading
-
-**Character and Stakes**:
-- Fight scenes without character work feel hollow
-- Readers must know what losing means
-- High stakes make tension matter
-- Show protagonist's limitations and vulnerabilities
-
-**Rhythm and Variation**:
-- Don't sustain maximum intensity throughout
-- Mix moments of intensity with brief pauses
-- Show character fatigue and recovery
-- Create emotional climax, not just physical action
-
-**Audit Implication**: Check fight scenes are visually clear. Detect over-complicated choreography. Verify sensory language present. Check stakes are established. Flag fight scenes without character perspective.
-
----
-
-### 2.6 Emotional and Quiet Scenes
-
-**Principle**: Stillness can be loaded with emotion, meaning, and tension—but only if you charge it properly.
-
-**Building Emotional Weight in Stillness**:
-- Know what's at stake beneath the calm
-- Emotion must show through nonverbal communication
-- Body language, micro-reactions, tiny movements are gold
-- Show what character won't or can't say
-
-**Techniques**:
-
-**Controlled Emotion**:
-- Express strong feeling through implication rather than declaration
-- Show how emotion alters behavior, environment, pacing, dialogue
-- Pressure building is more powerful than emotion venting immediately
-- Restraint often feels heavier than explosion
-
-**Prose Structure**:
-- Keep prose lean; let each line land
-- Avoid over-explaining
-- Use white space as friend
-- Short paragraphs and intentional line breaks
-- Silence and stillness are active, not passive
-
-**Nonverbal Elements**:
-- Dialogue with room to breathe
-- Fractured sentences showing disrupted thinking
-- Sensory detail: temperature, texture, light
-- Physical positioning and distance between characters
-
-**Transformation Requirement**:
-- Even if scene is physically still, something must shift
-- Realization, decision, loss, intimacy, understanding
-- Best quiet moments are transformational
-- Show change in character's emotional or psychological state
-
-**Audit Implication**: Check quiet scenes aren't emotionally flat. Verify nonverbal communication shows emotion without stating it. Detect over-explaining. Flag scenes without transformation or emotional arc.
-
----
-
-## 3. CHARACTER CRAFT
-
-### 3.1 Deep POV and Character Voice
-
-**Definition of Deep POV**: Most intimate, closest writing style where reader experiences story as if inside the character—feeling what they feel, experiencing what they experience, hearing their thoughts, without distance.
-
-**Creating Deep POV**:
-- Character's immediate sensory perceptions and reactions
-- Character's internal thoughts and emotional responses
-- Character's interpretation of events (not omniscient narrator's)
-- Filter out authorial distance
-- Immerse reader in character's moment-to-moment experience
-
-**Character Voice Components**:
-- **Sentence structure**: Reflects how character thinks and speaks
-- **Vocabulary**: Reveals education, background, region
-- **Rhythm and accent**: Distinctive speech patterns
-- **What character notices**: Emphasizes their priorities and concerns
-- **What character omits or avoids thinking about**: Shows internal conflict
-- **Personal opinions and biases**: Reveals character worldview
-
-**First-Person Voice**: 
-- Narrator voice carries throughout
-- Every word reflects character's perspective
-- Personality shines through word choice and rhythm
-- Readers know character intimately through voice
-
-**Third-Person Deep POV**:
-- Narrative uses third person but filtered through character's perception
-- Narrator adopts character's vocabulary and syntax
-- Character's internal voice becomes the prose voice
-- Maintains emotional intimacy despite third person
-
-**Establishing Voice Quickly**:
-- Characters should be distinguishable by voice alone
-- Readers should know POV character from random page opening
-- Voice consistency across scene/chapter
-- Assessment words reveal character desire/fear ("probably," "fortunately," "weirdly," "disastrously")
-
-**Audit Implication**: Check voice is consistent within character's POV. Detect authorial intrusion (narrator voice differs from character voice). Verify character voice is distinct if multiple POV characters. Flag filter words as distance-creating.
-
----
-
-### 3.2 Head-Hopping and POV Breaks
-
-**Definition**: Jumping from one character's head to another's within the same passage—typically mid-scene or mid-chapter, not at scene/chapter breaks.
-
-**Why It's Problematic**:
-- Breaks immersion—hauls readers out of narrative
-- Reader loses sense of whose story it is
-- Creates confusion about perspective
-- Reminds readers they're "being told" a story
-- Breaks reader trust in author's authority
-
-**How It Happens**:
-- POV switches within scene without clear break
-- Revealing one character's thoughts immediately followed by another's
-- Shifting to external description that narrator couldn't access
-- Revealing information no POV character could know
-
-**Professional Standards**:
-- Multiple POV characters are acceptable
-- Switch only at scene breaks or chapter breaks
-- Scene has one POV character throughout
-- If switching POV characters, use clear structural signals (chapter break, section break)
-
-**Detection and Fixing**:
-- Color-code scenes by POV during revision
-- Use writing software (Scrivener, Dabble) to tag POV
-- Keep POV log during drafting
-- Check each paragraph for POV consistency
-- Verify all thoughts/internal reactions belong to current POV character
-
-**Audit Implication**: Flag POV shifts within scenes without breaks. Detect thoughts/knowledge that don't belong to current POV character. Verify clear structure when switching POV characters.
-
----
-
-### 3.3 Character Motivation and Agency
-
-**Character Agency Definition**: Character's ability to make decisions and affect the story; has own motivations; is active more than reactive; pushes plot more than plot pushes them.
-
-**Passive vs. Active Protagonists**:
-- **Passive**: Go with flow, make no decisions, don't affect story, always one step behind
-- **Active**: Make story what it is, drive narrative forward, make meaningful choices
-
-**Agency Components**:
-
-**Motivation (Motive)**:
-- What character wants
-- Why they want it
-- Must be something they'll take risks to get
-- Should connect to main story goals
-
-**Capacity**:
-- Character must have ability to pursue the goal
-- Doesn't mean guaranteed success, but means they can try meaningfully
-- Includes skills, resources, willingness, determination
-
-**Goals and Choices**:
-- Scene-level goals drive immediate action
-- Story-level goals drive overall arc
-- Character must make consequential choices
-- Choices drive story forward
-
-**Overcoming Passivity**:
-- Give character strong goal connected to main story
-- Ensure character has motivation to chase it
-- Character must take action and make decisions in pursuit of goal
-- Create situations where character's agency matters
-
-**Nuance**: Reactive characters aren't automatically passive. Character can react to circumstances while remaining active (making choices, pursuing goals). Difference is whether character's choices and agency matter to plot.
-
-**Audit Implication**: Check protagonist has clear goal. Detect protagonists who never initiate action or make meaningful choices. Flag "plot happens to them" structure. Verify character decisions have consequences. Check motivation is credible.
-
----
-
-### 3.4 Character Consistency and Voice Checks
-
-**Voice as Distinguishing Feature**:
-- Readers should identify POV character from voice alone
-- Agents and publishers expect this in professional fiction
-- Even in third person, voice must be character-specific
-
-**Consistency Elements to Track**:
-- **Vocabulary**: Word choice consistent with character education/background
-- **Sentence structure**: Reflects character's thinking patterns
-- **Speech patterns**: Dialogue distinctive to character
-- **What character notices**: Consistent with personality and priorities
-- **Internal reactions**: Consistent with character values
-- **Assessment words**: Words like "luckily," "fortunately," "weirdly" show POV character's judgment
-
-**Avoiding Inconsistency**:
-- Establish voice early and maintain throughout
-- Don't shift into authorial voice
-- Keep character's biases and perspectives consistent
-- Don't have character know things they couldn't know
-- Maintain internal logic of character's worldview
-
-**Dialogue Consistency**:
-- Each character's speech should be distinctive
-- Vocabulary, slang, formality level varies by character
-- Speech patterns reveal education, age, region, personality
-- Avoid all characters sounding like author
-
-**Audit Implication**: Flag inconsistent voice within character's POV sections. Detect authorial intrusion. Verify multiple POV characters have distinct voices. Check dialogue is character-differentiated.
-
----
-
-## 4. PLOT AND STRUCTURE
-
-### 4.1 Three-Act Structure and Serial Fiction
-
-**Basic Three-Act Model**:
-- **Act 1 (Setup)**: ~25% of story
-  - Introduce characters, setting, central conflict
-  - Establish stakes and protagonist's status quo
-  - Inciting incident: pivotal event that disrupts normal world and sets story in motion
-  - Plot Point 1: locks character into story (no turning back)
-
-- **Act 2 (Confrontation)**: ~50% of story
-  - Character reacts to conflicts and obstacles
-  - Rising action: complications escalate, stakes raise
-  - Character pushed to limits
-  - Try-fail cycles multiply challenges
-  - Midpoint: major revelation or turning point
-
-- **Act 3 (Resolution)**: ~25% of story
-  - Repercussions of Act 2 choices revealed
-  - Climax: final confrontation with stakes at maximum
-  - Resolution: consequence of climactic action
-  - Denouement: return to new normal
-
-**Adaptation for Serial Fiction**:
-- Three-act structure still applies to overall story arc
-- Episodic structures overlay three-act with flexible segments
-- Works particularly well for web serials
-- Each episode can have mini-arc while contributing to larger narrative
-
-**Cliffhangers in Serial Format**:
-- Top web serials place cliffhangers every 1,500–2,000 words
-- Episodic structure requires cliffhangers to drive reader return
-- Can be dramatic or emotional
-- Effective cliffhangers include unresolved questions, plot twists, peril, emotional stakes
-
-**Pacing for Serial**:
-- Word counts become strategically important
-- Readers expect consistency (similar episode lengths)
-- J.K. Rowling model: episodic arc threaded through three-act design
-- End chapters with question that begs next click
-- Provide mini-resolution within episode while leaving larger questions open
-
-**Audit Implication**: Check three-act structure is recognizable. Verify Act 1 sets up stakes and locks in protagonist. Check Act 2 shows escalation through try-fail cycles. Verify Act 3 climax reflects prior choices. For serial: check cliffhangers appropriately placed.
-
----
-
-### 4.2 Promise, Progress, and Payoff
-
-**Framework**: Brandon Sanderson's fundamental storytelling structure.
-
-**Promise** (Beginning):
-- Story makes promises to audience about what it will deliver
-- Establishes expectation and contract with reader
-- Sets up genre, tone, character, conflict
-- Reader expects satisfaction of these promises
-
-**Progress** (Middle):
-- Maintains audience investment through visible forward movement
-- Readers sense plot moving toward promises
-- Without progress, story feels stalled
-- Progress shows working toward payoff, not just spinning wheels
-
-**Payoff** (End):
-- Fulfills the promises made at beginning
-- Rewards audience for sticking around
-- Creates satisfaction if done properly
-- Ideally delivers more than promised ("and then some")
-
-**Application to Structural Units**:
-- Applies to whole story, acts, scenes, even moments
-- Each scene needs promise and payoff
-- Larger story need not resolve all promises (can leave threads for sequels)
-- Consistency between promise and payoff is essential
-
-**Example**: Luke doesn't just adventure into stars—he becomes hero of entire galaxy (promise exceeded).
-
-**Audit Implication**: Check opening establishes clear promises. Verify middle shows progress toward those promises. Check ending fulfills promises made at beginning. Flag stories that make promises but don't deliver.
-
----
-
-### 4.3 Foreshadowing Techniques
-
-**Purpose**: Give indication or hint of what's coming, creating suspense, unease, curiosity, or sense that things aren't as they seem.
-
-**When Readers Notice Foreshadowing**: Usually they don't initially—understanding comes on reread or when "aha moment" arrives.
-
-**Key Craft Rules**:
-- Foreshadow only major events; overuse creates unintentional comedy
-- Payoff must match tone/mood of foreshadowing
-- Don't blow out proportion of trivial events (avoid soap opera melodrama)
-- Foreshadowed event must actually occur; unfulfilled foreshadowing damages trust
-
-**Foreshadowing Techniques**:
-
-**Direct Foreshadowing**:
-- Most obvious, least subtle
-- Prologue, narrator statement, dialogue, prophecy
-- Explicitly prepares reader
-- Useful for thematic weight
-
-**Indirect Foreshadowing**:
-- Hides clues in background details
-- Only makes sense in retrospect
-- More sophisticated
-- Clues seem innocuous until payoff
-
-**Symbolic Foreshadowing**:
-- Objects, settings, motifs carry deeper meaning
-- Works on thematic/emotional level
-- Filters through reader's subconscious
-- Reader may not consciously recognize pattern
-
-**Through Dialogue**: Characters joke, mention offhand, discuss concerns
-**Through Setting**: Atmospheric choices hint at events
-**Through Character Details**: Appearance, attire, mannerisms foreshadow truth or actions
-**Through Title**: Novel or chapter titles can foreshadow major events (e.g., "The Fall of the House of Usher" foreshadows both house and family destruction)
-
-**Examples**:
-- Dickens's storm descriptions in Great Expectations foreshadow dark turn of plot
-- Rowling's Professor Quirrell's turban is noted, revealing its significance later
-- Chekhov's Gun: if gun appears in Act 1, it must be fired by Act 3 (principle of economy—don't introduce unless it matters)
-
-**Audit Implication**: Verify significant plot events are foreshadowed. Check foreshadowing payoff matches setup. Flag unfulfilled foreshadowing. Detect excessive foreshadowing of minor events.
-
----
-
-### 4.4 Tension Management and Escalation
-
-**Tension Definition**: Emotional pressure keeping readers engaged and invested in story outcome, created through conflict, uncertainty, and emotional stakes.
-
-**Components of Tension**:
-
-**Pacing**:
-- Controls how fast information arrives
-- Too fast: readers can't feel emotional impact
-- Too slow: readers lose interest
-- Short sentences and words accelerate; long sentences slow
-
-**Escalation**:
-- Each conflict/obstacle more significant than last
-- Raises stakes progressively
-- Small threats escalate to major ones
-- Creates building pressure
-
-**Information Control**:
-- **Withholding Information**: Show effect without cause; creates desperation to understand
-- **Dramatic Irony**: Reader knows what character doesn't; creates different tension
-- **Cliffhangers**: Unresolved questions create need for answers
-
-**Structure**:
-- Three-act structure designed to escalate tension
-- Act II accelerates through rising action
-- Complications introduced, stakes raised, protagonist pushed to limits
-- Climax reaches maximum tension
-
-**Balancing Pace**:
-- Fast-paced action followed by slower moments of introspection
-- Balance deepens emotional weight
-- Action peaks more impactful when contrasted with calm
-- Moments of calm more unsettling when surrounded by tension
-
-**Advanced Techniques**:
-- **Foreshadowing**: Builds background hum of tension without slowing pace
-- **Subtext**: Characters and readers understand different meanings
-- **Uncertainty**: Readers unsure of outcome increases investment
-- **Personal Stakes**: Making threat personal to protagonist increases tension
-
-**Common Mistake**: Sustaining maximum intensity constantly creates exhaustion, not engagement. Readers need variation and breathing room.
-
-**Audit Implication**: Check escalation through story (stakes grow higher). Verify pacing varies (not all fast or all slow). Detect moments of relief between peaks. Check tension techniques (withholding, irony, cliffhangers) employed appropriately.
-
----
-
-### 4.5 Try-Fail Cycles
-
-**Definition**: When character attempts to achieve goal and fails (or partially succeeds). Good plots full of these cycles create sense of escalation and character exploration.
-
-**Structure and Progression** (typical):
-
-**First Try-Fail Cycle**:
-- Often involves negotiation
-- Fails because real conflict requires more than simple conversation
-
-**Second Try-Fail Cycle**:
-- Bigger effort
-- Doesn't work as well as expected
-- Often makes situation worse
-- Raises stakes
-
-**Third Try-Fail Cycle** (and beyond):
-- Character realizes they must change to resolve problem
-- B-line conflict (emotional/psychological growth) becomes solution to A-line conflict (external plot)
-- Reveals character through failure
-
-**Partial Success/Failure**:
-- "Yes, but..." (partial success): Character gets something or moves closer without full achievement
-- "No, and..." (partial failure): Setback that can still be overcome or introduces new opportunity
-- These prevent story from feeling completely stuck
-
-**Character Development Through Failure**:
-- Shows character's makeup and values
-- Explores how character reacts to setback
-- More realistic than constant success
-- Creates empathy when readers see character struggle
-
-**Placement in Structure**:
-- Most occur in Act II
-- Escalate through story
-- Lead to climactic final attempt (Act III)
-- Number varies (minimum 3 for complexity)
-
-**Audit Implication**: Check protagonist faces obstacles and failures (not constant success). Verify try-fail cycles show escalation. Detect at least 3 cycles in Act II. Check failures have consequences and change character understanding.
-
----
-
-## 5. COMMON WRITING MISTAKES TO DETECT
-
-### 5.1 Head-Hopping (See Section 3.2)
-
----
-
-### 5.2 Telling Emotions Instead of Showing
-
-**Problem**: Stating emotion directly ("he was angry," "she felt sad") rather than showing through action, thought, and physical reaction.
-
-**Why It Fails**:
-- Tells reader what to think instead of letting them experience
-- Creates distance between reader and character
-- Less emotionally impactful
-- Often devolves to cliché descriptions
-
-**Showing Techniques**:
-- **Physical reactions**: Tense shoulders, clenched jaw, tears, trembling, shallow breathing
-- **Actions**: Slamming doors, pacing, abandoning tasks
-- **Thoughts**: Character's internal dialogue revealing emotional state
-- **Word choice**: Specific vocabulary revealing emotion
-- **Dialogue**: What character says (or doesn't say) and how they say it
-- **Non-verbal**: Body language, positioning, micro-expressions
-
-**Specific by Emotion**:
-- **Anger**: Clenched fists, tight jaw, sharp breathing, cutting words, aggressive movement
-- **Fear**: Racing heartbeat, dry mouth, hunched posture, hesitation, avoiding eye contact
-- **Sadness**: Heaviness, stillness, quiet voice, hollow feeling, listless movement
-- **Joy**: Quickened pace, brightened voice, expansive movement, relaxed posture
-
-**Avoiding Cliché**:
-- Be specific: not just "tears" but "one tear tracked down her cheek"
-- Find unique expressions of emotion for character
-- Show emotion through what character does, not how they feel
-
-**When Telling Is Acceptable**: Rarely. Sometimes after major emotional climax, a moment of direct statement can work for emphasis. Must be exception, not rule.
-
-**Audit Implication**: Flag direct emotion statements ("he was angry," "she felt betrayed"). Verify emotional scenes show through action and reaction. Detect over-reliance on emotion description rather than cause.
-
----
-
-### 5.3 Info Dumps and "As You Know, Bob" Dialogue
-
-**Definition**: Large amounts of exposition delivered at once, often through dialogue where characters discuss things they already know.
-
-**"As You Know, Bob" Pattern**:
-- Two characters discuss information both already know
-- Unrealistic conversation created for exposition
-- Feels artificially constructed
-- Pulls reader out of story
-
-**Why It Fails**:
-- Unnatural dialogue patterns
-- Reader recognizes information is for them, not character-to-character
-- Breaks immersion
-- Characters wouldn't have this conversation in reality
-
-**How It Manifests**:
-- Dialogue starting with "As you know..."
-- Lengthy explanations of world, history, or backstory in character conversation
-- Questions asking for information character already knows answer to
-- Conversations about things protagonist already understands
-
-**Solutions**:
-
-**Weave Into Narration**:
-- Sprinkle exposition throughout narrative
-- Reveal information when relevant to immediate story
-- Integrate with character action and reaction
-
-**Drip Information Gradually**:
-- Don't dump all backstory at once
-- Reveal only what reader needs to know at that moment
-- Trust reader to accept mysteries until explanations arrive
-
-**Motivation for Dialogue**:
-- Characters discuss things when there's real reason to—conflict, disagreement, new information
-- Dialogue should reveal character, not just information
-- Information should be secondary purpose
-
-**Use Conflict**:
-- Characters discuss things when stakes exist
-- Disagreement about information creates tension
-- Dialogue serves plot, not just exposition
-
-**Audit Implication**: Flag long exposition blocks in dialogue. Detect "As you know, Bob" patterns. Verify dialogue reveals character conflict/stakes, not just information. Check information distributed throughout narrative rather than front-loaded.
-
----
-
-### 5.4 Deus Ex Machina
-
-**Definition**: Convenient, unlikely solution appearing from nowhere to save protagonist from apparently hopeless situation. Originally from theater tradition of literal god brought on stage via crane.
-
-**Why It Fails**:
-- Protagonist didn't earn solution through their skill, wit, sacrifice, or growth
-- Feels like lazy writing—author wrote themselves into corner
-- Undermines all preceding tension
-- Feels cheap and unsatisfying to reader
-- Breaks reader trust in narrative logic
-
-**Examples of Deus Ex Machina**:
-- Unexpected rescue with no foreshadowing
-- Sudden plot device solving all problems
-- Character revelation that conveniently solves situation
-- External force intervening without setup
-
-**Avoiding It**:
-- Plant clues early (Chekhov's Gun principle): if gun goes off in Act 3, introduce in Act 1
-- Let characters earn survival through skill, wit, sacrifice, or growth
-- Build in foreshadowing and setup for solutions
-- If you find yourself conjuring deus ex machina: write to end, then go back to find where story went off course
-
-**Distinction from Plot Twist**: 
-- Plot twist is foreshadowed, even if reader doesn't see it coming
-- Deus ex machina feels unearned and arbitrary
-- Good twist makes reader think "I didn't see that coming, but it makes sense"
-- Deus ex machina makes reader think "that came from nowhere"
-
-**Audit Implication**: Flag unearned solutions to problems. Detect major plot problems solved without character action. Verify setup and foreshadowing for major revelations.
-
----
-
-### 5.5 Mary Sue / Gary Stu Characters
-
-**Definition**: Unrealistically flawless character who is center of attention, excels at everything with little training, is adored by everyone, and either lacks flaws or has superficial ones ("too kind," "too beautiful").
-
-**Red Flags**:
-- Excels at everything without training or struggle
-- Adored by nearly all characters
-- Never faces real consequences for mistakes
-- Can get past conflict easily due to intelligence or power
-- Purpose unclear or changes frequently
-- Other characters exist only to admire them
-- Reader doesn't understand why they matter to story
-- No genuine vulnerability or struggle
-
-**Why They Weaken Stories**:
-- Low stakes (they can't lose meaningfully)
-- No growth (already perfect)
-- Overshadow other characters
-- Reader doesn't connect (no struggle to empathize with)
-- Defies logic (breaks story believability)
-
-**Avoiding Mary Sue**:
-- **Personal conflict**: Character's goal conflicts with primary objective at some point, forcing sacrifice
-- **Real obstacles**: Character faces obstacles requiring effort to overcome
-- **Failure**: Character should stumble and fail multiple times
-- **Growth**: Character must change and grow (proves they weren't perfect)
-- **Genuine flaws**: Flaws that create real conflict and cost
-- **Vulnerability**: Show genuine moments of weakness or fear
-- **Complex relationships**: Not all characters adore protagonist; some dislike them
-
-**Nuance**: Competent, capable protagonists aren't automatically Mary Sues. Difference is whether character faces struggle, has genuine flaws, experiences failure, and grows.
-
-**Audit Implication**: Check protagonist has genuine vulnerabilities and flaws. Detect excessive competence without struggle. Flag characters who never fail or face consequences. Verify protagonist changes through story.
-
----
-
-### 5.6 Plot Armor (Related to 5.4 Deus Ex Machina)
-
-**Definition**: Character cannot die, be seriously injured, or face serious consequences because of importance to story. Shield protecting from narrative logic.
-
-**Why It's Problematic**:
-- Stakes feel low (readers know character can't be harmed)
-- Tension deflates
-- Other characters' sacrifices feel meaningless
-- Breaks story logic and believability
-
-**How It Manifests**:
-- Character in mortal danger but consistently escapes unscathed
-- Injuries that should be serious are quickly resolved
-- Character faces consequences others face for same actions
-- Death of major character seems unlikely despite genuine peril
-
-**Distinction from Survivorship**:
-- Skilled character surviving through competence: not plot armor
-- Character taking injuries and suffering consequences: not plot armor
-- Character facing death and losing: not plot armor
-- Character protected from logic of story: plot armor
-
-**Fixing It**:
-- Let character be harmed (physically or emotionally)
-- Show consequences of character's choices
-- Allow failure to affect character
-- Make stakes feel real by showing real risk
-
-**Audit Implication**: Check protagonist faces genuine consequences. Detect unexplained survival of serious injuries. Verify stakes feel real (character could lose). Flag protection from story logic.
-
----
-
-### 5.7 Talking Heads (See Section 2.4)
-
----
-
-### 5.8 White Room Syndrome (See Section 2.2)
-
----
-
-### 5.9 Protagonist Lacking Agency (See Section 3.3)
-
----
-
-## 6. DIALOGUE CRAFT
-
-### 6.1 Natural and Realistic Dialogue
-
-**Core Principle**: Dialogue is heartbeat of fiction, breathing life into characters and driving narrative forward.
-
-**Observational Techniques**:
-- Listen to real conversations
-- Note quirks, filler words, rhythms
-- Observe how people talk in different contexts
-- Notice ebb and flow, interjections, interruptions, unfinished sentences
-- Pay attention to regional differences, age-based speech, education markers
-
-**Building Character Voice**:
-- Understand character's personality, education, background, age
-- Vocabulary reveals education level ("gonna" vs. "going to"; "ain't" vs. "isn't")
-- Word choice reflects region
-- Slang and dialect reveal group membership
-- Speech patterns reflect mental state
-
-**Testing Dialogue**:
-- Read aloud to check natural flow
-- Hearing words helps identify awkward phrasing, unnatural rhythm
-- Reveals inconsistencies in character voice
-- Easier to spot overused phrases when heard
-
-**Purpose and Function**:
-- Dialogue must do work: reveal character, convey information, show plot happening
-- Each conversation should reveal something about characters or advance plot
-- Dialogue shouldn't exist just to move exposition
-
-**Avoiding Common Errors**:
-- Don't have all characters sound like author
-- Don't give every character complex speech patterns (some characters speak simply)
-- Don't use dialogue for information that's better in narration
-- Don't write how people actually talk (ums, ahs, false starts) constantly—suggest it, don't replicate it
-
-**Audit Implication**: Check dialogue sounds natural when read aloud. Verify character voices are distinct. Detect all characters sounding similar. Check dialogue serves plot/character purpose.
-
----
-
-### 6.2 Subtext in Dialogue
-
-**Definition**: The conflict between what's said aloud versus what character is thinking, feeling, wanting, or hiding.
-
-**Importance**: Strong dialogue is supported by subtext; surface meaning differs from underlying truth.
-
-**Creating Subtext**:
-- **Evasion**: Character says one thing while implying another
-- **Contradiction**: Actions/thoughts contradict dialogue
-- **Hesitation**: Pauses, fragments, avoiding direct answer
-- **Coded language**: Saying something innocuous while meaning something else
-- **Disagreement between words and emotion**: Saying positive things with angry tone
-
-**Mismatch Between Dialogue and Action/Thought**:
-- Character says "I'm fine" while shaking
-- Character claims happiness while hunched and quiet
-- Character agrees while jaw clenches
-- Character swears they don't care while eyes betray them
-
-**Achieving Subtext**:
-- Don't state hidden emotion directly
-- Show through nonverbal cues
-- Use action beats to reveal what words hide
-- Let readers infer underlying truth
-- Create gap between surface and depth
-
-**Example**:
-- Surface dialogue: "That's wonderful. I'm happy for you."
-- Subtext shown through: Flat tone, looking away, fingers clenching, hesitation before response
-
-**Audit Implication**: Check dialogue has underlying meaning beyond surface words. Verify subtext shown through action beats and tone, not stated. Detect flat dialogue without hidden layers.
-
----
-
-### 6.3 Dialogue as Conflict
-
-**Principle**: Dialogue can be most vigorous interaction of which characters are capable.
-
-**Creating Conflict in Dialogue**:
-- Characters disagree about goals, values, understanding
-- Conversation itself is battleground
-- Characters try to persuade, convince, defend, attack
-- Stakes exist in the conversation itself
-
-**Types of Dialogue Conflict**:
-- **Direct conflict**: Characters disagree openly
-- **Passive resistance**: Character refuses to engage or cooperates minimally
-- **Misunderstanding**: Characters talk past each other
-- **Hidden agenda**: Character has unstated goal in conversation
-- **Power struggle**: Characters compete for control of interaction
-- **Emotional conflict**: Unresolved feelings create tension in surface conversation
-
-**Avoiding Flat Dialogue**:
-- Characters must want something from the conversation
-- Opposition creates tension
-- Stakes must exist (social, emotional, plot-based)
-- Dialogue shouldn't be simple exchange of information
-- Characters should push back against each other
-
-**Balancing Information and Conflict**:
-- Provide necessary exposition through conflict, not simple explanation
-- Characters reveal information while pursuing goals
-- Information comes out through disagreement or evasion
-
-**Audit Implication**: Check dialogue scenes have conflict (not just information exchange). Verify characters want something from conversation. Detect flat exchanges lacking tension. Flag scenes where characters cooperate too easily.
-
----
-
-### 6.4 Action Beats vs. Dialogue Tags
-
-**Understanding the Difference**:
-
-**Dialogue Tags**:
-- "he said," "she asked," "they replied"
-- Identify speaker
-- Most effective when invisible
-
-**Action Beats**:
-- Character performs action while speaking
-- Shows how something is said through action
-- Reveals character, emotion, physicality
-- Breaks up dialogue blocks visually
-
-**Why Action Beats Work Better Than Fancy Tags**:
-- Fancy tags draw attention ("she exclaimed," "he declared")
-- Action beats show rather than tell emotion
-- Create visual variety
-- Ground dialogue in physical reality
-- Show character behavior revealing inner state
-
-**Examples**:
-- Tag: "I hate this," she said angrily.
-- Action beat: "I hate this." She slammed the door.
-
-- Tag: "Where are you going?" he asked nervously.
-- Action beat: "Where are you going?" He fumbled for his keys, missing twice before getting them right.
-
-**Rules for Action Beats**:
-- Use varied verbs (not just "she did X")
-- Action should reflect emotional state and character
-- Action can show setting detail
-- Don't use action beats artificially
-- Use enough to break up dialogue; not so much it bogs down pacing
-
-**Audit Implication**: Check dialogue uses "said/asked" rather than fancy tags. Detect long stretches of dialogue without action beats. Verify action beats use varied verbs and reveal character.
-
----
-
-## 7. SPECIALIZED TOPICS
-
-### 7.1 Serial Fiction (Web Novels, Web Serials) - Additional Considerations
-
-**Episodic Structure**:
-- Thrive in serialized markets
-- Cliffhangers every 1,500–2,000 words standard
-- Word count consistency important (readers expect similar episode lengths)
-- Each installment has mini-arc while contributing to larger narrative
-
-**Reader Retention Principles**:
-- Episode-level resolution crucial (readers return when feeling rewarded, not stalled)
-- Cliffhangers effective but not always dramatic
-- Can be emotional cliffhangers (investing in character struggle)
-- Unresolved questions keep readers curious
-- Physical peril, plot twists, personal decisions all work as cliffhangers
-
-**Planning and Structure**:
-- Some form of outline necessary for multi-episode stories
-- Working with multiple storylines stretched over episodes requires game plan
-- Each installment should resolve something while opening new questions
-- Pacing differs from completed novel (slower burn acceptable in serial)
-
-**Reader Experience**:
-- Readers develop habit of checking for new chapters
-- Consistent publication schedule matters
-- They remember details across gaps between episodes
-- Emotional investment builds over time
-
-**Audit Implication**: For serial fiction, verify episodic structure provides mini-arcs. Check cliffhangers appear at natural breaking points. Verify word counts consistent. Detect reader retention mechanisms (unresolved questions, stakes).
-
----
-
-### 7.2 Stephen King's "On Writing" - Core Principles Summary
-
-**Writing is Telepathy**: Good writing allows reader to see what writer sees.
-
-**Story-First Approach**: Begin with story, progress to theme. Never begin with theme and progress to story.
-
-**Show Don't Tell**: Cardinal rule—never tell if you can show.
-
-**Character Development**:
-- Best stories are character-driven (about people, not events)
-- Comes from: paying attention to real people's behavior and telling truth about what you see
-
-**Dialogue Craft**:
-- Dialogue tells if character is smart/dumb, honest/dishonest, funny/serious
-- Best learned by listening to people (accents, rhythms, dialect, slang)
-
-**Word Choice and Weight**:
-- Words have weight
-- Words create sentences; sentences create paragraphs
-- Sometimes paragraphs quicken and breathe
-
-**Essential Practice**:
-- Write a lot
-- Read a lot (reading is creative center of writer's life)
-- Set daily goal: 1,000 words minimum until goal met, door stays shut
-- Take one day off per week maximum
-
-**Write What You Know and Like**:
-- Bring unique truths into story
-- Make your writing unique through authentic perspective
-
-**Audit Implication**: Verify stories character-driven. Check word choice is strong (not padded with adverbs). Detect show-tell violations. Verify dialogue reveals character effectively.
-
----
-
-### 7.3 Brandon Sanderson's Writing Lectures - Key Principles
-
-**Writing Philosophy**:
-- "The product of your writing time is YOU" (not the novel—the person you become through writing, empathy you develop, voice you discover)
-
-**Chef vs. Cook Mentality**:
-- Cook follows recipe
-- Chef understands art, tools, ingredients, how they interact; experiments and learns
-
-**Key Learning**:
-- You'll learn more from writing your first book than from any class
-- Explore, try, revise to figure out what works
-- Distinguish good writing advice from bad through practice
-
-**Content Areas**: Plot, setting, character, worldbuilding, viewpoint, magic systems, climax satisfaction
-
-**Magic Systems**: Directly proportional to satisfying climax (more defined magic = easier to provide satisfying climax)
-
-**Promise, Progress, Payoff Structure**: (See Section 4.2)
-
-**Audit Implication**: Check story structure follows promise-progress-payoff. Verify magic systems (if fantasy) defined clearly. Check climax satisfies setup.
-
----
-
-### 7.4 Writing Excuses Podcast - Key Lessons
-
-**Podcast Format**: Fast-paced, educational, addressing common writing obstacles.
-
-**Hosts**: Rotating panel including Mary Robinette Kowal, Dan Wells, Brandon Sanderson (early seasons), DongWon Song, Erin Roberts.
-
-**Major Topics**:
-- Plot-driven vs. character-driven fiction
-- Both require conflict, tension
-- Best result when internal moments (character) and external moments (plot) align
-
-**Character Development Tools**:
-- Kowal Relationship Axes: building believable, messy character dynamics
-- Practical tools for realistic relationships with momentum
-
-**Short Story Craft**:
-- Start with concept and character
-- Give them desire
-- Systematically deny it to them
-- Creates satisfying short arc
-
-**Comprehensive Coverage**: Worldbuilding, voice, plot twists, pacing, editing, queries, brainstorming, publishing (traditional vs. self), killing darlings, much more.
-
-**Audit Implication**: Check character relationships have complexity and conflict. Verify character desires clearly established. Detect systematic obstacles preventing easy satisfaction of goals.
-
----
-
-### 7.5 Mythcreants Writing Craft Guides
-
-**Overview**: Comprehensive, accessible craft advice for fantasy and sci-fi storytelling.
-
-**Philosophy**:
-- Storytelling has learnable basic principles built on human psychology
-- Story construction is learnable and teachable
-- Most advice applies beyond speculative fiction
-- Emphasis on practical principles
-
-**Building Writing Skills**:
-- Write short stories for rapid iteration
-- Build craft through various exercises
-- Direct instruction valuable but self-guided learning also effective
-
-**Coverage**: Worldbuilding, plot structure, avoiding oppressive tropes, character development, dialogue, pacing, tension.
-
-**Audit Implication**: Apply practical principles from community-vetted craft sources. Check story avoids problematic tropes. Verify worldbuilding serves story needs.
-
----
-
-### 7.6 Robert McKee's "Story" - Narrative Principles
-
-**Scope**: Intended for screenwriters but applies to any storytelling (novel writing included).
-
-**Core Principles**:
-- Story about archetypes (universal experiences), not stereotypes
-- Thoroughness over shortcuts
-- Precision in expression
-
-**Plot Approach**: Dynamic plotting with conflict and resolution driving story forward. Weave plots with character arcs for rich narrative.
-
-**Plot Types**: Archplot (classical three-act), miniplot, antiplot.
-
-**Character Requirements**:
-- Protagonist has conscious desire (and often contradictory unconscious desire)
-- Must have capacity to pursue desire
-- Must have at least one chance to attain desire
-- Must be empathetic (and may or may not be sympathetic)
-
-**Theme**:
-- Central theme underlying narrative
-- Controlling Idea: answer to "What value is brought into protagonist's world through climactic action?" and "What is chief cause/force by which this value is brought?"
-- Every scene and character arc should echo theme
-
-**Audit Implication**: Verify protagonist has clear desire (conscious at minimum). Check character capacity to pursue goal. Verify theme resonates throughout. Detect Controlling Idea driving climactic action.
-
----
-
-### 7.7 Emotional Craft and Showing vs. Telling Emotion
-
-**Advanced Principle**: Best writing triggers emotion in reader, not just describes character emotion.
-
-**Two Modes**:
-- **Outer mode**: Character's physical/behavioral response (protagonist tenses, eyes widen)
-- **Reader mode**: What these descriptions provoke in reader (reader feels tension/fear)
-
-**Goals of Emotional Writing**:
-- Not just to describe what character feels
-- But to incite that emotion in reader
-- Reader experiences what character experiences
-
-**Avoiding Emotional Clichés**:
-- Common ways of showing emotion become meaningless through overuse
-- Be specific in word choice and body language
-- Find character-specific expressions of emotion
-- Show emotion through unique personal reactions
-
-**Advanced Techniques**:
-- Show emotion through thought patterns (not just bodily sensation)
-- Use physical sensation accurately (fear doesn't always cause trembling; sometimes freezes)
-- Show emotion through what character does/doesn't do
-- Context and environment shape emotional expression
-
-**Controlled vs. Explosive**:
-- Both can be effective
-- Controlled emotion through restraint often feels heavier
-- Explosive emotion needs foundation to land
-
-**Audit Implication**: Check emotional scenes trigger reader emotion, not just describe character feeling. Detect clichéd emotional descriptions. Verify specificity in physical/behavioral response. Flag over-explanation of emotion.
-
----
-
-## SUMMARY OF KEY AUDIT DIMENSIONS
-
-Based on this research, the following dimensions should be prioritized for quality auditing of English fiction:
-
-### **CRITICAL DIMENSIONS** (Foundation):
-1. Show vs. Tell effectiveness
-2. POV consistency and head-hopping detection
-3. Character agency and motivation clarity
-4. Plot structure (three-act, try-fail cycles, escalation)
-5. Dialogue purpose and character voice distinctiveness
-6. Tension and pacing management
-
-### **HIGH-PRIORITY DIMENSIONS**:
-7. Prose clarity (avoiding purple prose, filter words)
-8. Sentence-level rhythm and variation
-9. Scene structure (goal-conflict-disaster-reaction)
-10. Dialogue tags vs. action beats
-11. Emotional scene effectiveness
-12. Foreshadowing setup and payoff
-
-### **IMPORTANT DIMENSIONS**:
-13. Adverb usage patterns
-14. Action scene clarity
-15. White room syndrome and setting grounding
-16. Common mistakes (deus ex machina, plot armor, Mary Sue, talking heads)
-17. Subtext in dialogue
-18. Character consistency in voice
-
-### **SPECIALIZED DIMENSIONS** (For Serial Fiction):
-19. Episodic structure and cliffhangers
-20. Promise-progress-payoff at episode level
-21. Reader retention mechanics
-
----
-
-## SOURCES
-
-The following sources were referenced in this research:
-
-### **Show Don't Tell**
-- [Stephen King - On Writing Quote Analysis](https://www.themarginalian.org/2013/03/13/stephen-king-on-adverbs/)
-- [Show vs Tell in Writing](https://www.thefishypen.com/show-vs-tell-in-writing-when-to-do-both-for-better-storytelling/)
-- [Show Don't Tell Lessons](https://polishingyourprose.wordpress.com/2014/12/04/show-dont-tell-a-writing-lesson-from-stephen-king/)
-
-### **Active/Passive Voice**
-- [Active vs Passive Voice in Fiction](https://www.writeacademy.com/blog/active-vs-passive-voice/)
-- [Passive Voice in Fiction Writing](https://fictionary.co/journal/passive-voice-in-fiction-writing-should-you-use-it/)
-- [Passive Voice Examples](https://mythcreants.com/blog/what-fiction-writers-should-know-about-passive-voice/)
-- [When to Use Passive Voice in Fiction](https://wintersediting.com/passive-voice-fiction/)
-
-### **Adverbs and Dialogue Tags**
-- [Stephen King on Adverbs](https://www.themarginalian.org/2013/03/13/stephen-king-on-adverbs/)
-- [Self-Editing for Fiction Writers](https://prowritingaid.com/self-editing-for-fiction-writers)
-- [Dialogue Tags](https://nathanbransford.com/blog/2020/05/everything-authors-need-to-know-about-dialogue-tags/)
-- [Stephen King's No Adverbs Rule](https://jareddees.com/no-adverbs/)
-
-### **Filter Words**
-- [Filter Words List and Alternatives](https://kathysteinemann.com/Musings/why-you-should-avoid-feel-in-your-writing/)
-- [Filtering in Writing](https://specficwriters.com/filter-words/)
-- [Filter Word Avoidance](https://www.scribophile.com/academy/an-introduction-to-filtering/)
-- [Filter Words Guide](https://www.tckpublishing.com/filter-words/)
-
-### **Purple Prose**
-- [Purple Prose Detection](https://writershelpingwriters.net/2025/07/writing-101-avoiding-purple-prose/)
-- [What is Purple Prose](https://www.nownovel.com/blog/purple-prose-how-to-avoid/)
-- [Purple Prose Guide](https://www.septembercfawkes.com/2018/03/purple-prose-what-it-is-how-it-works.html)
-- [Identifying and Fixing Purple Prose](https://reedsy.com/blog/purple-prose/)
-
-### **Sentence Rhythm**
-- [Sentence Variety and Rhythm](https://www.kristencorrects.com/how-to-vary-your-sentences-to-create-rhythmic-writing/)
-- [Rhythmic Writing Guide](https://writershelpingwriters.net/2022/04/what-is-rhythmic-writing/)
-- [Sentence Structure Variation](https://horrortree.com/how-can-writers-vary-sentence-structure/)
-
-### **Scene Structure**
-- [Scene Structure: Goal-Conflict-Disaster](https://www.helpingwritersbecomeauthors.com/scene-structure/)
-- [Scene and Sequel Structure](https://www.advancedfictionwriting.com/articles/writing-the-perfect-scene/)
-- [Dwight V. Swain Scene Structure](https://www.septembercfawkes.com/2021/09/scene-structure-according-to-dwight-v.html/)
-
-### **Action Scene Pacing**
-- [Explode Your Action Scenes](https://specficwriters.com/explode-your-action-scenes-goals-pacing-clarity-and-character/)
-- [Pacing Fight Scenes](https://www.writersdigest.com/write-better-fiction/pacing-your-fight-scene-fightwrite)
-- [Action Scene Writing](https://www.edelmanedits.com/post/how-to-write-action-scenes)
-- [Action Scene Tips](https://thewritepractice.com/write-action-scenes/)
-
-### **Dialogue Scene Construction**
-- [Story Beats in Scenes](https://www.novelcrafter.com/blog/writing-with-story-beats)
-- [Using Beats in Dialogue](https://www.writersdigest.com/write-better-fiction/using-beats-to-improve-dialogue-and-action-in-scenes)
-- [Dialogue and Action Beats](https://www.cameronmontaguetaylor.com/2022/03/18/tips-for-writing-action-scenes/)
-
-### **Fight Scenes**
-- [Crafting Fight Scenes](https://writersinthestormblog.com/2025/08/writing-and-weapons-the-art-of-crafting-accurate-fight-scenes/)
-- [Writing Fight Scenes Guide](https://www.writingmastery.com/blog/how-to-write-a-good-fight-scene-tips-for-crafting-action-in-your-story)
-- [Fight Scene Basics](https://descriptionary.wordpress.com/2023/10/16/describe-it-writing-fight-scenes-the-basics/)
-
-### **Quiet Emotional Scenes**
-- [Writing the Quiet Moment](https://famouswritingroutines.com/writing-tips/writing-the-quiet-moment-how-to-make-stillness-feel-electric/)
-- [Emotional Scenes and Stillness](https://authorspathway.com/types-of-writing/fiction/the-art-of-the-quiet-scene-how-stillness-creates-powerful-fiction/)
-- [Writing Emotional Scenes](https://www.livewritethrive.com/2024/11/27/how-to-turn-good-dialogue-into-great-dialogue/)
-
-### **Deep POV and Character Voice**
-- [Deep POV Character Voice](https://erinfulmer.com/2021/07/26/write-deep-pov-voice-and-emotion/)
-- [First Person Deep POV](https://lisahallwilson.com/examples-of-first-person-deep-pov/)
-- [Mastering Deep POV](https://thewritepractice.com/deep-pov/)
-- [The Intersection of Voice and Deep POV](https://www.livewritethrive.com/2023/01/09/the-intersection-of-voice-and-deep-pov/)
-
-### **Head-Hopping**
-- [What is Head-Hopping](https://www.alyssamatesic.com/free-writing-resources/head-hopping)
-- [Head-Hopping: Avoiding This Mistake](https://www.scribophile.com/academy/what-is-head-hopping)
-- [Head-Hopping Detection and Fixes](https://www.helpingwritersbecomeauthors.com/common-writing-mistakes-goody-goody-characters-2/)
-- [Official Rules on Head-Hopping](https://www.advancedfictionwriting.com/blog/2014/04/30/head-hopping-fiction-writing/)
-
-### **Character Motivation and Agency**
-- [Character Agency in Fiction](https://ruffdraft.pub/editing/the-ulti-mutt-guide-on-character-agency-and-motivation-in-writing-fiction/)
-- [How to Fix a Passive Protagonist](https://racheljrowlands.com/2023/04/13/how-to-fix-a-passive-protagonist/)
-- [Making Protagonists Proactive](https://jamigold.com/2020/01/how-can-we-make-our-protagonist-more-proactive/)
-
-### **Three-Act Structure**
-- [Three-Act Structure Guide](https://reedsy.com/blog/guide/story-structure/three-act-structure/)
-- [Three-Act Structure Overview](https://www.scribophile.com/academy/what-is-the-three-act-structure)
-- [How to Write Three Act Structure](https://www.masterclass.com/articles/how-to-write-three-act-structure)
-
-### **Foreshadowing**
-- [How to Use Foreshadowing](https://www.masterclass.com/articles/how-to-use-foreshadowing-in-your-writing)
-- [Foreshadowing Laws](https://nownovel.com/8-laws-foreshadowing/)
-- [Types of Foreshadowing](https://firstmanuscript.com/types-of-foreshadowing-with-examples/)
-
-### **Try-Fail Cycles**
-- [Try/Fail Cycle Guide](https://www.septembercfawkes.com/2025/12/writing-try-fail-cycles-strengths-vs-weaknesses.html)
-- [Being a Better Writer: Try/Fail Cycles](https://maxonwriting.com/2015/06/15/being-a-better-writer-the-tryfail-cycle-and-the-evolving-story/)
-- [Try-Fail Cycles and Plot Twists](https://goteenwriters.com/2013/07/30/try-fail-cycles-the-yes-but-or-no-and-method-to-creating-plot-twists/)
-
-### **Info Dumps and "As You Know Bob"**
-- [As You Know Bob Trope](https://www.helenhawkins-author.com/as-you-know-bob-how-to-spot-and-avoid-info-dumps-and-exposition/)
-- [Avoiding As You Know Bob](https://www.helpingwritersbecomeauthors.com/as-you-know-bob/)
-- [Identifying Info Dumps](https://authorkristenlamb.com/2013/12/do-you-have-as-you-know-bob-syndrome-how-writers-can-butcher-dialogue-how-to-fix-it/)
-
-### **Mary Sue/Gary Stu**
-- [Mary Sue Detection](https://www.scribophile.com/academy/what-is-a-mary-sue-character)
-- [Avoiding Mary Sue Characters](https://barelyharebooks.com/how-to-avoid-writing-a-mary-sue-character/)
-- [Mary Sue and Gary Stu](https://blog.jotterpad.app/how-to-avoid-writing-a-mary-sue-character/)
-
-### **Deus Ex Machina**
-- [Dodging Deus Ex Machina](https://www.autocrit.com/dodging-deus-ex-machina/)
-- [Plot Armor and Deus Ex Machina](https://www.inkdroplit.com/blog/2019/5/1/is-your-protagonist-wearing-too-much-plot-armor)
-- [What is Deus Ex Machina](https://theintuitivedesk.com/what-is-deus-ex-machina-and-why-we-should-try-to-avoid-it-in-our-writing/)
-
-### **White Room Syndrome and Talking Heads**
-- [Avoiding White Room Syndrome](https://www.writingmastery.com/blog/avoiding-white-room-syndrome-tips-to-ground-your-fiction-effectively)
-- [What is White Room Syndrome](https://thelittlebookish.com/blogs/news/white-room-syndrome)
-- [Dialogue Talking Heads Problem](https://www.helpingwritersbecomeauthors.com/are-your-characters-talking-heads/)
-
-### **Dialogue Craft**
-- [Writing Natural Dialogue](https://www.masterclass.com/articles/how-to-write-realistic-dialogue)
-- [Realistic Dialogue Tips](https://spines.com/10-tips-for-writing-realistic-dialogue-in-fiction/)
-- [Natural Dialogue Guide](https://www.well-storied.com/blog/write-better-dialogue)
-
-### **Dialogue Subtext and Conflict**
-- [Writing Dialogue with Subtext](https://www.skillshare.com/en/classes/writing-dialogue-mastering-conflict-actions-and-subtext/855225348)
-- [Conflict in Dialogue](https://www.craftliterary.com/2017/09/15/conflict-in-dialogue/)
-- [Mastering Dialogue Conflict](https://www.livewritethrive.com/2023/11/13/show-meaningful-character-action-in-dialogue-scenes/)
-
-### **Said-Bookism**
-- [Said Bookism Overview](https://tvtropes.org/pmwiki/pmwiki.php/Main/SaidBookism)
-- [Why Adverbs and Fancy Tags Are Bad](https://jpaulroe.com/why-adverbs-and-fancy-dialogue-tags-are-bad/)
-- [Said-Bookisms Explained](https://ladyknightediting.com/said-bookism/)
-
-### **Climax Writing**
-- [How to Write a Compelling Climax](https://fictionary.co/journal/how-to-write-a-compelling-climax-for-a-story/)
-- [Climax Tips](https://writershelpingwriters.net/2023/11/tips-for-writing-a-successful-story-climax/)
-- [Building to the Climax](https://thewritepractice.com/climax-build/)
-
-### **Tension and Pacing**
-- [Tension in Suspenseful Fiction](https://medium.com/the-writers-reach/tension-in-suspenseful-fiction-3ef2f8269283)
-- [David Baldacci on Pacing and Tension](https://www.masterclass.com/articles/david-baldaccis-writing-tips-for-pacing-tension-and-suspense)
-- [How to Build Tension](https://jerryjenkins.com/build-tension/)
-
-### **Paragraph Structure and Pacing**
-- [Pacing and Spacing](https://killzoneblog.com/2019/02/pacing-and-spacing-the-power-of-artful-paragraphing/)
-- [How to Structure Paragraphs](https://sandragerth.com/structure-paragraphs/)
-- [Paragraph Breaks for Pacing](https://www.helpingwritersbecomeauthors.com/how-to-use-paragraph-breaks-guide-the-readers-experience/)
-
-### **Promise, Progress, Payoff**
-- [Promise, Progress, Payoff Explained](https://www.septembercfawkes.com/2024/10/promise-progress-payoff-in-stories-acts.html)
-- [Promise and Payoff in Stories](https://www.worldbuilders.ai/p/promises-payoffs)
-- [Brandon Sanderson's Promise, Progress, Payoff](https://www.brandonsanderson.com/blogs/blog/brandon-sandersons-2025-guide-to-plot-lecture-2)
-
-### **Emotional Beats**
-- [Beats and Emotional Development](https://threepennyeditor.com/library/2016/10/beats)
-- [Building Scenes with Beats](https://www.livewritethrive.com/2025/04/26/33309/)
-- [Story Beats Explained](https://www.novelcrafter.com/blog/writing-with-story-beats)
-
-### **Web Serial Fiction**
-- [Serial Fiction Success](https://indieauthormagazine.com/the-intentional-craft-of-successful-serialized-fiction/)
-- [Writing Serial Fiction Guide](https://creativewritinghaven.wordpress.com/2025/04/09/writing-serial-fiction/)
-- [Why Episodic Stories Retain Readers](https://info.reamstories.com/post/why-some-episodic-stories-retain-readers-better-than-others)
-
-### **Brandon Sanderson Lectures**
-- [Philosophy of Professional Writing](https://www.brandonsanderson.com/blogs/blog/brandon-sandersons-writing-class-2025-week-1)
-- [Writing Advice](https://www.brandonsanderson.com/pages/writing-advice)
-- [Story Structure Overview](https://www.brandonsanderson.com/blogs/blog/brandon-sandersons-2025-overview-of-story-structure-lecture-3)
-
-### **Writing Excuses Podcast**
-- [Writing Excuses Website](https://writingexcuses.com/)
-- [Plot-Driven vs Character-Driven Fiction](https://writingexcuses.com/writing-excuses-season-3-episode-20-plot-vs-character-driven-fiction/)
-
-### **Stephen King's On Writing**
-- [On Writing Notes](https://www.ricklindquist.com/notes/notes-and-takeaways-from-on-writing)
-- [Key Lessons from On Writing](https://www.novlr.org/the-reading-room/breaking-down-the-key-lessons-of-stephen-kings-on-writing)
-- [On Writing Summary](https://www.shortform.com/summary/on-writing-summary-stephen-king)
-
-### **Robert McKee's Story**
-- [Story Summary](https://www.supersummary.com/story/summary/)
-- [McKee Story Principles](https://www.shortform.com/summary/story-summary-robert-mckee)
-- [Story Book Summary](https://growthabit.com/story-book-summary-review-notes/)
-
-### **Mythcreants**
-- [Mythcreants Website](https://mythcreants.com/)
-- [Five Books on Writing Fantasy](https://mythcreants.com/blog/five-books-on-writing-fantasy-compared/)
-- [Recognizing Good Storytelling Advice](https://mythcreants.com/blog/recognizing-bad-and-good-storytelling-advice/)
-
-### **Showing vs. Telling Emotion**
-- [Donald Maass and Emotional Craft](https://litreactor.com/columns/donald-mass-and-the-emotional-craft-of-fiction-writing)
-- [The Emotional Craft of Fiction](https://www.livewritethrive.com/2015/06/24/how-fiction-writers-can-show-emotions-in-their-characters-in-effective-ways/)
-- [How to Write Emotion](https://www.masterclass.com/articles/how-to-write-emotion)
-
----
-
-**END OF REPORT**
-
-This comprehensive research identifies the core professional craft rules used to evaluate English fiction quality, with specific, auditable definitions and examples. The findings can directly inform development of quality audit dimensions for automated novel-writing systems targeting genre fiction markets.

+ 0 - 969
docs/raw-genre-profiles.md

@@ -1,969 +0,0 @@
-Perfect. I now have comprehensive research across all the major genres. Let me compile the complete report:
-
----
-
-# COMPREHENSIVE GENRE PROFILES: ENGLISH WEB FICTION CONVENTIONS
-
-## EXECUTIVE SUMMARY
-
-This research synthesizes conventions, rules, tropes, and reader expectations across seven major English web fiction genres. The analysis draws from Royal Road communities, author blogs, Reddit forums, publishing data, and successful case studies to establish what readers expect and what breaks reader engagement.
-
----
-
-## 1. LitRPG (LITERARY ROLE-PLAYING GAME)
-
-### Core Definition
-LitRPG is a literary genre combining computer RPG mechanics with narrative fiction, where game-like elements form an essential part of the story. Visible RPG statistics (strength, intelligence, damage) and explicit progression systems are significant parts of the reading experience.
-
-### Reader Contract
-"I want to watch a character grow stronger through quantified, visible progression. I expect clear game mechanics, consistent system rules, and the satisfaction of seeing numbers improve. The system itself should be a character—rule-based, logical, and internally consistent."
-
-### Hard Rules (Break These and Readers Leave)
-1. **System Consistency**: Once established, rules cannot change arbitrarily. Readers will catch violations more reliably than you know your own system.
-2. **Visible Progression**: Stats, levels, and skill acquisitions must be apparent. Hiding them frustrates readers.
-3. **Meaningful Power Curves**: Progression that feels earned, not arbitrary. Too-fast progression bores; too-slow frustrates.
-4. **No Unexplained Power Jumps**: Character growth must follow established system logic.
-5. **Respect Reader Game Knowledge**: Many readers have played actual RPGs and will identify broken mechanics immediately.
-
-### Sub-Types and Their Distinctions
-
-**Crunchy vs. Lite LitRPG**
-- **Crunchy**: Data-heavy, detailed stat sheets, complex skill trees, spreadsheet-like stat presentation. Appeals to seasoned gamers who want to understand the mathematics.
-- **Lite/Creamy**: Minimal mechanics, narrative focus over numbers, accessible to non-gamers. Mechanics serve story, not vice versa.
-- Reader self-selection is stark: some readers *only* read "Crunchy Town-Builders" or "Progression Fantasy with light LitRPG elements."
-
-**VR vs. Real-World LitRPG**
-- **VR**: Characters enter game worlds via headsets/pods. Clear separation between real and virtual.
-- **Real-World/System Apocalypse**: Game mechanics invade Earth. All survival has mechanical weight.
-
-**Solo vs. Guild vs. Town-Building**
-- **Solo**: Single protagonist grinding and growing alone (e.g., *Dungeon Crawler Carl*).
-- **Guild**: Focus on party dynamics, team progression, faction politics.
-- **Town-Building/Settlement**: Base-building as primary mechanic. MC builds and manages structures, NPCs, economies.
-
-**Other Sub-Types**
-- **Crafting-Focused**: Blacksmithing, alchemy, cooking, enchanting as primary class.
-- **Deckbuilding**: Characters collect and duel with card decks.
-- **Harem**: Romance subplot with multiple love interests (contentious subgenre; readers pre-select based on "harem/no-harem" tags).
-
-### System Design Fundamentals
-
-**Stat Architecture**
-- Systems typically include core stats (Strength, Dexterity, Intelligence, Constitution, Wisdom, Charisma) or custom variations.
-- Derivative stats (Health Points, Mana, etc.) should depend on primary stats logically (e.g., HP = CON × Level).
-- Successful systems maintain numerical consistency across the entire narrative using spreadsheets or system documentation.
-
-**Skill Acquisition and Progression**
-- Skills progress through tiers: Apprentice → Journeyman → Master, unlocking higher-tier abilities.
-- Experience requirements can follow exponential decay (like WoW) or linear progression with milestone spikes.
-- Successful stories: each skill unlock feels *earned*, tied to genuine risk/sacrifice/problem-solving, not free gifts.
-
-**Progression Curves**
-The four main patterns observed in successful LitRPG:
-
-1. **Linear Progression**: Steady, slow growth. Feels grounded and realistic but can feel grindy (e.g., *Dungeon Crawler Carl*).
-2. **Exponential Decay**: Fast early levels, slowing dramatically. Matches MMO expectations.
-3. **Milestone-Based**: Clear stages (Beginner → Base Class → Advanced Class → Tiers). Each transition has power spike.
-4. **Ranked Tiers**: Discrete jumps between ranks (Iron → Bronze → Silver → Gold → Diamond) with exponential gains at each step (e.g., *He Who Fights with Monsters*).
-
-**Critical Progression Rule**: Too-fast = boring. Too-slow = readers abandon. Test pacing by ensuring Book 3 MC decisively defeats Book 1 version but not so overwhelmingly that challenges feel trivial.
-
-### Presenting System UI in Prose
-
-**Blue Box Method** (Most Common)
-- Use Royal Road's table formatting (blue boxes by default, can customize color).
-- Appears after action/revelation, not mid-scene.
-- Example:
-  ```
-  [Status: Level 12 acquired]
-  Strength: 14 → 15
-  Dexterity: 12 → 13
-  ```
-
-**System Voice/Personality**
-- Give the system character: formal, archaic, playful, or clinical tone.
-- Consistent phrasing and formatting becomes part of worldbuilding.
-- Example: System always says "Quest Accepted" vs. "Task Logged" signals flavor.
-
-**Narrative Integration**
-- Describe stats in narration first (audiobook-friendly, immersive).
-- Include full stat sheet for readers who want details.
-- Avoid info-dumping during action scenes.
-
-**Key Principle**: Stat blocks should interrupt *narrative tension minimally*. Use them to punctuate moments of achievement, not mid-combat confusion.
-
-**Common Mistake**: "Blue Box Madness"—stats every chapter, stat dumps pages long. Readers resent this. Save reveals for meaningful moments.
-
-### Beloved Tropes
-- Underdog rises to power.
-- Unique class/skill only protagonist can access (subverted if the item/skill is obviously available to others).
-- Mentor relationship with skilled NPC.
-- Discovery of hidden skill/talent.
-- Breaking through level caps and power thresholds.
-- The "first level feels weak but rewarding" curve.
-
-### Tired Tropes to Avoid
-- **Instant Mastery**: Character acquires skill and immediately excels. Readers want struggle and failure first.
-- **Secret Ancient Power**: Protagonist finds item/skill lost to history that no one else has thought to use. Readers spot this immediately as contrived.
-- **Overpowered Main Character**: Starting too strong removes tension. The genre is about growth from humble beginnings.
-- **Harems**: If included without careful character work, feel tacked on and devalue romance subplots.
-- **Chosen One Narrative**: Especially when tied to destiny/prophecy rather than earned power.
-- **System Message Overload**: Too many stat dumps, too many notifications. Breaks immersion.
-- **Poor Female Character Portrayal**: Women as "perfect girlfriend" or "sickly daughter to protect." Female readers are significant LitRPG consumers and notice shallow characterization.
-
-### Pacing and Chapter Structure
-
-**Typical Royal Road Pacing**
-- **Chapter Length**: 2.8k–3.5k words is the sweet spot (depends on stat density).
-- **Release Schedule**: 2–5 chapters/week (2k word chapters) or 1/week (4–8k chapters).
-- **Chapter Structure**:
-  - Opening hook/recap
-  - Action, exploration, or character moment
-  - System interaction/stat gain
-  - Cliffhanger or transition
-
-**Progression Pacing**
-- Early chapters: frequent level-ups and stat increases (every 1–3 chapters).
-- Mid-story: level-ups every 5–10 chapters, harder to achieve.
-- Late story: tier/rank transitions spaced further apart, each representing massive growth.
-
-### Common Mistakes That Tank LitRPG Stories
-
-1. **Author Doesn't Know the System**: Making up mechanics as you go. Readers will spot inconsistencies instantly.
-2. **Info-Dump Syndrome**: Explaining system rules at length instead of revealing them organically.
-3. **Stats ≠ Character Development**: Numbers going up on a spreadsheet is satisfying but hollow without emotional/narrative weight.
-4. **Poor Editing**: Grammar and typo errors "absolutely KILLING this genre" per reader surveys. Professionalism matters.
-5. **Uninteresting MC vs. Detailed World**: Elaborate system but bland protagonist. Readers' comment: "Everyone BUT the MC keeps me reading."
-6. **Lack of Stakes**: Progression without risk/difficulty. Wins feel unearned.
-7. **Unexplained Power Scaling**: Character gets stronger but readers can't track why or how much.
-8. **Boring Skill Descriptions**: Abilities need flavor, not just mechanical output. "Slash does 30% more damage" vs. "Rending Slash tears through material, leaving jagged wounds that bleed profusely."
-
-### Examples of Excellent System Design
-
-**Dungeon Crawler Carl** (Matt Dinniman)
-- Linear progression with slow, grounded growth.
-- Stats matter tangibly to survival. Player must understand system to survive traps and enemies.
-- Stat blocks are sparse, purposeful, and tied to dramatic moments.
-- Acquired 280,000+ ratings on Royal Road; published by Ace Books in 2024; reached #2 on NYT Audio Fiction list in 2025.
-
-**He Who Fights with Monsters** (Shirtaloon/Travis Deverell)
-- Ranked tier system (Iron → Bronze → Silver → Gold → Diamond) with exponential power jumps.
-- Unique hybrid cultivation/LitRPG mechanics that surprise genre-savvy readers.
-- Strong character voice and cultural clash (laid-back Australian in serious magical world) makes MC memorable despite divisive personality.
-- Books published by major houses; strong reader retention.
-
-**Awaken Online** (Travis Bagwell)
-- VR LitRPG with villain-protagonist (Jason raises undead armies, becomes antagonist).
-- System allows player freedom and moral ambiguity.
-- Nearly 1 million copies sold; invested heavily in professional audio production, which drove mainstream success.
-
-**The Wandering Inn** (pirateaba)
-- Portal fantasy/isekai LitRPG.
-- System focuses on Classes, Skills, Levels in service of human/character storytelling.
-- System messages highlight emotional beats, not just mechanical ones.
-- 16+ million words, twice-weekly updates, comic adaptation in development.
-
-**Primal Hunter** (Zogarth)
-- System Apocalypse subgenre.
-- MC is an archer/hunter with specific identity (not generic "guy with powers").
-- Clear differentiation and character specificity helped reader retention (11,000+ monthly patrons).
-
----
-
-## 2. PROGRESSION FANTASY
-
-### Core Definition
-A fantasy subgenre centered on the protagonist's *intentional and quantifiable* increase in power, skill, or magical ability. The journey of growth is the primary narrative driver, not a subplot. Unlike LitRPG, explicit game mechanics (stats, levels) are optional; the focus is on structured, visible advancement.
-
-### Key Distinction from LitRPG
-- **Progression Fantasy**: No game UI required. Power growth happens through mystical training, cultivation, martial arts advancement, or internal magical cultivation. System may use words like "Rank," "Stage," "Cultivation Level" rather than "Level."
-- **LitRPG**: Game mechanics and notifications are essential parts of the reading experience.
-- **Overlap**: All LitRPG is technically progression fantasy, but not all progression fantasy is LitRPG.
-
-### Reader Contract
-"Show me a protagonist learning, training, struggling to grow stronger. I want clear milestones, earned power gains, and visible transformation. The protagonist should feel fundamentally different between Act 1 and Act 3."
-
-### Hard Rules
-1. **Progress Must Be Quantifiable**: Readers need measurable advancement, even without explicit numbers. "Stage 3 cultivator" or "Master swordsman" markers work.
-2. **No Power Loss (Critical)**: Progress loss scares off more readers than virtually anything else. A character losing abilities mid-series creates abandonment.
-3. **Clear Power Tiers**: Readers use these to understand world power levels. Once established, tier progression must follow logic.
-4. **Earned Growth**: Power gains must connect to effort, sacrifice, or problem-solving. Free power is unsatisfying.
-5. **Book-to-Book Comparison**: A useful test: Book 3 protagonist should decisively defeat Book 1 version. If not, progression feels stalled.
-
-### Three Major Styles
-
-**Eastern-Style (Xianxia/Wuxia Foundation)**
-- Cultivation through meditation, qi manipulation, internal energy.
-- Heavy emphasis on philosophy, enlightenment, Buddhist/Taoist concepts.
-- Often includes immortality seeking, heavenly tribulations.
-- Examples: *Cradle* (western interpretation of eastern concepts).
-
-**Western-Style Progression Fantasy**
-- Borrows cultivation mechanics but strips traditional Chinese cultural trappings.
-- Magic systems with Western naming conventions (Copper → Iron → Jade → Gold instead of Qi Condensation → Core Formation).
-- Academy settings, mentorship, adventuring parties.
-- Examples: *Cradle* (hybrid), *Warformed: Stormweaver*.
-
-**LitRPG-Adjacent**
-- Uses explicit game mechanics but emphasizes growth journey over system mechanics.
-- Blurs the line between progression fantasy and LitRPG.
-
-### Power System Design Principles
-
-**Tier/Rank Systems**
-Common patterns:
-- **Color Tiers**: White (beginner) → Yellow → Orange → Red → Gold (master).
-- **Metal Tiers**: Copper → Iron → Bronze → Silver → Gold.
-- **Cultivation Stages**: Foundation → Golden Core → Immortal Ascension.
-- **Letter Ranks**: F (weakest) → E → D → C → B → A → S → SS.
-
-Each tier should represent *meaningful* power difference. Characters at different tiers shouldn't be able to compete directly. Physical transformations signal mental ones: eye color changes, hair color changes, wings, horns manifest at specific tiers.
-
-**Quantifiable Advancement**
-Methods without explicit numbers:
-- Technique mastery (bronze-level sword strikes vs. silver-level).
-- Capacity increase (can hold more mana, sustain spells longer).
-- Spiritual attribute development (sensitivity to magic, intuition).
-- Combat capability (can fight and win against tier X enemies).
-
-**Training Arcs vs. Individual Breakthroughs**
-- **Montage Risk**: Training montages are tempting but can feel rushed. Readers want *some* individual training scenes showing struggle, failure, epiphanies.
-- **Breakthrough Scenes**: When protagonist achieves tier advancement, this deserves a scene showing struggle, breakthrough, and transformation.
-- **Best Practice**: Mix montages (covering weeks of training) with 1–2 detailed breakthrough scenes per advancement tier.
-
-### Maintaining Tension as MC Gets Stronger
-
-**Problem Scaling**
-- As protagonist grows, introduce enemies/challenges that scale faster or introduce different threat types.
-- Strongest threat need not be physical: political, magical, spiritual, temporal.
-- Example: *Cradle* - as Lindon grows, new factions and cultivation sects present equal or greater challenge despite personal power gain.
-
-**Internal Struggle Escalation**
-- Power doesn't solve everything. New power unlocks new problems (pride, responsibility, temptation, enemies attracted by strength).
-- Emotional stakes must rise with power stakes.
-
-**Shifting Power Hierarchies**
-- Early story: MC is underdog among peers.
-- Mid-story: MC becomes formidable but others advance too.
-- Late story: MC among strongest but faces tier-transcending threats.
-
-### Beloved Tropes
-- Underdog from weak background.
-- Mentor relationship and eventual transcendence of mentor.
-- Breakthrough moments with dramatic transformation.
-- Accumulation of techniques and power combinations.
-- Rivalry with peer who also progresses.
-- Discovery of unique cultivation path/technique.
-- Facing the impossible and barely succeeding through growth.
-
-### Tired Tropes to Avoid
-- **Instant Power-Up**: Finding an item that grants instant power.
-- **Bloodline Awakening Without Buildup**: Protagonist suddenly has latent power that explains past weakness. Feels unearned without foreshadowing.
-- **Training Montage Only**: Readers want at least some detailed training scenes.
-- **Arbitrary Advancement Blocks**: "You can't progress past this tier until..." rules that feel like artificial gates.
-- **Power That Doesn't Solve Problems**: Protagonist gains power but narrative problems remain unchanged. Progression should open new story paths.
-
-### Pacing Expectations
-- **Tier Advancement**: Every 2–4 chapters early (rapid growth, high-stakes breakthroughs).
-- **Mid-Story**: Every 8–15 chapters (growth slowing, advancement harder).
-- **Late-Story**: Every 20+ chapters (major tier jumps, rare and climactic).
-
-### Chapter Structure
-Similar to LitRPG but with less mechanics:
-- Training/learning moment
-- Application/combat testing
-- Breakthrough trigger
-- Advancement scene or cliffhanger
-
-### Examples Defining the Genre
-
-**Cradle** (Will Wight)
-- Western cultivation fantasy with clear tier system: Copper → Iron → Jade → Gold → Underlord → Overlord → Archlord.
-- Lindon starts as "runt of the litter," cast out by his clan for weakness.
-- System gives "enough information to imagine solutions but not so much a min-maxer could determine perfect strategy mathematically."
-- Inspired by xianxia/wuxia but fully Western in approach; New York Times bestseller; massive indie success.
-
-**Defiance of the Fall** (TheFirstDefier)
-- System Apocalypse progression fantasy with xianxia elements.
-- MC starts alone in wilderness after system integration.
-- 20+ million views on Royal Road; books published on Amazon/KU/Audible.
-
-**He Who Fights with Monsters** (Shirtaloon)
-- Hybrid cultivation/LitRPG progression system.
-- Ranked advancement with ranked tier jumps creating exponential power gains.
-- Character-driven progression with strong voice.
-
----
-
-## 3. SYSTEM APOCALYPSE (LitRPG APOCALYPSE)
-
-### Core Definition
-A game-like system appears in the world during an apocalyptic event, forcing characters to adapt to new reality where magic, levels, quests, and game mechanics are real. Combines LitRPG mechanics with survival fiction.
-
-### Reader Contract
-"The world has changed fundamentally. I want to see how people adapt to supernatural/magical reality, balance survival with power fantasy, and build new society from collapse."
-
-### Hard Rules
-1. **Day Zero Must Matter**: The inciting incident (system arrival) should change everything permanently. No reverting to old world.
-2. **Survival Pressure Early**: Early chapters must establish genuine danger. Readers want to feel stakes, not power fantasy without context.
-3. **System Integration Logical**: System arrival should have in-world explanation (however vague). "It just happened" is acceptable but feels thin.
-4. **Real-World Consistency**: If system arrives on Earth, maintain real geography, real consequences. Readers will notice if you ignore physics.
-
-### The "Day Zero" Opening and Conventions
-
-**Common Patterns**
-1. **Sudden Integration**: System appears with notification. Protagonist suddenly sees HUD, stats, quests. World immediately transforms.
-2. **Tutorial Phase**: First days/weeks are "tutorial," gentler challenges, gradual escalation.
-3. **Societal Collapse**: Governments fall, infrastructure breaks, civilization shatters. Survivors must organize.
-4. **Factions Form**: Within hours/days, groups form: government remnants, criminal networks, cults worshiping the system, military consolidation.
-
-**Critical Moment**: First 1–3 chapters establish:
-- How normal person reacts to system appearance.
-- First death or near-death (establishes real stakes).
-- Understanding that old rules are gone.
-
-### Balancing Survival with Power Fantasy
-
-**Early Story (Chapters 1–30)**
-- Focus: Survival, resource gathering, learning system mechanics.
-- Power fantasy is muted; MC is still weak, struggles with level 1–5 monsters.
-- Readers want desperation, not dominance.
-
-**Mid-Story (Chapters 30–100+)**
-- Focus: Growing stronger, claiming territory, power politics.
-- MC becomes formidable but faces tier-scaled challenges.
-- Power fantasy increases; survival becomes strategic rather than desperate.
-
-**Late-Story**
-- Focus: Societal rebuilding, faction wars, world-scale threats.
-- MC is powerful but not unstoppable; challenges are existential/political.
-
-**Key Balance Technique**: Introduce *new* threat types as MC grows. Example: MC defeats zombies/low-tier monsters but discovers intelligent predators, rival factions, interdimensional invasions.
-
-### Societal Collapse Portrayal
-
-**Essential Elements**
-1. **Infrastructure Failure**: Food, water, electricity, medicine stop.
-2. **Government Vacuum**: Official structures collapse or fracture. Martial law or warlordism emerges.
-3. **Human Behavior Spectrum**: Some help, some exploit, some break. Avoid binary good/evil; people are survival-driven.
-4. **Resource Scarcity**: Water, ammunition, medical supplies, safe shelter drive conflict.
-
-**Tropes**
-- **The Safe House**: Temporary refuge offering physical safety and mental reprieve. Often marks turning points in narrative.
-- **The Journey**: Group traveling through devastated landscape toward goal. Allows full-range encounters with post-collapse society.
-- **Survivor Guilt/Hope Tension**: Characters wrestle between despair and reason to rebuild.
-
-### Faction Building and Politics
-
-**Faction Types**
-- **Military/Government Remnants**: Organized, disciplined, might be authoritarian.
-- **Criminal Networks**: Exploit chaos, control black markets, prey on weak.
-- **Cults**: Worship the system, may sacrifice followers to it.
-- **Survival Communities**: Towns banding together, often democratic.
-- **Warlords/Strongmen**: Charismatic leaders claiming territory.
-- **Isolationists**: Avoid society, set up hidden communities.
-
-**Political Complexity**
-- Factions should have competing interests, not all evil/good.
-- MC becomes political player: making alliances, enemies, navigating complex webs.
-- Readers enjoy intrigue and political depth.
-
-### Integration of Real-World and Fantasy Elements
-
-**Grounding Techniques**
-- Name real locations (if MC is in USA, mention states, cities).
-- Acknowledge real infrastructure (highways, power lines, hospitals are now dangerous/ruined).
-- Use real weapons/survival skills: firearms, first aid, agriculture, carpentry matter.
-- Maintain daylight cycles, weather, seasons.
-
-**Tech Integration**
-- Survivors try to use old-world tech: vehicles (fuel issues), weapons (ammo), medicine.
-- Show why tech fails in magical world: magic interferes with electronics, or doesn't; internal consistency matters.
-- Hybrids interesting: magic-powered vehicles, guns enhanced with spells, etc.
-
-### Examples
-- **Defiance of the Fall** (TheFirstDefier): System apocalypse with cultivation elements. MC alone in wilderness. Survival, power-up, faction discovery arc.
-- **The Primal Hunter** (Zogarth): Office worker thrust into system apocalypse tutorial and thrives. Minimal base-building, focus on character development and progression.
-
-### Pacing and Chapter Structure
-- **Early (Chapters 1–15)**: Integration, confusion, first dangers. Shorter chapters (2–3k).
-- **Mid (Chapters 15–50+)**: Learning system, power-up, establishing base. Varied length.
-- **Late**: Expansion, war, existential threats. Can sustain longer chapters.
-
----
-
-## 4. DUNGEON CORE
-
-### Core Definition
-Protagonist is a dungeon, dungeon core, or magical construct bound to a location. Cannot leave but can reshape surroundings, create minions, set traps, grow stronger. Often pseudo-LitRPG with base-building management gameplay.
-
-### Reader Contract
-"I want to experience strategic base-building and optimization. I accept non-human POV and limited mobility in exchange for interesting economic systems, trap design, and creature management. The dungeon itself is the protagonist."
-
-### Hard Rules
-1. **Immobility is Feature, Not Bug**: Dungeon can't go on adventures. Tension comes from what threatens the core, not what MC chases.
-2. **Consequence for Strategic Failure**: If dungeon designs trap poorly or creates weak minions, adventurers will punish it. Dungeon must learn from failure.
-3. **Core is Vulnerable**: The core itself (dungeon's heart/mind) must be protected. This is central tension.
-4. **POV Clarity**: Reader must understand dungeon's sensory/cognitive limitations and how it perceives the world.
-
-### Non-Human POV Challenges
-
-**Sensory Limitations**
-- Dungeon can't leave. Limited direct sensory input.
-- Often "feels" through mana flows, monster senses, vibrations in dungeon structure.
-- Dungeon learns about outside world through adventurers, scouts, or other means.
-
-**Solution**: Split POV or relay POV. Example:
-- Primary POV: Dungeon core (strategic, omniscient within dungeon).
-- Secondary POV: Adventurer, NPC, or dungeon minion exploring dungeon (reader's ground-level perspective).
-
-This 50/50 split helps readers stay grounded in familiar human experience while experiencing dungeon's alien perspective.
-
-**Cognitive Differences**
-- Dungeon thinks slower (no human-speed consciousness).
-- Dungeon might experience time differently (seasons pass in what feels like days).
-- Dungeon has no human emotions (or slowly develops them through story).
-
-### Base-Building Narrative Mechanics
-
-**Resource Management in Prose**
-Instead of showing spreadsheets:
-- Describe dungeon's mana reserves and regen rate.
-- Show cost/benefit of spawning creatures or enchanting rooms.
-- Create scarcity: dungeon must choose between defense, expansion, or treasure hoarding.
-
-**Example Progression**
-- **Early**: Simple dungeon, 3–4 rooms, basic traps, weak monsters. Dungeon learns system.
-- **Mid**: Expanding territory, specialized rooms (library, forge, breeding chambers), sophisticated trap combinations.
-- **Late**: Sprawling complex, hundreds of minions, political relationships with other dungeons/factions, economic impact on region.
-
-**Trap and Creature Design**
-- Readers enjoy reading about creative dungeon design.
-- Each room/trap/creature should feel *purposeful*, not random.
-- Show dungeon learning: "Adventurers bypassed the arrow trap by..." → "Next dungeon iteration adds reinforced walls."
-
-### Creating Tension When MC is a Building
-
-**External Threat**
-- Adventurer parties seeking treasure or to kill dungeon.
-- Rival dungeons competing for territory/resources.
-- Natural disasters threatening dungeon stability.
-- Government/military wanting to control dungeon.
-
-**Internal Tension**
-- Resource scarcity: not enough mana to do everything.
-- Minion rebellions or dissatisfaction.
-- Dungeon's own curiosity/ambition creating danger.
-- Moral conflicts (dungeon kills adventurers; is dungeon evil?).
-
-**Progression Tension**
-- Dungeon can grow stronger, but with vulnerability windows.
-- Dungeon evolution/tier advancement creates periods of weakness.
-- New abilities come with new risks.
-
-### POV Management Best Practices
-
-**Single Dungeon POV** (Harder)
-- Keep readers inside dungeon's perspective only.
-- Show external events through dungeon's limitations (hearing screams, sensing mana disturbances).
-- Risk: readers feel trapped/limited.
-- Successful example: internal monologue and dungeon learning from observer NPCs.
-
-**Split POV** (Easier for Beginners)
-- Alternate: Dungeon core chapters → Adventurer/NPC exploration chapters.
-- 50/50 split works well.
-- Adventurer chapters ground reader in familiar human perspective and build suspense (readers know dungeon's plan; adventurers don't).
-
-**Relay POV**
-- Dungeon learns through minions' senses/reports.
-- Requires clear communication/understanding mechanism between dungeon and creatures.
-- Creates filter between dungeon and reader: sometimes dungeon is uncertain what minions experienced.
-
-### Avoiding Common Pitfalls
-
-1. **Lone-Wolf Dungeon**: Dungeon interacts only with adventurers and doesn't form relationships with NPCs. Add interaction and dialogue.
-2. **Overemphasis on Adventurer POV**: If 70%+ is adventurers exploring, it's not really dungeon core; it's fantasy with dungeon setting.
-3. **No Consequence for Design Failures**: Every trap should be disarmable; every creature should be defeatable. Make dungeon learn and adapt.
-4. **Reader Annoyance with Inability**: Some readers resent dungeon's immobility. Address this by making dungeon's strategic position interesting, not frustrating.
-
-### Examples
-
-**Dungeon Born** (Dakota Krout, 2016)
-- First in Divine Dungeon series, extremely popular.
-- Dungeon learns and grows, creating increasingly sophisticated challenges.
-
-**Rise of a Rogue Dungeon** (Royal Road)
-- Dungeon in fantasy world with dragons, titans, various races.
-- Focuses on dungeon's relationships with creatures and region.
-
-**A Dungeon Core** (Royal Road)
-- Core-focused dungeon narrative.
-- Explores dungeon's perspective and growth.
-
-**Another Dungeon Core** (Royal Road)
-- Variations on core mechanics and POV structure.
-
-### Chapter Structure
-- **Dungeon POV Chapters**: 2–3k words. Internal monologue, planning, resource management, strategy.
-- **Adventurer POV Chapters**: 2–3k words. Exploration, discovery, combat, adaptation.
-- **Alternating Pattern**: Works well. Ends dungeon chapter on suspense (adventurers approaching); ends adventurer chapter revealing dungeon's plan.
-
----
-
-## 5. COZY FANTASY / SLICE-OF-LIFE
-
-### Core Definition
-Fantasy fiction emphasizing hope, kindness, empathy, and community. Features characters in everyday magical routines, slice-of-life elements, and low-stakes conflict. Often single-location settings (small town, inn, shop). Focus on relationships: family, found family, friendship.
-
-### Reader Contract
-"I want comfort, warmth, and emotional connection. I'm not seeking danger or high stakes. Show me characters helping each other, building community, experiencing wonder in small magical moments. This is a refuge, not a battlefield."
-
-### Hard Rules
-1. **No Genre Bait-and-Switch**: If you promise cozy, don't introduce world-ending threat or graphic violence in chapter 20. Readers come for comfort; betraying that feels violating.
-2. **Low Stakes Can Still Engage**: Conflict can exist (personal growth, community problems, small dangers) but avoid existential threats.
-3. **Emotional Arcs Over Action Arcs**: Character development happens through emotional breakthroughs, not combat victories.
-4. **Community as Character**: The setting and community are as important as individual protagonist.
-5. **Hope Must Be Present**: Even sad moments don't end in despair. There's always path forward.
-
-### What Makes Cozy Fiction Work
-
-**Essential Elements**
-1. **Comforting Details**: Food (tea, baked goods), comfortable spaces, sensory warmth.
-2. **Character Kindness**: Characters help without extensive cost/trauma. Goodness is rewarded or at least acknowledged.
-3. **Found Family**: Whether biological or community, strong relationship bonds.
-4. **Slow Pacing**: Space for character moments, reflection, small conversations.
-5. **Wonder Without Danger**: Magic exists and is beautiful but not inherently threatening.
-
-**Tone**
-- Conversational, intimate.
-- Humor is gentle, not cruel.
-- Authorial voice is warm, even when describing conflict.
-
-### Low-Stakes Conflict That Still Engages
-
-**Types of Conflict**
-- **Personal Growth**: Character struggling with self-doubt, past trauma, learning to trust.
-- **Community Problem**: Town needs harvest before winter, shop is struggling, neighborhood conflict.
-- **Relationship Tension**: Misunderstanding between friends, unresolved feelings, communication breakdown.
-- **Small Danger**: Monster in the woods (not extinction-level threat), wild magic accident (not apocalypse).
-- **Moral Dilemma**: Choosing between loyalties, ethical quandary with no perfect answer.
-
-**Key Principle**: Stakes are high *emotionally* but not existentially. Character failing matters because they care about outcome, not because world ends.
-
-### Slice-of-Life vs. Cozy Fantasy Spectrum
-
-**Slice-of-Life Heavy**
-- Minimal plot. Emphasis on daily routines, small discoveries, character observation.
-- Some readers want *no* conflict at all (iyashikei/healing anime influence).
-- Risk: feels static or dull if no arc exists.
-
-**Cozy Fantasy with Plot**
-- Clear character/community arc, gentle resolution.
-- Small conflicts woven through.
-- Most successful cozy fantasies blend both: slice-of-life texture with emotional throughline.
-
-### No-Conflict Rule Debate
-
-**Reader Divide**
-- Some want pure slice-of-life with no antagonist.
-- Others want small conflict for narrative tension.
-- Spectrum matters: cozy fantasy *can* have conflict, just not violence/trauma/doom.
-
-**Best Practice**: Define upfront what "cozy" means for your story. Advertise accurately to manage reader expectations.
-
-### Emotional Arcs in Cozy Fantasy
-
-**Character Arc Example**
-- **Start**: Character isolated, grieving, or self-doubting.
-- **Journey**: Small community interactions, gradual opening to hope.
-- **Climax**: Emotional breakthrough (not battle).
-- **Resolution**: Character healed/transformed, integrated into community, found belonging.
-
-**Community Arc Example**
-- **Start**: Community divided, struggling, or disconnected.
-- **Journey**: Characters working together on small problem.
-- **Climax**: Community rallies, realizes strengths in unity.
-- **Resolution**: Stronger bonds, shared purpose, renewed hope.
-
-### Beloved Tropes
-- Found family.
-- Small-town charm and quirky characters.
-- Magical apprenticeship/learning craft.
-- Healing through relationships and community.
-- Discovering hidden talents/purpose.
-- Cozy mystery elements (gentle puzzle-solving).
-- Holiday/seasonal celebrations bringing community together.
-
-### Tired Tropes to Avoid
-- **Manic Pixie Dream Character**: Quirky character exists only to change protagonist. Give characters depth.
-- **Nostalgic Falseness**: "Simpler time" romanticization that ignores real historical problems.
-- **Conflict Resolution Without Work**: Problems solve themselves. Readers want to see characters communicate and grow.
-- **Shallow Diversity**: Token diverse character with no depth.
-
-### Pacing Expectations
-- **Slow, Meditative Pacing**: 2–3k chapters, weekly updates.
-- **Space for Reflection**: Character has time to think, feel, process.
-- **Seasonal/Cyclical Structure**: Calendar-based (winter chapter, spring chapter) works well.
-
-### Chapter Structure
-- Quiet opening (character in routine or reflection).
-- Small event or interaction.
-- Character's internal response/growth moment.
-- Gentle transition to next scene.
-- Soft ending (not cliffhanger; sense of peace or hope).
-
-### Examples
-- **The City We Became** (N.K. Jemisin) - Urban fantasy with love and community at heart.
-- Indie cozy fantasy web serials on Royal Road emphasizing tea shops, bakeries, magical crafts.
-
----
-
-## 6. ROMANTASY / ROMANCE
-
-### Core Definition
-Fantasy fiction where romance is a significant/primary plot driver. Reader expectations depend on which of two types:
-
-**Fantasy Romance**: Romance is the focus; HEA/HFN ending mandatory.
-**Romantic Fantasy**: Fantasy plot is primary; romance is significant subplot; HEA/HFN not guaranteed.
-
-### Reader Contract (Depends on Type)
-
-**Fantasy Romance**: "The romance is the story. I want to see two characters fall in love against obstacles, with emotional depth and sexual/romantic tension. I expect a satisfying ending where they end up together."
-
-**Romantic Fantasy**: "The story has a significant love arc, but the external plot is primary. I expect beautiful romantic moments and character chemistry, but the ending is determined by story logic, not romance requirements."
-
-### Hard Rules
-
-**Universal to Both**
-1. **Chemistry Must Be Earned**: Readers need to understand why characters care for each other. Attraction must feel real, not convenient.
-2. **Love Interest Must Drive Transformation**: The love interest significantly causes/contributes to protagonist's growth.
-3. **Emotional Honesty**: Inner feelings must be shown, not told. "I love you" means nothing without demonstrated vulnerability.
-4. **Conflict Must Be Real**: Easy romance (no obstacles) is boring. Genuine reasons for relationship difficulty.
-
-**Fantasy Romance-Specific**
-- HEA/HFN is *required*. Readers feel betrayed if romance ends ambiguously or tragically.
-- Romance scenes take significant page time (not just epilogue).
-- Internal conflict (emotional journey) is as important as external conflict.
-
-**Romantic Fantasy-Specific**
-- HEA/HFN is *not* required. Story logic determines ending.
-- Romance thread is woven through but secondary to plot.
-- Reader cares about both relationship *and* external stakes equally.
-
-### Expected Tropes (Beloved)
-
-**Enemies to Lovers**
-- Two characters start at odds: opposition, misunderstanding, or genuine enmity.
-- Forced proximity (war, quest, captivity) requires interaction.
-- Gradual understanding and attraction as they see past first impressions.
-- Slow-burn chemistry with banter and tension.
-- Works exceptionally well in fantasy: nations at war, spy dynamics, magical opposition.
-
-**Fated Mates/Chosen One**
-- Characters magically bonded or destined for each other.
-- Internal recognition of connection.
-- Both resist, then accept fate.
-- Can feel contrived if not grounded in character choice and emotional growth.
-
-**Forbidden Love**
-- Social/magical barrier preventing relationship: class difference, species difference, magic/no-magic, enemy factions.
-- Conflict comes from external pressure, not character incompatibility.
-- Relationship must prove worth the cost.
-
-**Second Chance/Forced Proximity**
-- Characters separated or estranged, forced to reconcile through circumstance.
-- History adds depth and pain to reconciliation.
-- Excellent for character depth (readers see how much they've changed).
-
-**Love Triangle**
-- Two love interests, protagonist must choose.
-- Risky: readers often resent love triangles; only works if both love interests are genuinely compelling and each relationship feels different.
-- Must be resolved decisively, not dragged out.
-
-### Character Chemistry Techniques
-
-**Show Attraction Subtly**
-- Physical description notices: dimples, the way someone laughs, how they move.
-- Small touches that linger slightly longer.
-- Involuntary reactions: heartbeat increase, breath catching, blushing.
-
-**Banter and Wit**
-- Clever dialogue showing mutual understanding.
-- Characters who make each other laugh or challenge each other intellectually.
-- Verbal sparring that masks attraction (enemies-to-lovers especially).
-
-**Vulnerability Moments**
-- Characters showing weakness or fear to each other.
-- Sharing secrets or past trauma.
-- Comforting each other (non-romantic, then gradually romantic).
-
-**Shared Goals/Values**
-- Characters discover common purpose.
-- Working together toward goal reveals compatibility.
-- Seeing how partner handles conflict/makes decisions.
-
-### Heat Levels and Reader Expectations
-
-**Heat Level Spectrum**
-1. **Sweet (Fade-to-Black)**
-   - Kissing, maybe embracing.
-   - Sex happens off-page ("They spent the night together...").
-   - Suitable for YA, general audiences, romance readers who prefer subtle.
-
-2. **Warm (Mild Sensual)**
-   - On-page kissing with description.
-   - Beginning of sexual activity described (clothing removal, touching).
-   - Fades to black before or during explicit sexual content.
-
-3. **Sensual (Moderate Heat)**
-   - Full sexual scenes on-page.
-   - Language is flowery/poetic, not crude.
-   - Euphemisms and indirect language ("their bodies joined").
-   - 1–2 sex scenes, focus on emotion over mechanics.
-
-4. **Spicy (Explicit)**
-   - Multiple explicit sex scenes.
-   - Coarse language acceptable.
-   - Clear anatomical descriptions.
-   - Sexual tension and lust drive some scenes.
-   - 2–4+ sex scenes per book.
-
-5. **Erotic (Very Explicit)**
-   - Sex scenes frequent and detailed.
-   - BDSM, kink, non-standard sexual activities.
-   - Sexual content is primary plot driver alongside romance.
-   - Readers specifically seeking high sexual content.
-
-**Critical Rule**: Communicate heat level clearly in blurb/cover. Readers self-select based on expectations. Mislabeling causes reviews from disgruntled readers.
-
-### Romance Integration with Fantasy Elements
-
-**World-Building Strategy**
-- Use fantasy setting to *complicate* romance (species difference adds real tension).
-- Or use setting to create *opportunities* for romance (war forces proximity, magic enables bonding, politics separates lovers).
-- World should not feel like afterthought to romance.
-
-**Magic and Romance Intersection**
-- Magic systems can enable intimacy (magic bonds, soul connections, sensing mana intertwining).
-- Or prevent it (magic and romance are separate, magic warns of danger).
-- Cultural magic can influence relationship: some cultures encourage arranged bonds, others forbid cross-species love, etc.
-
-**Action Sequences and Romance**
-- Action scenes should show relationship dynamics, not pause romance.
-- Fighting together reveals trust, compatibility, how partners support each other.
-- Sexual tension can heighten during/after action (adrenaline, relief at survival, protective instincts).
-
-### Examples
-- **Swordheart** (Elizabeth Bear) - Romantic fantasy with complex antagonists and emotional depth.
-- Indie romantasy web serials on Royal Road emphasizing enemies-to-lovers and character chemistry.
-
-### Pacing
-- **Fantasy Romance**: Heavy romance focus early, building to consummation/climax around 60–75% mark. Resolution after romance is established.
-- **Romantic Fantasy**: Romance subplot woven through action plot. Key romantic moments at act breaks. Romance resolution aligned with plot resolution.
-
----
-
-## 7. SCI-FI / SPACE OPERA
-
-### Core Definition
-Space-based or futuristic fiction with science-based worldbuilding. **Hard sci-fi** emphasizes scientific accuracy and explanation of mechanics. **Space opera** prioritizes epic scale and human drama over scientific accuracy.
-
-### Reader Contract
-
-**Hard Sci-Fi**: "Explain the science. I want plausible physics, technology consistency, and logical consequences of scientific principles. Handwave nothing; build the world on real science (or clear extensions of it)."
-
-**Space Opera**: "Give me epic scale, grand conflicts, and compelling characters. Science is backdrop; human drama is foreground. Don't worry about whether FTL is physically possible; focus on the story."
-
-### Hard Rules
-
-**Hard Sci-Fi**
-1. **Scientific Consistency**: Physics and tech must follow established rules. No magic wand fixes.
-2. **Logical Consequences**: Technology has realistic limitations and side effects.
-3. **Explanation Expected**: Readers want to understand *how* things work, not just that they do.
-4. **Accuracy Matters**: Get the science right or handwave it clearly.
-
-**Space Opera**
-1. **Epic Scale**: Settings spanning planets/systems/galaxies. Civilizations and empires clash.
-2. **Human Drama**: Personal stories matter; political intrigue, relationships, character arcs drive story.
-3. **Science Can Be Soft**: Faster-than-light travel, hyperdrives, teleports are "good enough" without explanation.
-4. **Action and Grandeur**: Epic space battles, first contact, exploration.
-
-### Tech Consistency Rules
-
-**Soft Sci-Fi Worldbuilding**
-- Create internally consistent universe with its own laws of physics.
-- Allow divergences from reality (time travel, FTL) but rules must be consistent.
-- Focus on *human experience* of living with technology.
-
-**Example**: If robots can't feel emotion, they don't aid protagonist out of principle. If AI can be enslaved, show the moral implications. Rules matter.
-
-**Tech as Extension of Rules**
-- Every technology should have limitations.
-- Introduce problems that technology *can't* solve (corruption, emotion, nature, human greed).
-- Technology solves old problems; new technologies create new ones.
-
-### Space Opera Conventions
-
-**Epic Scale**
-- Settings span star systems to galaxies.
-- Civilizations and empires with histories and politics.
-- Grand conflicts: nations at war, first contact, existential threats.
-
-**Political Complexity**
-- Factions with competing interests.
-- Diplomacy as important as combat.
-- Intrigue and betrayal common.
-
-**Exploration and Discovery**
-- Unknown worlds, alien species, new phenomena.
-- Sense of wonder and vastness.
-
-**Military/Adventure Focus**
-- Space battles, starship crews, adventuring parties.
-- Character-driven action.
-
-### Examples
-- **Of Blood and Stardust** (Royal Road) - Military hard sci-fi space opera.
-- **Final War: Hetairoi** (Royal Road) - Progression + hard sci-fi + mecha space opera.
-
-### Reader Expectations
-
-**Hard Sci-Fi Readers Want**:
-- Believable worldbuilding.
-- Accurate technology/physics explanations.
-- Logical problem-solving.
-- Science as character (challenges drive plot).
-
-**Space Opera Readers Want**:
-- Epic scope and grand conflicts.
-- Memorable characters and relationships.
-- Sense of wonder.
-- Action and adventure.
-- Politics and intrigue.
-
----
-
-## CROSS-CUTTING INSIGHTS & PATTERNS
-
-### On System Design Generally
-
-**Readers' Test for Good System Design**:
-1. Can I understand the system from reading naturally?
-2. Does the system have internal logic/consistency?
-3. Do the rules explain character capabilities and limitations?
-4. Do stat increases/power-ups feel *earned* through struggle?
-5. Can I predict how the system works without author explanation?
-
-### Reader Self-Selection
-
-Readers actively select based on:
-- **Crunch Level**: Crunchy vs. lite preferences are stark (some readers *only* read one).
-- **Harem/No-Harem**: Significant portion of readers filter explicitly on this.
-- **Dark/Light Tone**: Dark themes with violence vs. lighter adventure.
-- **Heat Level**: In romance, clearly labeled.
-- **Pacing**: Fast/multiple releases vs. fewer, longer chapters.
-
-### Universal Hard Rules Across Genres
-
-1. **Internal Consistency**: Once rules are set, follow them. Readers will catch violations.
-2. **Earned Growth/Change**: Character power/status/relationships should feel earned, not gifted.
-3. **Meaningful Stakes**: Even low-stakes stories need consequences for failure (emotional, relational, or strategic).
-4. **Character Over Mechanics**: Readers care about people more than systems, even in system-heavy genres.
-5. **Clear Genre Labeling**: Advertise genre accurately. Bait-and-switch betrays reader trust.
-
-### On Editing and Professionalism
-
-**Critical Finding**: Grammar, spelling, and editing quality are "absolutely KILLING this genre." Readers notice and leave for poor presentation, even if story is solid.
-
-Professional editing is essential for success, especially in self-publishing.
-
-### Monetization and Format Trends (2024-2025)
-
-- **Audio Success**: Major success stories invested heavily in professional audiobooks (*Dungeon Crawler Carl*, *Awaken Online*).
-- **Patreon Model**: Web serial authors often monetize through Patreon (early access, bonus chapters).
-- **KU/Amazon Publishing**: Successful Royal Road stories often move to Amazon KU for revenue and wider reach.
-- **Transmedia**: Successful stories expand to comics, audio, merchandise.
-
----
-
-## BIBLIOGRAPHY & SOURCES
-
-### LitRPG & System Design
-- [Strategies For Success Releasing LitRPG Stories On Royal Road](https://johnchampaign.com/2024/01/29/strategies-for-success-releasing-litrpg-stories-on-royal-road/)
-- [Royal Road Forum: Difference between progression fantasy and litrpg](https://www.royalroad.com/forums/thread/156327)
-- [Royal Road Forum: LitRPG Think Tank](https://www.royalroad.com/forums/thread/100306)
-- [LitRPG Power Arc Analysis by C.R. Rowenson](https://crrowenson.com/case-studys/litrpg-power-arc-analysis-case-studies/)
-- [How to Write LitRPG - LitRPG Reads](https://litrpgreads.com/blog/litrpg/how-to-write-litrpg-integrating-game-systems-into-your-story-without-losing-readers)
-- [Blue Box Madness - Joi Massat](https://jmassat.com/2024/02/13/blue-box-madness-or-the-dark-side-of-writing-litrpgs/)
-
-### Progression Fantasy
-- [Luke Chmilenko: Progression Fantasy Compendium](https://lukechmilenko.com/compendium/progression-fantasy/)
-- [Andrew Rowe: Progression Fantasy - A New Subgenre Concept](https://andrewkrowe.wordpress.com/2019/02/26/progression-fantasy-a-new-subgenre-concept/)
-- [Andrew Rowe: Distinctions in Progression Fantasy Styles](https://andrewkrowe.wordpress.com/2022/11/04/distinctions-in-progression-fantasy-styles/)
-- [Andrew Rowe: Writing Progression Fantasy](https://andrewkrowe.wordpress.com/2019/03/02/writing-progression-fantasy/)
-
-### Cozy Fantasy
-- [Rachel Neumeier: Cozy Fantasy](https://www.rachelneumeier.com/2023/07/21/cozy-fantasy/)
-- [Book Riot: What Counts as Cozy Fantasy?](https://bookriot.com/what-counts-as-cozy-fantasy/)
-- [The Rise of Comfort TTRPGs](https://therpggazette.wordpress.com/2025/12/12/the-rise-of-comfort-ttrpgs-cosy-gaming-slice-of-life-and-the-fantasy-of-safety/)
-
-### Romantasy / Romance
-- [Savannah Gilbo: Writing Romantasy](https://www.savannahgilbo.com/blog/how-to-write-romantasy)
-- [Book Riot: Romantasy vs. Fantasy Romance](https://bookriot.com/romantasy-vs-fantasy-romance/)
-- [Heat Levels in Romance - Write With Harte](https://writewithharte.com/heat-levels-in-romance-novels-a-guide-for-authors/)
-- [How to Write Enemies to Lovers - Quill & Steel](https://www.quillandsteel.com/blogs/writing-tips/how-to-write-enemies-to-lovers-trope)
-
-### Dungeon Core
-- [Narrator.sh: Dungeon Core Guide](https://narrator.sh/blog/dungeon-core-guide)
-- [Royal Road Forum: Essentials of Dungeon Core](https://www.royalroad.com/forums/thread/120972)
-- [Vox Ghostwriting: Ultimate Dungeon Core Books for Starters](https://www.voxghostwriting.com/blog/from-zero-to-overlord-the-ultimate-dungeon-core-books-for-starters/)
-
-### System Apocalypse
-- [Apocalypse LitRPG - Level Up Publishing](https://www.levelup.pub/apocalypse-litrpg)
-- [Post-Apocalyptic Genre - Cornett Fiction](https://www.cornettfiction.com/post-apocalyptic-genre-explained/)
-
-### Space Opera & Hard Sci-Fi
-- [Laterpress: Space Operas: What They Are and How To Write Them](https://www.laterpress.com/blog/space-operas)
-- [Hard vs. Soft Worldbuilding - World Anvil](https://academy.worldanvil.com/blog/hard-versus-soft-worldbuilding)
-
-### Royal Road & Community Insights
-- [Most popular LitRPG - Royal Road Forum](https://www.royalroad.com/forums/thread/133480)
-- [Chapter Length Discussions - Royal Road Forum](https://www.royalroad.com/forums/thread/155914)
-- [Common LitRPG Mistakes - Goodreads LitRPG Forum](https://www.goodreads.com/topic/show/19548378-poll-which-of-these-do-you-consistently-have-a-problem-with-having-rea)
-- [Top 5 Overused LitRPG Tropes - Aaron Oster](https://www.aaronosterauthor.com/from-the-bean-bag-of-aaron-oster/top-5-litrpg-tropes)
-
-### Popular Stories Cited
-- [Dungeon Crawler Carl - Matt Dinniman](https://www.royalroad.com/fiction/29358/dungeon-crawler-carl-book-6-the-ghosts-of-earth)
-- [He Who Fights with Monsters - Shirtaloon](https://www.royalroad.com/fiction/26294/he-who-fights-with-monsters)
-- [Defiance of the Fall - TheFirstDefier](https://www.royalroad.com/fiction/24709/defiance-of-the-fall)
-- [The Primal Hunter - Zogarth](https://www.royalroad.com/fiction/36049/the-primal-hunter)
-- [The Wandering Inn - pirateaba](https://wanderinginn.com/)
-
----
-
-## FINAL NOTES FOR PROMPT DESIGNERS
-
-### Critical Takeaways
-
-1. **Genre is a Contract**: Readers come with specific expectations. Violating them (genre bait-and-switch, unexplained rule changes, power loss) causes abandonment.
-
-2. **System Matters, But Character Matters More**: Complex magic systems are appealing, but bland protagonists kill engagement. Invest equally in character development.
-
-3. **Consistency = Credibility**: Readers will track system rules more carefully than authors. Internal consistency (even in soft magic systems) is paramount.
-
-4. **Pacing and Structure Align with Genre**:
-   - LitRPG: Frequent power-ups, regular stat progression, blue-box stat reveals.
-   - Progression Fantasy: Milestone breakthroughs, earned advancement, less mechanical presentation.
-   - System Apocalypse: Survival urgency early, faction politics mid-story, existential stakes late.
-   - Cozy Fantasy: Slow, meditative, emphasis on emotional beats over action.
-   - Dungeon Core: Strategic resource management, split POV, learning through failure.
-   - Romantasy: Chemistry building, relationship obstacles, HEA/HFN expectations depend on subgenre.
-   - Space Opera: Epic scope, political intrigue, character relationships in grand setting.
-
-5. **Reader Self-Selection is Real**: Readers filter heavily on crunch level, harem/no-harem, heat level, darkness. Accurate labeling is essential.
-
-6. **Editing is Non-Negotiable**: Grammar and professional presentation directly impact reader retention in web fiction.
-
----
-
-**Research Completed**: This report synthesizes data from Royal Road communities, author blogs, published research, Goodreads reader discussions, Patreon trends, and bestseller analyses to provide comprehensive genre profiles for automated novel-writing system development.