@demig0d2/skills 1.0.2 → 1.1.2

package/skills/book-creator/references/kdp_specs.md

@@ -0,0 +1,139 @@
+# KDP Publishing Specifications Reference
+
+Complete KDP interior formatting requirements for print-on-demand.
+
+---
+
+## Trim Sizes (DXA units — 1440 DXA = 1 inch)
+
+| Trim     | Width DXA | Height DXA | Common Use |
+|----------|-----------|------------|------------|
+| 5×8      | 7,200     | 11,520     | Compact non-fiction, poetry |
+| 5.5×8.5  | 7,920     | 12,240     | Standard non-fiction |
+| 6×9      | 8,640     | 12,960     | Most common for trade paperback |
+| 6.14×9.21| 8,842     | 13,262     | Slightly taller trade |
+| 7×10     | 10,080    | 14,400     | Workbooks, textbooks |
+| 8×10     | 11,520    | 14,400     | Illustrated books |
+| 8.5×11   | 12,240    | 15,840     | Workbooks, journals |
+
+---
+
+## Minimum Margins by Page Count
+
+KDP requires larger inside margins as page count increases (to account for binding).
+
+| Page Count | Inside (Gutter) | Outside | Top    | Bottom |
+|------------|-----------------|---------|--------|--------|
+| 24–150     | 0.375"          | 0.25"   | 0.25"  | 0.25"  |
+| 151–300    | 0.5"            | 0.25"   | 0.25"  | 0.25"  |
+| 301–500    | 0.625"          | 0.25"   | 0.25"  | 0.25"  |
+| 501–700    | 0.75"           | 0.25"   | 0.25"  | 0.25"  |
+| 701–828    | 0.875"          | 0.25"   | 0.25"  | 0.25"  |
+
+**Vivid's standard margins (6×9, 200–300 pages):**
+
+| Side    | Inches | DXA   |
+|---------|--------|-------|
+| Inside  | 0.75"  | 1,080 |
+| Outside | 0.6"   | 864   |
+| Top     | 0.75"  | 1,080 |
+| Bottom  | 0.6"   | 864   |
+
+---
+
+## Typography Standards
+
+| Element          | Font     | Size | Weight | Spacing |
+|------------------|----------|------|--------|---------|
+| Body text        | Georgia  | 11pt | Normal | 1.15    |
+| Chapter title    | Georgia  | 18pt | Bold   | Before: 0.5" After: 0.33" |
+| Section heading  | Georgia  | 14pt | Bold   | Before: 0.33" After: 0.17"|
+| Part title       | Georgia  | 20pt | Bold   | Centered, full page |
+| Epigraph         | Georgia  | 10pt | Italic | Centered, 0.5" margins |
+| Footer/Header    | Georgia  | 9pt  | Normal | — |
+
+---
+
+## Body Text Layout
+
+- **Alignment**: Justified
+- **First paragraph** after heading: No indent
+- **Subsequent paragraphs**: First-line indent 0.25" (360 DXA)
+- **Line spacing**: 1.15 (line: 276, lineRule: auto in docx-js)
+- **Paragraph spacing**: 0 before, 0 after (spacing handled by line indent)
+
+---
+
+## Headers and Footers
+
+- **Even pages (verso/left)**: Book title, left-aligned
+- **Odd pages (recto/right)**: Chapter title, right-aligned
+- **Chapter first page**: No header (suppress)
+- **Part divider pages**: No header, no footer
+- **Page numbers**: Bottom outside (left on even, right on odd)
+- **Start page numbering**: From Chapter 1 (front matter uses Roman numerals or no numbers)
+
+---
+
+## Front Matter Order (standard KDP)
+
+1. Half-title page (title only)
+2. Also by the author (optional)
+3. Title page (title + subtitle + author)
+4. Copyright page
+5. Dedication
+6. Table of Contents
+7. Foreword / Preface (if any)
+8. Introduction
+
+## Back Matter Order
+
+1. Epilogue / Conclusion
+2. Acknowledgments
+3. About the Author
+4. Also by the Author (optional)
+5. Index (non-fiction)
+6. Bibliography (academic)
+
+---
+
+## Image Requirements
+
+| Type  | Minimum DPI | Color Mode | Format |
+|-------|-------------|------------|--------|
+| B&W   | 300 DPI     | Grayscale  | PNG/TIFF |
+| Color | 300 DPI     | RGB        | PNG/TIFF |
+| Cover | 300 DPI     | RGB        | JPG/TIFF |
+
+---
+
+## File Requirements
+
+- **Format**: DOCX (recommended) or PDF
+- **Max file size**: 650 MB
+- **Fonts**: Must be embedded or standard system fonts
+- **No password protection**
+- **No form fields**
+
+---
+
+## Page Count Estimator
+
+At 11pt Georgia, 1.15 spacing, 6×9 with standard margins:
+- ~250–280 words per page
+- 20,000 words ≈ 75–80 pages
+- 40,000 words ≈ 145–160 pages
+- 60,000 words ≈ 215–240 pages
+- 80,000 words ≈ 290–320 pages
+
+---
+
+## Common KDP Rejection Reasons
+
+1. Margins too small (especially inside/gutter)
+2. Images below 300 DPI
+3. Fonts not embedded
+4. Blank pages at unexpected locations
+5. File size over 650 MB
+6. Page size doesn't match trim size selected at upload
+7. Header/footer content in the margin bleed area

