@soulcraft/kits 1.0.0

package/kits/world-building/kit.json

@@ -0,0 +1,497 @@
+{
+  "$schema": "https://soulcraft.com/schemas/kit/v2.json",
+  "id": "world-building",
+  "type": "soulcraft",
+  "role": "primary",
+  "status": "released",
+  "name": "World Building Bible",
+  "description": "Comprehensive universe bible for fantasy, sci-fi, and speculative fiction worlds",
+  "longDescription": "Create a detailed, interconnected world for your creative projects. Document characters, locations, factions, history, magic systems, technology, and cultures. Perfect for novelists, game designers, screenwriters, and RPG creators. Use the knowledge graph to track relationships and the timeline to maintain historical consistency.",
+  "version": "1.0.0",
+  "author": {
+    "name": "Soulcraft Labs",
+    "email": "kits@soulcraft.com",
+    "url": "https://soulcraft.com"
+  },
+  "icon": "🌍",
+  "tags": [
+    "worldbuilding",
+    "fantasy",
+    "sci-fi",
+    "fiction",
+    "games",
+    "rpg",
+    "writing"
+  ],
+  "variables": [
+    {
+      "key": "projectName",
+      "label": "World Name",
+      "description": "The name of your fictional world",
+      "type": "string",
+      "required": true,
+      "example": "Eldoria"
+    },
+    {
+      "key": "worldGenre",
+      "label": "Genre",
+      "description": "Fantasy, Sci-Fi, Post-Apocalyptic, etc.",
+      "type": "string",
+      "required": false,
+      "example": "High Fantasy"
+    },
+    {
+      "key": "worldEra",
+      "label": "Primary Era",
+      "description": "Main time period of your story",
+      "type": "string",
+      "required": false,
+      "example": "The Age of Dragons"
+    },
+    {
+      "key": "worldLogline",
+      "label": "World Logline",
+      "description": "One sentence essence of your world",
+      "type": "string",
+      "required": false,
+      "example": "A realm where magic flows from ancient dragons..."
+    }
+  ],
+  "shared": {
+    "industry": "creative-arts",
+    "category": "creative",
+    "aiExpertise": [
+      "Fantasy and sci-fi world design",
+      "Magic system and technology rules",
+      "Faction and political dynamics",
+      "Character and cultural development",
+      "Historical timeline and lore consistency"
+    ],
+    "dataModelHints": [
+      "person",
+      "place",
+      "organization",
+      "event",
+      "concept",
+      "thing",
+      "category"
+    ],
+    "dataModel": {
+      "entities": [
+        {
+          "domain": "character",
+          "type": "Person",
+          "description": "A named character with role, allegiance, and backstory",
+          "products": {
+            "workshop": {
+              "view": "gallery",
+              "icon": "🧑"
+            },
+            "academy": {
+              "mapsTo": "learning-subject",
+              "assessable": false
+            }
+          }
+        },
+        {
+          "domain": "location",
+          "type": "Location",
+          "description": "A region, city, or landmark in the world",
+          "products": {
+            "workshop": {
+              "view": "graph",
+              "icon": "📍"
+            }
+          }
+        },
+        {
+          "domain": "faction",
+          "type": "Concept",
+          "description": "A political, military, or social organisation",
+          "products": {
+            "workshop": {
+              "view": "graph",
+              "icon": "⚔️"
+            },
+            "academy": {
+              "mapsTo": "knowledge-unit",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "historical event",
+          "type": "Event",
+          "description": "A significant historical event or era in the world's past",
+          "products": {
+            "workshop": {
+              "view": "timeline",
+              "icon": "📜"
+            },
+            "academy": {
+              "mapsTo": "practice-session",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "magic system",
+          "type": "Concept",
+          "description": "The rules, source, and limitations of magic in this world",
+          "products": {
+            "workshop": {
+              "view": "graph",
+              "icon": "✨"
+            },
+            "academy": {
+              "mapsTo": "knowledge-unit",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "artifact",
+          "type": "Thing",
+          "description": "A significant object, weapon, or relic with history",
+          "products": {
+            "workshop": {
+              "view": "gallery",
+              "icon": "🏺"
+            },
+            "academy": {
+              "mapsTo": "resource",
+              "assessable": false
+            }
+          }
+        },
+        {
+          "domain": "species",
+          "type": "Concept",
+          "description": "A race or species inhabiting the world",
+          "products": {
+            "workshop": {
+              "view": "graph",
+              "icon": "🧬"
+            },
+            "academy": {
+              "mapsTo": "knowledge-unit",
+              "assessable": true
+            }
+          }
+        }
+      ],
+      "relationships": [
+        {
+          "from": "character",
+          "to": "location",
+          "verb": "LocatedIn",
+          "description": "Character lives in or originates from this location"
+        },
+        {
+          "from": "character",
+          "to": "faction",
+          "verb": "MemberOf",
+          "description": "Character belongs to this faction"
+        },
+        {
+          "from": "character",
+          "to": "character",
+          "verb": "RelatedTo",
+          "description": "Family, friendship, or alliance between characters"
+        },
+        {
+          "from": "character",
+          "to": "character",
+          "verb": "OpposedTo",
+          "description": "Characters are enemies or rivals"
+        },
+        {
+          "from": "location",
+          "to": "location",
+          "verb": "Contains",
+          "description": "Region contains this sub-location"
+        },
+        {
+          "from": "faction",
+          "to": "faction",
+          "verb": "OpposedTo",
+          "description": "Factions are in conflict"
+        },
+        {
+          "from": "historical event",
+          "to": "historical event",
+          "verb": "Precedes",
+          "description": "Historical ordering of events"
+        }
+      ]
+    },
+    "suggestions": [
+      {
+        "label": "Create a location",
+        "prompt": "Help me create a new location with geography and culture"
+      },
+      {
+        "label": "Design a faction",
+        "prompt": "Help me design a faction or organization in my world"
+      },
+      {
+        "label": "Build a magic system",
+        "prompt": "Help me develop the rules and limits of my magic system"
+      },
+      {
+        "label": "Write world history",
+        "prompt": "Help me write a historical event or era for my world"
+      },
+      {
+        "label": "Map relationships",
+        "prompt": "Help me map the political and social relationships between factions"
+      },
+      {
+        "label": "Explore the world",
+        "prompt": "Show me my world-building elements in the mind map view"
+      }
+    ]
+  },
+  "academy": {
+    "skillPath": "worldbuilding",
+    "level": "intermediate",
+    "learningObjectives": [
+      "Design a magic or technology system with internal rules, cost, and limitations that remain consistent",
+      "Create a regional geography where terrain shapes culture, economy, and political power",
+      "Document a faction with goals, methods, and internal tensions that make them feel three-dimensional",
+      "Write a historical timeline where past events causally explain the present conflicts",
+      "Identify and resolve internal consistency errors (timeline paradoxes, geography contradictions)"
+    ],
+    "assessmentTypes": [
+      "portfolio",
+      "peer-review"
+    ],
+    "certificationSlug": "worldbuilder"
+  },
+  "workshop": {
+    "difficulty": "intermediate",
+    "templateTier": 3,
+    "aiPersona": {
+      "role": "You are a world-building consultant and creative writing collaborator helping creators build deep, consistent, and compelling fictional worlds for novels, games, and screenplays.",
+      "expertise": [
+        "Fantasy and sci-fi world design",
+        "Magic system and technology rules",
+        "Political and social dynamics",
+        "Cultural development",
+        "Historical lore and consistency"
+      ],
+      "tone": "collaborator"
+    },
+    "workspaceConfig": {
+      "paradigm": "creative",
+      "defaultTab": "explore",
+      "defaultView": "graph",
+      "defaultFile": "overview/world-overview.md",
+      "layout": {
+        "leftDock": "concepts",
+        "rightDock": "views"
+      },
+      "onboarding": {
+        "showGuide": true,
+        "highlightFeatures": [
+          "graph",
+          "gallery",
+          "ai-chat"
+        ],
+        "suggestedActions": [
+          "Start with World Overview to establish core concepts",
+          "Define your magic system or technology rules",
+          "Create major regions using Location templates",
+          "Use Graph view to visualize relationships between elements",
+          "Ask AI to help develop cultures and histories"
+        ]
+      }
+    },
+    "graphGuidance": {
+      "conceptCreation": {
+        "triggers": [
+          "User creates a new character",
+          "User defines a location",
+          "User establishes a faction",
+          "User describes a historical event",
+          "User creates a species or creature"
+        ],
+        "typeMapping": {
+          "character": "person",
+          "location": "place",
+          "region": "place",
+          "faction": "organization",
+          "era": "event",
+          "historical event": "event",
+          "magic system": "concept",
+          "technology": "concept",
+          "culture": "concept",
+          "species": "category",
+          "artifact": "thing"
+        }
+      },
+      "relationshipPatterns": [
+        {
+          "from": "person",
+          "to": "place",
+          "verb": "locatedIn",
+          "description": "Character lives in location"
+        },
+        {
+          "from": "person",
+          "to": "organization",
+          "verb": "memberOf",
+          "description": "Character belongs to faction"
+        },
+        {
+          "from": "person",
+          "to": "person",
+          "verb": "relatedTo",
+          "description": "Characters are related"
+        },
+        {
+          "from": "person",
+          "to": "person",
+          "verb": "opposedTo",
+          "description": "Characters are enemies"
+        },
+        {
+          "from": "place",
+          "to": "place",
+          "verb": "contains",
+          "description": "Region contains location"
+        },
+        {
+          "from": "organization",
+          "to": "organization",
+          "verb": "opposedTo",
+          "description": "Factions are rivals"
+        },
+        {
+          "from": "event",
+          "to": "event",
+          "verb": "precedes",
+          "description": "Event happened before"
+        },
+        {
+          "from": "thing",
+          "to": "person",
+          "verb": "ownedBy",
+          "description": "Item belongs to character"
+        }
+      ]
+    },
+    "qualityGates": {
+      "fileChecks": [
+        {
+          "path": "overview/world-overview.md",
+          "required": [
+            "World Name",
+            "Genre",
+            "Core Concept"
+          ],
+          "optional": [
+            "Themes"
+          ]
+        },
+        {
+          "path": "systems/magic-system.md",
+          "required": [
+            "Source",
+            "Limitations"
+          ],
+          "optional": [
+            "Categories"
+          ]
+        },
+        {
+          "path": "history/timeline.md",
+          "required": [
+            "Major Eras",
+            "Key Events"
+          ],
+          "optional": [
+            "Detailed Timeline"
+          ]
+        }
+      ],
+      "projectChecks": [
+        "World has a clear identity and tone",
+        "Magic/technology system has defined rules",
+        "At least 3 major locations defined",
+        "Key characters have motivations",
+        "Historical timeline established",
+        "Major factions have goals"
+      ],
+      "exportReady": [
+        "All core sections complete",
+        "No major consistency issues",
+        "Relationships mapped in graph",
+        "Timeline populated"
+      ]
+    },
+    "exporters": [
+      {
+        "id": "world-bible-pdf",
+        "name": "World Bible (PDF)",
+        "description": "Complete reference document",
+        "icon": "📚",
+        "format": "pdf",
+        "category": "document",
+        "handler": "wdoc-pdf",
+        "options": {
+          "includeFiles": [
+            "**/*.md"
+          ],
+          "combineFiles": true,
+          "tableOfContents": true
+        }
+      },
+      {
+        "id": "world-wiki",
+        "name": "World Wiki (HTML)",
+        "description": "Linked wiki-style pages",
+        "icon": "🌐",
+        "format": "html",
+        "category": "web",
+        "handler": "wdoc-html",
+        "options": {
+          "includeFiles": [
+            "**/*.md"
+          ],
+          "preserveStructure": true,
+          "generateIndex": true
+        }
+      },
+      {
+        "id": "world-overview",
+        "name": "Quick Reference",
+        "description": "One-page summary for collaborators",
+        "icon": "📋",
+        "format": "pdf",
+        "category": "document",
+        "handler": "wdoc-pdf",
+        "options": {
+          "includeFiles": [
+            "overview/*.md"
+          ],
+          "combineFiles": true
+        }
+      }
+    ],
+    "exportStructure": {
+      "combineStrategy": "path-order",
+      "includePatterns": [
+        "**/*.md"
+      ],
+      "excludePatterns": [
+        "_drafts/*",
+        "_notes/*"
+      ]
+    },
+    "exportPreferences": {
+      "defaultExporter": "world-bible-pdf",
+      "fileNameTemplate": "{{projectName}}-world-bible"
+    }
+  }
+}

package/kits/world-building/skills/consistency-check/SKILL.md

@@ -0,0 +1,179 @@
+---
+id: consistency-check
+name: consistency-check
+description: Check worldbuilding for internal consistency and identify contradictions
+version: "1.0.0"
+type: invocable
+requiresVision: false
+requiresData: false
+---
+
+## Worldbuilding Consistency Check Skill
+
+When the user invokes `/consistency`, help them identify contradictions and logical inconsistencies in their worldbuilding.
+
+### Invocation Patterns
+
+- `/consistency` - Full world consistency audit
+- `/consistency [system]` - Check specific system (magic, geography, etc.)
+- `/consistency [event]` - Check historical event implications
+
+### Consistency Check Areas
+
+**Physical World**
+- Geography and climate logic
+- Travel times and distances
+- Day/night cycles, seasons
+- Resource distribution
+
+**Magic/Technology**
+- Rule consistency
+- Power level balance
+- Limitation adherence
+- Social implications
+
+**History**
+- Timeline coherence
+- Cause and effect chains
+- Population changes
+- Technology progression
+
+**Society**
+- Economic viability
+- Political stability
+- Cultural logic
+- Information flow
+
+### Output Format
+
+```markdown
+## Consistency Audit: [World/System Name]
+
+### Summary
+- **Elements reviewed**: [X]
+- **Issues found**: [X]
+- **Critical issues**: [X]
+- **Minor issues**: [X]
+
+### Critical Issues (Story-Breaking)
+
+#### Issue 1: [Title]
+**Category**: [Physical/Magic/History/Society]
+**Contradiction**:
+- [Statement A] conflicts with [Statement B]
+**Location**: [Where in notes/story]
+**Impact**: [How this affects the world]
+**Suggested fixes**:
+1. [Option 1]
+2. [Option 2]
+
+#### Issue 2: [Title]
+[Same format]
+
+### Moderate Issues (Noticeable)
+
+#### Issue 3: [Title]
+**Category**: [Category]
+**Problem**: [Description]
+**Suggested fix**: [Solution]
+
+### Minor Issues (Nitpicks)
+
+- [Minor issue 1]: [Quick fix]
+- [Minor issue 2]: [Quick fix]
+
+### Unexplored Implications
+
+Things established but not fully developed:
+
+1. **[Element]**: If [X] is true, then [Y] should follow
+   - Consider: [What to explore]
+
+2. **[Element]**: [Description]
+   - Consider: [What to explore]
+
+### Questions to Resolve
+
+1. [Unresolved question 1]
+2. [Unresolved question 2]
+3. [Unresolved question 3]
+
+### Consistency Checklist
+
+#### Physical World
+- [ ] Travel times match distances
+- [ ] Climate matches geography
+- [ ] Resources support population
+- [ ] Ecosystems are viable
+
+#### Magic/Technology
+- [ ] Rules apply consistently
+- [ ] Costs always apply
+- [ ] Limitations are maintained
+- [ ] Social impact addressed
+
+#### History
+- [ ] Events follow logically
+- [ ] Timeline is consistent
+- [ ] Consequences are shown
+- [ ] Records match events
+
+#### Society
+- [ ] Economy functions
+- [ ] Government is stable (or unstably for reason)
+- [ ] Cultures interact logically
+- [ ] Information spreads realistically
+```
+
+### Common Consistency Issues
+
+**Geography**
+- Desert next to rainforest
+- Rivers flowing uphill
+- Impossible travel times
+- Missing trade routes
+
+**Magic**
+- Rules broken when convenient
+- No cost when there should be
+- Power creep without explanation
+- Ignored social implications
+
+**History**
+- Population doesn't match events
+- Technology doesn't progress
+- No consequence from major events
+- Contradicting accounts without reason
+
+**Society**
+- Economy doesn't add up
+- Governments wouldn't survive
+- Information travels too fast/slow
+- Cultures don't interact logically
+
+### Cascading Consistency
+
+**If X, Then Y**
+Every element implies other elements:
+
+- If magic healing exists → medicine less developed, longer lifespans, different warfare
+- If instant communication exists → different politics, faster news, different spy craft
+- If flying mounts common → different architecture, different borders, different warfare
+
+### Fixing Inconsistencies
+
+**Option 1: Change the contradiction**
+- Modify one element to match the other
+- Usually the simpler fix
+
+**Option 2: Explain the exception**
+- Create in-world reason for apparent contradiction
+- Can add depth if done well
+
+**Option 3: Remove the element**
+- If neither fits, maybe you don't need it
+- Simplicity is valuable
+
+**Option 4: Embrace the mystery**
+- Some things can be unexplained
+- Works better for soft magic/rare events