cc-agentic-framework 1.14.1

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

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

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

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

package/framework/modules/writer/commands/cmd-writer-create-world-rule.md

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

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

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

package/framework/modules/writer/commands/cmd-writer-generate-context.md

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

package/framework/modules/writer/commands/cmd-writer-init-baseline.md

@@ -0,0 +1,42 @@
+---
+command: cmd-writer-init-baseline
+cli-command: "agentic-framework writer init-baseline"
+module: writer
+type: create
+description: "Initialize book baseline (world state at book start)"
+related-skill: organizing-books
+---
+
+# Writer Init Baseline
+
+**Command:** `agentic-framework writer init-baseline`
+**Module:** Fantasy Book Writer
+**Type:** create
+
+## Description
+
+Initialize book baseline (world state at book start)
+
+## Usage
+
+```bash
+agentic-framework writer init-baseline [options]
+```
+
+## Execution
+
+When invoked, run the CLI command:
+
+```bash
+agentic-framework writer init-baseline
+```
+
+Use `--help` to see all available options:
+
+```bash
+agentic-framework writer init-baseline --help
+```
+
+## Related
+
+- **Skill:** `organizing-books` - Provides detailed guidance for this command

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

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

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

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

package/framework/modules/writer/commands/cmd-writer-validate-immutability.md

@@ -0,0 +1,42 @@
+---
+command: cmd-writer-validate-immutability
+cli-command: "agentic-framework writer validate-immutability"
+module: writer
+type: validate
+description: "Verify world fact immutability (hash verification)"
+related-skill: organizing-books
+---
+
+# Writer Validate Immutability
+
+**Command:** `agentic-framework writer validate-immutability`
+**Module:** Fantasy Book Writer
+**Type:** validate
+
+## Description
+
+Verify world fact immutability (hash verification)
+
+## Usage
+
+```bash
+agentic-framework writer validate-immutability [options]
+```
+
+## Execution
+
+When invoked, run the CLI command:
+
+```bash
+agentic-framework writer validate-immutability
+```
+
+Use `--help` to see all available options:
+
+```bash
+agentic-framework writer validate-immutability --help
+```
+
+## Related
+
+- **Skill:** `organizing-books` - Provides detailed guidance for this command

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

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

package/framework/modules/writer/module.json

