@rubytech/create-realagent 1.0.406

package/payload/premium-plugins/writer-craft/references/conflict-escalation.md

@@ -0,0 +1,81 @@
+# Conflict and Escalation
+
+## Why Conflict Is Non-Negotiable
+
+The brain's default setting is homeostasis — it goes to enormous lengths to maintain its existing models. Even beneficial change triggers resistance, because change means the existing model was wrong.
+
+This is why conflict is not dramatic embellishment. It is the mechanism of story. Without conflict strong enough to force genuine change, nothing of narrative consequence can happen. The protagonist will simply maintain their misbelief indefinitely — which is what they would do in real life if the story weren't intervening.
+
+## The "Versus"
+
+Every story requires a specific "versus" — the rock and the hard place.
+
+- On one side: what the protagonist wants and believes
+- On the other: the reality that will ultimately challenge that want and that belief
+
+The conflict must be:
+- **Personalised** — aimed at this specific protagonist's vulnerabilities
+- **Specific** — not vague menace, but a concrete threat or dilemma
+- **Unavoidable** — the protagonist cannot simply walk away
+
+### Conflict Must Arise From Character
+The best conflict is not external difficulty arbitrarily imposed. It flows from who the protagonist is. The most painful conflicts are those in which the protagonist's own fears, misbeliefs, and desires create the trap they're caught in. This makes their struggle feel inevitable rather than contrived.
+
+## The Escalation Principle
+
+Everything that can go wrong must go wrong — and the wrongness must escalate.
+
+### Rules of Escalation
+
+1. **Each complication raises the stakes** beyond where they were before
+2. **Each apparent solution creates a larger problem** — the fix makes things worse
+3. **The protagonist must be forced to find resources** they didn't know they had
+4. **Each failure costs more** — the price of losing increases with each setback
+5. **The protagonist is simultaneously forced to confront** the inner issue they've been avoiding
+
+### The Worst Thing You Can Do
+The worst thing you can do as a writer is be kind to your protagonist. Readers do not want to watch someone navigate manageable difficulties. They want to see someone survive — or fail to survive — the unsurvivable. The brain uses story to simulate navigating difficult situations. A story that is too easy provides no simulation worth running.
+
+### No Free Victories
+There are no free victories in a well-told story.
+- Every gain costs something
+- Every loss has a consequence
+- The universe of the story is governed by cause and effect applied mercilessly
+- If the protagonist gets things for free, the reader stops believing the story is real
+
+## Force of Opposition
+
+The antagonist — whether a person, a force, or a circumstance — must be:
+
+- **Specific** — not generalised evil or vague threat
+- **Present** — actively in the story, not lurking offscreen
+- **Active** — taking actions, not just existing as a backdrop
+- **Targeted** — aimed specifically at the protagonist's most vulnerable points
+- **Credible** — capable of actually winning
+
+### The Best Antagonists
+The most compelling antagonists aren't simply evil. They are:
+- Pursuing their own goals that genuinely conflict with the protagonist's
+- Operating from their own misbelief, which makes their actions feel internally logical
+- Capable of making the protagonist question whether they are in the right
+- Forcing the protagonist to confront aspects of themselves they'd rather not face
+
+## Withholding and the Big Reveal
+
+Strategic withholding of information creates tension. The rules:
+
+1. Whatever you withhold must still produce a story that makes complete logical sense
+2. When the reveal comes, the story must make even more sense
+3. The reader should experience not confusion but retroactive recognition — "of course"
+4. Withholding must serve the story's needs, not the author's desire to be clever
+
+## Conflict Diagnostic
+
+- [ ] Is there a clear "versus" — a specific rock and hard place?
+- [ ] Does the conflict arise from the protagonist's own character?
+- [ ] Does each complication escalate — raising stakes higher than before?
+- [ ] Does each apparent solution create a bigger problem?
+- [ ] Is the protagonist earning every gain and paying for every loss?
+- [ ] Is the force of opposition specific, present, active, and credible?
+- [ ] Are the protagonist's deepest secrets and guarded flaws being exposed?
+- [ ] Has everything that can go wrong gone wrong?

