cc-agentic-framework 1.14.1

package/framework/modules/writer/skills/writer/writing-prose/examples/zelazny-style.md

@@ -0,0 +1,415 @@
+# Zelazny-Style Examples
+
+Extended examples demonstrating Roger Zelazny's narrative techniques with annotations explaining what makes them effective.
+
+## Example 1: Opening with Voice and Mystery
+
+```
+I woke up in a hospital bed. This wasn't unusual. What was unusual
+was not remembering how I got there.
+
+I tried to sit up. Bad idea. Everything hurt. The kind of hurt that
+suggested I'd done something monumentally stupid and survived it
+anyway. That part was familiar. The surviving, not the stupid. Well,
+maybe both.
+
+A nurse came in. She looked surprised to see me awake. That was
+never a good sign.
+
+"You're not supposed to be conscious," she said.
+
+"Story of my life," I told her. "What happened?"
+
+"You died. Twice."
+
+"Only twice? I'm losing my touch."
+```
+
+**Annotations:**
+
+**First-person immediacy:**
+- Opens mid-situation (woke up in hospital)
+- No preamble or setup
+- Reader dropped into POV's confusion
+
+**Sardonic voice:**
+- "Story of my life" deflects concern with humor
+- "I'm losing my touch" treats death casually
+- Self-aware about pattern of stupid survival
+
+**Economy of language:**
+- Short sentences build rhythm
+- "Bad idea" paragraph = 2 sentences
+- No wasted words describing hospital in detail
+
+**Mystery established:**
+- Doesn't remember (unusual for character)
+- Died twice (raises questions)
+- Nurse surprised (implies something strange)
+
+**Character revealed through response:**
+- Humor as defense mechanism
+- Experienced with near-death
+- Not taking situation seriously (or hiding fear with jokes)
+
+## Example 2: Combat Scene
+
+```
+He came at me with the knife. I wasn't there when he arrived.
+
+The blade scraped the wall where I'd been. Stone chips flew. He
+was strong. And fast. And very clearly trying to kill me.
+
+Three out of three. Not a great combination.
+
+I kicked his knee. He grunted. Didn't go down. Bad sign. I'd
+put force behind that kick. Normal people went down.
+
+He wasn't normal people.
+
+The knife came back around. I blocked with my forearm. Felt the
+edge bite through my jacket. Not deep. But deep enough to piss
+me off.
+
+I grabbed his wrist. Twisted. He should have dropped the knife.
+
+He didn't.
+
+Worse. He smiled.
+
+I adjusted my assessment. Not human. Or not entirely human. That
+changed the math significantly.
+
+Math said I should run.
+
+I hate math.
+```
+
+**Annotations:**
+
+**Action economy:**
+- One action per sentence
+- "I wasn't there when he arrived" = efficient dodge description
+- No elaborate choreography
+- Focus on outcome over process
+
+**Character voice maintained:**
+- "Three out of three. Not a great combination."
+- "I hate math." = personality in combat
+- Sardonic even while losing fight
+
+**Escalation through detail:**
+- Starts with "strong and fast"
+- "Didn't go down" elevates threat
+- "Should have dropped the knife" further escalation
+- "He smiled" = peak threat indicator
+
+**Internal monologue as analysis:**
+- "I'd put force behind that kick"
+- "I adjusted my assessment"
+- Character thinking tactically while fighting
+
+**Paragraph rhythm:**
+- Single-sentence paragraphs for emphasis
+- "He didn't." / "Worse. He smiled."
+- White space creates impact
+
+**Understated danger:**
+- "That changed the math significantly"
+- Massive understatement for "I might die"
+- Typical Zelazny casualness about mortal threat
+
+## Example 3: Philosophical Reflection
+
+```
+Immortality sounds great until you've lived a few centuries.
+Then you realize the problem isn't dying. It's watching everyone
+else die while you keep going.
+
+The Pattern granted long life. Very long. I'd stopped counting
+after the first millennium. What was the point? The numbers just
+got depressing.
+
+Everyone I'd known as a young man was dust. Their children were
+dust. Their children's children were historical footnotes I'd
+have to look up to remember.
+
+That's the thing about immortality—it's not the years that get
+you. It's the accumulation of empty spaces where people used to be.
+
+I stood in front of my brother's grave. I couldn't remember which
+brother anymore. I'd lost three. Or four. The graves all looked
+the same after enough time.
+
+I should have felt something. Grief. Loss. Something.
+
+I felt tired.
+
+That was worse.
+```
+
+**Annotations:**
+
+**Opening with universal truth:**
+- "Immortality sounds great until..."
+- Invites reader agreement, then subverts
+
+**Personal experience grounds abstraction:**
+- Not theoretical immortality
+- Character has lived it
+- "I'd stopped counting after the first millennium"
+
+**Accumulating emptiness:**
+- Everyone → children → children's children
+- Progression shows time scale
+- "Historical footnotes" = devastating detail
+
+**Metaphor that works:**
+- "Empty spaces where people used to be"
+- Not overwrought or purple
+- Precise and painful
+
+**Emotional distance:**
+- "I couldn't remember which brother"
+- Horror in casual statement
+- Not melodramatic, more effective for understatement
+
+**Twist on expected emotion:**
+- Expects grief
+- Feels tired
+- "That was worse" = philosophical insight
+
+**Paragraph structure:**
+- Builds from general to specific
+- Ends on personal failure to feel
+- Short paragraphs for emotional weight
+
+## Example 4: Dialogue with Subtext
+
+```
+"You could surrender," she suggested.
+
+I considered it. I really did. For almost half a second.
+
+"What would I be surrendering to?"
+
+"Life. Safety. A chance to not die horribly in the next few minutes."
+
+"You say that like it's a good thing."
+
+She blinked. "Most people consider not dying horribly to be a
+priority."
+
+"I'm not most people."
+
+"Clearly." She sighed. "Why do I bother?"
+
+"Excellent question. I've been wondering that myself." I checked
+my blade. Still sharp. Still likely to get me killed. "You should
+probably leave. Things are about to get messy."
+
+"I'm staying."
+
+"I wasn't asking for company."
+
+"Good. Because I wasn't offering." She drew her own weapon. "I'm
+offering backup. Try not to die before I get a chance to say I
+told you so."
+
+"Deal."
+```
+
+**Annotations:**
+
+**Subtext layered:**
+- She's not really offering surrender
+- Testing his resolve
+- He knows it, plays along
+
+**Character through choice:**
+- Considers surrender for "half a second"
+- Acknowledges option then rejects it
+- Shows values through action
+
+**Humor defuses tension:**
+- "You say that like it's a good thing"
+- Not taking danger seriously (externally)
+- Defense mechanism visible
+
+**Reversal:**
+- She appears to be leaving
+- Actually staying to fight
+- Relationship revealed through inversion
+
+**Banter as intimacy:**
+- They understand each other
+- "I told you so" permission = trust
+- Fighting together assumed, not negotiated
+
+**Minimal tags:**
+- Most exchanges untagged
+- Voices distinct enough
+- Action beats preferred ("She drew her own weapon")
+
+**Economy of exchange:**
+- Quick volleys
+- No lengthy explanations
+- Relationship evident in brevity
+
+## Example 5: World-Building Through Experience
+
+```
+I'd walked through a thousand shadows. Maybe ten thousand. After
+a while they blurred together—infinite variations on the same
+themes. A city here, a forest there. Mountains, oceans, deserts.
+Different details, same basic template.
+
+This shadow was wrong.
+
+I couldn't put my finger on what made it different. The sky was
+blue. The sun was bright. The grass was green. Everything looked
+normal.
+
+Everything felt wrong.
+
+I'd learned to trust that feeling. The Pattern changed you when
+you walked it. One of the changes was a kind of sensitivity to
+the way reality was supposed to work. This reality wasn't working
+right.
+
+Something had broken it. Or bent it. Or was in the process of
+breaking it right now.
+
+I drew my blade. Probably wouldn't help against whatever could
+bend reality. But it made me feel better.
+
+That's what weapons are for, sometimes. Making you feel better
+about problems they can't solve.
+```
+
+**Annotations:**
+
+**Scale established casually:**
+- "Thousand shadows. Maybe ten thousand."
+- Infinite multiverse treated as routine
+- Character experience shows through numbness
+
+**Pattern recognition:**
+- Lists normal elements (blue sky, bright sun)
+- Contrast with "everything felt wrong"
+- Visceral rather than intellectual wrongness
+
+**Magic system revealed organically:**
+- Pattern changes walkers
+- Grants sensitivity
+- Explained through character understanding, not lecture
+
+**Building tension through wrongness:**
+- Can't identify specific problem
+- Knows something is wrong
+- Trust in instinct over analysis
+
+**Philosophical observation:**
+- "Making you feel better about problems they can't solve"
+- Deeper truth about violence and security
+- Delivered casually, not preachy
+
+**Character voice consistent:**
+- Sardonic even when afraid
+- Self-aware about limits
+- Practical despite cosmic stakes
+
+## Example 6: Internal Monologue and Decision
+
+```
+I had three choices. All of them bad.
+
+Option one: Go through the front door. Straightforward. Honest.
+Also suicidal. They'd kill me before I made it ten feet.
+
+Option two: Sneak in the back. Clever. Subtle. Except they knew
+I was coming. They'd be watching the back door. Maybe even more
+carefully than the front.
+
+Option three: Don't go in at all. Walk away. Let someone else
+handle it. Probably the smartest option.
+
+I stared at the building. Someone else wouldn't handle it. I
+knew that. This was my problem. Had been from the start.
+
+Walking away wasn't actually an option. It just looked like one
+if you didn't think about it too hard.
+
+I thought about it too hard. Professional hazard.
+
+That left options one and two. Or some variation thereof. Maybe
+a combination. Front door as distraction, back door as actual
+entry?
+
+No. Too complicated. Complicated plans fell apart. Simple plans
+at least fell apart in predictable ways.
+
+Front door it was. I'd survived suicidal before.
+
+I straightened my jacket. Checked my blade. Took a deep breath.
+
+Then I walked through the front door like I owned the place.
+```
+
+**Annotations:**
+
+**Systematic analysis:**
+- Lists options methodically
+- Evaluates each honestly
+- Admits flaws in own thinking
+
+**Self-awareness:**
+- "Probably the smartest option"
+- Knows walking away is smart
+- Acknowledges won't do it anyway
+
+**Character values revealed:**
+- "My problem. Had been from the start."
+- Responsibility over safety
+- Personal code drives decision
+
+**Thought process:**
+- Considers combinations
+- Rejects complexity
+- Settles on simple direct approach
+
+**Humor about mortality:**
+- "I'd survived suicidal before"
+- Death-defying as resume item
+- Casual about danger
+
+**Action follows decision:**
+- No extended preparation
+- Simple physical actions
+- Commits fully once decided
+
+**Final line confidence:**
+- "Like I owned the place"
+- False confidence as weapon
+- Zelazny hero archetype
+
+## Key Zelazny Techniques Summary
+
+1. **Voice First** - Personality in every sentence
+2. **Economy** - Short sentences, sharp observations
+3. **Sardonic Tone** - Humor undercuts drama
+4. **Self-Awareness** - Character knows their patterns
+5. **Casual Cosmic** - Huge stakes treated routinely
+6. **Action Minimal** - One action per sentence in fights
+7. **Philosophy Light** - Deep ideas delivered casually
+8. **Mystery Maintained** - Always more beneath surface
+9. **Subtext Heavy** - Characters don't explain everything
+10. **Understatement** - Deadly situations described mildly
+
+---
+
+**Reading Level:** Grade 10-12 maintained throughout
+**Sentence Avg:** 8-12 words (action) to 15-18 (reflection)
+**Paragraph Max:** 5 sentences, often 2-3
+
+**Next:** See [tolkien-style.md](./tolkien-style.md) for contrasting approach.

