@soulcraft/kits 1.0.0

package/kits/family-tree/kit.json

@@ -0,0 +1,380 @@
+{
+  "$schema": "https://soulcraft.com/schemas/kit/v2.json",
+  "id": "family-tree",
+  "type": "soulcraft",
+  "role": "primary",
+  "status": "released",
+  "name": "Family Tree",
+  "description": "Visual family tree with person profiles and relationship mapping",
+  "longDescription": "Create a beautiful, interactive family tree that automatically visualizes in the graph view. Each person gets their own profile document, and all relationships (parent-child, spouses, siblings) are connected in the knowledge graph. Perfect for genealogy research, family history projects, or understanding complex family dynamics.",
+  "version": "1.0.0",
+  "author": {
+    "name": "Soulcraft Labs",
+    "email": "kits@soulcraft.com",
+    "url": "https://soulcraft.com"
+  },
+  "icon": "👪",
+  "tags": [
+    "family",
+    "genealogy",
+    "relationships",
+    "visualization"
+  ],
+  "variables": [
+    {
+      "key": "familyName",
+      "label": "Family Name",
+      "description": "The name of your family",
+      "type": "string",
+      "required": true,
+      "example": "The Smith Family"
+    },
+    {
+      "key": "location",
+      "label": "Primary Location",
+      "description": "Where the family is primarily based",
+      "type": "string",
+      "required": false,
+      "example": "California, USA"
+    }
+  ],
+  "shared": {
+    "industry": "personal-productivity",
+    "category": "knowledge",
+    "glossary": {
+      "generation": "A group of people born and living at around the same time",
+      "lineage": "The direct line of descent from an ancestor"
+    },
+    "aiExpertise": [
+      "Genealogy research methods",
+      "Family history documentation",
+      "Relationship mapping",
+      "Oral history preservation",
+      "Ancestral record analysis"
+    ],
+    "dataModelHints": [
+      "person",
+      "event",
+      "thing",
+      "topic"
+    ],
+    "dataModel": {
+      "entities": [
+        {
+          "domain": "person",
+          "type": "Person",
+          "description": "A family member with biographical details and dates",
+          "products": {
+            "workshop": {
+              "view": "gallery",
+              "icon": "🧑"
+            },
+            "academy": {
+              "mapsTo": "learning-subject",
+              "assessable": false
+            }
+          }
+        },
+        {
+          "domain": "family",
+          "type": "Concept",
+          "description": "A nuclear family unit grouping related members",
+          "products": {
+            "workshop": {
+              "view": "graph",
+              "icon": "🏡"
+            },
+            "academy": {
+              "mapsTo": "knowledge-unit",
+              "assessable": false
+            }
+          }
+        },
+        {
+          "domain": "event",
+          "type": "Event",
+          "description": "A significant life event such as birth, marriage, or death",
+          "products": {
+            "workshop": {
+              "view": "timeline",
+              "icon": "📅"
+            },
+            "academy": {
+              "mapsTo": "practice-session",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "location",
+          "type": "Location",
+          "description": "A place associated with family history such as birthplace or residence",
+          "products": {
+            "workshop": {
+              "view": "graph",
+              "icon": "📍"
+            }
+          }
+        }
+      ],
+      "relationships": [
+        {
+          "from": "person",
+          "to": "person",
+          "verb": "ChildOf",
+          "description": "Parent-child relationship"
+        },
+        {
+          "from": "person",
+          "to": "person",
+          "verb": "SpouseOf",
+          "description": "Marriage or partnership"
+        },
+        {
+          "from": "person",
+          "to": "person",
+          "verb": "SiblingOf",
+          "description": "Brother or sister relationship"
+        },
+        {
+          "from": "person",
+          "to": "family",
+          "verb": "MemberOf",
+          "description": "Person belongs to this family unit"
+        },
+        {
+          "from": "person",
+          "to": "location",
+          "verb": "BornIn",
+          "description": "Person's birthplace"
+        },
+        {
+          "from": "person",
+          "to": "event",
+          "verb": "ParticipatedIn",
+          "description": "Person took part in this life event"
+        }
+      ]
+    },
+    "suggestions": [
+      {
+        "label": "Add a family member",
+        "prompt": "Help me add a new family member to the tree"
+      },
+      {
+        "label": "Record a story",
+        "prompt": "Help me record a family story or memory"
+      },
+      {
+        "label": "Define relationships",
+        "prompt": "Help me map out the relationships between family members"
+      },
+      {
+        "label": "Create a timeline",
+        "prompt": "Help me create a timeline of important family events"
+      },
+      {
+        "label": "Find connections",
+        "prompt": "Show me how family members are connected across generations"
+      },
+      {
+        "label": "Explore the tree",
+        "prompt": "Show me my family tree in the tree view"
+      }
+    ]
+  },
+  "academy": {
+    "skillPath": "genealogy",
+    "level": "beginner",
+    "learningObjectives": [
+      "Record biographical profiles for family members with birth, marriage, and death data",
+      "Map kinship relationships (parent-child, spouse, sibling) across multiple generations",
+      "Identify and document primary sources for key genealogical facts",
+      "Construct a multi-generation family tree and interpret lines of descent"
+    ],
+    "assessmentTypes": [
+      "portfolio"
+    ],
+    "certificationSlug": "genealogist"
+  },
+  "workshop": {
+    "difficulty": "beginner",
+    "templateTier": 4,
+    "aiPersona": {
+      "role": "You are an expert genealogist and family historian helping people document, research, and visualize their family trees and heritage.",
+      "expertise": [
+        "Genealogy research and documentation",
+        "Family history preservation",
+        "Relationship and kinship mapping",
+        "Historical records and archives",
+        "Oral history collection"
+      ],
+      "tone": "collaborator"
+    },
+    "workspaceConfig": {
+      "paradigm": "creative",
+      "defaultTab": "explore",
+      "defaultView": "tree",
+      "defaultFile": "people/self.md",
+      "layout": {
+        "leftDock": "concepts",
+        "rightDock": "views"
+      },
+      "onboarding": {
+        "showGuide": true,
+        "highlightFeatures": [
+          "tree",
+          "graph"
+        ],
+        "suggestedActions": [
+          "Start with yourself and add immediate family",
+          "Add photos and bios to each person",
+          "Use Tree view for hierarchical view",
+          "Use Graph view to see all relationships"
+        ]
+      }
+    },
+    "graphGuidance": {
+      "conceptCreation": {
+        "triggers": [
+          "When adding a new family member",
+          "When documenting a marriage or partnership",
+          "When identifying a new family branch",
+          "When recording important events (births, deaths, marriages)"
+        ],
+        "typeMapping": {
+          "person": "person",
+          "family member": "person",
+          "relative": "person",
+          "family": "organization",
+          "event": "event",
+          "location": "location",
+          "generation": "category"
+        }
+      },
+      "relationshipPatterns": [
+        {
+          "from": "Person",
+          "to": "Person",
+          "verb": "childOf",
+          "description": "Parent-child relationship"
+        },
+        {
+          "from": "Person",
+          "to": "Person",
+          "verb": "spouseOf",
+          "description": "Marriage or partnership"
+        },
+        {
+          "from": "Person",
+          "to": "Person",
+          "verb": "siblingOf",
+          "description": "Brother or sister"
+        },
+        {
+          "from": "Person",
+          "to": "Family",
+          "verb": "memberOf",
+          "description": "Belongs to family unit"
+        },
+        {
+          "from": "Person",
+          "to": "Location",
+          "verb": "bornIn",
+          "description": "Birthplace"
+        },
+        {
+          "from": "Person",
+          "to": "Location",
+          "verb": "livedIn",
+          "description": "Residence"
+        },
+        {
+          "from": "Person",
+          "to": "Event",
+          "verb": "participatedIn",
+          "description": "Life event"
+        }
+      ],
+      "rules": [
+        "Every person should have parents documented (even if unknown)",
+        "Spouses link bidirectionally",
+        "Children link to both parents when known",
+        "Family units group nuclear families",
+        "Locations should be reused when they refer to the same place"
+      ]
+    },
+    "qualityGates": {
+      "fileChecks": [
+        {
+          "path": "members/*.md",
+          "required": [
+            "Birth Date"
+          ],
+          "optional": [
+            "Biography",
+            "Photos",
+            "Notes"
+          ]
+        }
+      ],
+      "projectChecks": [
+        "At least one generation is documented",
+        "Person profiles have relationship information",
+        "No orphan people (everyone connects to someone)",
+        "Key dates are recorded"
+      ],
+      "exportReady": [
+        "All people have at least birth year",
+        "Relationships are documented for all members",
+        "Names are complete (not placeholders)",
+        "Sources are noted for key facts"
+      ]
+    },
+    "sampleData": {
+      "description": "Sample family tree spanning four generations",
+      "entities": [
+        {
+          "type": "person",
+          "name": "Robert Mitchell Sr.",
+          "properties": {
+            "birthDate": "1920-05-12",
+            "deathDate": "1998-11-03",
+            "birthPlace": "Boston, MA",
+            "description": "Family patriarch. Immigrated from Ireland as a child. Worked as a carpenter.",
+            "generation": 1
+          }
+        },
+        {
+          "type": "person",
+          "name": "Eleanor Mitchell",
+          "properties": {
+            "birthDate": "1924-08-20",
+            "deathDate": "2010-03-15",
+            "birthPlace": "Boston, MA",
+            "maidenName": "O'Brien",
+            "description": "Homemaker and community volunteer. Met Robert at a church social.",
+            "generation": 1
+          }
+        }
+      ],
+      "relationships": [
+        {
+          "from": "Robert Mitchell Sr.",
+          "verb": "worksWith",
+          "to": "Eleanor Mitchell"
+        }
+      ]
+    },
+    "deploy": {
+      "provider": "cloud-run",
+      "buildCommand": "npm run build",
+      "outputDir": "build",
+      "config": {
+        "port": 3000,
+        "memory": "512Mi"
+      },
+      "oneClickCommand": "gcloud run deploy"
+    }
+  }
+}

package/kits/family-tree/skills/add-family-member/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: Add Family Member
+description: Add a new person to the family tree with proper relationships
+type: invocable
+version: "1.0.0"
+parameters: [name, relationship]
+---
+
+## Add Family Member
+
+Add a new person to the family tree with proper relationships
+
+### Steps
+
+1. Gather basic information: full name, birth date, birth place
+2. Identify their relationships: parents, spouse(s), children
+3. Create a person profile file in members/
+4. Add biographical information and life events
+5. Include any photos with dates and descriptions
+6. Create the person concept in the knowledge graph
+7. Add relationship links (child-of, spouse-of, parent-of)
+8. Link to the family collection
+9. Note sources for the information
+
+### Inputs Required
+
+- **name** (required): Person's full name
+- **relationship** (required): How they relate to existing members
+
+### Expected Outputs
+
+- Person profile file
+- Knowledge graph entries
+- Relationships
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "add person"
+- "add family member"
+- "new family member"
+- "add relative"

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

@@ -0,0 +1,41 @@
+---
+name: Analyze Family Relationship
+description: Understand how two family members are related
+type: invocable
+version: "1.0.0"
+parameters: [person1, person2]
+---
+
+## Analyze Family Relationship
+
+Understand how two family members are related
+
+### Steps
+
+1. Identify the two people to analyze
+2. Trace each person's lineage to a common ancestor
+3. Count generations from common ancestor to each person
+4. Determine relationship type (cousin, removal, etc.)
+5. Document the path of relationship
+6. Note if there are multiple relationship paths
+
+### Inputs Required
+
+- **person1** (required): First person
+- **person2** (required): Second person
+
+### Expected Outputs
+
+- Relationship explanation
+- Lineage path
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "how are they related"
+- "relationship between"
+- "what relation is"
+
+### Execution Mode
+
+This workflow can be executed automatically when triggered. Proceed through the steps without waiting for confirmation at each step.

package/kits/family-tree/skills/export-gedcom/SKILL.md

@@ -0,0 +1,34 @@
+---
+name: Prepare GEDCOM Export
+description: Prepare family tree data for export to genealogy software
+type: invocable
+version: "1.0.0"
+---
+
+## Prepare GEDCOM Export
+
+Prepare family tree data for export to genealogy software
+
+### Steps
+
+1. Review all person profiles for completeness
+2. Verify all relationships are documented
+3. Check date formats are consistent
+4. Ensure locations have consistent formatting
+5. Identify any missing critical data
+6. Note which photos/media to include
+7. Generate GEDCOM-ready summary
+8. List items needing attention before export
+
+### Expected Outputs
+
+- Export readiness report
+- Data quality checklist
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "export"
+- "GEDCOM"
+- "share family tree"
+- "export to ancestry"

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

@@ -0,0 +1,188 @@
+---
+name: genealogy-research
+description: Background expertise in genealogical research techniques and documentation
+type: background
+version: "1.0.0"
+---
+
+## Genealogy Research Expertise
+
+You have expertise in genealogical research methods and family history documentation. Apply these principles when helping users build and research their family trees.
+
+### Research Process
+
+**Step 1: Start with Known**
+- Document what you know
+- Interview living relatives
+- Gather family documents
+- Note sources for everything
+
+**Step 2: Work Backward**
+- One generation at a time
+- Verify before extending
+- Follow all lines
+- Document dead ends
+
+**Step 3: Verify and Expand**
+- Cross-reference sources
+- Fill in details
+- Resolve conflicts
+- Note uncertainties
+
+### Source Types
+
+**Primary Sources**
+- Created at or near the time of event
+- By someone with direct knowledge
+- Examples: birth certificates, church records, census
+
+**Secondary Sources**
+- Created later
+- Based on primary sources
+- Examples: biographies, indexes, transcriptions
+
+**Original vs. Derivative**
+- Original: First recording
+- Derivative: Copy, transcription, abstract
+
+### Record Types
+
+**Vital Records**
+- Birth certificates
+- Marriage licenses
+- Death certificates
+- Divorce records
+
+**Census Records**
+- Population counts
+- Household members
+- Occupations, birthplaces
+- Available every 10 years (US)
+
+**Church Records**
+- Baptisms, christenings
+- Marriages
+- Burials
+- Membership rolls
+
+**Immigration Records**
+- Passenger lists
+- Naturalization papers
+- Border crossings
+- Passport applications
+
+**Military Records**
+- Service records
+- Draft registrations
+- Pension files
+- Veterans' records
+
+**Land and Property**
+- Deeds
+- Tax records
+- Wills, probate
+- Land grants
+
+### Source Citation
+
+**Essential Elements**
+- Who created the record
+- What is it
+- When created
+- Where found
+- Any identifying numbers
+
+**Example Format**
+```
+[Creator], [Title], [Publication info], [Location/repository], [Item identifier]; accessed [date].
+```
+
+### Research Standards
+
+**GPS (Genealogical Proof Standard)**
+1. Reasonably exhaustive search
+2. Complete citation of sources
+3. Analysis and correlation
+4. Resolution of conflicts
+5. Written conclusion
+
+**Best Practices**
+- Source everything
+- Note negative searches
+- Date your research
+- Review periodically
+- Collaborate carefully
+
+### Common Research Challenges
+
+**Name Variations**
+- Spelling changes
+- Anglicization
+- Nicknames
+- Name changes
+
+**Date Discrepancies**
+- Calendar changes
+- Age rounding
+- Memory errors
+- Misrecording
+
+**Location Changes**
+- Boundary shifts
+- Name changes
+- Immigration
+
+**Record Loss**
+- Wars, fires, disasters
+- Deliberate destruction
+- Poor preservation
+
+### Documentation Standards
+
+**For Each Person**
+- Full name (all known variations)
+- Birth date and place
+- Death date and place
+- Marriage(s) date and place
+- Parents (if known)
+- Children (if any)
+- Sources for each fact
+
+**Relationship Recording**
+- Use standard relationships
+- Note adoptions separately
+- Document step-relationships
+- Handle multiple marriages
+
+### Privacy Considerations
+
+**Living Persons**
+- Get consent before sharing
+- Don't publish full dates
+- Protect addresses
+- Respect wishes
+
+**Sensitive Information**
+- Handle adoptions carefully
+- Note illegitimacy privately
+- Respect cultural sensitivities
+
+### Research Tools
+
+**Online Databases**
+- Ancestry.com
+- FamilySearch.org
+- FindMyPast
+- MyHeritage
+
+**Local Resources**
+- County courthouses
+- Libraries and archives
+- Historical societies
+- Cemeteries
+
+**DNA Testing**
+- Ethnicity estimates
+- Cousin matching
+- Paper trail companion
+- Not definitive alone