package/payload/premium-plugins/writer-craft/references/copyediting.md

@@ -0,0 +1,73 @@
+# Copyediting
+
+## What Copyediting Is
+
+The quality-control phase of manuscript preparation. Copyediting checks grammar, spelling, punctuation, capitalisation, consistency, and factual accuracy. It is the final pass before the manuscript enters production.
+
+Copyediting is the phase most often confused with "editing" by people outside publishing. It is important and skilled work, but it is the third layer — after developmental editing and line editing.
+
+## What Copyeditors Check
+
+### Grammar and Mechanics
+- Grammar errors
+- Spelling errors (including proper nouns, place names, technical terms)
+- Punctuation consistency and correctness
+- Capitalisation consistency (especially titles, proper nouns, and technical terms)
+- Number style (spelled out vs. numerals, consistency)
+- Hyphenation consistency
+
+### Internal Consistency
+This is one of the copyeditor's most valuable functions — catching contradictions the author and previous editors missed:
+- **Character names** — spelled the same way throughout? Not accidentally changed?
+- **Physical descriptions** — blue eyes in chapter 3, brown eyes in chapter 17?
+- **Timeline** — events in the right order? Days of the week matching dates? Seasons matching months?
+- **Geography** — distances, directions, and locations consistent?
+- **Facts** — where checkable, are factual claims accurate?
+- **Style sheet** — maintaining a running record of decisions made (spellings, capitalizations, hyphenations) and applying them consistently
+
+### Good Expression
+Copyeditors also flag:
+- Awkward constructions that line editing should have caught
+- Unclear antecedents ("She told her that she..." — who told whom?)
+- Misused words (affect/effect, lay/lie, fewer/less)
+- Jargon that may need explanation for the intended audience
+- Sentences that are technically correct but confusing
+
+## Copyediting vs. Line Editing
+
+| Aspect | Copyediting | Line Editing |
+|--------|------------|-------------|
+| **Focus** | Correctness and consistency | Clarity, flow, and impact |
+| **Scale** | Word and sentence | Sentence and paragraph |
+| **Authority** | Follows style guide | Uses judgment |
+| **Author contact** | Usually indirect (through managing editor) | Usually direct |
+| **Structural changes** | No | Sometimes |
+
+Good copyeditors frequently do the line editing that the acquiring editor should have done — a reality of the industry, though a source of professional tension.
+
+## Style Guides
+
+Professional copyeditors work from a style guide, most commonly:
+- **Chicago Manual of Style** — the standard for most book publishing
+- **AP Stylebook** — standard for journalism and some nonfiction
+- **Publisher-specific variants** — house style that modifies the base guide
+
+The copyeditor applies house style consistently and queries anything that deviates without apparent reason.
+
+## The Value of Copyediting
+
+Sloppy published books undermine the credibility of authors and publishers. In a competitive environment, poorly presented manuscripts may never receive the reading they deserve.
+
+Copyediting is not optional, even for self-published work. Authors cannot see their own errors — familiarity creates blind spots that are precisely what an outside reader can address.
+
+## Self-Copyediting Techniques
+
+For writers who must do their own copyediting (knowing it is no substitute for professional work):
+
+1. **Leave time between writing and copyediting** — the longer the better
+2. **Read on a different medium** — if you wrote on screen, print and read on paper
+3. **Read backwards** — sentence by sentence, from the end to the beginning, to break the flow of expectation
+4. **Read aloud** — forces slower attention and catches awkwardness
+5. **Use a style sheet** — write down every decision (name spellings, capitalizations, style choices) and check against it
+6. **Focus on one type of error per pass** — check spelling in one pass, punctuation in another, consistency in another
+7. **Use spellcheck as a tool, not a substitute** — it catches typos but misses correctly spelled wrong words

package/payload/premium-plugins/writer-craft/references/crafting-persuasive-story.md

