@rubytech/create-maxy-code 0.1.106 → 0.1.108

package/payload/platform/plugins/writer-craft/skills/prose-craft/references/punctuation-and-grammar.md

@@ -1,72 +0,0 @@
-# Punctuation and Grammar for Writers — Steering the Craft
-
-## Why Punctuation Matters
-
-Punctuation tells the reader how to hear the writing. It makes grammatical structure clear and shows where the pauses and breaks come. An unpunctuated paragraph makes meaning hard to extract. The same words, punctuated differently, either clarify or destroy meaning.
-
-Writers must be competent in punctuation and grammar themselves. Copy editors are an endangered species, and grammar-correcting software is dangerously incompetent at understanding context and intent.
-
-## Grammar as the Writer's Toolkit
-
-Grammar is the vocabulary of the writer's tools. A writer who doesn't know grammar is like a carpenter who doesn't know a hammer from a screwdriver. You need to know the rules — not to follow them slavishly, but to break them consciously and effectively.
-
-### The Distinction: Correctness vs. Craft
-- **Correctness** is a social and political matter — it can be a marker of class and education
-- **Craft** is a matter of clear communication — in written prose, incorrect usage is disastrous because the reader has only the words, and they must be clear
-- Unconventional usage (fragments, run-ons, dialect, deliberate rule-breaking) is a legitimate craft choice — when it's conscious
-- Unconscious errors undermine the reader's trust
-
-## Fake Rules to Reject
-
-### "Never begin a sentence with 'There is'"
-There is no such thing as "the passive tense." "There is" is an existential construction that good writers use all the time. The claim that it's passive voice reveals ignorance of what passive voice actually is.
-
-### "Never use the passive voice"
-The passive is one of the lovely versatilities of the verb. It is perfectly appropriate in many situations:
-- When the agent is unknown: "The window was broken"
-- When the agent is less important than the action: "The building was completed in 1847"
-- When the passive creates the right rhythm or emphasis
-
-What writers should guard against: passive voice that seeps in from academic or business English to obscure agency and responsibility. "Mistakes were made" when someone specific made them.
-
-### "He is the generic pronoun"
-This is a social convention, not a grammatical law. Using "their" with singular antecedents is a conscious, defensible choice that many careful writers make deliberately.
-
-## Real Rules to Know
-
-### Sentence Coherence
-A sentence must hang together — it must be coherent. The parts must relate to each other clearly. When they don't, meaning becomes ambiguous or absurd.
-
-### Modifier Placement
-Place modifiers next to what they modify. Misplaced modifiers create unintended comedy:
-- "Walking down the street, the trees were beautiful" (the trees are walking)
-- "After rotting in the cellar for three weeks, my sister brought up some oranges" (the sister was rotting)
-
-### Dangling Participles
-A participial phrase at the beginning of a sentence must modify the subject of the sentence. If it doesn't, it dangles.
-
-### Comma Splices and Run-Ons
-- A **comma splice** joins two independent clauses with only a comma (often considered an error, but deliberately used by many skilled writers for rhythm)
-- A **run-on** jams two independent clauses together with no punctuation at all
-- The fix (when one is needed): period, semicolon, or conjunction
-
-### The Semicolon
-Joins two independent clauses that are closely related in meaning. Creates a pause longer than a comma but shorter than a period. A useful tool that many writers fear unnecessarily.
-
-## Key Punctuation for Prose Writers
-
-| Mark | Function in Prose |
-|------|------------------|
-| **Period** | Full stop. End of thought. Creates silence. |
-| **Comma** | Brief pause. Separates clauses, items, and modifying phrases. The most versatile and most misused mark. |
-| **Semicolon** | Connects related independent clauses. Creates a bridge between thoughts too close for a period, too independent for a comma. |
-| **Colon** | Announces what follows: a list, an explanation, or an amplification of what came before. |
-| **Dash (em dash)** | Interruption, parenthetical emphasis, or dramatic pause. More forceful than a comma, less formal than a colon. |
-| **Ellipsis** | Trailing off, omission, or the passage of time. Overused in amateur prose — use sparingly. |
-| **Parentheses** | Aside, digression, or supplementary information. Can create intimacy or distance depending on context. |
-
-## The Moral Dimension
-
-Socrates: "The misuse of language induces evil in the soul." This does not mean grammar errors are morally wrong. It means that language used carelessly — to obscure rather than clarify, to manipulate rather than communicate, to evade responsibility — is a failure of craft and, at its worst, a failure of character.
-
-The writer's obligation: know what you are doing with your language and why.

