@rubytech/create-siteoffice-code 0.1.256

package/payload/premium-plugins/writer-craft/skills/persuasive-storytelling/references/audience-analysis.md

@@ -0,0 +1,73 @@
+# Audience Analysis and Finding Real Resistance
+
+## Who Your Audience Is Not
+
+### Not You
+We instinctively assume our audience shares our priorities and will respond to the same arguments that move us. They won't. Your audience doesn't care why you think they should act — they care how the action fits their self-narrative.
+
+### Not Everyone
+Trying to reach everyone produces toothless messaging. Different groups have entirely different misbeliefs. A story can only target one. The energy spent avoiding offence is energy stolen from the story's power.
+
+**Example:** Conservatives buy energy-efficient light bulbs when the message is about money saved. They reject the same product labelled "protect the environment." Different tribes, different misbeliefs, different stories needed.
+
+## Defining Your Call to Action
+
+The call to action must be:
+- **Concrete** — not "think deeply about the issues" but a specific, observable action
+- **Specific** — what exactly will they do, when, where, how?
+- **Actionable** — something they can actually do immediately
+
+List every possible call to action, then select the one that best matches your audience's current worldview.
+
+## Researching Your Audience
+
+### Three Grounding Questions
+1. How will your call to action benefit your audience based on their specific worldview?
+2. What beliefs do they hold that you'll be butting up against?
+3. How will the change you want help them become their most authentic self?
+
+### Research Methods
+
+**Digital fieldwork:** Social media reveals tribal affiliations, fears, aspirations, and self-image. Look at what they post, share, follow, comment on, and avoid. You're looking for why, not what.
+
+**Physical fieldwork:** Go where your audience congregates. Observe. Listen. T-shirt slogans, purchases, body language, and conversations reveal their story.
+
+### Key Questions
+- What matters most to them right now?
+- What do they aspire to be?
+- What do they fear?
+- What would they have to give up to follow your call to action?
+- What internal (emotional) cost would that trade carry?
+
+## Finding the Real Resistance
+
+### Surface vs. Real Resistance
+The stated reason for not adopting a behaviour is almost never the real reason. People don't know their own misbeliefs, or admitting the real reason feels too vulnerable.
+
+**The General Mills Cake Mix Case:** In 1947, instant cake mixes sat unsold despite being cheap, fast, and easy. Market research said the problem was time. Psychologists revealed the real issue: homemakers felt they'd contributed nothing. They felt guilty calling it "homemade." The fix: remove the powdered eggs and require the baker to add a fresh one. Sales exploded. Same cake; the baker now had a hand in it.
+
+### The Drilling Technique: "Why?" and "And So?"
+Start with the surface behaviour and keep asking "why" or "and so?" until you reach the emotional core.
+
+**Example: Teenager texting while driving**
+- "It's safe, I'm good at multitasking" → surface rationalization
+- "I need to reply quickly or they'll think I don't care" → social anxiety
+- "If they think I don't care, they'll text someone else" → fear of exclusion
+- "If Becky texts Malik instead, I'll lose her" → fear of abandonment and unworthiness
+
+This isn't about driving. It's about belonging. No amount of crash statistics addresses that.
+
+### The Real Resistance Is Always Emotional
+The universal tension: what I want versus what's expected of me — fitting in (hiding who you are) vs. belonging (being loved for who you are).
+
+Your story must show the audience that your call to action is not a sacrifice of self — it is an act of becoming more themselves.
+
+## What They Have to Give Up
+
+Every call to action asks the audience not just to gain something but to give up something they're already doing. Identify it precisely. Understand what it means to them emotionally. You are not asking for a behaviour change — you are asking for an identity shift.
+
+## Visualising Your Audience
+
+Stop thinking in demographics. Close your eyes: who is the one person who represents your target audience? Give them a name, a day, a life. This person will become your story's protagonist.
+
+**The Motrin Failure:** In 2008, Motrin launched an ad targeting baby-wearing moms that characterised the practice as a fashion statement. Baby-wearing moms did it to bond with their children. The ad was written by people who had never worn their babies. The backlash was swift. Lesson: if you don't understand the internal meaning your audience assigns to what they do, you will inadvertently attack their identity.