@@ -0,0 +1,76 @@
+# Crafting the Persuasive Story
+
+## Specificity Creates Meaning
+
+The general is a category; the specific is the thing being categorised. Specificity is what creates meaning and emotional resonance.
+
+### Summary Is Not Story
+"Hazel gets on her bike and rides to work, arriving energised and ready to nail her presentation" — this is a plot summary. It triggers no dopamine, cortisol, or oxytocin because there is no internal struggle, no hard choice, no escalating stakes.
+
+Effective storytelling puts the audience inside the experience. Every specific detail does two things: makes the world visible and carries meaning.
+
+### The Two Rules of Detail
+1. **Concrete** — the reader can picture it
+2. **Meaningful** — it carries significance beyond itself
+
+"Our friends were very supportive" is noise. "The church neighbours brought covered dishes" is a world — it reveals tribe, community, values, and the weight of collective care.
+
+### Finding the Right Details
+Not every concrete detail is the right one. The details you choose must concretise your meaning. A supermarket's rows of Jell-O Pudding Pops became the symbol of Western abundance for a Soviet politician — because the mundane specificity created a juxtaposition (Cold War geopolitics meets frozen snacks) more powerful than any abstract statement.
+
+## The Core Conflict Structure
+
+### Dual-Layer Structure
+- **External conflict** — the unavoidable problem the protagonist must tackle
+- **Internal conflict** — the misbelief versus the truth
+
+The external conflict is what happens. The internal conflict is why we care. Without internal conflict, there's no story — just events. Without external conflict, the internal struggle has nothing to act on.
+
+### Building the Story
+
+**Setup Questions:**
+1. Who, exactly, is my protagonist?
+2. What does my protagonist want at the start?
+3. What specific event today could fulfil or threaten that desire?
+4. What external problem will stand in the way, and how does it force the protagonist to confront their misbelief?
+
+### The If-Then-Therefore Chain
+Your story's cause-and-effect trajectory must be believable at two levels:
+- Physically possible
+- Emotionally and psychologically true to the protagonist's logic
+
+Each twist must raise the stakes. The Rule of Threes: two failed attempts, then the breakthrough.
+
+**Twist structure:**
+- **Twist 1:** Easiest option exhausted; stakes unchanged
+- **Twist 2:** Stakes escalate dramatically; the cost of failure increases
+- **Twist 3:** With nothing left to lose, the protagonist must act from their authentic self
+
+## Where Your Story Begins
+
+Three questions determine the starting point:
+1. What makes this day different from any other day for my protagonist?
+2. What's at stake for them because of it?
+3. How can I telegraph that to the audience as efficiently as possible?
+
+## The Aha Moment
+
+### Anatomy
+The protagonist's moment of realisation is the point of the story. It must:
+- Come at the last possible moment (when failure is imminent)
+- Belong to the protagonist (no external saviour)
+- Be transparent (the audience sees why they changed)
+- Be liberating (the protagonist is freed to act authentically)
+
+### The Story Must End Here
+Don't add a coda showing the outcome. The emotional transformation is the ending. Everything after dilutes it.
+
+## Story and Responsibility
+
+### Story Can Be Weaponised
+Stories persuade by bypassing the analytical brain. This mechanism works for good and for manipulation. Falsehoods are often more novel than truths — and novelty triggers dopamine.
+
+Those who don't learn to harness story will fall victim to it. Understanding how story works in your own cognition and in the communications of others is a form of sovereignty.
+
+### The Ethical Imperative
+The power comes with responsibility. Once you understand your audience's story — not your version of it, but theirs — you cease to be an adversary and become an ally. You're not trying to change them; you're showing them a version of themselves they already want to be.

package/payload/premium-plugins/writer-craft/references/developmental-editing.md

