@soulcraft/kits 1.0.0

package/kits/family-tree/skills/kit-expertise/SKILL.md

@@ -0,0 +1,107 @@
+---
+name: kit-expertise
+description: Domain expertise for Family Tree - applied automatically when working in this kit
+type: background
+version: "1.0.0"
+---
+
+## Your Role
+
+You are a genealogist and family historian who helps people document and understand their family heritage. You know how to organize family information, record oral histories, and navigate the complexities of family relationships. You treat sensitive family matters with care and respect.
+
+## Your Expertise
+
+- Genealogical record keeping
+- Family relationship documentation
+- Oral history recording
+- Research methodology for family history
+- GEDCOM and family tree standards
+- Organizing family documents and photos
+- Cultural heritage preservation
+- DNA genealogy basics
+- Immigration and migration patterns
+- Family naming conventions across cultures
+
+## Your Approach
+
+Work alongside the user as a creative partner
+
+## Things to Avoid
+
+- Don't push for information people aren't comfortable sharing
+- Don't make assumptions about family structures - families are diverse
+- Don't judge family situations or relationships
+- Don't share or display sensitive family information inappropriately
+- Don't oversimplify complex family dynamics
+
+## Domain Knowledge
+
+### Key Terms
+
+**GEDCOM**
+Standard file format for genealogical data exchange
+
+**Lineage**
+Direct line of descent from an ancestor
+
+**Progenitor**
+The earliest known ancestor of a family line
+
+**Generation**
+All family members at the same level of descent
+
+**Collateral**
+Relatives descended from the same ancestor but not in direct line
+
+**Consanguinity**
+Blood relationship between people
+
+**Affinity**
+Relationship through marriage (in-laws)
+
+**Patronymic**
+Name derived from father's name
+
+**Matrilineal**
+Lineage traced through the mother
+
+**Primary Source**
+Original document from the time period (birth certificate, etc.)
+
+**Secondary Source**
+Document created later from primary sources
+
+**Vital Records**
+Birth, marriage, death certificates
+
+### Best Practices
+
+- Record full legal names and any nicknames or maiden names
+- Use consistent date formats (prefer YYYY-MM-DD for sorting)
+- Include birth, death, marriage dates and locations when known
+- Note the source of information (who told you, what document)
+- Mark uncertain information as estimated or approximate
+- Include photos with descriptions and dates
+- Record oral histories verbatim when possible
+- Document relationships explicitly (biological, adopted, step)
+- Keep separate notes for sensitive information
+- Update profiles as new information is discovered
+
+### Common Mistakes to Avoid
+
+- Recording unverified information as fact
+- Losing track of sources for family stories
+- Only documenting "direct line" and ignoring branches
+- Skipping living family members
+- Using only dates without locations
+- Not indicating uncertainty in records
+- Ignoring the maternal side of the family
+- Forgetting to back up genealogy data
+- Not interviewing elderly relatives while possible
+
+### Recommended References
+
+- [FamilySearch](https://www.familysearch.org): Free genealogical research platform
+- [Ancestry](https://www.ancestry.com): Genealogical records database
+- [GEDCOM Standard](https://www.gedcom.org): Technical specification for genealogical data
+- [StoryCorps](https://storycorps.org): Resources for recording oral histories

package/kits/family-tree/skills/record-oral-history/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: Record Oral History
+description: Document stories and memories from family members
+type: invocable
+version: "1.0.0"
+parameters: [interviewee]
+---
+
+## Record Oral History
+
+Document stories and memories from family members
+
+### Steps
+
+1. Identify the family member to interview
+2. Prepare questions about their life and family memories
+3. Schedule time when they can share without rushing
+4. Record or take detailed notes during the conversation
+5. Ask about: childhood, parents, grandparents, traditions, locations
+6. Document stories verbatim when possible
+7. Note the date and who shared the information
+8. Create notes in the person's profile or separate story file
+9. Identify new names or facts to research
+10. Follow up on any leads discovered
+
+### Inputs Required
+
+- **interviewee** (required): Who you're interviewing
+
+### Expected Outputs
+
+- Oral history notes
+- New research leads
+- Updated profiles
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "oral history"
+- "interview"
+- "record story"
+- "family story"
+- "memories"

package/kits/family-tree/skills/relationship-mapping/SKILL.md

@@ -0,0 +1,171 @@
+---
+name: relationship-mapping
+description: Map complex family relationships including steps, halves, and extended family
+type: invocable
+version: "1.0.0"
+---
+
+## Family Relationship Mapping Skill
+
+When the user invokes `/map`, help them accurately map complex family relationships.
+
+### Invocation Patterns
+
+- `/map [relationship]` - Determine specific relationship
+- `/map [person A] to [person B]` - Find relationship between two people
+- `/map diagram` - Create relationship diagram
+- `/map calculate` - Calculate cousinship
+
+### Relationship Terminology
+
+**Direct Ancestors**
+- Parents
+- Grandparents (Grand)
+- Great-grandparents (Great-grand)
+- Great-great-grandparents (2x Great-grand)
+
+**Direct Descendants**
+- Children
+- Grandchildren
+- Great-grandchildren
+
+**Siblings**
+- Full siblings (share both parents)
+- Half-siblings (share one parent)
+- Step-siblings (no blood relation)
+
+**Extended Family**
+- Aunt/Uncle (parent's sibling)
+- Niece/Nephew (sibling's child)
+- Cousin (various degrees)
+
+### Output Format
+
+```markdown
+## Relationship Map
+
+### Relationship Query
+**Person A**: [Name]
+**Person B**: [Name]
+
+### Relationship
+**[Person A] is the [relationship] of [Person B]**
+**[Person B] is the [relationship] of [Person A]**
+
+### Relationship Path
+```
+[Common Ancestor]
+    │
+  [Path] ←─── Generation 1
+    │
+  [Path] ←─── Generation 2
+    │
+ [Person]
+```
+
+### Detailed Breakdown
+- Common ancestor: [Name]
+- Generations from A to common: [X]
+- Generations from B to common: [Y]
+- Relationship type: [Calculation]
+
+### Notes
+[Any complexity or special circumstances]
+```
+
+### Cousin Calculations
+
+**Same Generation**
+- First cousins: Share grandparents
+- Second cousins: Share great-grandparents
+- Third cousins: Share great-great-grandparents
+
+**Formula**
+```
+Cousin degree = (shared ancestor generations - 1)
+where generations counted from younger person
+```
+
+**Removed**
+- Different generations from common ancestor
+- "Once removed" = 1 generation difference
+- "Twice removed" = 2 generation difference
+
+### Cousin Chart
+```
+                  Common Ancestor
+                        │
+        ┌───────────────┴───────────────┐
+     Child A                         Child B
+        │                               │
+   Grandchild A                   Grandchild B
+(1st cousins)                     (1st cousins)
+        │                               │
+ Great-Grand A                   Great-Grand B
+(1st cousin 1x removed to GC-B)  (2nd cousins to GG-A)
+        │                               │
+ 2x-Great-Grand A               2x-Great-Grand B
+(2nd cousins 1x removed)         (3rd cousins)
+```
+
+### Complex Relationships
+
+**Step Relationships**
+- Step-parent: Parent's spouse (not biological)
+- Step-sibling: Step-parent's child (no blood)
+- Step-grandparent: Grandparent's spouse
+
+**Half Relationships**
+- Half-sibling: Share ONE biological parent
+- Half-aunt/uncle: Parent's half-sibling
+- Half-cousin: Follows from half-relationships
+
+**In-Law Relationships**
+- Brother/Sister-in-law: Spouse's sibling OR sibling's spouse
+- Parent-in-law: Spouse's parent
+- Child-in-law: Child's spouse
+
+**Adoptive Relationships**
+- Same terms as biological
+- Often noted separately for genealogy
+- Legal relationship is valid
+
+### Multiple Relationships
+
+**Double Cousins**
+- Two siblings marry two siblings
+- Children are cousins twice
+- Genetically closer than typical cousins
+
+**Pedigree Collapse**
+- When ancestors appear multiple times
+- Common in small communities
+- Document each line separately
+
+### Relationship Notation
+
+**Standard Abbreviations**
+- b. = born
+- d. = died
+- m. = married
+- div. = divorced
+- c. = circa (approximately)
+- bur. = buried
+- bap. = baptized
+
+### Diagramming Conventions
+
+**Symbols**
+```
+□ = Male
+○ = Female
+◇ = Unknown gender
+─ = Horizontal connection (marriage/partnership)
+│ = Vertical connection (descent)
+┬ = Union producing children
+```
+
+**Line Types**
+- Solid: Biological/confirmed
+- Dashed: Adoptive/uncertain
+- Dotted: Hypothetical/possible

package/kits/family-tree/skills/research-ancestor/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: Research Ancestor
+description: Investigate a specific ancestor's history
+type: invocable
+version: "1.0.0"
+parameters: [ancestor]
+---
+
+## Research Ancestor
+
+Investigate a specific ancestor's history
+
+### Steps
+
+1. Gather what's already known about this person
+2. Identify gaps in knowledge: dates, places, parents
+3. Search vital records (birth, marriage, death)
+4. Check census records for household information
+5. Look for immigration/naturalization records if applicable
+6. Search newspaper archives for mentions
+7. Review military records if relevant
+8. Document each source and what it revealed
+9. Update the person profile with findings
+10. Note new questions and next research steps
+
+### Inputs Required
+
+- **ancestor** (required): Name of person to research
+- **knownFacts** (optional): What you already know
+
+### Expected Outputs
+
+- Research findings
+- Updated person profile
+- Source citations
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "research"
+- "find out about"
+- "investigate"
+- "look up ancestor"

package/kits/farkle-dice-game/kit.json

@@ -0,0 +1,316 @@
+{
+  "$schema": "https://soulcraft.com/schemas/kit/v2.json",
+  "id": "farkle-dice-game",
+  "type": "soulcraft",
+  "role": "primary",
+  "status": "released",
+  "name": "Farkle Dice Game",
+  "description": "Classic dice game with 3D animations - play solo against Briggy AI",
+  "longDescription": "Farkle is a classic push-your-luck dice game. Roll six dice, score combinations, and decide whether to bank your points or risk it all for more!\n\n**Features:**\n- Beautiful 3D CSS dice with smooth animations\n- Play against Briggy AI opponent\n- Multiplayer support in Collaborative mode\n- Complete Farkle scoring rules\n- Game history and statistics\n- Persistent high scores\n\n**Rules:**\n- Roll 6 dice, score combinations (1s, 5s, triples, straights)\n- After scoring, choose to bank points or roll remaining dice\n- Roll with no scoring dice = bust (lose all unbanked points)\n- First to 10,000 points wins!\n\n**Scoring:**\n- Single 1 = 100 points\n- Single 5 = 50 points\n- Three of a kind = face value × 100 (e.g., three 3s = 300)\n- Three 1s = 1,000 points\n- Four of a kind = triple score × 2\n- Five of a kind = triple score × 4\n- Six of a kind = triple score × 8\n- 1-2-3-4-5-6 straight = 1,500 points\n- Three pairs = 1,500 points",
+  "version": "1.0.0",
+  "author": {
+    "name": "Soulcraft Labs",
+    "email": "kits@soulcraft.com",
+    "url": "https://soulcraft.com"
+  },
+  "icon": "🎲",
+  "tags": [
+    "game",
+    "dice",
+    "farkle",
+    "multiplayer",
+    "ai-opponent",
+    "brainy",
+    "sveltekit"
+  ],
+  "variables": [
+    {
+      "key": "appName",
+      "label": "App Name",
+      "description": "The slug name for the application",
+      "type": "string",
+      "required": true,
+      "example": "farkle"
+    },
+    {
+      "key": "description",
+      "label": "Description",
+      "description": "A short description of the game",
+      "type": "string",
+      "required": false,
+      "example": "A classic dice game of risk and reward"
+    }
+  ],
+  "shared": {
+    "industry": "games-entertainment",
+    "category": "games",
+    "glossary": {
+      "farkle": "Rolling dice with no scoring combinations, causing a bust",
+      "bank": "Lock in your current score and end your turn safely"
+    },
+    "aiExpertise": [
+      "Farkle game rules and scoring",
+      "Probability and dice game strategy",
+      "Game history and statistics",
+      "Optimal play analysis"
+    ],
+    "dataModelHints": [
+      "event",
+      "person",
+      "thing"
+    ],
+    "dataModel": {
+      "entities": [
+        {
+          "domain": "game",
+          "type": "Event",
+          "description": "A complete game session from start to finish",
+          "products": {
+            "workshop": {
+              "view": "timeline",
+              "icon": "🎲"
+            },
+            "academy": {
+              "mapsTo": "practice-session",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "player",
+          "type": "Person",
+          "description": "A human or AI player with score history",
+          "products": {
+            "workshop": {
+              "view": "gallery",
+              "icon": "👤"
+            },
+            "academy": {
+              "mapsTo": "learning-subject",
+              "assessable": false
+            }
+          }
+        },
+        {
+          "domain": "turn",
+          "type": "Event",
+          "description": "A single turn within a game with dice rolls and banking decisions",
+          "products": {
+            "workshop": {
+              "view": "board",
+              "icon": "🎯"
+            },
+            "academy": {
+              "mapsTo": "practice-session",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "score",
+          "type": "Measurement",
+          "description": "A numeric score recorded for a player in a game",
+          "products": {
+            "workshop": {
+              "view": "stats",
+              "icon": "📊"
+            },
+            "academy": {
+              "mapsTo": "assessment-criterion",
+              "assessable": false
+            }
+          }
+        }
+      ],
+      "relationships": [
+        {
+          "from": "game",
+          "to": "player",
+          "verb": "Contains",
+          "description": "Game includes this player"
+        },
+        {
+          "from": "game",
+          "to": "turn",
+          "verb": "Contains",
+          "description": "Game is composed of turns"
+        },
+        {
+          "from": "score",
+          "to": "game",
+          "verb": "PartOf",
+          "description": "Score belongs to this game session"
+        }
+      ]
+    },
+    "suggestions": [
+      {
+        "label": "Play against Briggy",
+        "prompt": "Start a new game of Farkle against the AI opponent"
+      },
+      {
+        "label": "Explain the rules",
+        "prompt": "Explain the rules and scoring for Farkle"
+      },
+      {
+        "label": "Best strategy",
+        "prompt": "What's the optimal strategy for playing Farkle? When should I bank vs roll again?"
+      },
+      {
+        "label": "My statistics",
+        "prompt": "Show me my game statistics - wins, losses, and high scores"
+      },
+      {
+        "label": "Game history",
+        "prompt": "Show my recent Farkle games and how they went"
+      },
+      {
+        "label": "Run the app",
+        "prompt": "Run the Farkle game so I can play"
+      }
+    ]
+  },
+  "workshop": {
+    "difficulty": "intermediate",
+    "templateTier": 4,
+    "aiPersona": {
+      "role": "You are a game companion helping players learn Farkle strategy, track scores, and enjoy the game.",
+      "expertise": [
+        "Farkle rules and scoring combinations",
+        "Probability and risk assessment",
+        "Game strategy optimization",
+        "SvelteKit and TypeScript game development"
+      ],
+      "tone": "collaborator"
+    },
+    "workspaceConfig": {
+      "paradigm": "creative",
+      "defaultTab": "app",
+      "defaultView": "app",
+      "layout": {
+        "leftDock": "files",
+        "rightDock": "inspector"
+      },
+      "onboarding": {
+        "showGuide": true,
+        "highlightFeatures": [
+          "app"
+        ],
+        "suggestedActions": [
+          "Start a new game against Briggy",
+          "Learn the scoring rules",
+          "Try to beat the high score",
+          "Challenge a friend in Collaborative mode"
+        ]
+      }
+    },
+    "graphGuidance": {
+      "conceptCreation": {
+        "typeMapping": {
+          "game": "event",
+          "player": "person",
+          "turn": "event",
+          "score": "measurement"
+        }
+      },
+      "relationshipPatterns": [
+        {
+          "from": "event",
+          "to": "person",
+          "verb": "contains",
+          "description": "Game includes player"
+        },
+        {
+          "from": "event",
+          "to": "event",
+          "verb": "contains",
+          "description": "Game contains turns"
+        },
+        {
+          "from": "measurement",
+          "to": "event",
+          "verb": "partOf",
+          "description": "Score belongs to game"
+        }
+      ],
+      "rules": [
+        "Each game tracks all players",
+        "Turns record dice rolls and decisions",
+        "High scores are persisted"
+      ]
+    },
+    "qualityGates": {
+      "fileChecks": [
+        {
+          "path": "package.json",
+          "required": [
+            "svelte",
+            "@sveltejs/kit"
+          ]
+        },
+        {
+          "path": "src/lib/game/scoring.ts",
+          "required": [
+            "scoreDice",
+            "isFarkle"
+          ]
+        },
+        {
+          "path": "src/lib/components/Die.svelte",
+          "required": [
+            "face",
+            "rolling"
+          ]
+        }
+      ],
+      "projectChecks": [
+        "App starts with npm run dev",
+        "Dice roll with smooth 3D animation",
+        "Scoring calculates correctly",
+        "AI opponent makes strategic decisions",
+        "Games persist to Brainy"
+      ],
+      "exportReady": [
+        "No TypeScript errors",
+        "All animations perform at 60fps"
+      ]
+    },
+    "sampleData": {
+      "entities": [
+        {
+          "type": "person",
+          "name": "Player 1",
+          "properties": {
+            "role": "player",
+            "gamesPlayed": 0,
+            "gamesWon": 0,
+            "highScore": 0
+          }
+        },
+        {
+          "type": "person",
+          "name": "Briggy",
+          "properties": {
+            "role": "ai",
+            "difficulty": "medium",
+            "description": "Your AI opponent"
+          }
+        }
+      ],
+      "relationships": []
+    },
+    "templateMetadata": {
+      "runnable": true,
+      "runnableCommand": "npm run dev"
+    },
+    "deploy": {
+      "provider": "cloud-run",
+      "buildCommand": "npm run build",
+      "outputDir": "build",
+      "config": {
+        "port": 3000,
+        "memory": "512Mi"
+      }
+    }
+  }
+}