package/payload/platform/plugins/writer-craft/skills/prose-craft/references/repetition.md

@@ -1,71 +0,0 @@
-# The Craft of Repetition — Steering the Craft
-
-## Deliberate vs. Accidental Repetition
-
-There is such a thing as clumsy repetition — the accidental echo that occurs when you aren't rereading as you write. That kind is easy to fix in revision. But to make a rule against repetition is to go right against the nature of narrative prose.
-
-### The Anti-Repetition Myth
-The journalistic and pedagogical rule against using the same word twice on a page drives writers to the thesaurus in search of far-fetched synonyms — flaming words that stick out of their prose like flamingos in a flock of pigeons.
-
-If the right word is "said," use "said" — do not cycle through "exclaimed," "uttered," "pronounced," "declared," and "vouchsafed" to avoid repeating it.
-
-## The Power of Deliberate Repetition
-
-From the grandmother telling a folktale to the most sophisticated novelist, all narrators use repetition. The skilful use of it is a great part of the power of prose.
-
-### Types of Repetition
-
-**Verbal Repetition** — repeating a word or phrase for emphasis, rhythm, or accumulation:
-- A word repeated like a hammer blow, gaining force with each use
-- A phrase that becomes a refrain, changing meaning through context each time it appears
-- A key word echoed across paragraphs, creating subconscious connections
-
-**Structural Repetition** — events, situations, or patterns that echo each other:
-- Near-repetition of events in different contexts
-- A scene that mirrors an earlier scene but with changed stakes or meaning
-- Patterns across the novel analogous to recapitulation and development in music
-
-**Comic Repetition** — a recurring element that gathers comedic weight:
-- Micawber's "Something is certain to turn up" in David Copperfield, gaining meaning with each recurrence
-
-**Incantatory Repetition** — repetition used for ritual, rhythmic, or hypnotic effect:
-- Sacred and oral narrative is completely fearless about repetition
-- Repetition can give words majesty and power, as in an incantation
-- The repeated phrase shapes the story and marks its rhythm
-
-## How Repetition Works in Novels
-
-### Opening Chapters Set the Pattern
-The first chapters of great novels often introduce images, words, and themes that will recur throughout the book. Jane Eyre's opening chapters introduce images of imprisonment, fire, coldness, and justice that echo across hundreds of pages.
-
-### Repetition Creates Structure
-At the level of the whole novel, structural repetition creates the architecture the reader feels but may not consciously identify:
-- A conversation that recurs in different contexts, revealing how the characters have changed
-- An image (a colour, an object, a place) that appears at key turning points
-- A physical action repeated — the same gesture meaning something different each time
-
-### Repetition Reveals Change
-One of the most powerful uses: repeat an element and change one thing. The contrast between what's the same and what's different reveals exactly what has changed in the character or situation.
-
-## When Repetition Fails
-
-### Accidental Echoes
-An unconscious verbal echo within a paragraph or across adjacent paragraphs is distracting. It draws attention to the words themselves rather than what the words are saying. Catch these in revision by reading aloud.
-
-### Dead Repetition
-Repetition without accumulation — saying the same thing in different words without adding meaning. This is not the same as deliberate repetition for emphasis. Test: does each repetition add something? If the reader's response is "you already said that" rather than "yes, again, harder," the repetition is dead.
-
-### Thesaurus Syndrome
-The opposite failure: avoiding natural repetition by substituting awkward synonyms. If a character is walking, they are walking — they are not "ambulating," "perambulating," "proceeding on foot," and "locomoting." The word "said" can appear fifty times in a chapter and remain invisible; "ejaculated" cannot appear once without derailing the reader.
-
-## Practical Guidance
-
-### In First Drafts
-Don't worry about repetition. Write the word that comes naturally. Deliberate repetition will emerge instinctively if you're listening to the rhythm of your prose.
-
-### In Revision
-1. Read aloud and listen for accidental echoes — fix these
-2. Look for places where deliberate repetition could strengthen the prose — add these
-3. Check the thesaurus impulse — if you've replaced a natural word with a synonym to avoid repetition, put the original back
-4. Map structural repetitions across the whole text — are there patterns that could be strengthened?
-5. Check that every deliberate repetition accumulates meaning — each occurrence should add something the previous one didn't