@@ -0,0 +1,85 @@
+# Developmental Editing
+
+## What Developmental Editing Is
+
+The big picture. Structure, pacing, argument, character development, narrative arc. The editor reads the complete first draft and writes a detailed editorial letter addressing large-scale issues.
+
+This is intellectually the most demanding phase of editing. It requires holding the entire book in mind while diagnosing weaknesses and imagining solutions. Three qualities are required that cannot be taught: judgment, taste, and empathy.
+
+## What Developmental Editors Look For
+
+### Structure
+- Is the book's organising principle clear? Does the reader understand why chapters appear in this order?
+- Does the structure serve the material, or is material forced into an ill-fitting structure?
+- Are there structural alternatives that would serve the story or argument better?
+- In fiction: does the plot structure arise from character, or is it imposed from a template?
+- In nonfiction: does the argument build logically? Are there structural gaps?
+
+### Pacing
+- Are there sections that drag — where the reader's interest would flag?
+- Are there sections that rush — where the reader needs more space to absorb what's happening?
+- Is the ratio of scene to summary appropriate? (Too much summary reads as thin; too much scene reads as slow)
+- Do chapters and sections end at points that propel the reader forward?
+
+### Character (Fiction)
+- Is the protagonist's internal arc driving the plot?
+- Is the protagonist active or passive? (Passive protagonists kill momentum)
+- Do secondary characters have their own internal lives, or are they functional props?
+- Are subplots connected to the main story, or floating independently?
+- Is the protagonist changing through the course of the story?
+
+### Argument (Nonfiction)
+- Is the central argument stated clearly and early enough?
+- Does each chapter advance the argument?
+- Are there logical gaps — places where the evidence doesn't support the claim?
+- Is the author making claims beyond what their evidence warrants?
+- Does the book need material it doesn't have? Does it have material it doesn't need?
+
+### Missing and Surplus
+- Is anything missing that should be there? A scene the reader needs, a chapter that would strengthen the argument, a character whose absence creates a hole?
+- Is anything present that should be cut? A subplot that goes nowhere, a chapter that repeats what an earlier chapter established, a character who doesn't contribute?
+
+## The Editorial Letter
+
+### Structure of an Effective Editorial Letter
+
+1. **Open with genuine, specific praise.** Not flattery — identify what the writer is doing well and name it precisely. This is not just kindness; it protects the writer's confidence and helps them understand their strengths.
+
+2. **Address structural issues in order of importance.** Start with the biggest issue — the one that, if solved, would most transform the book.
+
+3. **Propose solutions constructively.** Frame as "what if" rather than "you must." Offer possibilities rather than commands. Multiple options are better than a single prescription.
+
+4. **Maintain the author's ownership.** The book belongs to the author. The editor's job is to help them write the best version of their book, not to rewrite it as the editor's book.
+
+### Tone
+- Honest without being harsh
+- Specific without being pedantic
+- Constructive without being condescending
+- The editor must hold two perspectives simultaneously: the author's creative vision and the reader's experience
+
+## The Acquiring Editor vs. the Specialist Developmental Editor
+
+**Acquiring editor**: Usually does developmental work on a proposal or partial draft, allowing early shaping. Their relationship with the author often spans the entire lifecycle of the book.
+
+**Specialist developmental editor**: Usually brought in when a completed manuscript has serious structural problems. They may not have a prior relationship with the author.
+
+Both require the same three assets:
+1. **Subject expertise** — understanding where the author is coming from
+2. **Market knowledge** — understanding what the target audience needs
+3. **Tenacity and tact** — navigating conflict when author preferences and audience needs diverge
+
+## Common Developmental Problems
+
+### In Fiction
+- Plot without internal story — things happen but they don't mean anything to the protagonist
+- Passive protagonist — the main character reacts to events instead of driving them
+- Sagging middle — the first act is compelling, the third act is dramatic, but the middle meanders
+- Disconnected subplots — storylines that don't affect the main narrative
+- Resolution without escalation — the climax isn't earned because the complications didn't build
+
+### In Nonfiction
+- Interesting content without a compelling concept — facts and ideas without an organising argument
+- Excessive reliance on sources without authorial synthesis — the author curates but doesn't think
+- Failure to explain why the subject matters beyond its own confines
+- The "dissertation problem" — a book written to demonstrate knowledge rather than communicate it
+- Scope creep — the book tries to cover everything instead of making one argument well

package/payload/premium-plugins/writer-craft/references/genre-specific-editing.md

