Phelan_Varrent/CLAUDE.md

CLAUDE.md — A Phelan Varrant Novel

Phelan Varrant | World of Corvel | Guild of Necessary Services

---

1. PROJECT OVERVIEW

Series Title (working): A Phelan Varrant Novel Author: Phillip Tarrant
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.

Phelan's Combat Magic — Fire & Earth

In addition to Flaw Sight, Phelan has conventional combat magic he learned as a child due to bullying. He kept it quiet after leaving school and hasn't needed it until guild work takes him into dangerous environments.

• Fire element: Strong. His primary combat tool — close-quarters fire weaving combined with melee strikes. Practiced obsessively as a kid.
• Earth element: Serviceable but weaker. Used practically (stabilizing terrain, creating cover) rather than offensively.
• Melee + magic combination: Rare in Corvel. Mages are common (~20% of the population can use magic), so being a mage alone isn't special. What's rare is combining physical combat skills with spell casting — most mages only know spells. Phelan can fight in close quarters while maintaining spell work.
• Current state: A dormant skill resurfacing out of necessity — not his identity, but a real capability he's been sitting on. The skill and muscle memory are there, but his stamina isn't what it was.

---

5. CHARACTER BIBLE — PHELAN VARRANT

Vital Statistics

• Full Name: Phelan Varrant
• Known As: "The Locksmith" (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 — dreams of buying land and building a real house
• 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 (*italicized 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/mere-fields.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 Floundry Affair" — FINALIZED. Do not edit Book 1 chapters or content. Treat as locked canon.
• Book 2: (in progress) — current active work

Current status: Book 1 is complete and finalized. All work is now on Book 2. Book 1 text, outlines, and chapter files are reference-only — read them for continuity but never modify them.

---

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 (*italicized content*) — italics inside parentheses. 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

/flawsight/
  CLAUDE.md                    ← This file. Master instructions.
  
  /world/
    world-overview.md          ← Corvel summary
    story-summary-book1.md     ← Running story summary (update after each chapter draft/edit)
    timeline-book1.md          ← Chapter-by-chapter timeline tracking (consult before drafting)
    economy.md                 ← Currency, pricing, wages, economic reference
    /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
    mere-fields.md             ← Mere Fields
    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:

• Story summary — consult and update /world/story-summary-book1.md after each chapter draft or edit. This file tracks key events, character states, and plot developments so Claude doesn't need to re-read entire chapters for context
• Timeline — consult and update /world/timeline-book1.md whenever drafting or revising chapters. All time references (bells, days elapsed, day-of-week) must be checked against this file before writing. Flag conflicts immediately.
• 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). Consult /world/economy.md when writing any price, payment, or financial reference to ensure consistency.
• 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 Locksmith 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 Locksmith 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.