package/framework/modules/writer/src/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/framework/modules/writer/templates/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "0.1.0",
+  "description": "Fantasy book project built with Agentic Framework Writer module",
+  "private": true,
+  "scripts": {
+    "build": "node -r tsx/register ./node_modules/@agentic-framework/cli/dist/writer/build.js",
+    "build:watch": "npm run build -- --watch",
+    "analyze": "node -r tsx/register ./node_modules/@agentic-framework/cli/dist/writer/analyze.js",
+    "export": "node -r tsx/register ./node_modules/@agentic-framework/cli/dist/writer/export.js",
+    "export:md": "npm run export -- --format md",
+    "export:html": "npm run export -- --format html",
+    "validate": "npx agentic-framework writer validate",
+    "validate:immutability": "npx agentic-framework writer validate-immutability",
+    "context": "npx agentic-framework writer generate-context"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "tsx": "^4.7.0",
+    "vite": "^5.0.0",
+    "yaml": "^2.3.4",
+    "ajv": "^8.12.0",
+    "ajv-formats": "^2.1.1"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/framework/modules/writer/templates/world/baseline.template.md

@@ -0,0 +1,183 @@
+---
+id: baseline-{{bookName}}
+title: "Book Baseline - {{bookTitle}}"
+type: baseline
+established: {{date}}
+book: {{bookName}}
+world-snapshot:
+  date: "{{worldDate}}"
+  era: "{{era}}"
+  major-events-concluded: []
+  major-events-active: []
+token-budget:
+  full: 2000
+  summary: 400
+---
+
+# Book Baseline: {{bookTitle}}
+
+## Purpose
+
+This baseline defines the world state at the exact moment this book begins. It captures:
+- What the reader knows (or doesn't know yet)
+- What the AI needs to know for consistent writing
+- Character states and locations
+- Active conflicts and tensions
+- Established facts vs. future reveals
+
+## World State When Book Opens
+
+### Timeline Position
+
+**World Date:** {{worldDate}}
+**Era:** {{era}}
+**Time Since Last Major Event:** [Duration]
+
+### Political Situation
+
+[Current political landscape - alliances, tensions, power structures]
+
+### Geographic Context
+
+[Where the story takes place - primary locations at book start]
+
+### Active Conflicts
+
+[Ongoing tensions, wars, disputes at the time the book begins]
+
+### Social Climate
+
+[General mood, cultural trends, societal concerns]
+
+### Recent Events
+
+[What has happened recently that affects the opening of this book]
+
+## Character States at Book Opening
+
+| Character | Location | Status | Physical State | Mental State | Knowledge State |
+|-----------|----------|--------|----------------|--------------|-----------------|
+| [Name] | [Where they are] | [Alive/Role] | [Condition] | [State of mind] | [What they know] |
+| [Name] | [Where] | [Status] | [Condition] | [State] | [Knowledge] |
+
+### Character Relationships
+
+[Map of relationships between characters at book start]
+
+### Character Goals
+
+- **[Character]**: [What they want at book opening]
+- **[Character]**: [Goal]
+
+## Magic State
+
+[If magic system evolves: what magic exists and what's known about it at this point]
+
+## Technology State
+
+[What technology exists, what's available to characters]
+
+## Resources and Items
+
+[Important artifacts, items, resources that exist at book start]
+
+## What Reader Knows at Start
+
+### Information Available to Reader
+
+[List what information the reader has at the beginning of this book]
+
+### Mysteries and Unknowns
+
+[What the reader does NOT know yet - future reveals]
+
+## What AI Needs to Know
+
+### Full Context (Not Yet Revealed to Reader)
+
+[Complete information the AI needs for consistent writing, even if reader doesn't know it yet]
+
+### Future Plot Points
+
+[Major reveals planned for later - AI needs to avoid contradicting these]
+
+### Character Secrets
+
+[Hidden information about characters that will be revealed later]
+
+## Constraints for This Book
+
+### World Facts That Apply
+
+[List of world facts (by ID) that are relevant to this book]
+
+### Facts Not Yet Established
+
+[What doesn't exist yet in the world at this point in the timeline]
+
+### Canon Boundaries
+
+[What must stay consistent with previous books if this is a series]
+
+## Context Loading Strategy
+
+### Essential Context (Always Load)
+
+Priority 1 - Critical facts:
+- [Fact ID]: [Brief description]
+- [Fact ID]: [Brief description]
+
+### Standard Context (Load for Most Scenes)
+
+Priority 2 - Important background:
+- [Fact ID]: [Brief description]
+- [Fact ID]: [Brief description]
+
+### Optional Context (Load on Demand)
+
+Priority 3 - Nice to have:
+- [Fact ID]: [Brief description]
+
+### Token Budget Allocation
+
+- Character states: ~400 tokens
+- World state: ~600 tokens
+- Magic/rules: ~500 tokens
+- History relevant to plot: ~500 tokens
+- **Total:** ~2000 tokens
+
+---
+
+## Summary (400 tokens max)
+
+<!-- BASELINE-SUMMARY: START -->
+[Compact baseline summary for token-efficient loading. Include:
+- When and where the book begins
+- Key character positions
+- Active conflicts
+- What reader knows vs. what AI knows
+- Critical constraints
+
+This summary should be sufficient for the AI to start writing the book with correct context.]
+<!-- BASELINE-SUMMARY: END -->
+
+---
+
+## Validation Checklist
+
+- [ ] All character states defined
+- [ ] World state accurately reflects timeline
+- [ ] Reader knowledge vs. AI knowledge clearly separated
+- [ ] Token budget allocation realistic
+- [ ] All referenced world facts exist
+- [ ] Constraints documented
+- [ ] Summary captures essential information
+- [ ] No contradictions with previous books (if series)
+
+## Update Log
+
+[Track updates to this baseline as the book is written]
+
+| Date | Change | Reason |
+|------|--------|--------|
+| {{date}} | Initial baseline | Book planning |

package/framework/modules/writer/templates/world/history-event.template.md

@@ -0,0 +1,89 @@
+---
+id: world-history-{{name}}
+title: "{{title}}"
+type: world-fact
+category: history
+mutability: append-only
+established: {{date}}
+content-hash: ""
+token-count: 0
+era: "{{era}}"
+date-in-world: "{{worldDate}}"
+additions: []
+depends-on: []
+referenced-by: []
+---
+
+# {{title}}
+
+## Original Content (LOCKED - established {{date}})
+
+### When It Happened
+
+**Era:** {{era}}
+**Date:** {{worldDate}}
+**Duration:** [How long the event lasted]
+
+### What Happened
+
+[Detailed description of the historical event - this section is IMMUTABLE]
+
+### Key Figures
+
+[Important people involved in this event]
+
+#### Primary Actors
+
+- **[Name]**: [Role and significance]
+- **[Name]**: [Role and significance]
+
+#### Supporting Figures
+
+- **[Name]**: [Brief role]
+
+### Causes
+
+[What led to this event - precipitating factors]
+
+### The Event Itself
+
+[Detailed chronology of what occurred]
+
+### Immediate Consequences
+
+[What happened as a direct result]
+
+### Geographic Scope
+
+[Where this event took place and what areas it affected]
+
+---
+
+## Additions
+
+<!-- New content added after establishment goes here -->
+<!-- Each addition must be logged in frontmatter additions array -->
+
+<!-- Example addition format:
+### Long-term Impact (Added: 2026-03-15)
+
+[New information discovered or revealed later in the series]
+-->
+
+---
+
+## Summary
+
+<!-- SUMMARY: START -->
+[Brief summary of the event - who, what, when, where, why - in 100-150 words for efficient context loading]
+<!-- SUMMARY: END -->
+
+---
+
+## Story Relevance
+
+[How this historical event affects your books - legacy, character motivations, current conflicts stemming from this event]
+
+## References in Books
+
+[Track where this event is mentioned or referenced across your series]