@@ -0,0 +1,78 @@
+# Genre-Specific Editing Considerations
+
+## Literary Fiction
+
+**Core principle:** Form and content are inseparable. Meaning emerges through the relationship between what is said and how it is said.
+
+**Editorial approach:**
+- Be deeply attuned to prose at the sentence level while holding structural and thematic architecture in mind
+- Resist the temptation to impose your own aesthetic — literary sensibility is not literary taste
+- Serve the author's vision. The most damaging interventions make a book sound more like the editor
+- Look for: narrative voice, thematic coherence, prose rhythm, structural innovation, emotional depth
+- Be willing to read slowly and repeatedly — literary fiction rewards and demands attention
+
+**Economic reality:** Literary fiction rarely produces large commercial returns. Editors who publish it must either work at a house whose mission supports it or cross-subsidise with more commercial titles.
+
+## Genre Fiction (Romance, Mystery, SF/Fantasy, Thriller)
+
+**Core principle:** Must entertain. Boredom is the cardinal sin. Genre fiction competes not just with other books but with every form of leisure.
+
+**Editorial approach:**
+- Readers don't just follow the protagonist — they become them. Character identification drives engagement.
+- Know the genre deeply. Genre readers have sophisticated expectations; meeting them is craft, not formula.
+- Each genre has specific requirements:
+  - **Romance:** Emotional tension and satisfying resolution
+  - **Mystery:** Fair-play plotting, misdirection, satisfying revelation
+  - **SF/Fantasy:** Internally consistent world-building
+  - **Thriller:** Pacing, stakes, escalation
+- The distinction between "genre" and "literary" is increasingly meaningless. Genre fiction frequently crosses into literary territory.
+
+## General Nonfiction
+
+**Core principle:** Must be persuasive — carry the reader along as a good dinner-table story carries its audience.
+
+**Editorial approach:**
+- The most useful marginal comment: "I'm bored here"
+- Watch for: drive, richness, economy, clarity, and shape
+- Flag repetition, excessive detail, and passages where the author assumes knowledge the reader doesn't have
+- The editor represents the non-expert reader. Deep knowledge is the author's greatest asset but can lead to skipping steps or dwelling on specialist detail.
+- Nonfiction must offer a journey — the promise that with the author's guidance, the reader will see something new and be changed.
+
+## Memoir and Biography
+
+### Memoir
+**Core principle:** The author's subjectivity is a feature, not a problem. Memoir is a life examined from the inside.
+
+**Editorial approach:**
+- The story must impose narrative shape on messy chronology
+- Not everything that happened belongs in the book — selection is craft
+- The memoirist must answer: why does this story matter beyond my own life?
+- Voice is paramount — the reader is investing in a relationship with the narrator
+
+### Biography
+**Core principle:** A life examined from the outside, with the apparatus of research and verification.
+
+**Editorial approach:**
+- Two opening questions: Why does this life matter? And to whom?
+- Watch for: excessive reliance on sources without authorial synthesis, inability to distinguish important from merely interesting, reluctance to draw conclusions the evidence supports
+- Be sceptical of the "there's never been a biography of X" pitch — usually there's a reason
+- What makes a life book-worthy is not novelty but resonance: the capacity to illuminate something beyond itself
+
+## Children's and Young Adult
+
+**Core principle:** Audience awareness. What a toddler needs is entirely different from what a ten-year-old needs, which is entirely different from what a teenager needs.
+
+**Editorial approach:**
+- Constantly ask: is this appropriate, comprehensible, and engaging for the intended reader?
+- Picture books demand that text and images work together, not duplicate each other — the editor must leave room for the illustrator
+- Children read for the story, not the commentary. They don't theorise. When bored, they simply stop reading.
+- This radical honesty should discipline editors in every category.
+
+## Scholarly Nonfiction
+
+**Core principle:** First, do no harm. Scholarly authors have invested years in preparation. Improve without distorting.
+
+**Editorial approach:**
+- Common problems: excessive citation burying the author's voice, jargon signalling insider status at the expense of accessibility, excessive length from reluctance to cut research, structural problems from converting a dissertation to a book
+- Help authors step back from their material, find their argument, and present it with economy and clarity — without losing rigour
+- A dissertation demonstrates knowledge. A book communicates it. The editor helps make the transition.

