docs: add 'the noise' parenthetical convention to style guides

Update voice guidelines, KDP formatting rules, and pacing section
with the noise parenthetical convention for Phelan's ADD tangents.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

CLAUDE.md

@@ -0,0 +1,367 @@
+# CLAUDE.md — The Shade Series
+## Phelan Varrant | World of Corvel | Guild of Necessary Services
+
+---
+
+## 1. PROJECT OVERVIEW
+
+**Series Title (working):** The Shade Series  
+**Author:** Phillip (writing as [pen name TBD])  
+**Publishing Target:** Amazon Kindle Direct Publishing (KDP) — eBook + Print on Demand  
+**Enrollment:** Kindle Unlimited (KU) eligible — exclusive to Amazon  
+**Format:** Episodic fantasy series, 3+ books planned  
+**Target Length per Book:** 80,000–100,000 words  
+**Genre:** Fantasy / Adventure / Humor  
+**Comparable Titles:** The Dresden Files (Jim Butcher), Discworld (Terry Pratchett), The Magicians (Lev Grossman)
+
+---
+
+## 2. CLAUDE'S ROLE IN THIS PROJECT
+
+Claude Code is the primary writing assistant for this series. Your responsibilities include:
+
+- **Drafting chapters** in Phelan's established first-person voice
+- **Maintaining lore consistency** — never contradict established world rules, character facts, or magic system logic
+- **Tracking continuity** — character names, locations, and plot threads must remain consistent within and across books
+- **Flagging inconsistencies** — if a draft contradicts established canon, note it with `[CONTINUITY FLAG]` inline
+- **Suggesting plot beats** when asked, but never rewriting established outline directions without instruction
+- **Formatting output for KDP** at all times (see Section 9)
+
+When in doubt about lore, character behavior, or plot direction: **ask before inventing.**
+
+---
+
+## 3. WORLD BIBLE — CORVEL
+
+### Overview
+Corvel is a world technologically positioned between the late Middle Ages and the early First Industrial Revolution. Think water-powered mills, early printing presses, rudimentary steam concepts, guild-based economies, and a growing merchant class — but no electricity, no combustion engines, and no mass communication.
+
+**Magic fills the gaps where technology hasn't reached yet.** It enables selective mass production, long-distance communication, preservation, and construction that would otherwise be impossible. Magic is not miraculous — it is a *system*, and like all systems, it has rules, inefficiencies, and exploitable flaws.
+
+### Technology Level
+- **Transportation:** Horse, cart, canal barge, early rail (magically assisted)
+- **Communication:** Courier networks, magical sending-stones (expensive, limited), printed broadsheets
+- **Industry:** Guild workshops, water mills, early steam (unstable, supplemented by magic)
+- **Medicine:** Herbalism, trained surgeons, and healing magic — but death from infection is common due to both cost and skill levels.
+- **Construction:** Stone, timber, brick — magical assistance for large projects is a luxury
+
+### Society & Power
+- **Guild system** is the dominant economic and social force — most skilled workers belong to one
+- **Noble houses** retain land and political power but increasingly depend on guild wealth
+- **A growing middle class** of merchants, skilled craftspeople, and specialists is creating social tension
+- **Magic users** are registered, regulated, and taxed by the **Arcane Compact** — the governing body for magical practice
+- **Religion** exists but is not monolithic — multiple faiths coexist with varying relationships to magic
+
+### The City of Drenwick (Phelan's Home Base)
+Phelan operates primarily out of **Drenwick**, a mid-sized city built around a river junction — part trade hub, part administrative center, part seedy underbelly. It has:
+- A guild quarter (legitimate business, political maneuvering)
+- A dockside district (cargo, smuggling, cheap lodging — where Phelan rents his shack)
+- An arcane district (registered magic users, shops, the Compact's local offices)
+- Noble estates on the hill (clients who pay well and ask few questions)
+- The warrens (slums, street-level crime, useful contacts)
+
+*Drenwick can be expanded as the series develops. Other cities/regions should be added to `/world/locations/` as they appear.*
+
+---
+
+## 4. THE MAGIC SYSTEM — RUNIC FLOW
+
+### Core Concept
+Magic in Corvel operates through **Runic Flow** — a structured system of inscribed symbols, verbal components, and mental frameworks that channel ambient arcane energy. It is taught, licensed, and regulated. Most practitioners learn a narrow specialty and use it reliably within defined parameters.
+
+**The system has bugs.** Like any complex system built by fallible people over centuries, Runic Flow has inconsistencies, edge cases, and exploitable interactions. Most practitioners never look for them — they follow the rules they were taught. Phelan does not.
+
+### Rules of Runic Flow
+1. **Magic requires anchoring** — a rune, a phrase, a material component, or a combination. Raw willpower alone does nothing.
+2. **Energy is finite** — practitioners have a personal reservoir that recovers with rest. Overextension causes exhaustion, then unconsciousness, then death.
+3. **Complexity costs more** — layered or multi-part workings drain faster than simple ones.
+4. **Magic leaves traces** — any significant working leaves detectable arcane residue. Phelan can read these traces.
+5. **Intent matters** — a working keyed to a specific person, place, or outcome is harder to redirect but also harder to break cleanly.
+6. **Curses are contracts** — binding magic (curses, oaths, compulsions) operates like a locked contract. Breaking the lock head-on is nearly impossible. Finding a loophole is not.
+
+### Phelan's Rare Ability — Flaw Sight
+Phelan can perceive the **structural weaknesses in any magical working** — gaps in the logic, inefficiencies in the anchoring, contradictions in the intent-binding. This manifests as a visual/intuitive overlay when he focuses on active magic: he sees the working as a kind of glowing lattice with visible cracks, loose threads, and unstable nodes.
+
+**This ability has costs:**
+- It cannot be turned off passively — he is always *aware* of magical flaws nearby, which is distracting and exhausting in arcane-heavy environments. He sometimes goes down the "rabbit-hole" involuntarily building a theory causing sleep deprevation (can't stop until it's solved) and leaving him overwhelmed.
+- Active use (deep analysis of a complex working) triggers an ADD-like hyperfocus state — he becomes non-functional for everything else until the pattern resolves
+- After a major exploit, he experiences a hard crash: physical exhaustion, temporary inability to use any magic, and occasional sensory distortion, migraines.
+- **The Arcane Compact does not know the full extent of his ability** — he keeps it quiet, because people with interests in certain "unbreakable" magic would prefer it stayed unbroken
+
+### Magical Exploits
+When Phelan identifies a flaw, he can:
+- **Thread through it** — slip a working past a ward without triggering it
+- **Widen it** — destabilize a working to cause controlled failure
+- **Chain vulnerabilities** — link multiple flaws across separate workings to create a cascading effect that achieves something no single exploit could
+
+**Chaining is rare, dangerous, and exhausting.** It's his signature move for impossible jobs.
+
+*Document all new exploits Phelan uses in `/world/magic/exploits-log.md` for continuity.*
+
+---
+
+## 5. CHARACTER BIBLE — PHELAN VARRANT
+
+### Vital Statistics
+- **Full Name:** Phelan Varrant
+- **Known As:** "The Pirate Shade" (clients, underworld contacts), "Phelan" (close associates), "Varrant" (guild formality)
+- **Age:** Early-to-mid 30s (exact age flexible, keep consistent once established)
+- **Appearance:** Lean and unremarkable by design — average height, nondescript coloring, the kind of face that doesn't stick in memory. He considers this an asset. His eyes are slightly unsettling to those who notice them — always moving, cataloguing.
+- **Home:** A rented shack on the dockside of Drenwick, on land he owns but cannot yet afford to build on
+- **Guild:** The Guild of Necessary Services (see Section 7)
+
+### Personality & Voice
+Phelan is **not a hero who happens to be sarcastic.** He is a deeply pragmatic, socially detached operator who happens to do things that look heroic from the outside when the math works out that way.
+
+**Core traits:**
+- **Cold reader:** He processes people as systems — motivations, pressure points, likely behaviors. He is rarely wrong. He finds this useful and slightly boring.
+- **Personal code:** He has rules he doesn't break. He won't explain them. They cost him money sometimes and he pays that cost without complaint.
+- **Perpetually broke:** Not from incompetence — from the gap between his ambitions (the house, the farm, the workshop) and what cases actually pay. This is a source of dark comedy and genuine frustration.
+- **Social reluctance:** He prefers to work alone. The job keeps requiring people. This is the central irony of his life.
+- **ADD brain ("the noise"):** His thoughts move fast, jump tracks, hyperfocus without warning, and occasionally surface brilliance at inconvenient moments. He calls this constant background processing "the noise" — a term he coined at fourteen when he realized other people's heads were apparently quiet. This manifests in the text as **parenthetical asides** `(like this)` — clipped, fragment-style raw brain output that interrupts the narration. See "The Noise Convention" below for formatting rules.
+
+### Phelan's Voice — Writing Guidelines
+First-person, present-tense narration is NOT used. **First-person, past tense** — the story is told as recollection, which allows for occasional meta-commentary without breaking immersion.
+
+**DO write Phelan like this:**
+- Dry, precise observations about people that are slightly too accurate to be comfortable
+- Tangents that seem off-topic and then suddenly aren't
+- Genuine enthusiasm about magical systems that disappears the moment a person tries to connect with him about it
+- Understatement in dangerous situations, overstatement in mundane ones
+- Occasional fourth-wall-adjacent asides that don't quite break it
+- **"The noise" parentheticals** — involuntary brain tangents in `(parentheses)`, clipped fragment style (see "The Noise Convention" in Section 9)
+
+**DO NOT write Phelan like this:**
+- Warm, spontaneous emotional expression
+- Explaining his feelings unprompted
+- Being surprised by people behaving badly
+- Heroic speeches (he will do the heroic thing while complaining about it)
+- Asking for help gracefully (he is terrible at this)
+
+**Sample Voice Reference:**
+> "She was crying. I noted this the way I note weather — relevant to planning, not personally affecting. The tears were real, which narrowed the manipulation angle down to either genuine distress or very committed theater. Given that she'd hired me through three intermediaries and paid the retainer in unmarked coin, I gave it sixty-forty toward theater. I pulled up a chair anyway. Sixty-forty isn't a sure thing, and I've been wrong before. Twice."
+
+### Backstory
+- Raised by a working mother who was present in the house but largely absent in attention — not from cruelty, from necessity
+- No father figure. Built his own code of conduct through trial, error, and observation of people who had codes and people who didn't
+- Discovered his Flaw Sight ability young — spent years thinking he was simply better at magic than others before realizing it was categorically different
+- Joined the Guild of Necessary Services because it was the only structure that didn't require him to pretend to be something he wasn't
+- Has never told anyone the full extent of what he can do
+
+### Wants vs. Needs
+- **Wants:** To be left alone, to be paid, to eventually have enough money to build the house and stop renting the shack
+- **Needs:** To let people in enough to actually accomplish anything — every major goal requires collaboration he resists
+- **Series arc:** Slow, reluctant, and occasionally involuntary growth toward genuine connection — he doesn't change his nature, he learns to work with it
+
+### The Love Interest - Mere Fields.
+*(Mere — develop in `/characters/love-interest.md`)*
+- She sees through the detachment without trying to fix it
+- She is a high functioning autistic, with top notch pattern recognition.
+- She shares his anti-social behavior and understands it. She hates people but loves animals.
+- She is extremely blunt honestly, and doesn't realize how her comments affect people or the situation.
+- Their relationship is defined by competence and honesty with a subtle romantic convention. Her love for Phelan is the only emotional attachment she has.
+- Phelan's motivation to build the house and farm is not possession — it's the closest he gets to saying something out loud that he won't say
+- She is not a damsel. She has her own agenda, skills, and opinions about his methods. Extremely goal oriented.
+
+---
+
+## 6. SUPPORTING CAST ARCHETYPES
+
+Develop full character files in `/characters/` as they appear. Core archetypes for Book 1:
+
+### The Exasperated Partner - Jonael Carterson
+- Someone drawn into Phelan's orbit by necessity who stays by choice
+- Understands Phelan is odd (sociopath) but accepts his friendship anyway.
+- Primary function: Grounding, social translation, and the straight-man to Phelan's detached observations
+- Must be competent — Phelan doesn't tolerate incompetence and neither should the reader
+
+### The Morally Gray Friend - Leon D’Nardis
+- A close friend of Phelan who often work together. 
+- Has ADD but not as much as Phelan. 
+- Relationship is transactional (often help each other) — they understand each other, and trust each other
+- Often they rift off eachothers thoughts and one feeds the other.
+- Occasionally share hacks and tips when discussing their project work.
+- Occasional lifeline who supplies the "nugget" that triggers Phelan's brain to click and find the solution.
+
+### The Comic Relief Who Is Unexpectedly Competent - Devod Fields
+- Mere's father
+- Introduced as a joke, revealed to be essential
+- Has 10 idea's, most are not sound and don't work, but one of them somehow is the perfect solution for the issue.
+- Occaionally a genius
+- Insist that Phelan listens to his ideas, even if most are bad.
+- Is aware his ideas are terrible, but also knows the one out of 10 is so good, it's worth listening to the others.
+- Not an idiot, just has flawed logic.
+- Best deployed in Book 1 to signal to readers that this world rewards paying attention
+
+*Additional cast to be developed as the series expands. Document all named characters in `/characters/`.*
+
+---
+
+## 7. THE GUILD OF NECESSARY SERVICES
+
+### What It Is
+Officially: a registered professional guild providing specialized consulting and problem resolution services to clients in Drenwick and surrounding regions.
+
+Actually: a structured network of people who solve problems that other guilds won't touch, can't solve, or would prefer not to know about. Members are vetted, licensed, and bound by a code of professional conduct that is simultaneously more flexible and more strictly enforced than any official guild charter.
+
+### Structure
+- **Guild Master:** Known internally, anonymous publicly. Communication is indirect.
+- **Members:** Independent contractors. They pay dues, follow the code, get access to the network, safe houses, and the implicit protection of the guild's reputation.
+- **The Code:** Never burn a client who paid in good faith. Never work both sides of the same job. Don't make messes that land on other members. Everything else is judgment.
+
+### Tone
+The Guild of Necessary Services has a front office on a respectable street. It has a sign. The sign is small. The receptionist is extremely polite and tells visitors that there's an eight-week waiting list. There is no waiting list. This is how they filter clients.
+
+---
+
+## 8. BOOK-SPECIFIC INSTRUCTIONS
+
+Each book has its own `CLAUDE.md` in its chapter directory with premise, case details, themes, and milestone beats.
+
+- **Book 1:** `/chapters/book1/CLAUDE.md` — "The Unbreakable Curse"
+
+---
+
+## 9. KINDLE KDP FORMATTING RULES
+
+All chapter drafts must comply with these rules from the first draft. Do not use formatting that will break in Kindle rendering.
+
+### Structure
+- **Chapter headings:** Use `# Chapter [Number]: [Title]` — no decorative characters around them
+- **Scene breaks:** Use `* * *` (three asterisks with spaces) — never a blank line alone, never `---`
+- **No headers below H2** within chapter body text
+- **"The Noise" parenthetical tangents:** Phelan's involuntary ADD brain processing is formatted as parenthetical asides `(like this)` — short, clipped fragments, raw brain output. No nested parentheses. Can be block-level or inline with em-dash framing when the tangent interrupts mid-action. Target frequency: 4-6 per chapter (establishing chapters), 3-5 per chapter (ongoing). Higher frequency and shorter fragments during high-stress scenes. See `docs/plans/2026-03-03-the-noise-tangent-convention-design.md` for full rules.
+- **No tables** in narrative text
+- **No fixed-width or monospace formatting** in prose
+
+### Typography
+- **Em dashes:** Use `—` (actual em dash character), not `--`
+- **Ellipsis:** Use `…` (single character), not `...`
+- **Quotation marks:** Curly/smart quotes only — never straight quotes
+- **No double spaces** after periods
+
+### Length & Pacing
+- Target chapter length: **3,000–5,000 words**
+- Each chapter should end with either a resolved beat or a micro-hook — no chapters that simply stop
+- Scene breaks should be used when time jumps, POV-relevant location changes, or tonal shifts occur
+
+### Front & Back Matter (per book)
+- Title page
+- Copyright page (template in `/kindle/templates/`)
+- Table of Contents (auto-linked)
+- Dedication (optional)
+- Chapter content
+- Author's Note (optional)
+- "Also in this series" page
+- Preview of next book (last 10%)
+
+---
+
+## 10. PROJECT FILE STRUCTURE
+
+```
+/the-shade-series/
+  CLAUDE.md                    ← This file. Master instructions.
+  
+  /world/
+    world-overview.md          ← Corvel summary
+    /magic/
+      runic-flow-rules.md      ← Full magic system
+      exploits-log.md          ← Every exploit Phelan uses (continuity)
+    /locations/
+      drenwick.md              ← Home city
+      [other locations]
+  
+  /characters/
+    phelan-varrant.md          ← Full character bible
+    love-interest.md           ← TBD
+    supporting-cast.md         ← All named characters
+  
+  /outline/
+    series-arc.md              ← High-level series trajectory
+    book1-outline.md           ← Chapter-by-chapter Book 1
+  
+  /chapters/
+    /book1/
+      ch01-draft.md
+      ch01-final.md
+      [etc]
+  
+  /notes/
+    cut-content.md             ← Good ideas that didn't fit
+    research.md                ← World-building research
+    ideas.md                   ← Future plot/character seeds
+  
+  /kindle/
+    /templates/
+      copyright-page.md
+      front-matter.md
+    /exports/
+      book1-manuscript.md      ← Final compiled manuscript
+```
+
+---
+
+## 11. WRITING STYLE GUIDE
+
+### Tone Targets
+- **Primary:** Jim Butcher (Dresden Files) — first-person competence, dry humor, genuine stakes
+- **Secondary:** Terry Pratchett — absurdist world logic, footnote-worthy observations, humanity underneath cynicism
+- **Tertiary:** Patrick Rothfuss — self-aware narrator, prose that rewards attention
+
+### Humor Rules
+1. **Dry wit from Phelan's narration** — his observations are funny because they're accurate, not because he's trying to be funny
+2. **Absurdist world details** — the world itself has a sense of humor (the Guild's polite receptionist, bureaucratic magic regulation, etc.)
+3. **Banter** — supporting cast should give as good as they get; Phelan is not always the funniest person in the room
+4. **Never punch down** — humor at the expense of the vulnerable isn't Phelan's style (and isn't the book's)
+5. **Earn the serious moments** — humor makes the genuine emotional beats land harder; don't undercut them
+
+### Pacing
+- Action scenes: Short sentences. Fragments acceptable. Phelan's narration gets clipped and precise under pressure. **Noise parentheticals:** more frequent, shorter, more fragmented.
+- Investigation scenes: Longer, discursive, tangent-prone. This is where the ADD voice breathes. **Noise parentheticals:** longer spirals, occasionally the tangent IS the key insight.
+- Conversation scenes: Subtext-heavy. Phelan hears what people mean, not what they say. **Noise parentheticals:** cold-read data intake, quick involuntary observations.
+- Quiet/personal scenes: Slower, more sensory detail. These are rare and should feel different. **Noise parentheticals:** medium length, sometimes the tangent is the emotional beat.
+- Hyperfocus/crash scenes: The parentheticals may take over entirely — the noise becomes the narrative, the real world becomes the interruption.
+
+### Things To Avoid
+- **Exposition dumps** — world-build through action and observation, not explanation
+- **Characters explaining things they both already know** — find another way
+- **Phelan being kind in obvious ways** — he shows care through action, precision, and showing up. Not words.
+- **Resolving tension too quickly** — sit in discomfort. Phelan would.
+- **Inconsistent voice** — if a paragraph doesn't sound like Phelan, rewrite it until it does
+
+---
+
+## 12. CONTINUITY TRACKING
+
+Claude Code must maintain awareness of the following across all sessions:
+
+- **Active character list** — all named characters, their relationship to Phelan, and their last known status
+- **Exploits used** — log in `/world/magic/exploits-log.md` every time Phelan uses Flaw Sight or chains an exploit
+- **Phelan's financial state** — track roughly across the book (broke → case fee → expenses → broke again)
+- **The land/house progress** — any development on this subplot must be noted
+- **Established world facts** — once stated in prose, treat as canon unless author explicitly retcons
+
+Use `[CONTINUITY FLAG: note here]` inline in drafts when something may conflict with established facts.
+
+---
+
+## 13. SERIES TRAJECTORY (HIGH LEVEL)
+
+Each book is **episodic and self-contained** — a new case with a beginning, middle, and end. The series arc is the slow accumulation of:
+
+- Phelan's reputation (The Pirate Shade becomes known for impossible jobs)
+- His personal life (the house gets closer, relationships deepen incrementally)
+- World consequences (his exploits have effects; people notice; the Arcane Compact gets curious)
+- His understanding of his own ability (what Flaw Sight actually is may be larger than he thinks)
+
+**Book 1:** Establish voice, world, character, the impossible case  
+**Book 2:** Raise the stakes — a case where the antagonist knows who The Shade is  
+**Book 3:** The Arcane Compact becomes a direct pressure; Phelan's ability can no longer stay quiet  
+
+*Expand in `/outline/series-arc.md`*
+
+---
+
+*Last updated: Project initialization*  
+*Author confirmed all details. Begin drafting only after `/outline/book1-outline.md` is complete.*