package/skills/book-creator/references/log_schema.md

@@ -0,0 +1,149 @@
+# Continuity Log — Schema Reference
+
+The continuity log is a JSON file (`continuity_log.json`) maintained
+alongside the manuscript. This document describes every field.
+
+---
+
+## Full Schema
+
+```json
+{
+  "book_title": "string — the book's working title",
+  "created": "ISO datetime — when the log was initialized",
+  "last_updated": "ISO datetime — last update timestamp",
+  "last_chapter": "integer — last chapter number completed",
+
+  "commitments": [
+    "string — book-level promises established in front matter/intro"
+  ],
+
+  "established_facts": [
+    "string — factual details about the author's story, must stay consistent"
+  ],
+
+  "metaphors": {
+    "by_chapter": {
+      "1": ["metaphor used in chapter 1", "another metaphor"],
+      "2": ["metaphor used in chapter 2"]
+    },
+    "available": ["strong images not yet used"],
+    "retired": ["all metaphors used — do not repeat"]
+  },
+
+  "insights": {
+    "1": "Core insight fully delivered in chapter 1",
+    "2": "Core insight delivered in chapter 2"
+  },
+
+  "tone_decisions": {
+    "register": "string — e.g., intimate/confessional in My Story",
+    "reader_address": "string — e.g., direct 'you' in Reflection",
+    "author_position": "string — e.g., always in-process, never above",
+    "emotional_ceiling": "string — e.g., darkest content in Ch.1"
+  },
+
+  "structural_patterns": {
+    "section_format": "string — e.g., My Story + My Reflection",
+    "avg_chapter_words": "integer — running average",
+    "opening_style": "string — e.g., immersive scene",
+    "closing_style": "string — e.g., single reframe sentence",
+    "chapter_word_counts": [2400, 2200, 2600]
+  },
+
+  "open_threads": [
+    {
+      "thread": "string — the thread description",
+      "introduced_in": "string — chapter number",
+      "closed": false,
+      "added": "ISO datetime"
+    }
+  ],
+
+  "closed_threads": [
+    {
+      "thread": "string",
+      "introduced_in": "string",
+      "closed": true,
+      "closed_in": "string — chapter where resolved",
+      "added": "ISO datetime"
+    }
+  ],
+
+  "chapter_summaries": {
+    "1": {
+      "title": "Chapter 1 title",
+      "summary": "One-paragraph summary of what was covered"
+    }
+  }
+}
+```
+
+---
+
+## Field Guidelines
+
+### `commitments`
+Book-level promises that must never be contradicted. Examples:
+- "Author frames himself as someone who lived this, not an expert"
+- "Book promises no quick fixes — lasting transformation only"
+- "Author is always in-process, never looking back from arrival"
+
+### `established_facts`
+All narrative details stated in the manuscript that must remain consistent:
+- "Father passed away during author's degree years"
+- "Lived in a tiny penthouse apartment alone"
+- "Walked miles to save money on transport"
+- "Cooked rice and lentils, stretched groceries"
+
+### `metaphors.retired`
+Once a metaphor is used anywhere in the manuscript, it goes here.
+The conflict checker (`conflict_check.py`) scans new chapters against this list.
+
+### `insights`
+One core insight per chapter. Track to avoid restating:
+- Ch.1: "Loneliness as mirror of self-relationship"
+- Ch.2: "Chasing connection from fear, not love, creates neediness"
+- Ch.3: "Aloneness and loneliness are different — one is chosen"
+
+### `open_threads`
+Thematic or narrative threads introduced that haven't been resolved:
+- "Ch.2 mentioned 'the small proof that my life has value' — needs deeper exploration"
+- "Ch.3 established reader's 'wrong attempts' pattern — needs to pay off in Ch.7"
+
+---
+
+## CLI Quick Reference
+
+```bash
+# Initialize
+python log_manager.py init "My Book Title"
+
+# Add chapter
+python log_manager.py add-chapter 1 "Why It Hurts So Much"
+
+# Add established fact
+python log_manager.py add-fact "Author's father passed during degree years"
+
+# Add insight delivered
+python log_manager.py add-insight 1 "Loneliness as mirror of self-relationship"
+
+# Add metaphor (auto-retires it)
+python log_manager.py add-metaphor 1 "deafening scream inside my head"
+
+# Add open thread
+python log_manager.py add-thread "Ch.2 mentioned small proof of self-value — needs depth"
+
+# Close a thread (by index)
+python log_manager.py threads          # list open threads
+python log_manager.py close-thread 0  # close thread at index 0
+
+# View full log
+python log_manager.py show
+
+# Summary only
+python log_manager.py summary
+
+# Conflict check before finalizing a chapter
+python conflict_check.py chapter_5.md --log continuity_log.json
+```