package/payload/premium-plugins/writer-craft/references/hooking-readers.md

@@ -0,0 +1,67 @@
+# Hooking Readers from Page One
+
+## The Brain's Survival Filter
+
+The brain is bombarded with 11 million bits of sensory data per second. It consciously processes approximately forty. The cognitive unconscious ruthlessly filters out everything that doesn't matter for survival. Story bypasses this filter because it speaks the brain's native language for evaluating threats, opportunities, and social dynamics.
+
+## What Readers Hunt for on Page One
+
+### 1. Whose Story Is It?
+The protagonist must appear immediately. Readers need a surrogate — someone through whose eyes they will experience everything. Without this anchor, the reader has no reason to care about anything that happens.
+
+### 2. What's Happening Here?
+Something must already be in motion. Not the preamble to the ball — the ball itself. Not the character waking up and having breakfast before something interesting happens. The interesting thing is already happening when we arrive.
+
+### 3. What's at Stake?
+Conflict specific to the protagonist's quest must be visible from the opening. The reader must sense that something matters — that something can be gained or lost.
+
+## Dopamine and the Forward Pull
+
+When the brain senses that significant information is incoming, it releases dopamine — the anticipation neurochemical. This is what makes readers compelled to turn pages. The first sentence must trigger this response.
+
+The tool is not beautiful language. It is the suggestion that something is already wrong and about to get worse.
+
+### The Elizabeth George Example
+"Joel Campbell, eleven years old at the time, began his descent into murder with a bus ride."
+
+In a single sentence:
+- Protagonist identified (Joel Campbell)
+- Something happening (a bus ride)
+- Stakes visible (descent into murder)
+- Yardstick for the entire novel established
+- Dopamine circuit fired (how does a bus ride lead to murder?)
+
+## The Beautiful Writing Myth
+
+Storytelling always trumps beautiful writing. Dan Brown's prose is widely mocked, but The Da Vinci Code works because from page one the reader desperately wants to know what happens next. Beautiful writing is gravy. Story is the meal.
+
+This does not mean prose doesn't matter — it matters enormously. But prose in service of story creates engagement. Beautiful prose without story creates admiration that quickly fades.
+
+## The Story Yardstick
+
+Page one should establish a "yardstick" — a framework that helps the reader evaluate everything that follows. The reader should begin to understand:
+- What kind of story this is
+- What question will drive the narrative
+- Roughly what the stakes are
+- What world they're entering
+
+This doesn't mean spelling everything out. It means planting enough for the reader's pattern-recognition engine to start building expectations.
+
+## Page One Diagnostic Checklist
+
+- [ ] Is there a protagonist present from the first page?
+- [ ] Is something already happening that affects the protagonist?
+- [ ] Is there conflict with a direct impact on the protagonist's quest?
+- [ ] Is something at stake — something that can be gained or lost?
+- [ ] Can the reader glimpse the "big picture" — the yardstick?
+- [ ] Does the first sentence suggest something is wrong or about to go wrong?
+- [ ] Would a reader who knows nothing about this book want to read page two?
+
+## Common Opening Failures
+
+1. **The weather opening** — beginning with atmospheric description before introducing a character or conflict
+2. **The alarm clock opening** — the character wakes up and goes through their morning routine
+3. **The information dump** — pages of world-building or backstory before the story begins
+4. **The action without context** — explosions and car chases with no character to care about
+5. **The philosophical meditation** — the author musing about life before getting to the point
+6. **Starting too early** — the story begins before the interesting thing, not at the moment it arrives

package/payload/premium-plugins/writer-craft/references/indirect-narration.md