package/payload/platform/plugins/writer-craft/skills/prose-craft/references/sound-and-rhythm.md

@@ -1,64 +0,0 @@
-# Sound, Rhythm, and Sentence Variety — Steering the Craft
-
-## Sound Is Primary
-
-The basic elements of language are physical — noise, sound, silence, rhythm. These matter in prose just as much as in poetry, though prose's sound effects are usually subtle and irregular. A good writer has a mind's ear. The common critical terms for weak prose — dull, choppy, droning, jerky, feeble — are all faults of sound.
-
-The chief duty of a narrative sentence is to lead to the next sentence. It does this through pace, movement, and rhythm.
-
-### Training the Mind's Ear
-- Read prose aloud, or read it silently with full auditory attention
-- Listen to what your own prose sounds like as you write it
-- When something sounds wrong, it is wrong — even if you can't name the problem
-- Language can express delight in itself, as music does — "poetry isn't the only kind of writing that can sound gorgeous"
-
-### Elements of Sound
-- **Onomatopoeia** — words that sound like what they mean (sizzle, hiss, slurp, crack)
-- **Alliteration** — repetition of initial sounds (not just identical letters — identical sounds)
-- **Cadence** — the rise and fall of sentence rhythm, created by the pattern of stressed and unstressed syllables
-- **Silence** — what is left out; pauses created by punctuation, paragraph breaks, white space
-
-## Sentence Length and Variety
-
-### The Core Principle
-There is no optimum sentence length. The optimum is **variety**. Rhythm in prose depends fundamentally on the contrast and interplay between sentences of different lengths.
-
-### Short Sentences
-- Highly effective in the right place — for emphasis, impact, sudden revelation
-- Prose consisting entirely of short, syntactically simple sentences is monotonous, choppy, and irritating
-- The myth that short sentences are "more like speech" is wrong — people often use more complex sentences when speaking than when writing
-
-### Long Sentences
-- Need careful construction — clear connections, solid architecture — so they flow and carry the reader rather than losing them
-- A sentence so grand it stops the story is not working as a narrative sentence
-- The proper beauty and power of prose is in the work as a whole, not in individual show-off sentences
-- Long sentences can: build tension, accumulate emotional weight, enact a physical experience (a jolting journey, a flowing river, a gathering storm)
-
-### Common Sentence Problems
-
-**Conjunctivitis**: Stringing short sentences together with conjunctions ("and then... and then... and so... but then"), creating a childish, droning effect.
-
-**Misplacement**: Parts of the sentence in the wrong order, creating ambiguity or absurdity. ("Walking down the street, the trees were beautiful" — the trees are walking.)
-
-**Danglers**: Modifying phrases attached to the wrong noun. ("After rotting in the cellar for three weeks, my sister brought up some oranges.")
-
-## Rhythm and Emotional Register
-
-Rhythm should match and embody the emotional content:
-- Fast, staccato rhythm for action, urgency, shock
-- Slower, rolling rhythm for reflection, grief, beauty
-- Varied rhythm for conversation, ordinary life, complexity
-- A sudden short sentence after long ones creates emphasis through contrast
-- A long sentence after short ones creates a feeling of expansion or accumulation
-
-### Rhythmic Variety in Practice
-Map the sentence lengths in a passage. If they're all similar, the passage will sound monotonous regardless of content. The interplay of short and long, simple and complex, is what creates the music of prose.
-
-## Literary Examples of Sound
-
-- **Kipling** (Just So Stories): Exuberant vocabulary, musical rhythms, dramatic phrasing
-- **Twain** ("Jumping Frog"): Beauty through irresistible dialectical cadences
-- **Hurston** (Their Eyes Were Watching God): Rhythm with hypnotic, fatal, forward drive — simple vocabulary whose power is all in the beat
-- **Gloss** (The Hearts of Horses): Quiet, subtle — power from the perfect placement and timing of words
-- **Woolf** (To the Lighthouse): Variety of sentence length, complex syntax including parentheses, flowing and breaking until a one-word sentence stops everything: "Awake."
-- **Twain** (Huckleberry Finn): One long sentence made of short subsentences strung by semicolons, catching the rhythm of someone talking quietly — one of the great sunrises in literature

