@soulcraft/kits 1.0.0

package/kits/match-3-puzzle/skills/kit-expertise/SKILL.md

@@ -0,0 +1,96 @@
+# Match 3 Puzzle Kit Expertise
+
+You are an expert in this Match 3 puzzle game implementation using SVG rendering.
+
+## Architecture Overview
+
+### Game Logic
+- **`src/lib/game/Board.ts`**: Core board logic (matching, gravity, cascades)
+- **`src/lib/game/GameEngine.ts`**: Game state management and orchestration
+
+### Components
+- **`GameBoard.svelte`**: SVG-based gem rendering with click/drag interaction
+- **`GameHUD.svelte`**: Score, moves/time, combo display
+
+### Routes
+- **`/`**: Main game with mode selection (Level, Timed, Endless)
+- **`/leaderboard`**: High scores from Brainy
+
+## Game Modes
+
+1. **Level Mode**: Beat target score with limited moves
+2. **Timed Mode**: Score as much as possible in 2 minutes
+3. **Endless Mode**: Relaxed play with no limits
+
+## Match Detection
+
+```typescript
+// Find all 3+ horizontal and vertical matches
+const matches = board.findMatches()
+
+// Each match contains:
+interface Match {
+  gems: Gem[]       // Matched gems
+  horizontal: boolean
+  length: number    // 3, 4, 5, or 6
+}
+```
+
+## Cascade System
+
+When matches are cleared:
+1. Gems above fall down (gravity)
+2. New gems spawn at top
+3. Check for new matches
+4. Repeat until stable
+
+## Special Gems
+
+- **4-match**: Creates row/column clearer
+- **5+ match**: Creates rainbow gem (matches any color)
+
+## Scoring
+
+```typescript
+// Base: 10 points per gem
+// Length bonus: +20 per gem over 3
+// Combo multiplier: 1 + (combo × 0.5)
+score = (baseScore + lengthBonus) × comboMultiplier
+```
+
+## Brainy Integration
+
+High scores saved automatically:
+```typescript
+await brainy.add({
+  type: 'measurement',
+  data: { score, level, mode, maxCombo },
+  metadata: { type: 'match3-highscore' }
+})
+```
+
+## Customization
+
+### Change Board Size
+```typescript
+// In GameEngine.ts, modify LEVELS array
+{
+  boardWidth: 9,
+  boardHeight: 9,
+  // ...
+}
+```
+
+### Add New Gem Types
+```typescript
+// In types.ts, add to GemType
+type GemType = 'red' | 'blue' | ... | 'newcolor'
+
+// In GameBoard.svelte, add to gemColors
+const gemColors = {
+  newcolor: { fill: '#xxx', stroke: '#xxx', glow: 'rgba(...)' }
+}
+```
+
+### Modify Level Progression
+Edit the `LEVELS` array in `GameEngine.ts` to adjust difficulty curve.

package/kits/mind-map/kit.json

