@soulcraft/kits 1.0.0

package/kits/novel-writing-system/kit.json

@@ -0,0 +1,481 @@
+{
+  "$schema": "https://soulcraft.com/schemas/kit/v2.json",
+  "id": "novel-writing-system",
+  "type": "soulcraft",
+  "role": "primary",
+  "status": "released",
+  "name": "Novel Writing System",
+  "description": "Complete novel writing workspace with character development, worldbuilding, and manuscript organization",
+  "longDescription": "A comprehensive system for novelists that includes character profiles with relationship mapping, worldbuilding documentation, three-act structure outline, chapter organization, and integrated timeline. Perfect for fiction writers who want their story elements connected through Workshop's knowledge graph.",
+  "version": "1.0.0",
+  "author": {
+    "name": "Soulcraft Labs",
+    "email": "kits@soulcraft.com",
+    "url": "https://soulcraft.com"
+  },
+  "icon": "📖",
+  "tags": [
+    "fiction",
+    "creative-writing",
+    "novels",
+    "storytelling"
+  ],
+  "variables": [
+    {
+      "key": "projectName",
+      "label": "Novel Title",
+      "description": "The title of your novel",
+      "type": "string",
+      "required": true,
+      "example": "The Hidden Kingdom"
+    },
+    {
+      "key": "author",
+      "label": "Author Name",
+      "description": "The author's name",
+      "type": "string",
+      "required": false,
+      "example": "Your Name"
+    },
+    {
+      "key": "genre",
+      "label": "Genre",
+      "description": "Primary genre (Fantasy, Sci-Fi, Mystery, etc.)",
+      "type": "string",
+      "required": false,
+      "example": "Fantasy"
+    },
+    {
+      "key": "targetWordCount",
+      "label": "Target Word Count",
+      "description": "Your target final word count",
+      "type": "string",
+      "required": false,
+      "example": "80000"
+    }
+  ],
+  "shared": {
+    "industry": "creative-writing",
+    "category": "creative",
+    "glossary": {
+      "inciting incident": "The event that disrupts the protagonist's ordinary world and sets the story in motion",
+      "midpoint": "The story's central turning point, often a false victory or defeat",
+      "character arc": "The internal transformation a character undergoes through the story"
+    },
+    "aiExpertise": [
+      "Fiction writing and story structure",
+      "Character development and psychology",
+      "Worldbuilding and setting design",
+      "Plot architecture and pacing",
+      "Dialogue and scene writing"
+    ],
+    "dataModelHints": [
+      "person",
+      "event",
+      "document",
+      "topic",
+      "thing"
+    ],
+    "dataModel": {
+      "entities": [
+        {
+          "domain": "character",
+          "type": "Person",
+          "description": "A fictional character with arc, motivation, and relationships",
+          "products": {
+            "workshop": {
+              "view": "gallery",
+              "icon": "🧑"
+            },
+            "academy": {
+              "mapsTo": "learning-subject",
+              "assessable": false
+            }
+          }
+        },
+        {
+          "domain": "location",
+          "type": "Location",
+          "description": "A place in the story world where scenes unfold",
+          "products": {
+            "workshop": {
+              "view": "graph",
+              "icon": "📍"
+            }
+          }
+        },
+        {
+          "domain": "chapter",
+          "type": "Document",
+          "description": "A numbered chapter in the manuscript",
+          "products": {
+            "workshop": {
+              "view": "tree",
+              "icon": "📄"
+            },
+            "academy": {
+              "mapsTo": "learning-artifact",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "scene",
+          "type": "Document",
+          "description": "A discrete scene within a chapter, tied to characters and locations",
+          "products": {
+            "workshop": {
+              "view": "board",
+              "icon": "🎬"
+            },
+            "academy": {
+              "mapsTo": "learning-artifact",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "theme",
+          "type": "Concept",
+          "description": "A recurring thematic idea embodied by characters or events",
+          "products": {
+            "workshop": {
+              "view": "graph",
+              "icon": "💡"
+            },
+            "academy": {
+              "mapsTo": "knowledge-unit",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "subplot",
+          "type": "Concept",
+          "description": "A secondary narrative thread running alongside the main plot",
+          "products": {
+            "workshop": {
+              "view": "graph",
+              "icon": "🧵"
+            },
+            "academy": {
+              "mapsTo": "knowledge-unit",
+              "assessable": true
+            }
+          }
+        }
+      ],
+      "relationships": [
+        {
+          "from": "character",
+          "to": "character",
+          "verb": "Conflicts",
+          "description": "Character is in opposition or rivalry with another character"
+        },
+        {
+          "from": "character",
+          "to": "character",
+          "verb": "RelatedTo",
+          "description": "Family or romantic relationship between characters"
+        },
+        {
+          "from": "character",
+          "to": "theme",
+          "verb": "Embodies",
+          "description": "Character represents or illustrates a theme"
+        },
+        {
+          "from": "scene",
+          "to": "character",
+          "verb": "Contains",
+          "description": "Scene features this character"
+        },
+        {
+          "from": "scene",
+          "to": "location",
+          "verb": "LocatedAt",
+          "description": "Scene takes place in this location"
+        },
+        {
+          "from": "chapter",
+          "to": "chapter",
+          "verb": "Precedes",
+          "description": "Chapter ordering in the manuscript"
+        }
+      ]
+    },
+    "suggestions": [
+      {
+        "label": "Develop a character",
+        "prompt": "Help me create a new character with personality, backstory, and motivations"
+      },
+      {
+        "label": "Outline a chapter",
+        "prompt": "Help me outline the next chapter of my novel"
+      },
+      {
+        "label": "Write a scene",
+        "prompt": "Help me write a scene with vivid description and dialogue"
+      },
+      {
+        "label": "Track plot threads",
+        "prompt": "Review my plot threads and identify any loose ends"
+      },
+      {
+        "label": "Build the world",
+        "prompt": "Help me develop a world-building detail for my story"
+      },
+      {
+        "label": "View story structure",
+        "prompt": "Show me my novel's structure in the tree view"
+      }
+    ]
+  },
+  "workshop": {
+    "difficulty": "intermediate",
+    "templateTier": 4,
+    "aiPersona": {
+      "role": "You are an expert fiction writing coach helping novelists develop compelling characters, build rich worlds, and structure satisfying stories from first draft to polished manuscript.",
+      "expertise": [
+        "Story structure (three-act, save the cat, hero's journey)",
+        "Character development and arc design",
+        "Worldbuilding and setting",
+        "Scene and chapter writing",
+        "Plot architecture and pacing"
+      ],
+      "tone": "mentor"
+    },
+    "workspaceConfig": {
+      "paradigm": "writer",
+      "defaultTab": "edit",
+      "defaultView": "mindmap",
+      "defaultFile": "manuscript/chapters/01-opening.md",
+      "fallbackFiles": [
+        "planning/outline.md",
+        "README.md"
+      ],
+      "layout": {
+        "leftDock": "files",
+        "rightDock": "properties"
+      },
+      "onboarding": {
+        "showGuide": true,
+        "highlightFeatures": [
+          "graph",
+          "ai-chat"
+        ],
+        "suggestedActions": [
+          "Start with the outline in planning/outline.md",
+          "Create character profiles using the template",
+          "Use Graph view to visualize character relationships",
+          "Ask AI to help develop backstories and plot points"
+        ]
+      }
+    },
+    "graphGuidance": {
+      "conceptCreation": {
+        "triggers": [
+          "When user creates a new character",
+          "When user describes a location or setting",
+          "When user outlines a chapter or scene",
+          "When user mentions a plot thread or subplot"
+        ],
+        "typeMapping": {
+          "character": "person",
+          "location": "location",
+          "chapter": "document",
+          "scene": "document",
+          "theme": "concept",
+          "subplot": "concept"
+        }
+      },
+      "relationshipPatterns": [
+        {
+          "from": "person",
+          "to": "person",
+          "verb": "conflicts",
+          "description": "Character conflict"
+        },
+        {
+          "from": "person",
+          "to": "person",
+          "verb": "relatedTo",
+          "description": "Family or romantic relationship"
+        },
+        {
+          "from": "person",
+          "to": "concept",
+          "verb": "embodies",
+          "description": "Character represents theme"
+        },
+        {
+          "from": "document",
+          "to": "person",
+          "verb": "contains",
+          "description": "Scene features character"
+        },
+        {
+          "from": "document",
+          "to": "location",
+          "verb": "locatedAt",
+          "description": "Scene takes place in location"
+        },
+        {
+          "from": "document",
+          "to": "document",
+          "verb": "precedes",
+          "description": "Chapter order"
+        }
+      ],
+      "rules": [
+        "Create person entities for major characters",
+        "Link scenes to their featured characters",
+        "Track chapter sequence with precedes relationships",
+        "Connect themes to the characters who embody them"
+      ]
+    },
+    "qualityGates": {
+      "fileChecks": [
+        {
+          "path": "planning/outline.md",
+          "required": [
+            "Act 1",
+            "Act 2",
+            "Act 3",
+            "Inciting Incident",
+            "Midpoint",
+            "Climax"
+          ],
+          "optional": [
+            "Logline",
+            "Premise"
+          ]
+        },
+        {
+          "path": "characters/protagonist.md",
+          "required": [
+            "Name",
+            "Character Arc"
+          ],
+          "optional": [
+            "Backstory",
+            "Relationships",
+            "Voice Notes"
+          ]
+        },
+        {
+          "path": "characters/antagonist.md",
+          "required": [
+            "Name",
+            "Motivation"
+          ],
+          "optional": [
+            "Justification",
+            "Backstory"
+          ]
+        }
+      ],
+      "projectChecks": [
+        "Outline has all three acts defined",
+        "Protagonist has clear internal and external goals",
+        "Antagonist has understandable motivation",
+        "At least one chapter file exists",
+        "Timeline is consistent"
+      ],
+      "exportReady": [
+        "All outline beats are filled in",
+        "Character arcs are defined",
+        "First draft of chapters complete"
+      ]
+    },
+    "sampleData": {
+      "description": "Sample novel structure for a fantasy epic",
+      "entities": [
+        {
+          "type": "person",
+          "name": "Kira Ashwood",
+          "properties": {
+            "role": "protagonist",
+            "age": 19,
+            "want": "Find her missing brother",
+            "need": "Accept her magical heritage",
+            "description": "Orphaned healer's apprentice who discovers she's descended from the ancient Storm Weavers.",
+            "status": "main",
+            "createdAt": "2025-01-05"
+          }
+        },
+        {
+          "type": "person",
+          "name": "The Hollow King",
+          "properties": {
+            "role": "antagonist",
+            "description": "Immortal sorcerer who feeds on stolen magic. Seeks the last Storm Weaver bloodline.",
+            "status": "main",
+            "createdAt": "2025-01-05"
+          }
+        }
+      ],
+      "relationships": [
+        {
+          "from": "Kira Ashwood",
+          "verb": "conflicts",
+          "to": "The Hollow King"
+        }
+      ]
+    },
+    "templateMetadata": {
+      "identifyByStructure": true
+    },
+    "exporters": [
+      {
+        "id": "manuscript-bundle",
+        "name": "Manuscript Bundle",
+        "description": "ZIP archive of manuscript chapters in order",
+        "icon": "📦",
+        "format": "zip",
+        "category": "archive",
+        "handler": "markdown-bundle",
+        "options": {
+          "includeFiles": [
+            "manuscript/chapters/*.md"
+          ],
+          "excludeFiles": [
+            "manuscript/chapters/_chapter-template.md"
+          ],
+          "preserveStructure": true,
+          "addReadme": true
+        }
+      },
+      {
+        "id": "complete-novel-bundle",
+        "name": "Complete Novel Bundle",
+        "description": "ZIP of all project files with folder structure",
+        "icon": "📚",
+        "format": "zip",
+        "category": "archive",
+        "handler": "markdown-bundle",
+        "options": {
+          "includeFiles": [
+            "**/*.md"
+          ],
+          "excludeFiles": [
+            "**/_*-template.md"
+          ],
+          "preserveStructure": true,
+          "addReadme": true,
+          "addIndex": true
+        }
+      }
+    ],
+    "deploy": {
+      "provider": "cloud-run",
+      "buildCommand": "npm run build",
+      "outputDir": "build",
+      "config": {
+        "port": 3000,
+        "memory": "512Mi"
+      },
+      "oneClickCommand": "gcloud run deploy"
+    }
+  }
+}

package/kits/novel-writing-system/skills/character-arc/SKILL.md

@@ -0,0 +1,164 @@
+---
+name: character-arc
+description: Develop compelling character arcs using the want/need/lie/ghost/truth framework. Use /character to build or analyze a character's internal journey.
+type: invocable
+version: "1.0.0"
+parameters: [character name or description]
+---
+
+## Character Arc Development
+
+Help writers create deep, believable character arcs using established frameworks from story theory.
+
+### When User Invokes /character
+
+Guide them through the character arc framework:
+
+### The Core Framework
+
+Every compelling character arc contains these five elements:
+
+| Element | Definition | Question to Answer |
+|---------|------------|-------------------|
+| **Want** | External goal the character pursues | What does your character think they need? |
+| **Need** | Internal truth they must learn | What do they actually need to be whole? |
+| **Lie** | False belief holding them back | What misconception guides their actions? |
+| **Ghost** | Past wound that created the lie | What happened to make them believe the lie? |
+| **Truth** | Realization that completes the arc | What must they learn to overcome the lie? |
+
+### Character Arc Worksheet
+
+Generate this worksheet for each major character:
+
+```markdown
+# Character Arc: [CHARACTER NAME]
+
+## The Wound (Ghost)
+**What happened:** [Traumatic or formative event from the past]
+**When it happened:** [Age/timeframe]
+**Who was involved:** [Key people]
+**What they lost:** [Trust, innocence, love, security, etc.]
+
+## The Lie They Believe
+**Core belief:** "[State the lie as the character would]"
+**How it manifests:**
+- In relationships: [How the lie affects connections]
+- In decisions: [How the lie influences choices]
+- In self-perception: [How they see themselves through the lie]
+
+## The Want (External Goal)
+**Concrete goal:** [Specific, measurable objective]
+**Why they think this will help:** [How achieving this would validate the lie]
+**Stakes if they fail:** [What they lose without it]
+
+## The Need (Internal Growth)
+**True need:** [What would actually make them whole]
+**Why they resist it:** [How the need threatens the lie]
+**Cost of embracing it:** [What they must give up]
+
+## The Truth
+**What they learn:** [The realization that defeats the lie]
+**How they prove it:** [Action that demonstrates growth]
+**New identity:** [Who they become after accepting the truth]
+```
+
+### Arc Patterns
+
+**Positive Arc (Change)**
+1. Character believes the Lie
+2. Events challenge the Lie
+3. Character resists the Truth
+4. Crisis forces a choice
+5. Character embraces Truth and achieves Need
+6. External Want may or may not be achieved
+
+**Flat Arc (Testing)**
+1. Character already knows the Truth
+2. World around them believes Lies
+3. Character's Truth is tested
+4. They influence others to see the Truth
+5. World changes, character stays constant
+
+**Negative Arc (Fall)**
+1. Character believes partial Truth
+2. Events pull them toward a Lie
+3. Character resists, then accepts the Lie
+4. They achieve corrupted Want
+5. End in worse state than beginning
+
+### Character Arc Beats
+
+Map the arc across your story structure:
+
+| Story Beat | Arc Function |
+|------------|--------------|
+| **Opening** | Show the Lie in action |
+| **Inciting Incident** | Introduce what challenges the Lie |
+| **First Plot Point** | Character commits while holding the Lie |
+| **First Pinch Point** | Lie causes problems |
+| **Midpoint** | Glimpse of the Truth |
+| **Second Pinch Point** | Cost of the Lie escalates |
+| **All Is Lost** | Lie fully exposed |
+| **Dark Night** | Must choose: Lie or Truth |
+| **Climax** | Live out their choice |
+| **Resolution** | New normal based on growth |
+
+### Common Arc Problems
+
+**Shallow Arc**
+- Problem: Character changes too easily
+- Fix: Strengthen the Ghost and the reasons for the Lie
+
+**Sudden Change**
+- Problem: Transformation feels unearned
+- Fix: Add more moments where the Truth challenges the Lie
+
+**Passive Arc**
+- Problem: Things happen TO the character
+- Fix: Make their choices drive the plot
+
+**No Stakes**
+- Problem: Growth doesn't seem important
+- Fix: Show the real cost of the Lie and Need
+
+### Example Character Arc
+
+```markdown
+# Character Arc: MARCUS (Protagonist)
+
+## The Wound (Ghost)
+**What happened:** Father abandoned family when Marcus was 12
+**When it happened:** Age 12, day before his birthday
+**Who was involved:** Father, younger sister he had to protect
+**What they lost:** Belief that people stay
+
+## The Lie They Believe
+**Core belief:** "If I need anyone, they'll leave. I can only rely on myself."
+**How it manifests:**
+- In relationships: Keeps people at arm's length, sabotages intimacy
+- In decisions: Refuses help even when drowning
+- In self-perception: Sees needing others as weakness
+
+## The Want (External Goal)
+**Concrete goal:** Build his business empire alone
+**Why they think this will help:** Proves he doesn't need anyone
+**Stakes if they fail:** Would have to admit the Lie is wrong
+
+## The Need (Internal Growth)
+**True need:** Learn to trust and accept help
+**Why they resist it:** Trusting = vulnerability = abandonment
+**Cost of embracing it:** Must risk being hurt again
+
+## The Truth
+**What they learn:** Strength isn't isolation; it's choosing to trust despite fear
+**How they prove it:** Accepts his partner's help to save the company
+**New identity:** A leader who builds WITH others, not despite them
+```
+
+### Questions for Deep Character Work
+
+1. **Want vs Need Conflict**: How does pursuing the Want make achieving the Need harder?
+2. **Ghost Echoes**: Where in your plot does the original wound echo?
+3. **Lie Validation**: How does the world seem to confirm the character's Lie?
+4. **Truth Resistance**: Why is the Truth more terrifying than the Lie?
+5. **Change Cost**: What must the character sacrifice to grow?

package/kits/novel-writing-system/skills/develop-character-arc/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: Develop Character Arc
+description: Deep dive into a character's psychology, motivation, and transformation
+type: invocable
+version: "1.0.0"
+parameters: [characterName]
+---
+
+## Develop Character Arc
+
+Deep dive into a character's psychology, motivation, and transformation
+
+### Steps
+
+1. Review the existing character file
+2. Ask about the character's WANT (conscious external goal)
+3. Ask about the character's NEED (unconscious internal goal)
+4. Identify THE LIE the character believes at the beginning
+5. Explore the GHOST/WOUND - what backstory trauma created this lie?
+6. Define the character's strengths and flaws
+7. Map their arc: Beginning state → Midpoint shift → End transformation
+8. Identify the key scenes where change happens
+9. Update the character file with these insights
+
+### Inputs Required
+
+- **characterName** (required): Which character to develop
+
+### Expected Outputs
+
+- Updated character file
+- Character arc summary
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "develop character"
+- "character arc"
+- "motivation"
+- "backstory"
+- "who is"
+- "character change"