package/payload/platform/plugins/writer-craft/skills/prose-craft/references/word-economy.md

@@ -1,93 +0,0 @@
-# Word Economy: Adjectives, Adverbs, Crowding, and Leaping — Steering the Craft
-
-## Adjectives and Adverbs
-
-Adjectives and adverbs are rich, good, and nourishing. They add colour, life, immediacy. They cause obesity in prose only when used lazily or overused.
-
-### The Core Principle
-When the quality an adverb indicates can be put directly in the verb, or when the quality an adjective indicates can be put in the noun itself, the prose will be cleaner, more intense, more vivid.
-
-| Weak | Strong |
-|------|--------|
-| They ran quickly | They raced / They sprinted |
-| A growling voice | A growl |
-| She said loudly | She shouted / She bellowed |
-| He walked slowly | He shuffled / He crept |
-| A big house | A mansion / A sprawl |
-
-### Bloodsuckers: Qualifiers
-These words weaken almost every sentence they appear in:
-- rather
-- a little
-- just
-- very
-- kind of / sort of
-- somewhat
-- quite
-- really
-- perhaps (when hedging, not when genuinely uncertain)
-
-They are ticks in written prose. In conversation, they serve as social lubricant. In prose, they drain authority and precision.
-
-### Empty Intensifiers
-Words that have lost their meaning through overuse:
-- great
-- suddenly
-- somehow
-- absolutely
-- totally
-- literally (when used as emphasis)
-- amazing / incredible / unbelievable
-
-### The Muscle-to-Fat Ratio
-Narrative prose, especially long narrative, needs more muscle than fat. The English language is rich beyond belief — but richness must be earned by precision, not accumulated through decoration.
-
-## Crowding
-
-**Crowding** means loading every rift with ore. Avoiding flabby language and clichés. Always seeking the vivid phrase. Keeping the story full of what's happening in it, keeping it moving, keeping it interconnected.
-
-### Qualities of Crowded Prose
-- **Vivid** — the reader can see, hear, feel what's happening
-- **Exact** — the right word, not its approximate cousin
-- **Concrete** — specific objects, actions, sensations — not abstractions
-- **Accurate** — true to the physical and emotional reality being described
-- **Dense** — every sentence carrying weight
-- **Rich** — multiple layers of meaning working simultaneously
-
-### How to Crowd
-- Seek the specific over the general
-- Choose the vivid verb over the weak verb + adverb
-- Choose the precise noun over the generic noun + adjective
-- Make every detail do double or triple duty (reveal character AND advance plot AND illuminate theme)
-- Eliminate any word that isn't pulling its weight
-
-## Leaping
-
-**Leaping** means what you leave out. What you leave out is infinitely more than what you leave in. There must be white space around the word, silence around the voice.
-
-### What to Leave Out
-- Information the reader can infer
-- Steps in a sequence that are obvious
-- Descriptions of what the reader already knows or can imagine
-- Transitions that don't need to be spelled out
-- Emotional states that are already clear from action and dialogue
-
-### Listing Is Not Describing
-A catalogue of objects or actions does not create a vivid scene. Only the details that matter — that carry meaning — belong. The rest is noise.
-
-### The Danger of Overcrowding
-Even good writers can overdo crowding. Borges's fictional character Funes the Memorious perceived and remembered every detail of everything — and was utterly paralysed by it. Flaubert's Salammbô is a real-world cautionary tale: a novel choked by its own mots justes.
-
-### The Danger of Insufficient Leaping
-Action writing that tries to give blow-by-blow accounts creates confusion and boredom. The reader doesn't need to see every swing of the sword. They need to see the moments that change the stakes.
-
-## The Revision Method
-
-Crowd in the first draft — be generous, overwrite, include too much. Then cut.
-
-**Decide what counts, what tells, and cut and recombine until what's left is what counts.**
-
-Chekhov's advice: "First, throw out the first three pages." Most first drafts circle and explain before they find their way. In revision, if the beginning can be cut, cut it.
-
-### The Halving Exercise
-Take a piece of 400+ words and cut it to half — not trimming but counting words and actually reducing to half while keeping the narrative clear and the sensory impact vivid. This forces you to discover which words are Styrofoam and which are heavy gold.

