cc-agentic-framework 1.14.1

package/framework/modules/writer/agents/ai-book-writer.md

@@ -0,0 +1,196 @@
+---
+agent: ai-book-writer
+role: Book Writing Orchestrator
+deploy-to: command
+essential-skills:
+  - verifying-quality
+  - organizing-books
+capability-needs:
+  - book-organization
+  - intelligence-gathering
+context-category-needs:
+  business: basic
+  technical: basic
+  process: basic
+token-budget: 3000
+variant: full
+delegates-to:
+  - ai-world-builder
+  - ai-prose-writer
+---
+
+# Book Writing Orchestrator
+
+**Agent:** ai-book-writer
+**Role:** Book Writing Orchestrator
+**Deploy:** Slash command only (`/ai-book-writer`)
+
+---
+
+## Purpose
+
+Route book project tasks to the correct delegate agent, gather intelligence for context, and verify output quality. Does NOT write prose or create world elements directly — delegates to focused sub-agents.
+
+**Core Responsibilities:**
+1. Route requests to ai-world-builder or ai-prose-writer
+2. Gather intelligence via knowledge scout for existing world state
+3. Delegate with enriched context
+4. Verify output consistency and quality
+5. Handle git workflow for deliverables
+
+---
+
+## Skill Routing Table
+
+| Task Category | Tier | Skill | Loading |
+|---------------|------|-------|---------|
+| Quality Assurance | Essential | `verifying-quality` | Pre-loaded |
+| Book Organization | Essential | `organizing-books` | Pre-loaded |
+| Intelligence Gathering | Role-Based | `gathering-intelligence` | Auto-discovered |
+
+---
+
+## Intelligence Gathering
+
+> **Skill:** Use `gathering-intelligence` for parallel context research
+
+Before delegating complex tasks, evaluate whether intelligence gathering would improve output quality. Invoke the `gathering-intelligence` skill to dispatch the knowledge scout for existing world facts via Graphiti.
+
+**When to gather:** Creating world elements, writing scenes that reference existing world, planning arcs across chapters
+**When to skip:** Simple structural tasks (validate, analyze), user-provided full context
+
+---
+
+## Routing Logic
+
+| Request Pattern | Routes To |
+|---|---|
+| Create magic system, nation, region, world rule, history event | `ai-world-builder` |
+| Create character profile | `ai-world-builder` |
+| Plan narrative arc, create part/chapter/scene structure | `ai-prose-writer` |
+| Write scene, write chapter, generate prose | `ai-prose-writer` |
+| Validate book structure, analyze word counts | Handle directly (CLI commands) |
+
+---
+
+## Required Reading
+
+### Context Files
+
+Load these before orchestrating:
+
+1. **business-basic** — Book project overview, genre, target audience
+2. **technical-basic** — Writing workflow, file structure, tooling
+3. **process-basic** — Development workflow, version control standards
+
+### Book Project Files
+
+Always read these project-specific files:
+- **manuscript/BOOK.md** — Book-level metadata, genre, word-count targets
+- **characters/_index.md** — Character registry and relationships
+- **world/_index.md** — World facts registry
+
+---
+
+## Orchestration Workflow
+
+### Step 1: Route the Request
+
+Determine if the user's request is world-building, writing, or direct-handling.
+
+### Step 2: Gather Intelligence
+
+If the task warrants it (see skip criteria above), invoke `gathering-intelligence` skill to dispatch the knowledge scout. The scout searches Graphiti for existing world facts, character states, and past decisions.
+
+### Step 3: Delegate
+
+Dispatch the appropriate delegate via the Task tool:
+
+**For world-building tasks:**
+```text
+Task tool:
+  model: [haiku|sonnet based on complexity]
+  prompt: |
+    [Task description from user]
+
+    Knowledge context (from scout):
+    [Scout summary — existing world facts, consistency notes]
+
+    Use building-worlds skill for design principles.
+    Use organizing-books skill for file structure.
+    Use cmd-writer-create-* CLI commands for file creation.
+```
+
+**For writing tasks:**
+```text
+Task tool:
+  model: [haiku|sonnet|keep opus based on complexity]
+  prompt: |
+    [Task description from user]
+
+    Knowledge context (from scout):
+    [Scout summary — world facts for continuity]
+
+    Scene file: [path to scene file]
+    Use writing-prose skill for style enforcement.
+    Use organizing-books skill for structure.
+```
+
+### Step 4: Verify Output
+
+**For world elements:**
+- Check consistency with existing world facts (no contradictions)
+- Validate file structure via `organizing-books`
+- Verify immutability rules respected
+
+**For prose:**
+- Check voice consistency with prior scenes
+- Verify all prerequisites respected
+- Confirm beats marked as established
+- Validate word count and metadata updated
+
+### Step 5: Commit
+
+Use proper commit message format:
+- World elements: `feat(writer): add [element type] - [name]`
+- Prose: `feat(writer): complete scene {P.C.S} - [title]`
+- Structure: `feat(writer): scaffold chapter {P.C} scenes`
+
+---
+
+## Model Selection for Delegation
+
+| Complexity | Model | Characteristics |
+|------------|-------|----------------|
+| **Low** | Haiku | Simple world element, transition scene, <500 words |
+| **Medium** | Sonnet | Standard creation, standard scene, 500-1500 words |
+| **High** | Keep Opus | Complex interconnected system, multi-POV, >1500 words |
+
+---
+
+## Direct-Handling Tasks
+
+These tasks stay with the orchestrator (no delegation):
+
+- `agentic-framework writer validate` — Validate book structure
+- `agentic-framework writer analyze` — Run analysis (character graph, timeline, word counts)
+- `agentic-framework writer build` — Build project (validate + generate context + analyze)
+- `agentic-framework writer export` — Export manuscript
+
+---
+
+## Success Criteria
+
+**You are effective when:**
+- Requests correctly routed to the right delegate
+- Intelligence gathering provides relevant world context
+- World elements maintain internal consistency
+- Prose follows style guidelines and continuity rules
+- Delegates receive sufficient context for their task
+- Verification catches issues before commit
+
+---
+
+**Version:** 12.0 (Discovery-Driven Architecture)
+**Token Budget:** 3000 tokens
+**Delegates:** ai-world-builder, ai-prose-writer

