@soulcraft/kits 1.0.0

package/kits/game-design-doc/kit.json

@@ -0,0 +1,353 @@
+{
+  "$schema": "https://soulcraft.com/schemas/kit/v2.json",
+  "id": "game-design-doc",
+  "type": "soulcraft",
+  "role": "primary",
+  "status": "released",
+  "name": "Game Design Document",
+  "description": "Complete game design document with mechanics, story, characters, and art direction",
+  "longDescription": "Comprehensive game design document template with knowledge graph integration. Track characters, mechanics, story elements, and their relationships. Perfect for indie developers, students, or game design hobbyists.",
+  "version": "1.0.0",
+  "author": {
+    "name": "Soulcraft Labs",
+    "email": "kits@soulcraft.com",
+    "url": "https://soulcraft.com"
+  },
+  "icon": "🎮",
+  "tags": [
+    "game-design",
+    "creative",
+    "mechanics",
+    "storytelling"
+  ],
+  "variables": [
+    {
+      "key": "gameTitle",
+      "label": "Game Title",
+      "description": "The title of your game",
+      "type": "string",
+      "required": true,
+      "example": "Epic Quest"
+    },
+    {
+      "key": "genre",
+      "label": "Genre",
+      "description": "The game genre (RPG, Puzzle, Action, etc.)",
+      "type": "string",
+      "required": true,
+      "example": "RPG"
+    },
+    {
+      "key": "designer",
+      "label": "Designer",
+      "description": "The game designer's name",
+      "type": "string",
+      "required": false,
+      "example": "Your Name"
+    }
+  ],
+  "shared": {
+    "industry": "game-development",
+    "category": "creative",
+    "glossary": {
+      "core loop": "The primary repeating cycle of actions a player performs",
+      "mechanic": "A specific rule or system that governs player interaction",
+      "pillar": "A core design principle that guides all decisions"
+    },
+    "aiExpertise": [
+      "Game design principles and patterns",
+      "Mechanics and systems design",
+      "Narrative and character design",
+      "Balance and playtesting",
+      "Art direction and visual design"
+    ],
+    "dataModelHints": [
+      "topic",
+      "person",
+      "thing",
+      "event"
+    ],
+    "dataModel": {
+      "entities": [
+        {
+          "domain": "mechanic",
+          "type": "Concept",
+          "description": "A game rule or interactive system governing player behaviour",
+          "products": {
+            "workshop": {
+              "view": "graph",
+              "icon": "⚙️"
+            },
+            "academy": {
+              "mapsTo": "knowledge-unit",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "character",
+          "type": "Person",
+          "description": "A playable character, NPC, or enemy with abilities",
+          "products": {
+            "workshop": {
+              "view": "gallery",
+              "icon": "🧑"
+            },
+            "academy": {
+              "mapsTo": "learning-subject",
+              "assessable": false
+            }
+          }
+        },
+        {
+          "domain": "level",
+          "type": "Location",
+          "description": "A game level or area with layout and enemies",
+          "products": {
+            "workshop": {
+              "view": "graph",
+              "icon": "🗺️"
+            }
+          }
+        },
+        {
+          "domain": "system",
+          "type": "Concept",
+          "description": "A high-level game system such as combat, economy, or crafting",
+          "products": {
+            "workshop": {
+              "view": "graph",
+              "icon": "🔬"
+            },
+            "academy": {
+              "mapsTo": "knowledge-unit",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "item",
+          "type": "Thing",
+          "description": "A collectible or equippable item in the game world",
+          "products": {
+            "workshop": {
+              "view": "gallery",
+              "icon": "🎒"
+            },
+            "academy": {
+              "mapsTo": "resource",
+              "assessable": false
+            }
+          }
+        }
+      ],
+      "relationships": [
+        {
+          "from": "mechanic",
+          "to": "mechanic",
+          "verb": "DependsOn",
+          "description": "Mechanic requires another mechanic to function"
+        },
+        {
+          "from": "character",
+          "to": "mechanic",
+          "verb": "Uses",
+          "description": "Character uses this mechanic or ability"
+        },
+        {
+          "from": "level",
+          "to": "character",
+          "verb": "Contains",
+          "description": "Level contains these enemies or NPCs"
+        },
+        {
+          "from": "item",
+          "to": "mechanic",
+          "verb": "Enables",
+          "description": "Item enables or modifies this mechanic"
+        }
+      ]
+    },
+    "suggestions": [
+      {
+        "label": "Design a game mechanic",
+        "prompt": "Help me design and document a new game mechanic"
+      },
+      {
+        "label": "Create a character class",
+        "prompt": "Help me create a new character class or archetype"
+      },
+      {
+        "label": "Write a level design",
+        "prompt": "Help me write a level design document"
+      },
+      {
+        "label": "Balance gameplay",
+        "prompt": "Help me analyze and balance my game mechanics"
+      },
+      {
+        "label": "Define art direction",
+        "prompt": "Help me define the visual art direction for my game"
+      },
+      {
+        "label": "Review design doc",
+        "prompt": "Show me my game design document structure and completeness"
+      }
+    ]
+  },
+  "academy": {
+    "skillPath": "game-design",
+    "level": "intermediate",
+    "learningObjectives": [
+      "Define a core gameplay loop with action, feedback, progression, and motivation clearly articulated",
+      "Document game mechanics with rules, edge cases, and relationships to other systems",
+      "Design and balance a character roster with distinct abilities and roles",
+      "Write a GDD section that communicates scope and vision clearly to a developer or artist",
+      "Conduct a paper-prototype playtest and document balance findings"
+    ],
+    "assessmentTypes": [
+      "portfolio",
+      "playtest"
+    ],
+    "certificationSlug": "game-designer"
+  },
+  "workshop": {
+    "difficulty": "intermediate",
+    "templateTier": 4,
+    "aiPersona": {
+      "role": "You are an expert game designer helping creators design, document, and refine games with well-crafted mechanics, compelling characters, and balanced systems.",
+      "expertise": [
+        "Game design principles",
+        "Mechanics and systems balancing",
+        "Narrative design and character creation",
+        "Level design",
+        "Playtesting and iteration"
+      ],
+      "tone": "collaborator"
+    },
+    "workspaceConfig": {
+      "paradigm": "creative",
+      "defaultTab": "explore",
+      "defaultView": "gallery",
+      "defaultFile": "overview/concept.md",
+      "layout": {
+        "leftDock": "concepts",
+        "rightDock": "views"
+      },
+      "onboarding": {
+        "showGuide": true,
+        "highlightFeatures": [
+          "gallery",
+          "graph",
+          "ai-chat"
+        ],
+        "suggestedActions": [
+          "Define your core game loop in mechanics/",
+          "Create character profiles using templates",
+          "Use Graph view to see all elements connected",
+          "Ask AI for game design feedback"
+        ]
+      }
+    },
+    "graphGuidance": {
+      "conceptCreation": {
+        "triggers": [
+          "When user creates a game mechanic",
+          "When user describes a character or enemy",
+          "When user defines a level or area",
+          "When user outlines a system or feature"
+        ],
+        "typeMapping": {
+          "mechanic": "concept",
+          "character": "person",
+          "enemy": "person",
+          "level": "location",
+          "system": "concept",
+          "item": "thing"
+        }
+      },
+      "relationshipPatterns": [
+        {
+          "from": "concept",
+          "to": "concept",
+          "verb": "dependsOn",
+          "description": "Mechanic requires another"
+        },
+        {
+          "from": "person",
+          "to": "concept",
+          "verb": "uses",
+          "description": "Character uses mechanic"
+        },
+        {
+          "from": "location",
+          "to": "person",
+          "verb": "contains",
+          "description": "Level contains enemies"
+        },
+        {
+          "from": "thing",
+          "to": "concept",
+          "verb": "enables",
+          "description": "Item enables mechanic"
+        }
+      ],
+      "rules": [
+        "Create concept entities for mechanics and systems",
+        "Link mechanics to the characters that use them",
+        "Track dependencies between systems",
+        "Note which features support core pillars"
+      ]
+    },
+    "qualityGates": {
+      "fileChecks": [
+        {
+          "path": "mechanics/core-loop.md",
+          "required": [
+            "Action",
+            "Feedback",
+            "Progress",
+            "Motivation"
+          ],
+          "optional": [
+            "Primary Mechanics"
+          ]
+        },
+        {
+          "path": "characters/protagonist.md",
+          "required": [
+            "Name",
+            "Abilities"
+          ],
+          "optional": [
+            "Character Arc",
+            "Personality"
+          ]
+        },
+        {
+          "path": "README.md",
+          "required": [
+            "Overview",
+            "Core Pillars"
+          ],
+          "optional": [
+            "Genre",
+            "Designer"
+          ]
+        }
+      ],
+      "projectChecks": [
+        "Core loop is clearly defined",
+        "At least one mechanic is documented",
+        "Protagonist has defined abilities",
+        "Game has clear core pillars (2-3)"
+      ],
+      "exportReady": [
+        "All major mechanics documented",
+        "Character abilities defined",
+        "Story structure outlined",
+        "Art direction established"
+      ]
+    }
+  }
+}

package/kits/game-design-doc/skills/balance-system/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: Balance System Analysis
+description: Analyze and balance a game system
+type: invocable
+version: "1.0.0"
+parameters: [systemName]
+---
+
+## Balance System Analysis
+
+Analyze and balance a game system
+
+### Steps
+
+1. Review the system's current state
+2. Identify the intended player experience
+3. Map all inputs, outputs, and loops in the system
+4. Identify potential exploits or dominant strategies
+5. Consider different player skill levels
+6. Suggest tuning parameters and their effects
+7. Recommend playtesting focus areas
+8. Document balancing notes
+
+### Inputs Required
+
+- **systemName** (required): System to analyze
+
+### Expected Outputs
+
+- Balance analysis
+- Tuning recommendations
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "balance"
+- "is this fair"
+- "too easy"
+- "too hard"
+- "exploit"

package/kits/game-design-doc/skills/create-character/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: Create Game Character
+description: Design a character for gameplay and narrative
+type: invocable
+version: "1.0.0"
+parameters: [characterName, role]
+---
+
+## Create Game Character
+
+Design a character for gameplay and narrative
+
+### Steps
+
+1. Ask about the character's role in gameplay
+2. Define their core abilities or functions
+3. Ask about their narrative role
+4. Design their motivation and goals
+5. Consider their relationship to other characters
+6. Plan their visual design direction
+7. Create the character file
+8. Add character to the knowledge graph
+
+### Inputs Required
+
+- **characterName** (required): Character name
+- **role** (required): Gameplay role (protagonist, enemy, NPC, etc.)
+
+### Expected Outputs
+
+- Character document
+- Character concept
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "new character"
+- "create character"
+- "add character"
+- "design character"

package/kits/game-design-doc/skills/design-mechanic/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: Design Game Mechanic
+description: Create a well-documented game mechanic
+type: invocable
+version: "1.0.0"
+parameters: [mechanicName]
+---
+
+## Design Game Mechanic
+
+Create a well-documented game mechanic
+
+### Steps
+
+1. Ask what player experience or emotion this mechanic should create
+2. Define the mechanic's core action
+3. Identify inputs (what players do) and outputs (what happens)
+4. Consider how it interacts with existing mechanics
+5. Design the feedback - how players know what happened
+6. Identify potential edge cases and exploits
+7. Document the mechanic in mechanics/
+8. Add mechanic concept to the knowledge graph
+
+### Inputs Required
+
+- **mechanicName** (required): Name for the mechanic
+- **targetExperience** (optional): What emotion/experience it creates
+
+### Expected Outputs
+
+- Mechanic documentation
+- Mechanic concept in graph
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "new mechanic"
+- "design mechanic"
+- "add mechanic"
+- "how should X work"

package/kits/game-design-doc/skills/economy-design/SKILL.md

@@ -0,0 +1,152 @@
+---
+name: economy-design
+description: Design and balance in-game economies and reward systems
+type: invocable
+version: "1.0.0"
+---
+
+## Economy Design Skill
+
+When the user invokes `/economy`, help them design, balance, and troubleshoot in-game economic systems.
+
+### Invocation Patterns
+
+- `/economy` - Review/design game economy
+- `/economy balance` - Analyze economic balance
+- `/economy sinks` - Design currency sinks
+- `/economy rewards` - Optimize reward pacing
+
+### Economy Fundamentals
+
+**Sources (Faucets)**
+- Where currency/resources enter the system
+- Examples: Quest rewards, loot drops, daily bonuses
+- Must be balanced against sinks
+
+**Sinks (Drains)**
+- Where currency/resources leave the system
+- Examples: Purchases, upgrades, repairs, taxes
+- Prevent inflation and maintain value
+
+**The Balance Equation**
+```
+Healthy Economy: Sources ≈ Sinks (slight sink advantage)
+Inflation: Sources > Sinks (currency loses value)
+Deflation: Sinks > Sources (progression stalls)
+```
+
+### Currency Design
+
+**Primary Currency**
+- Abundant, earned through core gameplay
+- Used for common purchases
+- Creates ongoing engagement loop
+
+**Premium Currency**
+- Scarce, earned slowly or purchased
+- Used for special/cosmetic items
+- Psychological anchor for value
+
+**Multiple Currencies**
+- Segment different systems
+- Prevent one activity trivializing others
+- Example: Gold for gear, Reputation for faction items
+
+### Pricing Strategies
+
+**Anchor Pricing**
+- Set a few items at high prices
+- Makes other items feel reasonable
+- Players learn relative value
+
+**Bundle Pricing**
+- Offer better value in bundles
+- Encourages larger purchases
+- Creates perceived savings
+
+**Time-Based Pricing**
+- Daily deals and rotating stock
+- Creates urgency
+- Rewards regular play
+
+### Output Format
+
+```markdown
+## Economy Design: [Game Name]
+
+### Currency Overview
+| Currency | Source | Sink | Earn Rate | Healthy Balance |
+|----------|--------|------|-----------|-----------------|
+| Gold | Combat, quests | Items, repairs | ~100/hr | ~1000-5000 |
+| Gems | Achievements | Cosmetics | ~10/day | ~100-500 |
+
+### Source Analysis
+| Source | Currency | Amount | Frequency | Daily Total |
+|--------|----------|--------|-----------|-------------|
+| Quest completion | Gold | 50 | ~5/day | 250 |
+| Enemy drops | Gold | 5-10 | ~20/hr | 100-200/hr |
+
+### Sink Analysis
+| Sink | Currency | Cost | Frequency | Impact |
+|------|----------|------|-----------|--------|
+| Weapon upgrade | Gold | 200 | Every level | Major |
+| Consumables | Gold | 10 | Per session | Minor |
+| Repair | Gold | 50 | Per death | Moderate |
+
+### Economic Health Check
+| Metric | Target | Current | Status |
+|--------|--------|---------|--------|
+| Gold inflation rate | < 5%/week | X% | [🟢/🟡/🔴] |
+| Average player gold | 2000 | X | [🟢/🟡/🔴] |
+| Wealth inequality | < 10x | Xx | [🟢/🟡/🔴] |
+
+### Progression Pacing
+**Early Game (0-10 hrs)**
+- Gold earn rate: ~50/hr
+- Major purchases: Starter gear (100-200)
+- Player should feel: Growing power
+
+**Mid Game (10-50 hrs)**
+- Gold earn rate: ~150/hr
+- Major purchases: Specialization (500-1000)
+- Player should feel: Meaningful choices
+
+**Late Game (50+ hrs)**
+- Gold earn rate: ~300/hr
+- Major purchases: Prestige items (2000+)
+- Player should feel: Mastery and collection
+
+### Recommendations
+1. [Economic adjustment needed]
+2. [New sink/source suggestion]
+3. [Pacing improvement]
+```
+
+### Common Economy Problems
+
+**Inflation**
+- Symptoms: Prices feel trivial, hoarding
+- Causes: Too many sources, not enough sinks
+- Fixes: Add compelling sinks, reduce faucets
+
+**Deflation**
+- Symptoms: Progress feels impossible, frustration
+- Causes: Too many sinks, not enough sources
+- Fixes: Increase rewards, reduce mandatory costs
+
+**Wealth Inequality**
+- Symptoms: Rich get richer, new players can't compete
+- Causes: Compound returns, veteran advantages
+- Fixes: Diminishing returns, catch-up mechanics
+
+### Free-to-Play Considerations
+
+**Monetization Ethics**
+- Don't sell power (pay-to-win)
+- Time savers OK, advantages not OK
+- Cosmetics are safest monetization
+
+**Dual Currency Design**
+- Free currency: Abundant, gameplay loop
+- Premium currency: Scarce, cosmetic/convenience
+- Never paywall progression