package/payload/platform/plugins/writer-craft/skills/reader-engagement/SKILL.md

@@ -1,100 +0,0 @@
----
-name: reader-engagement
-description: "Analyzes and teaches reader engagement: hooking from page one, urgency, cause-and-effect chains, setup-payoff patterns, conflict escalation, emotional resonance, and pacing. Use this skill whenever the user asks about hooking readers, page one, opening scenes, reader engagement, urgency, cause and effect, setup and payoff, conflict escalation, raising stakes, pacing, 'why readers stop reading', 'my story is boring', 'the middle sags', or any question about why a story fails to hold attention. Also use when diagnosing why a manuscript loses momentum or when a writer needs to understand the neuroscience of why readers keep turning pages."
----
-
-# Reader Engagement
-
-The brain is bombarded with 11 million bits of sensory information per second. It consciously processes approximately forty. The cognitive unconscious acts as a ruthless filter — keeping only what matters, discarding the rest. Story is the brain's native language for what matters. When a story meets the brain's hardwired criteria, the reader surrenders. When it doesn't, they put the book down.
-
-Reader engagement is not a vague aesthetic preference. It is a biological response driven by specific neurochemical mechanisms:
-
-| Trigger | Neurochemical | Reader Experience |
-|---------|--------------|-------------------|
-| **Curiosity** (broken pattern, unanswered question) | Dopamine | "What happens next?" |
-| **Conflict** (hard choice, consequences) | Cortisol | "Will they get through this?" |
-| **Vulnerability** (empathy with protagonist) | Oxytocin | "I'm on their side" |
-
-A story that triggers all three is virtually impossible to put down.
-
-## Hooking the Reader: Page One
-
-Three things readers hunt for from the first sentence:
-
-1. **Whose story is it?** The protagonist must appear immediately. Readers need a surrogate.
-2. **What's happening here?** Something must already be in motion. Not the preamble — the thing itself.
-3. **What's at stake?** Conflict specific to the protagonist must be visible.
-
-The first sentence must suggest that something is already wrong and about to get worse. This fires the dopamine circuit — the anticipation response. Beautiful language alone does not do this. Storytelling always trumps beautiful writing.
-
-## Cause and Effect: The Causal Spine
-
-The brain is a causal-inference engine. It demands to understand how each event caused the next. Not "and then... and then... and then" but "therefore... because... so..."
-
-Every scene must be triggered by the scene before it and must trigger the scene after it. If you can remove a scene without disrupting the chain, it has no business being there.
-
-Cause and effect operates on two levels:
-1. **External (plot)**: physical events cause physical consequences
-2. **Internal (character arc)**: each event triggers an emotional reaction → a decision → a new action
-
-The internal level is primary. The reader tracks this pattern whether they know it or not: **action → reaction → decision → new action**. When it breaks, the story loses them.
-
-### The "And So?" Test
-For every scene, every detail — ask "And so?" What does this lead to? What consequence does it produce? If you can't answer, the element is probably a darling that the story doesn't need.
-
-## Setup and Payoff
-
-The brain instinctively scans for patterns. In a story, readers are continuously looking for setups — hints, details, actions that signal future significance. When a payoff arrives, the brain experiences the reward of a pattern completed.
-
-Rules:
-- Every payoff requires a clear setup
-- Every setup requires a clear payoff
-- The road between them must build — each step increasing in significance
-- Setups and payoffs must be separated enough to create anticipation
-- **Audit for inadvertent setups** — details described at length that then vanish. Readers catalogue everything. Absence in the payoff register reads as error or cheat.
-
-## Conflict Escalation
-
-The brain uses story to simulate navigating difficult situations. A story that is too easy provides no simulation worth running. Everything that can go wrong must go wrong, and the wrongness must escalate.
-
-Principles:
-- Each complication raises stakes beyond where they were
-- Each apparent solution creates a larger problem
-- The protagonist must be forced to find resources they didn't know they had
-- The antagonist (person, force, or circumstance) must be specific, present, and active
-- There are no free victories — every gain costs something, every loss has consequences
-- The worst thing you can do as a writer is be kind to your protagonist
-
-## Emotional Resonance
-
-Emotion is not the enemy of reason — it is the system within which reason operates. Every decision is ultimately made emotionally. For readers: if they do not feel what the protagonist feels, they are not processing the story.
-
-The mechanism: mirror neurons. When we observe someone in pain or joy, the same neural circuits fire as when we experience it ourselves. The brain does not fully distinguish between observed and directly experienced emotion.
-
-Requirements:
-- The protagonist must react emotionally to everything — if they witness something terrible and don't react, meaning collapses
-- Body language is subtext — physical response communicates what the character might never say
-- Every event must register through the protagonist's subjective emotional filter
-- Never editorialise (tell the reader what to feel) — show the protagonist's specific, embodied reaction
-
-## Engagement Diagnostic Checklist
-
-- [ ] Does the opening sentence trigger curiosity about what happens next?
-- [ ] Is the protagonist present and affected from page one?
-- [ ] Are stakes visible immediately?
-- [ ] Does every scene follow from the previous one through cause and effect?
-- [ ] Can you trace the internal pattern (action → reaction → decision → action) in every scene?
-- [ ] Does the "And so?" test pass for every major element?
-- [ ] Is every setup paid off? Is every payoff set up?
-- [ ] Are there inadvertent setups — details that promise significance but deliver nothing?
-- [ ] Does conflict escalate with each complication?
-- [ ] Is the opposition specific, present, and active?
-- [ ] Does the protagonist react emotionally to events in ways the reader can mirror?
-- [ ] Is the protagonist earning every gain and paying for every loss?
-
-## When to Read Reference Files
-
-- **For hooking readers and page-one requirements** — read `references/hooking-readers.md`
-- **For cause-and-effect and setup-payoff in detail** — read `references/cause-effect-setup-payoff.md`
-- **For conflict escalation and stakes** — read `references/conflict-escalation.md`
-- **For the neurochemistry of engagement and emotion** — read `references/neurochemistry-of-engagement.md`