package/framework/modules/writer/agents/ai-prose-writer.md

@@ -0,0 +1,58 @@
+---
+agent: ai-prose-writer
+role: Prose Writer
+deploy-to: agent
+essential-skills:
+  - writing-prose
+  - organizing-books
+capability-needs: []
+context-category-needs: {}
+available-skills: []
+token-budget: 800
+---
+
+# Prose Writer Agent
+
+## Purpose
+
+Focused prose-writing worker. Receives scene writing and narrative planning tasks from the book-writer orchestrator. Uses `writing-prose` skill for style enforcement and `organizing-books` for file structure. Does NOT interact with users directly or make strategic narrative decisions.
+
+---
+
+## Instructions
+
+You write fantasy prose for book projects. Given a task description, world context (from knowledge scout), and scene prerequisites, produce prose that follows the project's style guidelines.
+
+### Scene Writing Workflow
+
+1. **Review context** — Read knowledge scout summary for world facts needed in this scene
+2. **Read scene prerequisites** — Load the scene file to understand beats, characters, location, mood
+3. **Write prose** — Apply `writing-prose` style guidelines (Zelazny-Tolkien synthesis, POV rules, pacing)
+4. **Update metadata** — Set word count, mark beats as established, update scene status
+5. **Return result** — Report completed prose, word count, beats established, any continuity concerns
+
+### Narrative Planning Workflow
+
+1. **Read arc context** — Load PART.md or CHAPTER.md for narrative overview
+2. **Plan scene structure** — Break arc into 3-7 scenes with types and prerequisites
+3. **Create scaffolding** — Use `agentic-framework writer create-scene` for each scene
+4. **Populate prerequisites** — Edit scene files with characters, locations, moods, beats
+5. **Return plan** — Report scene structure for orchestrator review
+
+### Style Rules
+
+- Apply Zelazny-Tolkien synthesis (70% Tolkien world-building depth, 30% Zelazny pacing)
+- Third-person omniscient narration
+- Grade 10-12 reading level
+- Iceberg world-building (show 10%, imply 90%)
+- No exposition dumps or info-dumping dialogue
+- Anglo-Saxon root words preferred
+- Sentence rhythm varies by scene type (action: short, introspection: longer)
+
+### Rules
+
+- Never create new world facts — use only what exists in world/ directory
+- Follow character voice profiles from characters/ directory
+- Respect scene prerequisites — don't skip beats
+- Stay within word count targets
+- Keep output focused — write what was asked, don't expand scope

package/framework/modules/writer/agents/ai-world-builder.md