@@ -0,0 +1,72 @@
+# Indirect Narration and Polyphony
+
+## Beyond Direct Scene
+
+Not all storytelling is direct scene and action. Indirect narration encompasses all the ways a story communicates information, creates meaning, and builds its world without putting characters in a room together.
+
+### Story vs. Plot vs. Action
+- **Plot** is a device — a marvellous one — but not superior to story, and not necessary
+- **Action** must be present (something must change, something must move), but unceasing violent action is usually a sign that no story is being told
+- **Story** is broader than both — it is a narrative of events (external or psychological) that moves through time and involves change
+
+Some great stories have no conventional plot. The story is not in the plot but in the telling. It is the telling that moves.
+
+## Exposition: The Lump Problem
+
+### What Exposition Is
+Necessary information the reader needs to understand the story: world-building, backstory, technical details, historical context, character history. Every story requires some exposition.
+
+### The Expository Lump
+Information delivered as a block — a lecture from the author to the reader, pausing the story to explain. Science fiction writers are acutely aware of this problem because they must build entire worlds from scratch. But it appears in every genre.
+
+### Signs of an Expository Lump
+- The story stops while information is delivered
+- A character explains something they have no reason to explain to the person they're explaining it to ("As you know, Bob...")
+- A paragraph or passage exists purely to inform the reader, with no connection to the character's emotional experience
+- The narrative voice shifts from storytelling to lecturing
+
+### The Solution
+Break up the information. Grind it fine. Make it into bricks to build the story with.
+
+Techniques:
+- **Distribute across scenes** — deliver information only when the story needs it, not all at once
+- **Embed in action** — the character discovers the information as part of what they're doing
+- **Embed in dialogue** — characters discuss things they would naturally discuss, revealing information organically
+- **Embed in perception** — what the character notices and how they interpret it carries information about the world
+- **The TK method** — mark places where information is needed (TK = "to come") and return to integrate it later, when you know more about what the reader needs and when
+
+### The Goal
+Invisible exposition — information the reader absorbs without noticing they're being informed. The reader should feel they understand the world because they've been living in it, not because someone explained it.
+
+## Polyphony
+
+### Many-Voicedness
+The novel is inherently polyphonic — it contains many voices. Writers must be willing to let characters speak in their own voices, not as mouthpieces for the author.
+
+### What Polyphony Requires
+- Each character has their own vocabulary, rhythm, preoccupations, and blind spots
+- Dialogue should be distinguishable — the reader should often be able to identify who is speaking without attribution
+- Characters should be capable of surprising the author — if every character agrees with the author on every topic, the novel is a monologue wearing masks
+- Inhabit your characters — let them be themselves, even when they think and say things you disagree with
+
+### The Danger of Monophony
+When all characters sound alike — when the author's voice drowns out every character's individuality — the novel loses dimensionality. Every conversation becomes the author arguing with themselves.
+
+## Character by Indirection
+
+### Describing a Place to Reveal a Person
+A room, a desk, a garden — described when the character is absent — can reveal more about them than any direct characterisation. What they own, how they arrange their space, what's worn and what's pristine, what's hidden and what's displayed.
+
+### Describing an Aftermath to Reveal an Event
+The place where something happened, described after it happened, lets the reader reconstruct the event from evidence. This is more powerful than showing the event directly, because the reader's imagination fills in the gaps — and what the reader imagines is always more vivid than what you describe.
+
+### The Untold Event
+A glimpse of the mood and nature of an event by describing the place where it happened or is about to happen. The empty room after the party. The battlefield before dawn. The courtroom after the verdict.
+
+## Focus and Trajectory
+
+Every story needs:
+- **Focus** — what and who it is about, explicit or implicit
+- **Trajectory** — "the shape of a movement that never ceases, from which no passage departs entirely or for long, and to which all passages contribute in some way"
+
+The story knows its course. The writer's job is to be ready for it — to have the skills and self-discipline to follow where the story wants to go.

package/payload/premium-plugins/writer-craft/references/inner-issue-and-protagonist-goal.md