package/payload/premium-plugins/writer-craft/skills/persuasive-storytelling/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/skills/persuasive-storytelling/references/persuasion-case-studies.md

@@ -0,0 +1,67 @@
+# Persuasion Case Studies
+
+## Immortal Fans — SC Recife (Brazil, 2013)
+
+**Problem:** Critical shortage of organ donors in Brazil.
+**Audience:** Passionate football fans of Sport Club Recife.
+**Misbelief:** Organ donation is morbid and irrelevant to my life.
+**Approach:** Tapped into fans' single most consuming passion — love for the club. "What if your organs could keep rooting for SC Recife after you're gone?" Cards carrying organ donor pledges became badges of tribal loyalty.
+**Key mechanism:** Spoke to the audience's self-narrative rather than threatening it.
+**Results:** 51,000 donor cards issued. Organ donations rose 54%. Transplant waiting lists hit zero for the first time.
+
+## Always #LikeAGirl (2014)
+
+**Problem:** Always needed to connect with a new generation of girls. Over 80% of girls had a negative association with "like a girl."
+**Misbelief:** Doing something "like a girl" means doing it poorly.
+**Approach:** Director asked teens to demonstrate running/fighting/throwing "like a girl." They mimed weakness. Then asked a 10-year-old — she ran flat out. Younger girls did the same. The contrast unfolded in real time. No one was told what to think.
+**Realization:** A teenage boy, asked if he'd insulted his sister, stopped cold: his sister is a girl.
+**Transformation:** A teenage girl asked to "run like a girl" again ran like herself — fast, focused, determined.
+**Results:** Positive association with "like a girl" rose from 19% to 76%. Two-thirds of men said they'd think twice. Most-shared Super Bowl ad of 2015. UN award for impact on female empowerment.
+
+## Motel 6 / Tom Bodett
+
+**Problem:** Nobody wanted to admit staying at Motel 6, even though everyone in the focus group had.
+**Misbelief:** Staying at Motel 6 signals you're poor or stingy.
+**Research insight:** One woman said: "If it's late at night, I'll stay. And the money I save, I can spend on a tank of gas." Others echoed her. The shame transformed into pride. They weren't cheap — they were frugal.
+**Truth:** Staying at Motel 6 means you're smart with money and spend it on what matters.
+**Tagline (ad-libbed by Tom Bodett):** "We'll leave the light on for you."
+**Why it worked:** Offered what every weary traveller needs — the feeling that someone sees you, knows what you're going through, and is on your side.
+**Results:** 30 consecutive years of growth. Consistently rated best value in economy lodging.
+
+## Extra Gum — "The Story of Sarah & Juan" (2015)
+
+**Misbelief:** Gum is trivial, a throwaway.
+**Approach:** A couple's relationship across a decade, catalogued through gum wrappers Juan saves, each with a tiny sketch. At the end, framed in a gallery. The last sketch shows him on one knee.
+**Point:** Even the smallest, most ordinary moments can be the glue of a lasting love.
+**Emotion:** Unexpected joy; the tenderness of being truly seen.
+**Results:** 78 million Facebook views. 1.1 million shares in one week.
+
+## WATERisLIFE — Nkaitole's Bucket List
+
+**Problem:** Children dying from unsafe water in Kenya — abstract statistics nobody acts on.
+**Approach:** Told the story of Nkaitole, a 4-year-old with a 1-in-5 chance of dying before age five. Helped him complete a bucket list: ride a boat, play football, fly in a plane, see the ocean.
+**Key mechanism:** The audience is the implied protagonist — we have what Nkaitole lacks: the power to donate. Statistics would have remained abstract. The specificity of one child made it unbearable not to act.
+
+## Teen Driver — Noah DeVico (PSA)
+
+**Misbelief:** I have to reply immediately or I'll lose Becky to Malik — belonging is worth the risk.
+**Approach:** Instead of crash footage (fear → paralysis), built a story around a girl driving with her dog. She's giggling at her phone; the dog stares at her. A small huff breaks the spell. She puts the phone in the glove box.
+**Point:** Caring for your loved ones is worth more than staying in the loop.
+**Key emotion:** Unconditional love (the dog), not fear.
+**Why it worked:** By giving the protagonist agency — the choice is hers, not forced — the story activated the brain's reward circuitry. Autonomous choice makes the story one of triumph, not cautionary tale.
+
+## Lynda.com
+
+**Background:** In 1995, Lynda Weinman wrote a web design textbook in a friendly, story-based style for art school students intimidated by technology. Her publisher rewrote it to match their technical-manual house style.
+**The Aha moment:** She called on a Monday: "I consider this a rejection of my work." She exercised her contract clause and demanded her rights back.
+**Results:** Published in original form. First industry textbook of its kind. Over one million copies sold. Translated into 12 languages. In 2015, LinkedIn bought Lynda.com for $1.5 billion.
+**The lesson:** The book's value came precisely from what the publisher tried to eliminate — its humanity, accessibility, and trust in the reader. Vulnerability was the path to reaching her audience.
+
+## Common Patterns Across Case Studies
+
+1. **None led with facts or statistics.** All led with story.
+2. **All identified the audience's specific misbelief** — not the logical objection, the emotional one.
+3. **All spoke to the audience's self-narrative** rather than threatening it.
+4. **All gave the protagonist agency** — the transformation was chosen, not forced.
+5. **All used specificity** — one person, one moment, one concrete detail — rather than abstractions.
+6. **All ended at the transformation** — no lingering codas or explicit moralising.