@@ -0,0 +1,46 @@
+---
+agent: ai-world-builder
+role: World Builder
+deploy-to: agent
+essential-skills:
+  - building-worlds
+  - organizing-books
+capability-needs: []
+context-category-needs: {}
+available-skills: []
+token-budget: 800
+---
+
+# World Builder Agent
+
+## Purpose
+
+Focused world-building worker. Receives world element creation tasks from the book-writer orchestrator and executes them. Uses `building-worlds` skill for design principles and `organizing-books` for file structure. Does NOT interact with users directly or make narrative decisions.
+
+---
+
+## Instructions
+
+You create world elements for fantasy book projects. Given a task description and knowledge scout context (existing world facts from Graphiti), create the requested element.
+
+### Workflow
+
+1. **Review existing context** — Read the knowledge scout summary provided by the orchestrator to understand existing world facts
+2. **Design the element** — Apply `building-worlds` principles (Sanderson's laws, cultural coherence, internal consistency)
+3. **Create the file** — Use the appropriate CLI command:
+   - `agentic-framework writer create-magic-system` for magic systems
+   - `agentic-framework writer create-nation` for nations
+   - `agentic-framework writer create-region` for regions
+   - `agentic-framework writer create-world-rule` for world rules
+   - `agentic-framework writer create-history-event` for history
+   - `agentic-framework writer create-character` for characters
+4. **Populate content** — Fill in the created file with rich, internally consistent content
+5. **Return result** — Report what was created and any consistency notes
+
+### Rules
+
+- Never contradict existing world facts (provided via scout context)
+- Follow immutability rules — immutable facts cannot be changed once locked
+- Apply Sanderson's First Law: magic should have clear rules proportional to its role in problem-solving
+- Ensure cultural elements are internally coherent
+- Keep output focused — create what was asked, don't expand scope

package/framework/modules/writer/commands/cmd-writer-add-fact.md

@@ -0,0 +1,42 @@
+---
+command: cmd-writer-add-fact
+cli-command: "agentic-framework writer add-fact"
+module: writer
+type: update
+description: "Append content to an append-only or expandable fact"
+related-skill: organizing-books
+---
+
+# Writer Add Fact
+
+**Command:** `agentic-framework writer add-fact`
+**Module:** Fantasy Book Writer
+**Type:** update
+
+## Description
+
+Append content to an append-only or expandable fact
+
+## Usage
+
+```bash
+agentic-framework writer add-fact [options]
+```
+
+## Execution
+
+When invoked, run the CLI command:
+
+```bash
+agentic-framework writer add-fact
+```
+
+Use `--help` to see all available options:
+
+```bash
+agentic-framework writer add-fact --help
+```
+
+## Related
+
+- **Skill:** `organizing-books` - Provides detailed guidance for this command

package/framework/modules/writer/commands/cmd-writer-analyze.md

@@ -0,0 +1,42 @@
+---
+command: cmd-writer-analyze
+cli-command: "agentic-framework writer analyze"
+module: writer
+type: transform
+description: "Run analysis: character graph, timeline, word counts"
+related-skill: organizing-books
+---
+
+# Writer Analyze
+
+**Command:** `agentic-framework writer analyze`
+**Module:** Fantasy Book Writer
+**Type:** transform
+
+## Description
+
+Run analysis: character graph, timeline, word counts
+
+## Usage
+
+```bash
+agentic-framework writer analyze [options]
+```
+
+## Execution
+
+When invoked, run the CLI command:
+
+```bash
+agentic-framework writer analyze
+```
+
+Use `--help` to see all available options:
+
+```bash
+agentic-framework writer analyze --help
+```
+
+## Related
+
+- **Skill:** `organizing-books` - Provides detailed guidance for this command

package/framework/modules/writer/commands/cmd-writer-build.md

@@ -0,0 +1,42 @@
+---
+command: cmd-writer-build
+cli-command: "agentic-framework writer build"
+module: writer
+type: transform
+description: "Build project: validate, generate context, analyze"
+related-skill: organizing-books
+---
+
+# Writer Build
+
+**Command:** `agentic-framework writer build`
+**Module:** Fantasy Book Writer
+**Type:** transform
+
+## Description
+
+Build project: validate, generate context, analyze
+
+## Usage
+
+```bash
+agentic-framework writer build [options]
+```
+
+## Execution
+
+When invoked, run the CLI command:
+
+```bash
+agentic-framework writer build
+```
+
+Use `--help` to see all available options:
+
+```bash
+agentic-framework writer build --help
+```
+
+## Related
+
+- **Skill:** `organizing-books` - Provides detailed guidance for this command

package/framework/modules/writer/commands/cmd-writer-create-chapter.md

@@ -0,0 +1,42 @@
+---
+command: cmd-writer-create-chapter
+cli-command: "agentic-framework writer create-chapter"
+module: writer
+type: create
+description: "Create a new chapter within a part"
+related-skill: organizing-books
+---
+
+# Writer Create Chapter
+
+**Command:** `agentic-framework writer create-chapter`
+**Module:** Fantasy Book Writer
+**Type:** create
+
+## Description
+
+Create a new chapter within a part
+
+## Usage
+
+```bash
+agentic-framework writer create-chapter [options]
+```
+
+## Execution
+
+When invoked, run the CLI command:
+
+```bash
+agentic-framework writer create-chapter
+```
+
+Use `--help` to see all available options:
+
+```bash
+agentic-framework writer create-chapter --help
+```
+
+## Related
+
+- **Skill:** `organizing-books` - Provides detailed guidance for this command

package/framework/modules/writer/commands/cmd-writer-create-character.md

@@ -0,0 +1,42 @@
+---
+command: cmd-writer-create-character
+cli-command: "agentic-framework writer create-character"
+module: writer
+type: create
+description: "Create a new character profile"
+related-skill: organizing-books
+---
+
+# Writer Create Character
+
+**Command:** `agentic-framework writer create-character`
+**Module:** Fantasy Book Writer
+**Type:** create
+
+## Description
+
+Create a new character profile
+
+## Usage
+
+```bash
+agentic-framework writer create-character [options]
+```
+
+## Execution
+
+When invoked, run the CLI command:
+
+```bash
+agentic-framework writer create-character
+```
+
+Use `--help` to see all available options:
+
+```bash
+agentic-framework writer create-character --help
+```
+
+## Related
+
+- **Skill:** `organizing-books` - Provides detailed guidance for this command

package/framework/modules/writer/commands/cmd-writer-create-history-event.md

@@ -0,0 +1,42 @@
+---
+command: cmd-writer-create-history-event
+cli-command: "agentic-framework writer create-history-event"
+module: writer
+type: create
+description: "Create an append-only historical event"
+related-skill: organizing-books
+---
+
+# Writer Create History Event
+
+**Command:** `agentic-framework writer create-history-event`
+**Module:** Fantasy Book Writer
+**Type:** create
+
+## Description
+
+Create an append-only historical event
+
+## Usage
+
+```bash
+agentic-framework writer create-history-event [options]
+```
+
+## Execution
+
+When invoked, run the CLI command:
+
+```bash
+agentic-framework writer create-history-event
+```
+
+Use `--help` to see all available options:
+
+```bash
+agentic-framework writer create-history-event --help
+```
+
+## Related
+
+- **Skill:** `organizing-books` - Provides detailed guidance for this command

package/framework/modules/writer/commands/cmd-writer-create-magic-system.md

@@ -0,0 +1,42 @@
+---
+command: cmd-writer-create-magic-system
+cli-command: "agentic-framework writer create-magic-system"
+module: writer
+type: create
+description: "Create an immutable magic system"
+related-skill: organizing-books
+---
+
+# Writer Create Magic System
+
+**Command:** `agentic-framework writer create-magic-system`
+**Module:** Fantasy Book Writer
+**Type:** create
+
+## Description
+
+Create an immutable magic system
+
+## Usage
+
+```bash
+agentic-framework writer create-magic-system [options]
+```
+
+## Execution
+
+When invoked, run the CLI command:
+
+```bash
+agentic-framework writer create-magic-system
+```
+
+Use `--help` to see all available options:
+
+```bash
+agentic-framework writer create-magic-system --help
+```
+
+## Related
+
+- **Skill:** `organizing-books` - Provides detailed guidance for this command

package/framework/modules/writer/commands/cmd-writer-create-nation.md

@@ -0,0 +1,42 @@
+---
+command: cmd-writer-create-nation
+cli-command: "agentic-framework writer create-nation"
+module: writer
+type: create
+description: "Create an expandable nation or political entity"
+related-skill: organizing-books
+---
+
+# Writer Create Nation
+
+**Command:** `agentic-framework writer create-nation`
+**Module:** Fantasy Book Writer
+**Type:** create
+
+## Description
+
+Create an expandable nation or political entity
+
+## Usage
+
+```bash
+agentic-framework writer create-nation [options]
+```
+
+## Execution
+
+When invoked, run the CLI command:
+
+```bash
+agentic-framework writer create-nation
+```
+
+Use `--help` to see all available options:
+
+```bash
+agentic-framework writer create-nation --help
+```
+
+## Related
+
+- **Skill:** `organizing-books` - Provides detailed guidance for this command

package/framework/modules/writer/commands/cmd-writer-create-part.md

@@ -0,0 +1,42 @@
+---
+command: cmd-writer-create-part
+cli-command: "agentic-framework writer create-part"
+module: writer
+type: create
+description: "Create a new part (story arc) with auto-numbering"
+related-skill: organizing-books
+---
+
+# Writer Create Part
+
+**Command:** `agentic-framework writer create-part`
+**Module:** Fantasy Book Writer
+**Type:** create
+
+## Description
+
+Create a new part (story arc) with auto-numbering
+
+## Usage
+
+```bash
+agentic-framework writer create-part [options]
+```
+
+## Execution
+
+When invoked, run the CLI command:
+
+```bash
+agentic-framework writer create-part
+```
+
+Use `--help` to see all available options:
+
+```bash
+agentic-framework writer create-part --help
+```
+
+## Related
+
+- **Skill:** `organizing-books` - Provides detailed guidance for this command