package/skills/book-creator/references/patterns_quick_ref.md

@@ -0,0 +1,71 @@
+# AI Pattern Quick Reference
+
+All 25 documented AI writing patterns from Wikipedia's "Signs of AI Writing" guide.
+Used by `scan_ai_patterns.py` and the humanizer skill.
+
+---
+
+## CONTENT PATTERNS (1–6)
+
+| # | Pattern | Key Trigger Words |
+|---|---------|------------------|
+| 1 | Significance Inflation | stands/serves as, testament to, pivotal moment, underscores, evolving landscape |
+| 2 | Notability Claims | national media outlets, active social media presence, leading expert |
+| 3 | Superficial -ing Endings | highlighting..., symbolizing..., contributing to..., showcasing... |
+| 4 | Promotional Language | vibrant, nestled, breathtaking, groundbreaking, renowned, stunning |
+| 5 | Vague Attributions | experts argue, observers say, many believe, several sources |
+| 6 | Challenges/Future Sections | Despite challenges... continues to thrive, Future Outlook |
+
+## LANGUAGE & GRAMMAR (7–12)
+
+| # | Pattern | Key Trigger Words |
+|---|---------|------------------|
+| 7 | AI Vocabulary | delve, tapestry, multifaceted, nuanced, embark, realm, foster, transformative |
+| 8 | Copula Avoidance | serves as, stands as, represents a, boasts, features, offers a |
+| 9 | Negative Parallelism | "It's not just X; it's Y" / "Not merely X, but Y" |
+| 10 | Rule of Three | Exactly 3 abstract parallel items used as rhetorical device |
+| 11 | Synonym Cycling | Excessive substitution: protagonist → main character → central figure |
+| 12 | False Ranges | "from X to Y, from A to B" where items aren't on a real scale |
+
+## STYLE PATTERNS (13–18)
+
+| # | Pattern | Key Trigger Words |
+|---|---------|------------------|
+| 13 | Em Dash Overuse | — used as default connector more than 2× per page |
+| 14 | Boldface Overuse | **Bold** applied mechanically in prose |
+| 15 | Inline-Header Lists | **Header:** description as bullet items |
+| 16 | Title Case in Headings | Every Main Word Capitalized In Heading |
+| 17 | Emojis | 🚀 💡 ✅ in headings or bullets |
+| 18 | Curly Quotes | "smart" curly quotes in manuscripts |
+
+## COMMUNICATION PATTERNS (19–21)
+
+| # | Pattern | Key Trigger Words |
+|---|---------|------------------|
+| 19 | Chatbot Artifacts | I hope this helps, Let me know, Of course!, Feel free to |
+| 20 | Knowledge-Cutoff Disclaimers | "as of [date]", "while specific details are limited" |
+| 21 | Sycophantic Tone | Great question!, You're absolutely right!, That's excellent |
+
+## FILLER & HEDGING (22–25)
+
+| # | Pattern | Key Trigger Words |
+|---|---------|------------------|
+| 22 | Filler Phrases | In order to, Due to the fact that, At this point in time |
+| 23 | Hedging Overload | could potentially possibly be argued that might |
+| 24 | Generic Positive Conclusions | The future looks bright, Exciting times ahead |
+| 25 | Hyphen Overuse | cross-functional, data-driven, decision-making, well-known |
+
+---
+
+## PROTECTED — NEVER STRIP (Vivid's DNA)
+
+These constructions superficially match patterns above but are protected:
+
+| Construction | Why Protected | Strip Instead |
+|---|---|---|
+| "Not the silence, but what it forced me to face" | Grounded in specific experience | "Not just X; it's Y" (abstract) |
+| Parallel phrases building to emotional peak | Earned accumulation | Generic 3-item lists |
+| Em dash around emotionally significant phrase | Rhythmic weight | Em dash as default connector |
+| "But here's..." / "The hardest part wasn't..." | Signature phrases | Generic pivots |
+| insidious, agonizing, desolate, suffocating | Name felt experience | vibrant, groundbreaking, stunning |
+| Physical imagery: "pressed down on my chest" | Specific + grounded | Recycled: journey, storm, burden |