@@ -0,0 +1,181 @@
+{
+  "$schema": "../core/registries/schemas/module.schema.json",
+  "id": "writer",
+  "version": "1.9.0",
+  "name": "Fantasy Book Writer",
+  "description": "AI-assisted fantasy book writing with structured organization, world-building, and token-budgeted context generation",
+  "provides": {
+    "agents": [
+      "ai-book-writer",
+      "ai-world-builder",
+      "ai-prose-writer"
+    ],
+    "skills": [
+      "organizing-books",
+      "writing-prose",
+      "building-worlds"
+    ],
+    "capabilities": [
+      "book-writing",
+      "prose-generation",
+      "world-building",
+      "character-management",
+      "narrative-structure",
+      "style-enforcement",
+      "book-organization",
+      "context-generation"
+    ],
+    "scripts": [],
+    "cli-commands": [
+      {
+        "name": "writer init",
+        "type": "create",
+        "skill": "organizing-books",
+        "template": "book-project.template",
+        "description": "Initialize a new book project with folder structure"
+      },
+      {
+        "name": "writer create-part",
+        "type": "create",
+        "skill": "organizing-books",
+        "template": "part.template.md",
+        "description": "Create a new part (story arc) with auto-numbering"
+      },
+      {
+        "name": "writer create-chapter",
+        "type": "create",
+        "skill": "organizing-books",
+        "template": "chapter.template.md",
+        "description": "Create a new chapter within a part"
+      },
+      {
+        "name": "writer create-scene",
+        "type": "create",
+        "skill": "organizing-books",
+        "template": "scene.template.md",
+        "description": "Create a new scene within a chapter"
+      },
+      {
+        "name": "writer create-character",
+        "type": "create",
+        "skill": "organizing-books",
+        "template": "character.template.md",
+        "description": "Create a new character profile"
+      },
+      {
+        "name": "writer create-world-rule",
+        "type": "create",
+        "skill": "organizing-books",
+        "template": "world-rule.template.md",
+        "description": "Create an immutable world rule or law"
+      },
+      {
+        "name": "writer create-region",
+        "type": "create",
+        "skill": "organizing-books",
+        "template": "region.template.md",
+        "description": "Create an expandable geographic region"
+      },
+      {
+        "name": "writer create-nation",
+        "type": "create",
+        "skill": "organizing-books",
+        "template": "nation.template.md",
+        "description": "Create an expandable nation or political entity"
+      },
+      {
+        "name": "writer create-magic-system",
+        "type": "create",
+        "skill": "organizing-books",
+        "template": "magic-system.template.md",
+        "description": "Create an immutable magic system"
+      },
+      {
+        "name": "writer create-history-event",
+        "type": "create",
+        "skill": "organizing-books",
+        "template": "history-event.template.md",
+        "description": "Create an append-only historical event"
+      },
+      {
+        "name": "writer init-baseline",
+        "type": "create",
+        "skill": "organizing-books",
+        "template": "baseline.template.md",
+        "description": "Initialize book baseline (world state at book start)"
+      },
+      {
+        "name": "writer validate",
+        "type": "validate",
+        "skill": "organizing-books",
+        "schema": "book-structure.schema.json",
+        "description": "Validate book structure, references, and metadata"
+      },
+      {
+        "name": "writer validate-immutability",
+        "type": "validate",
+        "skill": "organizing-books",
+        "schema": "world-lock.schema.json",
+        "description": "Verify world fact immutability (hash verification)"
+      },
+      {
+        "name": "writer add-fact",
+        "type": "update",
+        "skill": "organizing-books",
+        "description": "Append content to an append-only or expandable fact"
+      },
+      {
+        "name": "writer lock-fact",
+        "type": "update",
+        "skill": "organizing-books",
+        "description": "Lock an expandable fact to immutable"
+      },
+      {
+        "name": "writer generate-context",
+        "type": "create",
+        "skill": "organizing-books",
+        "description": "Generate token-budgeted context files for AI writing"
+      },
+      {
+        "name": "writer build",
+        "type": "transform",
+        "skill": "organizing-books",
+        "description": "Build project: validate, generate context, analyze"
+      },
+      {
+        "name": "writer analyze",
+        "type": "transform",
+        "skill": "organizing-books",
+        "description": "Run analysis: character graph, timeline, word counts"
+      },
+      {
+        "name": "writer export",
+        "type": "export",
+        "skill": "organizing-books",
+        "description": "Export manuscript to markdown or HTML"
+      }
+    ]
+  },
+  "requires": {},
+  "optional-dependencies": [
+    "core"
+  ],
+  "context": {
+    "process": []
+  },
+  "metadata": {
+    "status": "wip",
+    "statusNote": "Templates not yet created. CLI commands are defined but template files are pending implementation.",
+    "category": "workflow",
+    "keywords": [
+      "writing",
+      "fantasy",
+      "book",
+      "world-building",
+      "narrative",
+      "prose",
+      "fiction",
+      "creative-writing"
+    ]
+  }
+}

package/framework/modules/writer/schemas/baseline.schema.json

@@ -0,0 +1,60 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Book Baseline Schema",
+  "description": "Schema for book baseline document defining initial world state",
+  "type": "object",
+  "required": ["id", "title", "type", "version", "established", "book"],
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^baseline-[a-z0-9-]+$"
+    },
+    "title": {
+      "type": "string",
+      "minLength": 5
+    },
+    "type": {
+      "const": "baseline"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "established": {
+      "type": "string",
+      "format": "date"
+    },
+    "book": {
+      "type": "string",
+      "description": "Book identifier in kebab-case"
+    },
+    "world-snapshot": {
+      "type": "object",
+      "properties": {
+        "date": { "type": "string" },
+        "era": { "type": "string" },
+        "major-events-concluded": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "major-events-active": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "token-budget": {
+      "type": "object",
+      "properties": {
+        "full": {
+          "type": "integer",
+          "maximum": 3000
+        },
+        "summary": {
+          "type": "integer",
+          "maximum": 500
+        }
+      }
+    }
+  }
+}