@soulcraft/kits 1.0.0

package/src/kits/world-building.ts

@@ -0,0 +1,476 @@
+/**
+ * @module @soulcraft/kits/kits/world-building
+ * @description Comprehensive universe bible for fantasy, sci-fi, and speculative fiction worlds
+ *
+ * Generated from: kits/world-building/kit.json
+ * Do not edit this file directly — edit the source kit.json and re-run `bun run build:kits`.
+ */
+
+import type { SoulcraftKitConfig } from '@soulcraft/kit-schema';
+
+/**
+ * World Building Bible kit configuration.
+ *
+ * @description Comprehensive universe bible for fantasy, sci-fi, and speculative fiction worlds
+ * @see {@link SoulcraftKitConfig}
+ */
+const worldBuilding: SoulcraftKitConfig = {
+	"$schema": "https://soulcraft.com/schemas/kit/v2.json",
+	"id": "world-building",
+	"name": "World Building Bible",
+	"description": "Comprehensive universe bible for fantasy, sci-fi, and speculative fiction worlds",
+	"version": "1.0.0",
+	"author": {
+		"name": "Soulcraft Labs",
+		"email": "kits@soulcraft.com",
+		"url": "https://soulcraft.com"
+	},
+	"status": "released",
+	"icon": "🌍",
+	"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.",
+	"tags": [
+		"worldbuilding",
+		"fantasy",
+		"sci-fi",
+		"fiction",
+		"games",
+		"rpg",
+		"writing"
+	],
+	"role": "primary",
+	"type": "soulcraft",
+	"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"
+		],
+		"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"
+			}
+		],
+		"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"
+				}
+			]
+		}
+	},
+	"workshop": {
+		"workspaceConfig": {
+			"paradigm": "creative",
+			"defaultTab": "explore",
+			"defaultView": "graph",
+			"defaultFile": "overview/world-overview.md"
+		},
+		"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"
+			]
+		},
+		"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"
+		},
+		"exporters": [
+			{
+				"id": "world-bible-pdf",
+				"name": "World Bible (PDF)",
+				"description": "Complete reference document",
+				"icon": "📚",
+				"format": "pdf",
+				"category": "document",
+				"handler": "wdoc-pdf"
+			},
+			{
+				"id": "world-wiki",
+				"name": "World Wiki (HTML)",
+				"description": "Linked wiki-style pages",
+				"icon": "🌐",
+				"format": "html",
+				"category": "web",
+				"handler": "wdoc-html"
+			},
+			{
+				"id": "world-overview",
+				"name": "Quick Reference",
+				"description": "One-page summary for collaborators",
+				"icon": "📋",
+				"format": "pdf",
+				"category": "document",
+				"handler": "wdoc-pdf"
+			}
+		],
+		"exportPreferences": {
+			"defaultExporter": "world-bible-pdf",
+			"fileNameTemplate": "{{projectName}}-world-bible"
+		},
+		"exportStructure": {
+			"combineStrategy": "path-order",
+			"includePatterns": [
+				"**/*.md"
+			],
+			"excludePatterns": [
+				"_drafts/*",
+				"_notes/*"
+			]
+		},
+		"difficulty": "intermediate",
+		"templateTier": 3
+	},
+	"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"
+	}
+} satisfies SoulcraftKitConfig;
+
+export default worldBuilding;