@soulcraft/kits 1.0.0

package/kits/personal-crm/kit.json

@@ -0,0 +1,373 @@
+{
+  "$schema": "https://soulcraft.com/schemas/kit/v2.json",
+  "id": "personal-crm",
+  "type": "soulcraft",
+  "role": "primary",
+  "status": "released",
+  "name": "Personal CRM",
+  "description": "Relationship manager with contact network visualization and interaction tracking",
+  "longDescription": "Build a relationship-focused contact manager where connections matter as much as contacts. Track interactions, visualize your network graph, and surface contacts you have not spoken to recently. Uses Brainy for rich relationship modeling with person, organization, event, and topic entity types.",
+  "version": "1.0.0",
+  "author": {
+    "name": "Soulcraft Labs",
+    "email": "kits@soulcraft.com",
+    "url": "https://soulcraft.com"
+  },
+  "icon": "👥",
+  "tags": [
+    "crm",
+    "contacts",
+    "relationships",
+    "networking",
+    "brainy",
+    "sveltekit"
+  ],
+  "variables": [
+    {
+      "key": "appName",
+      "label": "App Name",
+      "description": "The name of your personal CRM app",
+      "type": "string",
+      "required": true,
+      "example": "my-network"
+    },
+    {
+      "key": "description",
+      "label": "Description",
+      "description": "A short description of your network",
+      "type": "string",
+      "required": false,
+      "example": "My personal contact network",
+      "default": "A relationship-first contact manager"
+    }
+  ],
+  "shared": {
+    "industry": "personal-productivity",
+    "category": "business",
+    "aiExpertise": [
+      "Contact relationship management",
+      "Network analysis and insights",
+      "Follow-up strategy",
+      "Relationship nurturing",
+      "Contact organization and tagging"
+    ],
+    "dataModelHints": [
+      "person",
+      "organization",
+      "event",
+      "topic"
+    ],
+    "dataModel": {
+      "entities": [
+        {
+          "domain": "contact",
+          "type": "Person",
+          "description": "A person in the relationship network with contact details",
+          "products": {
+            "workshop": {
+              "view": "gallery",
+              "icon": "👤"
+            },
+            "academy": {
+              "mapsTo": "learning-subject",
+              "assessable": false
+            }
+          }
+        },
+        {
+          "domain": "company",
+          "type": "Concept",
+          "description": "An organisation or company contacts are associated with",
+          "products": {
+            "workshop": {
+              "view": "graph",
+              "icon": "🏢"
+            },
+            "academy": {
+              "mapsTo": "knowledge-unit",
+              "assessable": false
+            }
+          }
+        },
+        {
+          "domain": "interaction",
+          "type": "Event",
+          "description": "A logged interaction such as a call, email, or meeting",
+          "products": {
+            "workshop": {
+              "view": "timeline",
+              "icon": "💬"
+            },
+            "academy": {
+              "mapsTo": "practice-session",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "tag",
+          "type": "Concept",
+          "description": "A label categorising contacts by context or relationship type",
+          "products": {
+            "workshop": {
+              "view": "graph",
+              "icon": "🏷️"
+            },
+            "academy": {
+              "mapsTo": "knowledge-unit",
+              "assessable": false
+            }
+          }
+        }
+      ],
+      "relationships": [
+        {
+          "from": "contact",
+          "to": "company",
+          "verb": "MemberOf",
+          "description": "Contact works at this company"
+        },
+        {
+          "from": "contact",
+          "to": "contact",
+          "verb": "FriendOf",
+          "description": "Contact knows another contact"
+        },
+        {
+          "from": "contact",
+          "to": "contact",
+          "verb": "References",
+          "description": "Contact was introduced by another"
+        },
+        {
+          "from": "interaction",
+          "to": "contact",
+          "verb": "Communicates",
+          "description": "Interaction was with this contact"
+        },
+        {
+          "from": "tag",
+          "to": "contact",
+          "verb": "Categorizes",
+          "description": "Tag is applied to this contact"
+        }
+      ]
+    },
+    "suggestions": [
+      {
+        "label": "Add a contact",
+        "prompt": "Help me add a new contact to my personal CRM"
+      },
+      {
+        "label": "Log an interaction",
+        "prompt": "Help me log a recent interaction with a contact"
+      },
+      {
+        "label": "Plan follow-ups",
+        "prompt": "Show me contacts I should follow up with and help me plan outreach"
+      },
+      {
+        "label": "Tag and organize",
+        "prompt": "Help me organize my contacts with tags and groups"
+      },
+      {
+        "label": "Relationship insights",
+        "prompt": "Analyze my contact network and suggest relationship-building opportunities"
+      },
+      {
+        "label": "View my network",
+        "prompt": "Show me my contact network in the graph view"
+      }
+    ]
+  },
+  "academy": {
+    "skillPath": "relationship-management",
+    "level": "beginner",
+    "learningObjectives": [
+      "Build a structured contact record capturing role, context of meeting, and shared interests",
+      "Log interactions consistently so the history of any relationship is retrievable at a glance",
+      "Identify contacts who need follow-up using recency data and prioritise outreach",
+      "Map network connections to discover shared contacts and introduction opportunities"
+    ],
+    "assessmentTypes": [
+      "portfolio"
+    ],
+    "certificationSlug": "relationship-manager"
+  },
+  "workshop": {
+    "difficulty": "intermediate",
+    "templateTier": 4,
+    "aiPersona": {
+      "role": "You are a relationship management expert helping users build and maintain meaningful professional and personal connections.",
+      "expertise": [
+        "Contact relationship management",
+        "Network analysis",
+        "Follow-up strategy",
+        "Relationship nurturing",
+        "Contact organization"
+      ],
+      "tone": "collaborator"
+    },
+    "graphGuidance": {
+      "conceptCreation": {
+        "triggers": [
+          "User adds a new contact",
+          "User creates a company",
+          "User logs an interaction",
+          "User creates a tag"
+        ],
+        "typeMapping": {
+          "contact": "person",
+          "company": "organization",
+          "interaction": "event",
+          "tag": "topic"
+        }
+      },
+      "relationshipPatterns": [
+        {
+          "from": "person",
+          "to": "organization",
+          "verb": "memberOf",
+          "description": "Contact works at company"
+        },
+        {
+          "from": "person",
+          "to": "person",
+          "verb": "friendOf",
+          "description": "Contact knows another contact"
+        },
+        {
+          "from": "person",
+          "to": "person",
+          "verb": "references",
+          "description": "Contact was introduced by another"
+        },
+        {
+          "from": "event",
+          "to": "person",
+          "verb": "communicates",
+          "description": "Interaction was with contact"
+        },
+        {
+          "from": "topic",
+          "to": "person",
+          "verb": "categorizes",
+          "description": "Tag applied to contact"
+        }
+      ],
+      "rules": [
+        "Every contact should have at least one interaction logged",
+        "Prefer relationships over nested properties for connections",
+        "Use tags consistently across contacts for filtering"
+      ]
+    },
+    "qualityGates": {
+      "fileChecks": [
+        {
+          "path": "package.json",
+          "required": [
+            "svelte",
+            "@sveltejs/kit",
+            "@soulcraft/brainy"
+          ],
+          "optional": [
+            "typescript"
+          ]
+        },
+        {
+          "path": "src/lib/types.ts",
+          "required": [
+            "Contact",
+            "Company",
+            "Interaction"
+          ],
+          "optional": [
+            "Tag"
+          ]
+        }
+      ],
+      "projectChecks": [
+        "App starts with npm run dev",
+        "Can create new contacts",
+        "Can log interactions",
+        "Can view contact network graph",
+        "Search returns matching contacts"
+      ],
+      "exportReady": [
+        "No TypeScript errors",
+        "All routes load correctly",
+        "Error handling in place"
+      ]
+    },
+    "sampleData": {
+      "description": "Realistic sample contacts demonstrating the CRM features",
+      "entities": [
+        {
+          "type": "person",
+          "name": "Alex Chen",
+          "properties": {
+            "email": "alex.chen@techcorp.io",
+            "phone": "+1-555-0101",
+            "role": "Engineering Manager",
+            "description": "Engineering lead at TechCorp. Interested in knowledge graphs and AI.",
+            "notes": "Met at TechConf 2024. Interested in knowledge graphs.",
+            "lastContacted": "2024-11-15",
+            "status": "active",
+            "createdAt": "2024-09-01"
+          }
+        },
+        {
+          "type": "person",
+          "name": "Sarah Johnson",
+          "properties": {
+            "email": "sarah.j@startup.co",
+            "phone": "+1-555-0102",
+            "role": "CEO",
+            "description": "Founder and CEO of Startup.co. College friend turned entrepreneur.",
+            "notes": "College friend, now running a startup",
+            "lastContacted": "2024-10-20",
+            "status": "active",
+            "createdAt": "2024-06-15"
+          }
+        },
+        {
+          "type": "organization",
+          "name": "TechCorp",
+          "properties": {
+            "industry": "Technology",
+            "website": "https://techcorp.io",
+            "size": "500-1000",
+            "description": "Enterprise software company specializing in AI solutions.",
+            "createdAt": "2024-09-01"
+          }
+        }
+      ],
+      "relationships": [
+        {
+          "from": "Alex Chen",
+          "verb": "memberOf",
+          "to": "TechCorp"
+        },
+        {
+          "from": "Sarah Johnson",
+          "verb": "friendOf",
+          "to": "Alex Chen"
+        }
+      ]
+    },
+    "templateMetadata": {
+      "runnable": true,
+      "runnableCommand": "npm run dev"
+    },
+    "deploy": {
+      "provider": "cloud-run",
+      "buildCommand": "npm run build",
+      "outputDir": "build",
+      "config": {
+        "port": 3000,
+        "memory": "512Mi"
+      },
+      "oneClickCommand": "gcloud run deploy"
+    }
+  }
+}

package/kits/personal-crm/skills/add-contact/SKILL.md

@@ -0,0 +1,42 @@
+---
+id: add-contact
+name: Add New Contact
+description: Create a new person entity with contact details
+version: "1.0.0"
+type: invocable
+parameters: [contactData]
+requiresVision: false
+requiresData: false
+---
+
+## Add New Contact
+
+Create a new person entity with contact details
+
+### Steps
+
+1. Create a form component for contact input
+2. Validate required fields (name, at least one contact method)
+3. Create person entity in Brainy with properties
+4. Optionally link to existing company
+5. Add relevant tags
+6. Redirect to contact detail page
+
+### Inputs Required
+
+- **contactData** (required): Name, email, phone, company, notes
+
+### Expected Outputs
+
+- New contact entity
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "add contact"
+- "new person"
+- "create contact"
+
+### Execution Mode
+
+This workflow can be executed automatically when triggered. Proceed through the steps without waiting for confirmation at each step.

package/kits/personal-crm/skills/connect-contacts/SKILL.md

@@ -0,0 +1,41 @@
+---
+id: connect-contacts
+name: Connect Two Contacts
+description: Create a relationship between two people
+version: "1.0.0"
+type: invocable
+parameters: [contact1, contact2]
+requiresVision: false
+requiresData: false
+---
+
+## Connect Two Contacts
+
+Create a relationship between two people
+
+### Steps
+
+1. Select two contacts to connect
+2. Choose relationship type (introduced, knows, works with)
+3. Create friendOf or worksWith relationship in Brainy
+4. Show connection in network graph
+
+### Inputs Required
+
+- **contact1** (required): First contact
+- **contact2** (required): Second contact
+
+### Expected Outputs
+
+- New relationship
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "connect contacts"
+- "link people"
+- "add connection"
+
+### Execution Mode
+
+This workflow can be executed automatically when triggered. Proceed through the steps without waiting for confirmation at each step.

package/kits/personal-crm/skills/find-dormant/SKILL.md

@@ -0,0 +1,35 @@
+---
+id: find-dormant
+name: Find Dormant Contacts
+description: Surface contacts you haven't talked to recently
+version: "1.0.0"
+type: invocable
+requiresVision: false
+requiresData: false
+---
+
+## Find Dormant Contacts
+
+Surface contacts you haven't talked to recently
+
+### Steps
+
+1. Query contacts by lastContacted property
+2. Filter by configurable time threshold (e.g., 30 days)
+3. Sort by longest time since contact
+4. Display as reminder list with quick action to log interaction
+
+### Inputs Required
+
+- **daysSinceContact** (optional): Threshold in days
+
+### Expected Outputs
+
+- List of contacts needing attention
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "dormant contacts"
+- "haven't talked to"
+- "need to reach out"

package/kits/personal-crm/skills/kit-expertise/SKILL.md

@@ -0,0 +1,82 @@
+---
+id: kit-expertise
+name: kit-expertise
+description: Domain expertise for Personal CRM - applied automatically when working in this kit
+version: "1.0.0"
+type: background
+requiresVision: true
+requiresData: false
+---
+
+## Your Role
+
+You are a CRM and relationship management expert helping build a personal contact network application. You understand the importance of tracking not just contacts, but the relationships between people. You help users build an app that surfaces insights about their network and reminds them to stay in touch with important contacts.
+
+## Your Expertise
+
+- Contact and relationship management
+- Network visualization and analysis
+- SvelteKit 2 and Svelte 5 runes
+- Brainy knowledge graph for relationship data
+- Timeline and activity tracking
+- Search and filtering patterns
+- Notification and reminder systems
+
+## Your Approach
+
+Work alongside the user as a creative partner
+
+## Things to Avoid
+
+- Don't overcomplicate the data model - keep it focused on relationships
+- Avoid enterprise CRM complexity - this is personal
+- Don't add sales/pipeline features unless asked
+- Never store sensitive data without encryption considerations
+
+## Domain Knowledge
+
+### Key Terms
+
+**contact**
+A person in your network, stored as a Brainy 'person' entity
+
+**company**
+An organization, stored as a Brainy 'organization' entity
+
+**interaction**
+A touchpoint with a contact (call, meeting, email), stored as 'event'
+
+**tag**
+A category label for organizing contacts, stored as 'topic'
+
+**network graph**
+Visual representation of how contacts are connected
+
+**last contact**
+Date of most recent interaction with a person
+
+**relationship strength**
+Implicit metric based on interaction frequency
+
+### Best Practices
+
+- Store contacts as 'person' entities in Brainy
+- Store companies as 'organization' entities
+- Store interactions as 'event' entities linked to contacts
+- Use 'memberOf' for person-to-company relationships
+- Use 'friendOf' for person-to-person connections
+- Use 'communicates' for interaction relationships
+- Use 'categorizes' for tag assignments
+- Track lastContacted in entity properties for reminder features
+
+### Common Mistakes to Avoid
+
+- Creating custom entity types instead of using Brainy's built-in types
+- Storing relationship data as entity properties instead of as relationships
+- Not tracking interaction dates for 'last contacted' features
+- Mixing personal and professional contact data without clear separation
+
+### Recommended References
+
+- **Brainy Entity Types**: person, organization, event, topic
+- **Brainy Relationship Verbs**: memberOf, friendOf, communicates, categorizes, references

package/kits/personal-crm/skills/log-interaction/SKILL.md

@@ -0,0 +1,43 @@
+---
+id: log-interaction
+name: Log Interaction
+description: Record a touchpoint with a contact
+version: "1.0.0"
+type: invocable
+parameters: [contactId, interactionType]
+requiresVision: false
+requiresData: false
+---
+
+## Log Interaction
+
+Record a touchpoint with a contact
+
+### Steps
+
+1. Create interaction form (type, date, notes)
+2. Create event entity in Brainy
+3. Link to contact with 'communicates' relationship
+4. Update contact's lastContacted property
+5. Show in timeline view
+
+### Inputs Required
+
+- **contactId** (required): The contact this interaction is with
+- **interactionType** (required): call, meeting, email, message, etc.
+
+### Expected Outputs
+
+- Interaction event
+- Updated contact
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "log interaction"
+- "add touchpoint"
+- "record meeting"
+
+### Execution Mode
+
+This workflow can be executed automatically when triggered. Proceed through the steps without waiting for confirmation at each step.