package/payload/premium-plugins/writer-craft/skills/persuasive-storytelling/references/transformation-framework.md

@@ -0,0 +1,86 @@
+# The Four-Stage Transformation Framework
+
+## The Template
+
+Every persuasive story moves through four stages:
+
+### Stage 1: Misbelief
+The erroneous belief your audience holds that prevents them from heeding your call to action.
+
+**How to identify it:**
+- It is not what they say their reason is — it's the emotional core beneath the surface
+- It is often a belief they are not consciously aware of holding
+- It is usually connected to identity, belonging, or self-worth
+- It was formed through experience, not logic — which is why logic can't dislodge it
+
+**Requirements:**
+- Must be specific — not "they don't care about the environment" but "they believe that environmental action requires sacrifice that marks them as different from their tribe"
+- Must be empathetically understood — you must see why this belief makes sense from inside their worldview
+- Must be something your story can actually address
+
+### Stage 2: Truth
+What the story's events will reveal as actually true. This is not your logical argument — it is the emotional reality your story will make the audience experience.
+
+**The distinction:**
+- Your logical point: what you believe the evidence shows
+- Your story's truth: what will resonate with the audience's emotional logic and uproot their misbelief
+
+These may be very different. The story's truth must be stated in terms the audience would use, not in terms you would use.
+
+### Stage 3: Realization
+The moment the protagonist (and by extension, the audience) sees the misbelief for what it is. This is the pivot of the entire story.
+
+**Four conditions for an effective realization:**
+
+1. **Timing** — Must come at the absolute last second, when all other options are exhausted and failure is imminent. Early realizations reduce stakes and satisfaction.
+
+2. **Agency** — The protagonist must make the discovery themselves. No one can hand it to them. If a mentor or saviour delivers the insight, the audience is denied the vicarious triumph.
+
+3. **Transparency** — The audience must understand why the protagonist changes their mind — not just that they do. The penny must be seen to drop. Without the "because," the realization has no instructive value.
+
+4. **Liberation** — The misbelief is shed. The protagonist is freer, more authentically themselves, capable of acting.
+
+### Stage 4: Transformation
+The protagonist is freed from the misbelief and can now act. The audience, having vicariously lived the experience, is freed too.
+
+**End at the transformation.** Do not add a coda showing the aftermath. The emotional transformation is the story's end. Everything after dilutes it.
+
+## The Point
+
+### One Story, One Point
+Every story must make exactly one point. Multiple points muddy the waters.
+
+### The Formula
+1. Changing how your audience **feels** about something...
+2. ...changes how they **see** something...
+3. ...which makes them want to **do** something
+
+### The Point Is Never Stated Outright
+Story makes its point implicitly — through what the protagonist discovers. The audience draws the conclusion themselves, which is why they believe it.
+
+### Simple vs. Simplistic
+- **Simple** has layers beneath an elegant surface: "Just Do It." "We'll leave the light on."
+- **Simplistic** has no depth: "Be Your Way." "Enjoy Better." "Pork, Be Inspired."
+
+Simple works because it taps into a complex internal narrative the audience already holds. Simplistic doesn't tap into anything.
+
+### The Target Emotion
+The emotion must be specific and fused to the point. Generic fear leads to paralysis or denial. The goal: trigger the specific emotion that reveals why your call to action matters — and then the relief of seeing how to resolve it.
+
+## Story Construction
+
+### Basic Template
+- One protagonist (representing your audience)
+- One specific external problem (not generic — today's problem)
+- Three escalating twists, each raising stakes
+- One "aha" moment meeting all four conditions
+- One ending at the transformation
+
+### The Rule of Threes
+The brain looks for patterns, and the minimum viable pattern is three. Three twists create a satisfying arc: two failed attempts, then the breakthrough. Each must be distinct and must escalate.
+
+### Believability at Two Levels
+1. **Physical** — Does this make physical sense?
+2. **Psychological/emotional** — Does this make sense given who the protagonist is and how their tribe sees the world?
+
+The emotional level is the only one that truly matters. A talking baby (E*TRADE) violates physical believability — but works perfectly because it captures the emotional logic of its target audience.

package/payload/premium-plugins/writer-craft/skills/point-of-view/SKILL.md

@@ -0,0 +1,97 @@
+---
+name: point-of-view
+description: "Guides point of view, narrative voice, tense, person, and indirect narration in fiction and nonfiction. Use this skill whenever the user asks about POV, first person, third person, omniscient narrator, limited third, detached narrator, observer-narrator, narrative voice, tense choice (present vs past), person of the verb, changing viewpoint, POV shifts, unreliable narrator, indirect narration, polyphony, or 'whose head am I in'. Also use when a writer's POV is inconsistent, when diagnosing tense problems, or when helping choose the right narrative perspective for a story."
+---
+
+# Point of View and Voice
+
+Point of view is who tells the story and what their relation to it is. Voice is the sound of the telling. They are so intimately connected as to be the same thing. POV is also the single most common source of unconscious errors in fiction — writers shift viewpoint without knowing they've done it, and readers feel the wobble without being able to name it.
+
+## The Five Principal Points of View
+
+### 1. First Person
+"I" is the viewpoint character, centrally involved. Only what "I" knows, feels, perceives, thinks, guesses, hopes, and remembers can be told. The reader infers others only from what "I" observes.
+
+**Strengths**: Intimacy, voice, immediacy.
+**Dangers**: Can become claustrophobic; tempts the writer to make every character sound the same; limits information delivery.
+
+### 2. Limited Third Person
+"He" or "she" as viewpoint character, with the same essential limitation as first person — nothing is seen or known except what this character sees and knows. Switching from first to limited third is not as simple as changing pronouns; the imaginative energy is different for both writer and reader.
+
+**Strengths**: Intimacy without the constraints of "I"; can shift between characters (with care).
+**Dangers**: Accidental POV slips into other characters' thoughts; one-sentence incursions that break the contract.
+
+### 3. Involved Author (often called "Omniscient")
+No single viewpoint character. The author can enter any character's mind, describe things no character is present to see, make judgments, interpret behaviour. The oldest, most widely used, and most versatile POV — and probably the most difficult for contemporary writers to handle well.
+
+**Strengths**: Maximum flexibility; can provide context no character possesses; allows authorial commentary.
+**Dangers**: Can feel distant; requires a strong, confident authorial voice; easy to handle clumsily.
+
+### 4. Detached Author ("Fly on the Wall")
+No viewpoint character. The narrator reports only what a neutral observer could infer from behaviour and speech, never entering a character's mind. The least overtly but most covertly manipulative POV — everything is controlled by what the narrator chooses to show.
+
+**Strengths**: Creates mystery; forces the reader to interpret; can produce powerful understatement.
+**Dangers**: Emotional coldness; readers may not connect with characters.
+
+### 5. Observer-Narrator
+The narrator is a character but not the principal one — a witness rather than an actor. Available in both first and third person.
+
+**Strengths**: Can observe the protagonist from outside while maintaining a personal voice; creates natural mystery about the protagonist's inner life.
+**Dangers**: The observer can upstage the protagonist; limits access to the protagonist's thoughts.
+
+## Tense
+
+### Past Tense
+Gives continuous access to before and after. Minds move around easily as they normally do. Like sunlight — illuminates everything.
+
+### Present Tense
+Narrower field of vision. Focused on action in a single time and place. Sets up a permanent artificial emergency. Like a narrow-beam flashlight.
+
+Present tense can be exactly right for fast-paced action or a character whose engine runs hot. But many writers use it from fashion rather than choice. If you always write in present tense, some verb forms in your head may not have been activated for a long time.
+
+### Two-Timing
+Switching between past and present tense without awareness or signal is one of the most common and disorienting errors. Every tense shift must be deliberate and serve the story.
+
+## POV Shifts: The Rules
+
+You can change point of view. It is your right as a fiction writer. All that is required: **know that you're doing it**.
+
+The hierarchy of difficulty:
+1. **First ↔ third person** — enormously difficult in a short piece; uncommon even in novels
+2. **Detached ↔ involved author** — essentially impossible within a single piece
+3. **Between viewpoint characters in limited third** — possible but must be handled with awareness
+
+The final rule: you can shift from one viewpoint character to another any time you like, **if** you know why and how, **if** you're cautious about doing it frequently, and **if** you never do it for a moment only. One-sentence POV shifts are always uncomfortable.
+
+## Indirect Narration
+
+Not all storytelling is direct scene and action. Indirect narration includes:
+- **Exposition** — necessary information delivered without dumping it as lectures. Break it up, grind it fine, and make it into bricks to build the story with.
+- **Polyphony** — letting characters speak in their own voices, not as mouthpieces for the author.
+- **Character by indirection** — describing a place to reveal its inhabitant; describing an aftermath to reveal an event.
+
+## POV Diagnostic Checklist
+
+- [ ] Can you name the POV type being used? (first, limited third, involved author, detached, observer)
+- [ ] Is the POV consistent within scenes?
+- [ ] Are there accidental one-sentence slips into another character's thoughts?
+- [ ] Is the tense consistent? Are any shifts deliberate and signaled?
+- [ ] Does the chosen POV serve the story? (Would another POV work better?)
+- [ ] If the protagonist's subjective filter is the POV, does it color everything?
+- [ ] Is exposition integrated into the narrative, or dumped in lectures?
+- [ ] Do secondary characters have their own voices, or do they all sound like the author?
+
+## When to Read Reference Files
+
+- **For detailed POV types and voice guidance** — read `references/pov-types-and-voice.md`
+- **For tense, person, and the passive voice** — read `references/tense-and-person.md`
+- **For indirect narration and polyphony** — read `references/indirect-narration.md`
+- **For the protagonist's subjective filter and emotional POV** — read `references/protagonist-filter.md`
+
+## Exercises to Offer Writers
+
+1. **Points of View** — Devise a situation with several people. Write it five times: limited third (character A), limited third (character B), detached narrator, observer-narrator, involved author. Feel how each changes the story.
+2. **The Old Woman** — An old woman doing a task while thinking about a past event. Version 1: one tense throughout. Version 2: the other person, switching tenses between "now" and "then". Do not search-and-replace pronouns — rewrite, because changing person and tense changes the story.
+3. **Changing Voices** — Write a 300-600 word narrative shifting POV between characters with marked changes. Then rewrite it shifting POV without obvious signals. The ice is thin.
+4. **Pure Dialogue** — Two people in a crisis, written as A and B with no description or stage directions. Everything about character, setting, and situation must emerge from what they say.
+5. **Being the Stranger** — Write from the viewpoint of someone you dislike or find alien. Suspend judgment. Inhabit them. See the world through their eyes.

package/payload/premium-plugins/writer-craft/skills/point-of-view/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/skills/point-of-view/references/pov-types-and-voice.md

@@ -0,0 +1,91 @@
+# POV Types and Voice — Detailed Guide
+
+## The Five Principal Points of View
+
+Each POV is demonstrated below using the same fictional scenario: Princess Sefrid enters a crowded room.
+
+### 1. First Person
+
+"I pushed through the crowd, scanning for Aleth. The heat was unbearable. Someone stepped on my foot — I barely noticed."
+
+**Rules:**
+- Only what "I" knows, feels, perceives, thinks, guesses, hopes, and remembers can be told
+- The reader infers other characters only from what "I" observes
+- Switching from first person to another POV within a piece is enormously difficult
+
+**Strengths:** Maximum intimacy; strong voice; the reader is inside one mind completely
+**Dangers:** Claustrophobia; every character risks sounding like the narrator; information delivery is limited to what the narrator can plausibly know
+
+**Masters to study:** Grace Paley — first-person narration that avoids every pitfall
+
+### 2. Limited Third Person
+
+"Sefrid pushed through the crowd, scanning for Aleth. The heat was unbearable. Someone stepped on her foot — she barely noticed."
+
+**Rules:**
+- Same essential limitation as first person — nothing is seen or known except what this character sees and knows
+- Switching from first to limited third is not just changing pronouns — the imaginative energy is different
+- You can shift between limited-third viewpoint characters, but with care and awareness
+
+**Strengths:** Intimacy without the constraints of "I"; can shift between characters; allows more flexibility in language
+**Dangers:** Accidental one-sentence POV slips into other characters' thoughts; the reader may not notice, but they feel the wobble
+
+### 3. Involved Author (Omniscient)
+
+"Sefrid pushed through the crowd. Aleth, had she known, was already watching from the gallery, nursing a drink and a grievance. Neither woman would leave the room unchanged."
+
+**Rules:**
+- No single viewpoint character — the author can enter any mind, see anything, judge and interpret
+- The author's voice is itself a presence in the narrative
+- Requires confidence — a timid omniscient voice feels intrusive; a confident one feels authoritative
+
+**Strengths:** Maximum flexibility; can provide context no character possesses; can move freely across time and space
+**Dangers:** Can feel distant; requires a strong authorial voice; handled clumsily, reads as head-hopping
+
+**Masters to study:** Tolstoy (War and Peace) — the gold standard
+
+### 4. Detached Author (Fly on the Wall)
+
+"A woman in a grey dress pushed through the crowd. She stopped twice, looked around, then continued toward the gallery. At the bar, another woman set down her glass."
+
+**Rules:**
+- Reports only what a neutral observer could infer from behaviour and speech
+- Never enters a character's mind
+- The least overtly but most covertly manipulative POV — everything is controlled by selection
+
+**Strengths:** Creates mystery; forces the reader to interpret; powerful understatement
+**Dangers:** Emotional coldness; readers may struggle to connect
+
+**Masters to study:** Raymond Carver
+
+### 5. Observer-Narrator
+
+"I watched Sefrid push through the crowd. She was looking for someone — Aleth, I assumed, though with Sefrid you could never be sure what she was really after."
+
+**Rules:**
+- The narrator is a character but not the protagonist
+- Available in both first and third person
+- Natural mystery about the protagonist's inner life — the observer can speculate but not know
+
+**Strengths:** Can observe the protagonist from outside while maintaining a personal voice
+**Dangers:** The observer can upstage the protagonist; limited access to the protagonist's thoughts
+
+**Masters to study:** Henry James, Willa Cather
+
+## Voice
+
+Voice is the sound of the narration — the personality, rhythm, diction, and sensibility that makes one narrator distinct from another. In practice, voice and POV are inseparable.
+
+### What Creates Voice
+- Word choice and diction level (formal, colloquial, technical, poetic)
+- Sentence structure and rhythm
+- What the narrator notices and ignores
+- What the narrator judges and how
+- The narrator's relationship to the reader (confiding, distant, unreliable, authoritative)
+
+### Reliable vs. Unreliable Narrators
+- In nonfiction: the author/narrator is expected to be honest about what they believe happened
+- In fiction: unreliable narrators reveal how people see the world and why — their distortions are the point
+- An unreliable narrator must be unreliable in ways the reader can eventually detect — otherwise there's no story, just confusion
+
+**Master to study:** Henry James, "The Turn of the Screw" — the paradigmatic unreliable narrator

package/payload/premium-plugins/writer-craft/skills/point-of-view/references/protagonist-filter.md

@@ -0,0 +1,71 @@
+# The Protagonist's Subjective Filter
+
+## The Brain Sees What It Believes
+
+We see the world not as it is, but as we believe it to be. The brain is a prediction machine — it constantly generates expectations based on past experience and then processes incoming data through those expectations. We don't perceive reality raw; we perceive reality through the filter of everything we've already experienced.
+
+For fiction, this means: the protagonist does not see the world neutrally. They see it through the specific lens of their history, their misbelief, their desire, and their fears.
+
+## How the Filter Works in Fiction
+
+### Everything Is Coloured
+When the protagonist enters a room, what they notice is determined by their filter:
+- A character who was betrayed by a friend notices exits and escape routes
+- A character who craves approval notices facial expressions and body language
+- A character who feels invisible notices who is being watched and who isn't
+- A character who fears abandonment notices who is standing close to whom
+
+The same room, described through different filters, is a completely different place.
+
+### Interpretation Is Not Neutral
+The protagonist doesn't just notice things — they interpret them. And their interpretation is shaped by their misbelief:
+- A neutral comment is heard as criticism (if the filter expects attack)
+- A kind gesture is suspected as manipulation (if the filter expects betrayal)
+- An innocent mistake is read as deliberate sabotage (if the filter expects hostility)
+
+These misinterpretations are not errors in the writing — they are the writing. They show the reader, through specific moments, exactly how the protagonist's worldview distorts their experience.
+
+### Memory Is Active, Not Passive
+When the brain retrieves memories, it does so in the service of understanding the present moment. The protagonist doesn't remember randomly — they remember because something in the present activated a past experience.
+
+For fiction: flashbacks and backstory must be triggered by present events. The character sees something now that connects to something then, and the memory surfaces because it's useful for interpreting the current situation. Flashbacks that arrive without this triggering mechanism feel arbitrary.
+
+## Emotional Point of View
+
+### Emotion Determines Meaning
+Without emotional signal, the brain cannot assign meaning, make decisions, or prioritise information. A brain that cannot feel is a brain that cannot think. For readers: if they do not feel what the protagonist feels, they are not processing the story.
+
+### The Protagonist Must React to Everything
+Every event must register emotionally in the protagonist. The reaction need not be dramatic — it can be subtle, internal, even suppressed — but it must be present. If a character witnesses something and has no emotional response, the reader's mirror neurons have nothing to latch onto. Meaning collapses.
+
+### Two Failures of Emotional POV
+
+**1. Describing events without the protagonist's emotional response:**
+"The building collapsed. Debris filled the street. People ran in every direction."
+— This is journalism, not fiction. Where is the protagonist? What do they feel?
+
+**2. Editorialising — telling the reader what to feel:**
+"It was a terrible sight. Anyone would have been horrified."
+— This is the author stepping in front of the character. Show the protagonist's specific, embodied response and let the reader's mirror neurons do the rest.
+
+### The Correct Approach
+Show the protagonist's physical, cognitive, and behavioural response:
+"The building folded inward with a sound like the world cracking. Sarah's knees buckled. She grabbed the railing and held on while the dust rolled over her, gritty and hot, tasting of concrete and something worse."
+
+The reader doesn't need to be told this is terrible. They are experiencing it through Sarah.
+
+## 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.
+
+### In Fiction
+- Body language is not decoration — it is a "tell"
+- The physical reaction often reveals more than dialogue
+- A character who says "I'm fine" while gripping the armrest so hard their knuckles whiten is telling two stories simultaneously
+- The reader instinctively trusts the body over the words
+
+### Using Body Language Well
+- Specific and fresh — not clichéd (avoid "her heart raced," "his blood ran cold")
+- Consistent with the character — different people express the same emotion differently
+- Revealing something the character wouldn't say — body language is subtext, not illustration
+- Earning its place — every physical detail must carry meaning, not just atmosphere