@@ -0,0 +1,66 @@
+# The Inner Issue and Protagonist Goal — Wired for Story
+
+## The Neuroscience of Internal Story
+
+The brain processes story as a survival simulation. Readers track what happens inside the protagonist's mind, not what happens around them. Neuroscientist Steven Brown (McMaster University): even when reading news headlines, the brain immediately activates the "mentalizing network" — the neural system used to make inferences about other people's beliefs, desires, and emotions.
+
+Story is an internal journey. Plot is the vehicle. What the reader really wants to experience is how the protagonist changes.
+
+## The Protagonist's Inner Issue
+
+Every protagonist carries a specific misbelief about the world, formed in response to a past wound. This is not a character flaw — it is a worldview, a lens that distorts everything the protagonist sees.
+
+### The Brain Defends Its Models
+Being wrong feels exactly like being right. The brain defends its existing models with great tenacity. This is why genuine change is so costly — and why the story must put the protagonist under enough pressure to make change unavoidable.
+
+### When the Story Begins
+The story begins the moment the protagonist is forced to take action they have previously managed to avoid. Something changes — a ticking clock starts. The protagonist can no longer maintain the comfortable, if dysfunctional, equilibrium built around their misbelief.
+
+### The Inner Issue Must Be Traceable
+The protagonist's inner issue must have a specific origin — a defining experience in the past. The writer must know this origin intimately, even if the reader learns it gradually. Without it, the character's reactions feel arbitrary. With it, every reaction becomes inevitable.
+
+## The Protagonist's Goal
+
+### External Goal vs. Internal Goal
+- **External goal**: the concrete objective (win the case, escape the island, save the marriage)
+- **Internal goal**: what achieving the external goal means — what hole in the self it is meant to fill
+
+The internal goal is what the story is actually about. The external goal is the mechanism that forces the protagonist to confront the internal one. Both must be present, and they must be in tension.
+
+### Agenda-Reading
+From birth, the brain dedicates enormous resources to understanding what other people want and why — survival in a social species depends on it. When readers enter a story, they apply this machinery to the protagonist. They need to know: what does this person want? The moment they know, they begin tracking every event against that question.
+
+A protagonist without a clear goal gives the reader nothing to track. Events may happen, but they don't mean anything.
+
+### Goal Without Motivation Is Hollow
+Readers need to know not just what the protagonist wants but why — specifically, what fear, wound, or belief has created this need. The more precisely the writer understands the motivation, the more precisely every plot event can be calibrated to test it.
+
+## The Protagonist Must React to Everything
+
+Every event must register emotionally in the protagonist. If a character witnesses something terrible and doesn't react, the reader's mirror neurons have nothing to latch onto — meaning collapses.
+
+### Mirror Neurons
+We are wired to mirror the emotional states of others. When we observe someone in pain or joy, the same neural circuits fire. Story exploits this to create genuine emotional experience from imaginary events. Reader emotion is not a bonus — it is the mechanism by which the story communicates.
+
+### Two Common Failures
+1. **Describing events without emotional response** — leaving the reader in a vacuum of meaning
+2. **Editorialising** — telling the reader what to feel rather than showing it through the protagonist's specific reaction
+
+### Body Language as Subtext
+The protagonist's physical response communicates what the character might never say directly. Humans instinctively read micro-expressions, posture, and gesture as signals of hidden truth. Deploy this same instinct in fiction.
+
+## Everything Is Goal-Directed
+
+### The Story Question
+Every story has a central question that the reader tracks from beginning to end: will the protagonist achieve their goal? Everything in the story must relate to this question. Scenes, characters, subplots, and details that don't serve the story question drain attention rather than building it.
+
+### Theme, Plot, and Inner Issue
+Three elements must interlock:
+- **Theme** — the story's point about human nature
+- **Plot** — external events that test the protagonist
+- **Inner issue** — the protagonist's specific internal flaw being challenged
+
+These are not separate tracks. They are the same track viewed from different angles. The plot forces the protagonist to confront their inner issue. The theme is reflected in how the world treats them.
+
+### The "And So?" Test
+For every scene, every detail — ask "And so?" What does this lead to? If you can't answer, the element is probably serving the writer's interests (it's interesting, it's well-written) rather than the story's needs.