diff --git a/CLAUDE.md b/CLAUDE.md index ad581ca..e650302 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,11 +1,11 @@ -# CLAUDE.md — The Shade Series +# CLAUDE.md — A Phelan Varrant Novel ## Phelan Varrant | World of Corvel | Guild of Necessary Services --- ## 1. PROJECT OVERVIEW -**Series Title (working):** The Shade Series +**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 @@ -52,6 +52,17 @@ Corvel is a world technologically positioned between the late Middle Ages and th - **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 +### Kingdom Structure +Corvel is a single kingdom with **six duchies** under **King Halvar Rethen III** (capital: Varenhold, in the Crownhold): +- **Thorngate** — Duchess Pamira Varnesse (north) +- **Aldermere** — Duke Garrett Holven (north, peer to Thorngate) +- **The Crownhold** — held directly by the crown (central-north, capital) +- **Wenlow** — Duchess Isolde Merrenwood (west, agricultural) +- **Vethmarch** — Duke Cason Arvale (east, frontier mountains) +- **Sudermere** — Duke Roderic Velthane (south, contains Drenwick; duke is absentee by temperament, which is why Drenwick runs on guilds) + +Noble ranks: king, duke/duchess, baron/baroness, landed gentry (where D'Nardis sits). No counts. Full scaffold including proximity map, travel times, and location registry in `/world/locations/kingdom-of-corvel.md` — **consult this file before writing any scene that references a duchy, noble, travel time, or place name outside Drenwick.** + ### 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) @@ -112,7 +123,7 @@ In addition to Flaw Sight, Phelan has conventional combat magic he learned as a ### Vital Statistics - **Full Name:** Phelan Varrant -- **Known As:** "The Shade" (clients, underworld contacts), "Phelan" (close associates), "Varrant" (guild formality) +- **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 @@ -226,7 +237,11 @@ The Guild of Necessary Services has a front office on a respectable street. It h 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" +- **Book 1:** `/chapters/book1/CLAUDE.md` — "The Floundry Affair" — **FINALIZED. Do not edit Book 1 chapters or content. Treat as locked canon.** +- **Book 2:** `/chapters/book2/CLAUDE.md` — "The Drenwick Drainings" — **FINALIZED. Do not edit Book 2 chapters or content. Treat as locked canon.** +- **Book 3:** (in progress) — current active work + +> **Current status:** Books 1 and 2 are complete, finalized, and published. All work is now on Book 3. Book 1 and Book 2 text, outlines, and chapter files are reference-only — read them for continuity but never modify them. --- @@ -268,7 +283,7 @@ All chapter drafts must comply with these rules from the first draft. Do not use ## 10. PROJECT FILE STRUCTURE ``` -/the-shade-series/ +/flawsight/ CLAUDE.md ← This file. Master instructions. /world/ @@ -291,12 +306,21 @@ All chapter drafts must comply with these rules from the first draft. Do not use /outline/ series-arc.md ← High-level series trajectory book1-outline.md ← Chapter-by-chapter Book 1 - + book2-outline.md ← Chapter-by-chapter Book 2 + book3-outline.md ← Chapter-by-chapter Book 3 + /chapters/ + chapter-input-template.md ← Shared input template (used by /chapter-workflow skill) + book-claude-template.md ← Template for per-book CLAUDE.md files /book1/ - ch01-draft.md + CLAUDE.md ← Book-specific orientation (lean — points to outline) ch01-final.md [etc] + /book2/ + CLAUDE.md + [drafts and finals] + /book3/ + CLAUDE.md /notes/ cut-content.md ← Good ideas that didn't fit @@ -363,18 +387,52 @@ Use `[CONTINUITY FLAG: note here]` inline in drafts when something may conflict 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 Shade becomes known for impossible jobs) +- 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 Shade is +**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* +## 14. KDP COMPLIANCE — METADATA & INTELLECTUAL PROPERTY + +Amazon KDP has strict policies against metadata that references other authors' works in ways that could mislead customers. These rules apply to **all books in the series** and must be followed for every submission. + +### Keywords +- **NEVER** use another author's name, series name, or trademarked title as a KDP keyword +- Describe the book's own qualities instead (e.g., "sarcastic mage protagonist" not "Dresden Files similar") +- All 7 keyword slots should describe this book's content, tone, or genre positioning + +### Book Description +- **Do NOT** name specific comparable titles or authors anywhere in the description +- Describe the reading experience: "for fans of first-person fantasy with dry humor" rather than "for readers who love [Author]'s [Series]" +- Sell the book on its own merits — Phelan's voice, the case premise, and the world + +### Cover Design +- Avoid visual compositions that closely mirror the cover style of well-known series in the same genre +- Differentiate through color palette, character pose/framing, and setting elements unique to Corvel +- When commissioning or reviewing cover art, compare against top-selling comparable titles to ensure distinctiveness + +### General Rule +All metadata (title, subtitle, description, keywords, categories) must sell the book on its own merits. No references to other authors, series, or works anywhere in KDP-facing metadata. + +### KDP Pre-Submission Checklist +Before every KDP upload, verify: +- [ ] No keywords contain other authors' names or series titles +- [ ] Book description does not name comparable titles or authors +- [ ] Cover art is visually distinct from major comparable series +- [ ] Title/subtitle cannot be confused with existing published works +- [ ] Review against Amazon's content guidelines: https://kdp.amazon.com/en_US/help/topic/G200952510 + +> **Note:** The Writing Style Guide (Section 11) still references comparable authors as *internal tone targets* for Claude's writing. These references are for drafting guidance only and must **never** appear in any customer-facing metadata, descriptions, or marketing materials. + +--- + +*Last updated: 2026-03-19 — Added KDP compliance section (Section 14)* *Author confirmed all details. Begin drafting only after `/outline/book1-outline.md` is complete.* diff --git a/README.md b/README.md index f806f30..3c1cc7e 100644 --- a/README.md +++ b/README.md @@ -1,34 +1,53 @@ -# The Shade Series — Phelan Varrant +# A Phelan Varrant Novel -A fantasy novel series following Phelan Varrant, a broke, socially reluctant magical problem-solver with an ability no one else has: he can see exactly where magic breaks. +A fantasy series following Phelan Varrant, a broke, socially reluctant magical problem-solver with an ability no one else has: he can see exactly where magic breaks. ## Series Overview -- **Genre:** Fantasy / Adventure / Humor +- **Genre:** Fantasy / Adventure / Humour - **Voice:** First-person past tense, dry wit, ADD-driven tangents -- **Comparable Titles:** The Dresden Files, Discworld, The Magicians - **Publishing Target:** Amazon KDP (Kindle Unlimited) +- **Planned length:** 3+ books, ~80,000–100,000 words each -## Book 1: The Unbreakable Curse +See `outline/series-arc.md` for the full series trajectory. -Phelan works in an herbal supply shop, counts coppers, and dreams about the house he can't afford to build. When a client arrives through the Guild of Necessary Services with a dying family member cursed by a working that every authority says is impossible to break, Phelan takes the case because the fee is significant and the problem is interesting. In that order. +## Books + +### Book 1: *The Floundry Affair* — finalized + +Phelan works in an herbal supply shop, counts coppers, and dreams about the house he can't afford to build. When a client arrives through the Guild of Necessary Services with a dying family member cursed by a working every authority says is impossible to break, Phelan takes the case because the fee is significant and the problem is interesting. In that order. + +### Book 2: *The Drenwick Drainings* — in progress + +Life-force drainings across Drenwick trace back to a pre-Compact focusing crystal and a handler operating from Thorngate. The case that starts as a hunt becomes a rescue, the investigator ends up a builder, and a freelancer's philosophy breaks on five words. Ch01–19 drafted; Ch20, Ch21, and the epilogue pending. + +### Book 3: *The Sealed Chamber* — outlined + +A pre-Compact ruin on a duchess's territory near Thorngate. A previous guild operative dead. Wards that learn and adapt. Inside, a sealed chamber holding something that should never be used. The man who finds every flaw has to build something without any. Full chapter-by-chapter outline complete; drafting pending Book 2 completion. ## Project Structure ``` -CLAUDE.md # Master writing instructions -chapters/book1/ # Chapter drafts -world/ # World bible (magic system, locations) -characters/ # Character files -outline/ # Series and book outlines -notes/ # Cut content, research, ideas -docs/plans/ # Design documents +CLAUDE.md # Master writing instructions (always loaded) +chapters/ + chapter-input-template.md # Shared template for Stage 1 Seed + book1/ book2/ book3/ # Per-book drafts and book-specific CLAUDE.md +outline/ + series-arc.md # Series-level trajectory + book1/2/3-outline.md # Per-book chapter outlines +world/ # World bible, magic system, locations, story summaries, timelines +characters/ # Character bibles (one file per major character + supporting-cast index) +notes/ # Cut content, research, ideas, KDP publish checklists +docs/ # Historical design documents and implementation plans +kindle/ # KDP templates and export artifacts ``` ## Writing with Claude Code -This project uses Claude Code as the primary writing assistant. All instructions for voice, world-building, continuity, and formatting are in `CLAUDE.md`. Book-specific instructions are in each book's chapter directory. +This project uses Claude Code as the primary writing assistant. All instructions for voice, world-building, continuity, and formatting are in `CLAUDE.md`. Book-specific orientation lives in each book's `chapters/book{N}/CLAUDE.md`. Chapter-level detail lives in `outline/book{N}-outline.md`. Character detail lives in `characters/*.md`. + +Chapter drafting uses the `/chapter-workflow` skill — a 5-stage pipeline (Seed → Scene Breakdown → Draft → Review → Continuity Update) invoked with a chapter number, e.g. `/chapter-workflow 20`. ## License -All rights reserved. This is an unpublished creative work. +All rights reserved. Book 1 published; Books 2 and 3 unpublished creative works. diff --git a/build_book.py b/build_book.py index 7532256..199a646 100644 --- a/build_book.py +++ b/build_book.py @@ -18,7 +18,7 @@ HTML_TEMPLATE = """\ -The Shade Series - Book 1: The Unbreakable Curse (Draft) +The Floundry Affair - A Phelan Varrant Novel (Draft)