package/payload/platform/plugins/writer-craft/skills/reader-engagement/references/cause-effect-setup-payoff.md

@@ -1,79 +0,0 @@
-# Cause-and-Effect and Setup-Payoff Patterns
-
-## The Causal Spine
-
-The brain is a pattern-matching, causal-inference engine. It is not content to observe events — it demands to understand how each event caused the next. This is biology, not preference.
-
-### The Fundamental Test
-Not "and then... and then... and then" but "therefore... because... so..."
-
-If you can remove a scene without disrupting the causal chain, the scene has no business being there.
-
-### Two Levels of Cause and Effect
-
-**External (plot):** Physical events cause physical consequences.
-- She drops the letter → He finds it → He discovers the secret
-
-**Internal (character arc):** Each external event triggers an emotional reaction, which leads to a decision, which drives the next action.
-- She drops the letter → He finds it → He feels betrayed (reaction) → He decides to confront her (decision) → He drives to her house (action)
-
-The internal level is primary. The reader tracks this rhythm whether they know it or not.
-
-### The Internal Pattern
-**Action → Reaction → Decision → New Action**
-
-This four-beat pattern is the engine of narrative momentum. When it runs, the reader is engaged. When it breaks — when a character acts without reacting to what just happened, or reacts without making a visible decision — the reader disconnects.
-
-### Making Decisions Visible
-A common failure: the protagonist makes a decision whose reasoning is invisible to the reader. The writer knows why — but it's not on the page.
-
-Every decision must be traceable through the text. When a character changes their mind, the reader must see exactly what changed and why.
-
-### The "And So?" Test
-For every scene, every piece of information, every detail — ask "And so?" What does this lead to? What consequence does it produce? If you can't answer, the element is probably a darling — writing the author loves that the story doesn't need.
-
-## Setup and Payoff
-
-### The Brain Scans for Patterns
-The brain instinctively imposes pattern on everything it encounters. In a story, readers continuously scan for setups — hints, details, actions that signal future significance. When a payoff arrives, the reader experiences the satisfaction of a pattern completed, triggering a genuine neurological reward.
-
-### Setup-Payoff Rules
-
-1. **Every payoff requires a clear setup.** A payoff that arrives without a setup feels arbitrary, convenient, or cheap. The reader's response is "give me a break!" rather than "of course!"
-
-2. **Every setup requires a clear payoff.** A setup that is never paid off misleads the reader and destroys trust. The reader catalogued it; its absence from the payoff register reads as error or cheat.
-
-3. **The road between them must build.** Each step between setup and payoff should increase in significance. The dots must add up to a pattern.
-
-4. **Separate setup from payoff.** The payoff must not arrive too quickly after the setup, or too directly from it. The pleasure of anticipation requires distance. The reader should sense a pattern emerging but not see the destination.
-
-5. **Payoffs must be logistically possible.** Given what has been established, the payoff must make physical and psychological sense. No deus ex machina.
-
-### The Danger of Piggybacking
-When setup and payoff are too close together, the reader gets no pleasure of anticipation. The pattern completes before it registers as a pattern.
-
-### Inadvertent Setups
-Writers must audit for elements that inadvertently signal significance:
-- A detail described at length that then disappears from the story
-- A character trait mentioned in passing that is never relevant again
-- An object given narrative weight that plays no role in the plot
-- A scene that appears to establish something important but leads nowhere
-
-Readers will have catalogued all of these. Each unfulfilled promise erodes trust.
-
-### Auditing Setup-Payoff
-
-Create a two-column list:
-- **Left column:** Every setup you can identify (details, character traits, objects, scenes that promise future significance)
-- **Right column:** The payoff for each setup
-
-Any setup without a payoff needs either a payoff added or the setup removed.
-Any payoff without a setup needs a setup planted earlier.
-
-### Foreshadowing as Contract
-Foreshadowing is a specific form of setup — a promise that something is coming. When a character does something "out of character," it must have been foreshadowed. The goal is always the "aha!" reaction, not the "give me a break!" reaction.
-
-Foreshadowing works when:
-- The reader registers it subconsciously but doesn't see the destination
-- In retrospect, the outcome was inevitable given what was planted
-- The reader's second read reveals a rich network of planted clues

package/payload/platform/plugins/writer-craft/skills/reader-engagement/references/conflict-escalation.md

@@ -1,81 +0,0 @@
-# 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/platform/plugins/writer-craft/skills/reader-engagement/references/hooking-readers.md

@@ -1,67 +0,0 @@
-# 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