package/skills/book-creator/references/thinkers_reference.md

@@ -0,0 +1,104 @@
+# Thinkers Reference — Vivid's Genres
+
+Curated reference of thinkers, works, and ideas aligned with Vivid's
+writing genres: Philosophy/Essay, Self-help/Motivational, Non-fiction/Technical.
+
+Use as scaffolding — not direct citation. Vivid arrives at these conclusions
+through experience, then names them simply. Max 1 citation per chapter.
+
+---
+
+## SOLITUDE & INNER LIFE
+
+| Thinker | Key Work | Core Idea | Chapter Applications |
+|---|---|---|---|
+| Rainer Maria Rilke | Letters to a Young Poet | Solitude as the place where creation and self-knowledge happen | Chapters on embracing aloneness, inner world |
+| Blaise Pascal | Pensées | "All of humanity's problems stem from man's inability to sit quietly in a room alone" | Chapters on distraction, running from self |
+| Henry David Thoreau | Walden | Deliberate solitude as the condition for genuine life | Chapters on choosing aloneness |
+| Søren Kierkegaard | The Sickness Unto Death | The self must relate itself to itself | Chapters on self-relationship, identity |
+| Michel de Montaigne | Essays | "The greatest thing in the world is to know how to belong to oneself" | Chapter closings, independence |
+
+---
+
+## PHILOSOPHY OF IDENTITY & SELF
+
+| Thinker | Key Work | Core Idea | Chapter Applications |
+|---|---|---|---|
+| Epictetus | Enchiridion | Distinguish what is in your control from what is not | Chapters on letting go, acceptance |
+| Marcus Aurelius | Meditations | The inner citadel — strength from within regardless of external events | Emotional independence chapters |
+| Albert Camus | The Myth of Sisyphus | Finding meaning in the absence of inherent meaning | Chapters on finding purpose alone |
+| Jean-Paul Sartre | Existentialism is a Humanism | Existence precedes essence — you define yourself | Identity chapters |
+| Viktor Frankl | Man's Search for Meaning | Meaning can be found in suffering; no one can take your inner freedom | Chapters on finding strength in hardship |
+
+---
+
+## PSYCHOLOGY OF SELF & RELATIONSHIPS
+
+| Thinker | Key Work | Core Idea | Chapter Applications |
+|---|---|---|---|
+| Carl Rogers | On Becoming a Person | Unconditional positive self-regard as the foundation of health | Self-acceptance chapters |
+| Nathaniel Branden | The Six Pillars of Self-Esteem | Self-esteem as self-efficacy + self-respect | Self-worth chapters |
+| John Bowlby | Attachment Theory | Anxious attachment drives compulsive connection-seeking | Chapters on chasing connection |
+| Harriet Lerner | The Dance of Anger | Pursuing and distancing patterns in relationships | Chapters on relational patterns |
+
+---
+
+## EASTERN & CONTEMPLATIVE FRAMEWORKS
+
+| Framework | Core Idea | Chapter Applications |
+|---|---|---|
+| Non-attachment (Buddhist/Vedic) | Suffering arises from clinging — to people, outcomes, self-image | Chapters on letting go of outcomes |
+| Witness consciousness (Advaita) | The observer within who watches without judgment | Chapters on self-reflection |
+| Stoic practice | Focus exclusively on what is within your sphere of influence | Chapters on control, acceptance |
+| Wabi-sabi (Japanese) | Finding beauty in imperfection and impermanence | Chapters on accepting the self as incomplete |
+
+---
+
+## QUOTES — VIVID-APPROPRIATE (pre-validated)
+
+All under 30 words. None overexposed.
+
+**Solitude & Self:**
+- "The capacity to be alone is the capacity to love." — Osho
+- "In solitude the mind gains strength and learns to lean upon itself." — Laurence Sterne
+- "I exist as I am, that is enough." — Walt Whitman
+- "To be alone is to be different, to be different is to be alone." — Suzanne Gordon
+
+**Identity & Strength:**
+- "He who knows others is wise; he who knows himself is enlightened." — Lao Tzu
+- "You are enough just as you are." — Meghan Markle (quoting Brené Brown — better to find original)
+- "The privilege of a lifetime is to become who you truly are." — Carl Jung
+- "Without great solitude, no serious work is possible." — Pablo Picasso
+
+**Pain & Growth:**
+- "The wound is the place where the Light enters you." — Rumi
+- "Out of suffering have emerged the strongest souls." — Khalil Gibran
+- "Rock bottom became the solid foundation on which I rebuilt my life." — J.K. Rowling
+
+---
+
+## WHAT TO AVOID
+
+### Sources that conflict with Vivid's voice:
+- Tony Robbins, Brené Brown (pop psychology — too mainstream)
+- Gary Vee, Grant Cardone (hustle culture)
+- Marie Kondo, life-hack culture
+- Any quote from a "motivational poster"
+
+### Overexposed quotes (never use):
+- "Be the change you wish to see in the world" (misattributed to Gandhi)
+- "The unexamined life is not worth living" (Socrates — too academic)
+- "Insanity is doing the same thing and expecting different results" (misattributed to Einstein)
+- "You miss 100% of the shots you don't take" (Wayne Gretzky via Michael Scott)
+- "In the middle of difficulty lies opportunity" (Einstein)
+
+---
+
+## HOW TO USE THIS REFERENCE
+
+1. Identify the chapter's core theme
+2. Find 1–2 relevant thinkers from this list
+3. Note the **core idea** — use this as scaffolding, not as text
+4. Write the chapter so Vivid arrives at this idea through experience
+5. If the quote is perfect and under 30 words: use it once, at the end, to confirm
+6. Never open a chapter with a quote from a thinker — earn the insight first