@@ -0,0 +1,355 @@
+{
+  "$schema": "https://soulcraft.com/schemas/kit/v2.json",
+  "id": "mind-map",
+  "type": "soulcraft",
+  "role": "primary",
+  "status": "released",
+  "name": "Mind Map",
+  "description": "Radial mind map for brainstorming and idea organization",
+  "longDescription": "Create a beautiful mind map that automatically visualizes your ideas in radial layout. Perfect for brainstorming sessions, project planning, learning new topics, or organizing complex information. The central idea branches out to main topics, which connect to sub-ideas.",
+  "version": "1.0.0",
+  "author": {
+    "name": "Soulcraft Labs",
+    "email": "kits@soulcraft.com",
+    "url": "https://soulcraft.com"
+  },
+  "icon": "🧠",
+  "tags": [
+    "brainstorming",
+    "ideas",
+    "planning",
+    "visualization"
+  ],
+  "variables": [
+    {
+      "key": "centralTopic",
+      "label": "Central Topic",
+      "description": "The main idea at the center of your mind map",
+      "type": "string",
+      "required": true,
+      "example": "My Project Idea"
+    },
+    {
+      "key": "purpose",
+      "label": "Purpose",
+      "description": "What you are using this mind map for",
+      "type": "string",
+      "required": false,
+      "example": "Brainstorming new features"
+    }
+  ],
+  "shared": {
+    "industry": "personal-productivity",
+    "category": "knowledge",
+    "glossary": {
+      "branch": "A main subtopic radiating from the central idea",
+      "cross-link": "A connection between branches that are not directly related by hierarchy"
+    },
+    "aiExpertise": [
+      "Mind mapping methodology",
+      "Brainstorming facilitation",
+      "Idea organization and clustering",
+      "Creative thinking techniques",
+      "Visual thinking and spatial reasoning"
+    ],
+    "dataModelHints": [
+      "topic",
+      "thing",
+      "document"
+    ],
+    "dataModel": {
+      "entities": [
+        {
+          "domain": "topic",
+          "type": "Concept",
+          "description": "A main topic or branch radiating from the central idea",
+          "products": {
+            "workshop": {
+              "view": "graph",
+              "icon": "💡"
+            },
+            "academy": {
+              "mapsTo": "knowledge-unit",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "branch",
+          "type": "Concept",
+          "description": "A sub-branch expanding on a parent topic",
+          "products": {
+            "workshop": {
+              "view": "graph",
+              "icon": "🌿"
+            },
+            "academy": {
+              "mapsTo": "knowledge-unit",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "idea",
+          "type": "Concept",
+          "description": "A leaf-level idea or insight",
+          "products": {
+            "workshop": {
+              "view": "graph",
+              "icon": "✨"
+            },
+            "academy": {
+              "mapsTo": "knowledge-unit",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "category",
+          "type": "Concept",
+          "description": "A grouping category that clusters related branches",
+          "products": {
+            "workshop": {
+              "view": "graph",
+              "icon": "🗂️"
+            },
+            "academy": {
+              "mapsTo": "knowledge-unit",
+              "assessable": false
+            }
+          }
+        }
+      ],
+      "relationships": [
+        {
+          "from": "branch",
+          "to": "topic",
+          "verb": "PartOf",
+          "description": "Branch is a subdivision of this topic"
+        },
+        {
+          "from": "topic",
+          "to": "topic",
+          "verb": "RelatedTo",
+          "description": "Cross-branch association between topics"
+        },
+        {
+          "from": "topic",
+          "to": "idea",
+          "verb": "Contains",
+          "description": "Topic contains this leaf idea"
+        }
+      ]
+    },
+    "suggestions": [
+      {
+        "label": "Add a central idea",
+        "prompt": "Help me define and add a central idea for my mind map"
+      },
+      {
+        "label": "Branch out",
+        "prompt": "Help me expand a branch of my mind map with new sub-topics"
+      },
+      {
+        "label": "Brainstorm freely",
+        "prompt": "Let's brainstorm ideas and I'll help organize them into a mind map"
+      },
+      {
+        "label": "Find connections",
+        "prompt": "Analyze my mind map and suggest cross-branch connections"
+      },
+      {
+        "label": "Prioritize ideas",
+        "prompt": "Help me prioritize the ideas in my mind map"
+      },
+      {
+        "label": "View mind map",
+        "prompt": "Show me my ideas in the mind map view"
+      }
+    ]
+  },
+  "academy": {
+    "skillPath": "visual-thinking",
+    "level": "beginner",
+    "learningObjectives": [
+      "Define a focused central idea that anchors all branches of the map",
+      "Generate branches rapidly using divergent thinking without premature filtering",
+      "Identify clusters and cross-links that reveal hidden structure in a topic",
+      "Distill a mind map into a prioritized list of actionable next steps"
+    ],
+    "assessmentTypes": [
+      "portfolio"
+    ],
+    "certificationSlug": "visual-thinker"
+  },
+  "workshop": {
+    "difficulty": "beginner",
+    "templateTier": 4,
+    "aiPersona": {
+      "role": "You are an expert brainstorming facilitator and creative thinking coach helping people map and organize ideas visually using mind mapping techniques.",
+      "expertise": [
+        "Mind mapping methodology and best practices",
+        "Brainstorming and ideation techniques",
+        "Idea clustering and pattern recognition",
+        "Visual thinking frameworks",
+        "Creative problem solving"
+      ],
+      "tone": "collaborator"
+    },
+    "workspaceConfig": {
+      "paradigm": "creative",
+      "defaultTab": "explore",
+      "defaultView": "mindmap",
+      "defaultFile": "topics/central.md",
+      "layout": {
+        "leftDock": "concepts",
+        "rightDock": "views"
+      },
+      "onboarding": {
+        "showGuide": true,
+        "highlightFeatures": [
+          "graph",
+          "ai-chat"
+        ],
+        "suggestedActions": [
+          "Start with your central topic",
+          "Add branches for main themes",
+          "Use MindMap view to see the radial layout",
+          "Ask AI to expand on ideas"
+        ]
+      }
+    },
+    "graphGuidance": {
+      "conceptCreation": {
+        "triggers": [
+          "When user adds a new topic branch",
+          "When user expands an idea",
+          "When user identifies a category",
+          "When user makes an association"
+        ],
+        "typeMapping": {
+          "topic": "concept",
+          "branch": "concept",
+          "idea": "concept",
+          "category": "concept"
+        }
+      },
+      "relationshipPatterns": [
+        {
+          "from": "concept",
+          "to": "concept",
+          "verb": "partOf",
+          "description": "Branch of topic"
+        },
+        {
+          "from": "concept",
+          "to": "concept",
+          "verb": "relatedTo",
+          "description": "Associated ideas"
+        },
+        {
+          "from": "concept",
+          "to": "concept",
+          "verb": "contains",
+          "description": "Topic contains subtopic"
+        }
+      ],
+      "rules": [
+        "Create concept entities for each branch",
+        "Link branches to their parent topics",
+        "Track associations between branches",
+        "Note color-coded groupings"
+      ]
+    },
+    "qualityGates": {
+      "fileChecks": [
+        {
+          "path": "central-idea.md",
+          "required": [
+            "Core Concept"
+          ],
+          "optional": [
+            "Goals",
+            "Next Steps"
+          ]
+        },
+        {
+          "path": "branches/*.md",
+          "required": [
+            "Overview"
+          ],
+          "optional": [
+            "Sub-Ideas",
+            "Connections"
+          ]
+        }
+      ],
+      "projectChecks": [
+        "Central topic is clearly defined",
+        "At least 3 main branches exist",
+        "Branches have sub-ideas",
+        "Some cross-connections are documented"
+      ],
+      "exportReady": [
+        "All branches have keywords (not sentences)",
+        "Cross-links are documented",
+        "Main themes are identified",
+        "Summary is complete"
+      ]
+    },
+    "sampleData": {
+      "description": "Sample mind map for brainstorming a mobile app startup idea",
+      "entities": [
+        {
+          "type": "concept",
+          "name": "Mobile App Idea",
+          "properties": {
+            "description": "Central topic: Brainstorming a new mobile app product.",
+            "status": "in_progress",
+            "createdAt": "2025-01-10"
+          }
+        },
+        {
+          "type": "concept",
+          "name": "Target Users",
+          "properties": {
+            "description": "Who will use this app? Demographics and user personas.",
+            "status": "in_progress",
+            "createdAt": "2025-01-10"
+          }
+        },
+        {
+          "type": "concept",
+          "name": "Core Features",
+          "properties": {
+            "description": "Essential functionality the app must have.",
+            "status": "todo",
+            "createdAt": "2025-01-10"
+          }
+        }
+      ],
+      "relationships": [
+        {
+          "from": "Target Users",
+          "verb": "relatedTo",
+          "to": "Mobile App Idea"
+        },
+        {
+          "from": "Core Features",
+          "verb": "relatedTo",
+          "to": "Mobile App Idea"
+        }
+      ]
+    },
+    "deploy": {
+      "provider": "cloud-run",
+      "buildCommand": "npm run build",
+      "outputDir": "build",
+      "config": {
+        "port": 3000,
+        "memory": "512Mi"
+      },
+      "oneClickCommand": "gcloud run deploy"
+    }
+  }
+}

package/kits/mind-map/skills/add-branch/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: Add Branch
+description: Expand the mind map with a new branch and sub-ideas
+type: invocable
+version: "1.0.0"
+parameters: [branchName]
+---
+
+## Add Branch
+
+Expand the mind map with a new branch and sub-ideas
+
+### Steps
+
+1. Identify where the new idea connects (central or existing branch)
+2. Create the branch with a single keyword
+3. Choose a color for the branch (if main branch)
+4. Generate 3-5 initial sub-ideas
+5. Look for connections to other existing branches
+6. Add any relevant images or icons
+7. Create the branch file in branches/
+8. Update the knowledge graph
+
+### Inputs Required
+
+- **branchName** (required): Keyword for the new branch
+- **parentBranch** (optional): What it connects to
+
+### Expected Outputs
+
+- New branch with sub-ideas
+- Updated connections
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "add branch"
+- "new idea"
+- "what about"
+- "let's explore"

package/kits/mind-map/skills/brainstorm-topic/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: Brainstorm Topic
+description: Generate ideas freely around a central topic
+type: invocable
+version: "1.0.0"
+parameters: [topic]
+---
+
+## Brainstorm Topic
+
+Generate ideas freely around a central topic
+
+### Steps
+
+1. Place the central topic in the middle (can be a word or image)
+2. Set a timer for 5-10 minutes of free association
+3. Generate main branches (3-7 key aspects of the topic)
+4. For each main branch, add sub-ideas without filtering
+5. Use single keywords, not sentences
+6. Don't judge ideas - capture everything that comes to mind
+7. Add images or icons where they come naturally
+8. Look for unexpected connections between branches
+9. After the timer, review and identify the most promising areas
+
+### Inputs Required
+
+- **topic** (required): Central topic to brainstorm
+- **timeMinutes** (optional): Time for brainstorming
+
+### Expected Outputs
+
+- Expanded mind map
+- Key insights or themes
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "brainstorm"
+- "generate ideas"
+- "explore"
+- "what about"

package/kits/mind-map/skills/branch-expansion/SKILL.md

@@ -0,0 +1,181 @@
+---
+name: branch-expansion
+description: Expand mind map branches with sub-ideas and associations
+type: invocable
+version: "1.0.0"
+---
+
+## Branch Expansion Skill
+
+When the user invokes `/expand`, help them generate sub-ideas and expand branches on their mind map.
+
+### Invocation Patterns
+
+- `/expand [branch]` - Expand specific branch
+- `/expand all` - Suggest expansions for all main branches
+- `/expand deep [branch]` - Go multiple levels deep
+- `/expand creative` - Use creative techniques for expansion
+
+### Expansion Techniques
+
+**Categorical Expansion**
+- Types/kinds of the concept
+- Components/parts
+- Examples/instances
+- Related concepts
+
+**Question-Based Expansion**
+- What are its characteristics?
+- What causes/affects it?
+- What does it cause/affect?
+- How does it work?
+- When/where does it occur?
+- Who's involved?
+
+**SCAMPER Expansion**
+- Substitute: What could replace this?
+- Combine: What could merge with this?
+- Adapt: How could this be adjusted?
+- Modify: How could this change?
+- Put to use: Other applications?
+- Eliminate: What's unnecessary?
+- Reverse: What's the opposite?
+
+### Output Format
+
+```markdown
+## Branch Expansion: [Branch Name]
+
+### Current Context
+- **Parent**: [Parent branch]
+- **Current depth**: [Level]
+- **Related branches**: [Siblings]
+
+### Suggested Sub-Branches
+
+#### Level 1 (Direct children)
+1. **[Sub-idea 1]**
+   - Relevance: [Why this belongs here]
+   - Potential sub-branches: [Quick list]
+
+2. **[Sub-idea 2]**
+   - Relevance: [Why this belongs here]
+   - Potential sub-branches: [Quick list]
+
+3. **[Sub-idea 3]**
+   - Relevance: [Why this belongs here]
+
+[Continue for 4-7 ideas]
+
+### Deeper Expansion (Level 2)
+
+For **[Sub-idea 1]**:
+- [Sub-sub-idea 1.1]
+- [Sub-sub-idea 1.2]
+- [Sub-sub-idea 1.3]
+
+For **[Sub-idea 2]**:
+- [Sub-sub-idea 2.1]
+- [Sub-sub-idea 2.2]
+
+### Cross-Connections
+Ideas that could link to other branches:
+- [Sub-idea X] → connects to [Other Branch]
+- [Sub-idea Y] → relates to [Another Branch]
+
+### Questions to Explore
+- [Question that could spawn more branches]
+- [Question that could spawn more branches]
+
+### Visual Suggestion
+```
+        [Sub 1.1]
+       /
+[Sub 1]──[Sub 1.2]
+      \
+       [Sub 1.3]
+
+[BRANCH]──[Sub 2]──[Sub 2.1]
+      \
+       [Sub 3]
+```
+```
+
+### Expansion by Branch Type
+
+**Concept Branches**
+- Definition
+- Examples
+- Counter-examples
+- Related concepts
+- Applications
+
+**Process Branches**
+- Steps/phases
+- Inputs/outputs
+- Prerequisites
+- Variations
+- Outcomes
+
+**Category Branches**
+- Types/subtypes
+- Characteristics
+- Examples
+- Boundaries
+- Exceptions
+
+**Problem Branches**
+- Causes
+- Symptoms
+- Effects
+- Solutions
+- Prevention
+
+### Creative Expansion Prompts
+
+**Random Word**
+- Pick random word
+- Force connection to branch
+- Often sparks new ideas
+
+**Role Play**
+- How would [expert] expand this?
+- What would [skeptic] add?
+- How would [child] see this?
+
+**Time Shift**
+- Past: Historical aspects
+- Present: Current state
+- Future: Possibilities
+
+**Scale Shift**
+- Zoom in: Details, components
+- Zoom out: Context, systems
+- Parallel: Analogies
+
+### When to Stop Expanding
+
+**Good Stopping Points**
+- Reached concrete/actionable level
+- Natural endpoint (no more subdivisions)
+- Diminishing returns
+- Branch balanced with others
+
+**Signs of Over-Expansion**
+- Single-idea branches
+- Repetition across branches
+- Losing sight of central topic
+- Artificial subdivisions
+
+### Balancing the Map
+
+**Check Balance**
+- Are branches similarly developed?
+- Any obvious gaps?
+- Any overloaded branches?
+
+**Rebalancing**
+- Split heavy branches
+- Merge thin branches
+- Promote important sub-branches
+- Demote tangential ideas