@soulcraft/kits 1.0.0

package/kits/gtd-productivity-system/kit.json

@@ -0,0 +1,389 @@
+{
+  "$schema": "https://soulcraft.com/schemas/kit/v2.json",
+  "id": "gtd-productivity-system",
+  "type": "soulcraft",
+  "role": "primary",
+  "status": "released",
+  "name": "GTD Productivity System",
+  "description": "Getting Things Done productivity system with projects, next actions, and contexts",
+  "longDescription": "Implement David Allen's Getting Things Done methodology with a complete workflow system. Includes inbox capture, project lists, next actions organized by context, waiting for tracking, and someday/maybe lists. All connected through the knowledge graph for easy navigation.",
+  "version": "1.0.0",
+  "author": {
+    "name": "Soulcraft Labs",
+    "email": "kits@soulcraft.com",
+    "url": "https://soulcraft.com"
+  },
+  "icon": "✅",
+  "tags": [
+    "productivity",
+    "gtd",
+    "task-management",
+    "organization",
+    "workflow"
+  ],
+  "variables": [
+    {
+      "key": "projectName",
+      "label": "System Name",
+      "description": "What to call your GTD system",
+      "type": "string",
+      "required": true,
+      "example": "My GTD System"
+    },
+    {
+      "key": "userName",
+      "label": "Your Name",
+      "description": "Your name for the system",
+      "type": "string",
+      "required": false,
+      "example": "Your Name"
+    }
+  ],
+  "shared": {
+    "industry": "personal-productivity",
+    "category": "knowledge",
+    "glossary": {
+      "inbox": "The capture zone for all new items before processing",
+      "next action": "The very next physical action required to move a project forward",
+      "context": "The location or tool required to complete a task (e.g., @computer, @phone)",
+      "weekly review": "A regular system maintenance session to keep GTD current"
+    },
+    "aiExpertise": [
+      "GTD methodology and principles",
+      "Task and project management",
+      "Context-based productivity",
+      "Weekly review facilitation",
+      "Work-life balance and prioritization"
+    ],
+    "dataModelHints": [
+      "thing",
+      "event",
+      "topic",
+      "person"
+    ],
+    "dataModel": {
+      "entities": [
+        {
+          "domain": "project",
+          "type": "Concept",
+          "description": "A multi-step outcome requiring more than one next action",
+          "products": {
+            "workshop": {
+              "view": "board",
+              "icon": "📋"
+            },
+            "academy": {
+              "mapsTo": "knowledge-unit",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "action",
+          "type": "Event",
+          "description": "A concrete next physical action that can be done now",
+          "products": {
+            "workshop": {
+              "view": "board",
+              "icon": "✅"
+            },
+            "academy": {
+              "mapsTo": "practice-session",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "context",
+          "type": "Concept",
+          "description": "A location or tool context grouping actionable tasks",
+          "products": {
+            "workshop": {
+              "view": "graph",
+              "icon": "🏷️"
+            },
+            "academy": {
+              "mapsTo": "knowledge-unit",
+              "assessable": false
+            }
+          }
+        },
+        {
+          "domain": "area",
+          "type": "Concept",
+          "description": "A life area such as Work, Personal, or Health",
+          "products": {
+            "workshop": {
+              "view": "graph",
+              "icon": "🗂️"
+            },
+            "academy": {
+              "mapsTo": "knowledge-unit",
+              "assessable": false
+            }
+          }
+        },
+        {
+          "domain": "person",
+          "type": "Person",
+          "description": "A person to whom a waiting-for item is delegated",
+          "products": {
+            "workshop": {
+              "view": "gallery",
+              "icon": "👤"
+            },
+            "academy": {
+              "mapsTo": "learning-subject",
+              "assessable": false
+            }
+          }
+        }
+      ],
+      "relationships": [
+        {
+          "from": "action",
+          "to": "project",
+          "verb": "PartOf",
+          "description": "Action belongs to this project"
+        },
+        {
+          "from": "action",
+          "to": "context",
+          "verb": "Requires",
+          "description": "Action needs this context to be completed"
+        },
+        {
+          "from": "project",
+          "to": "area",
+          "verb": "PartOf",
+          "description": "Project belongs to this life area"
+        },
+        {
+          "from": "action",
+          "to": "person",
+          "verb": "DelegatedTo",
+          "description": "Waiting-for item delegated to this person"
+        },
+        {
+          "from": "project",
+          "to": "project",
+          "verb": "RelatedTo",
+          "description": "Projects that affect or depend on each other"
+        }
+      ]
+    },
+    "suggestions": [
+      {
+        "label": "Add a task",
+        "prompt": "Help me capture a new task or action item"
+      },
+      {
+        "label": "Process my inbox",
+        "prompt": "Help me process and organize my inbox items"
+      },
+      {
+        "label": "Plan my week",
+        "prompt": "Help me plan my tasks and priorities for the week"
+      },
+      {
+        "label": "Review projects",
+        "prompt": "Help me do a weekly review of all my projects and next actions"
+      },
+      {
+        "label": "Clear blockers",
+        "prompt": "Identify blocked tasks and help me find solutions"
+      },
+      {
+        "label": "View task board",
+        "prompt": "Show me my tasks organized on the board view"
+      }
+    ]
+  },
+  "academy": {
+    "skillPath": "personal-productivity",
+    "level": "beginner",
+    "learningObjectives": [
+      "Perform a complete mind sweep to capture all open loops into a single inbox",
+      "Clarify each inbox item by deciding if it is actionable and what the next physical action is",
+      "Organize projects and next actions into context lists for reliable retrieval",
+      "Run a weekly review to keep the system current and identify stalled projects"
+    ],
+    "assessmentTypes": [
+      "portfolio"
+    ],
+    "certificationSlug": "productivity-practitioner"
+  },
+  "workshop": {
+    "difficulty": "intermediate",
+    "templateTier": 4,
+    "aiPersona": {
+      "role": "You are an expert productivity coach specializing in the Getting Things Done methodology, helping users capture, organize, and execute their commitments with clarity.",
+      "expertise": [
+        "GTD methodology and best practices",
+        "Task and project management",
+        "Context-based work organization",
+        "Weekly review process",
+        "Mind sweep and brain dump techniques"
+      ],
+      "tone": "mentor"
+    },
+    "workspaceConfig": {
+      "paradigm": "planner",
+      "defaultTab": "explore",
+      "defaultView": "board",
+      "defaultFile": "inbox/capture.md",
+      "layout": {
+        "leftDock": "files",
+        "rightDock": "views"
+      },
+      "onboarding": {
+        "showGuide": true,
+        "highlightFeatures": [
+          "board",
+          "calendar",
+          "ai-chat"
+        ],
+        "suggestedActions": [
+          "Do a mind sweep - capture everything in inbox/",
+          "Process inbox using the clarify workflow",
+          "Use Board view to see next actions by context",
+          "Do weekly reviews to stay on track"
+        ]
+      }
+    },
+    "graphGuidance": {
+      "conceptCreation": {
+        "triggers": [
+          "User creates a new project",
+          "A new context is established",
+          "User identifies a recurring area of focus",
+          "A major life area is discussed"
+        ],
+        "typeMapping": {
+          "project": "project",
+          "context": "context",
+          "area": "category",
+          "person": "person",
+          "action": "task"
+        }
+      },
+      "relationshipPatterns": [
+        {
+          "from": "task",
+          "to": "project",
+          "verb": "partOf",
+          "description": "Action belongs to project"
+        },
+        {
+          "from": "task",
+          "to": "context",
+          "verb": "requires",
+          "description": "Action needs this context"
+        },
+        {
+          "from": "project",
+          "to": "category",
+          "verb": "partOf",
+          "description": "Project belongs to life area"
+        },
+        {
+          "from": "task",
+          "to": "person",
+          "verb": "delegatedTo",
+          "description": "Waiting for someone"
+        },
+        {
+          "from": "project",
+          "to": "project",
+          "verb": "relatedTo",
+          "description": "Projects that affect each other"
+        }
+      ],
+      "rules": [
+        "Every project should be linked to at least one next action",
+        "Contexts are categories that group next actions",
+        "Waiting for items should link to the person responsible",
+        "Projects can be grouped under life areas (work, personal, health)",
+        "Don't create actions as concepts - keep them in list files"
+      ]
+    },
+    "qualityGates": {
+      "fileChecks": [
+        {
+          "path": "inbox/capture.md",
+          "required": [],
+          "optional": [
+            "Processing Rules"
+          ]
+        },
+        {
+          "path": "projects/active/_project-list.md",
+          "required": [
+            "Work",
+            "Personal"
+          ],
+          "optional": [
+            "Health",
+            "Finance",
+            "Learning"
+          ]
+        }
+      ],
+      "projectChecks": [
+        "Inbox has been processed recently",
+        "Every active project has a next action",
+        "Context lists have actionable items (not vague tasks)",
+        "Waiting for items have who and when"
+      ],
+      "exportReady": [
+        "Weekly review has been completed",
+        "All projects have clear outcomes",
+        "Context lists are current"
+      ]
+    },
+    "sampleData": {
+      "description": "Sample GTD system with projects, tasks, and contexts",
+      "entities": [
+        {
+          "type": "project",
+          "name": "Launch Marketing Website",
+          "properties": {
+            "status": "in_progress",
+            "area": "Work",
+            "outcome": "New marketing site live with analytics",
+            "description": "Complete redesign and launch of company marketing website.",
+            "dueDate": "2025-02-28",
+            "createdAt": "2025-01-05"
+          }
+        },
+        {
+          "type": "task",
+          "name": "Email designer about homepage mockups",
+          "properties": {
+            "status": "todo",
+            "context": "@computer",
+            "description": "Request revised mockups with feedback from last meeting.",
+            "createdAt": "2025-01-12"
+          }
+        }
+      ],
+      "relationships": [
+        {
+          "from": "Email designer about homepage mockups",
+          "verb": "partOf",
+          "to": "Launch Marketing Website"
+        }
+      ]
+    },
+    "deploy": {
+      "provider": "cloud-run",
+      "buildCommand": "npm run build",
+      "outputDir": "build",
+      "config": {
+        "port": 3000,
+        "memory": "512Mi"
+      },
+      "oneClickCommand": "gcloud run deploy"
+    }
+  }
+}

package/kits/gtd-productivity-system/skills/break-down-project/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: Break Down Project
+description: Transform a project into actionable next steps
+type: invocable
+version: "1.0.0"
+parameters: [projectName]
+---
+
+## Break Down Project
+
+Transform a project into actionable next steps
+
+### Steps
+
+1. Review the project to understand the desired outcome
+2. Ask: What does "done" look like? Define clear success criteria
+3. Use natural planning: What's the purpose and vision?
+4. Brainstorm: What are all the things that might need to happen?
+5. Organize the brainstorm into logical sequences or categories
+6. Identify the very next physical action
+7. Add the next action to the appropriate context list
+8. Note any waiting for items or delegations needed
+9. Update the project file with the plan and next action
+
+### Inputs Required
+
+- **projectName** (required): The project to break down
+
+### Expected Outputs
+
+- Project plan
+- Identified next actions
+- Waiting for items
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "break down"
+- "plan project"
+- "next actions for"
+- "what should I do for"

package/kits/gtd-productivity-system/skills/clarify-task/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: Clarify Fuzzy Task
+description: Turn a vague item into a concrete next action
+type: invocable
+version: "1.0.0"
+parameters: [fuzzyTask]
+---
+
+## Clarify Fuzzy Task
+
+Turn a vague item into a concrete next action
+
+### Steps
+
+1. Read the fuzzy task or item
+2. Ask: What is the desired outcome here?
+3. Ask: Is this actually actionable, or is it reference/someday?
+4. If actionable: What is the VERY NEXT physical action?
+5. The next action should start with a verb: Call, Email, Draft, Review, etc.
+6. Determine the context: Where/what do you need to do this?
+7. If it's part of a larger project, identify or create that project
+8. Replace the fuzzy task with the clear next action
+
+### Inputs Required
+
+- **fuzzyTask** (required): The unclear task or item to clarify
+
+### Expected Outputs
+
+- Clear next action
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "clarify"
+- "what's the next action"
+- "this is unclear"
+- "help me understand"
+
+### Execution Mode
+
+This workflow can be executed automatically when triggered. Proceed through the steps without waiting for confirmation at each step.

package/kits/gtd-productivity-system/skills/gtd-methodology/SKILL.md

@@ -0,0 +1,185 @@
+---
+name: gtd-methodology
+description: Background expertise in Getting Things Done methodology and best practices
+type: background
+version: "1.0.0"
+---
+
+## GTD Methodology Expertise
+
+You have deep expertise in David Allen's Getting Things Done (GTD) methodology. Apply these principles when helping users manage their tasks and projects.
+
+### The Five Stages of GTD
+
+**1. Capture**
+- Collect everything that has your attention
+- Use as few inboxes as possible
+- Get it out of your head
+- Don't process while capturing
+
+**2. Clarify (Process)**
+- What is it?
+- Is it actionable?
+- What's the next action?
+- One item at a time
+
+**3. Organize**
+- Put items where they belong
+- Use appropriate lists
+- Assign contexts
+- Link to projects
+
+**4. Reflect (Review)**
+- Keep system current
+- Weekly review essential
+- Daily reviews helpful
+- Trust the system
+
+**5. Engage (Do)**
+- Choose actions based on context
+- Consider time available
+- Consider energy available
+- Consider priority
+
+### The Clarifying Questions
+
+**For Every Item**
+```
+Is it actionable?
+├── NO → Trash, Someday/Maybe, or Reference
+└── YES → What's the next action?
+    ├── < 2 minutes → Do it now
+    ├── Delegate → Waiting For list
+    └── Defer → Next Actions or Calendar
+```
+
+**Is This a Project?**
+- Requires more than one action
+- Has a defined outcome
+- Goes on Projects list
+- Identify next action
+
+### List Types
+
+**Next Actions**
+- Physical, visible actions
+- Organized by context
+- Not "figure out" or "decide"
+- Doable in one sitting
+
+**Projects**
+- Outcomes requiring multiple actions
+- Each has at least one next action
+- Reviewed weekly
+- 20-100 active projects typical
+
+**Waiting For**
+- Delegated items
+- Things you're expecting
+- Include date and person
+- Follow up regularly
+
+**Someday/Maybe**
+- Not committed to yet
+- Ideas and possibilities
+- Review regularly
+- Move to active when ready
+
+**Calendar**
+- Only time-specific items
+- Appointments
+- Deadlines
+- Day-specific tasks (rare)
+
+**Reference**
+- Not actionable
+- Might need someday
+- Organized for retrieval
+
+### Context Tags
+
+**Common Contexts**
+- @computer
+- @calls
+- @errands
+- @home
+- @office
+- @anywhere
+- @waiting
+- @agenda (person's name)
+
+**Context Principles**
+- Based on tool/location needed
+- Helps batch similar tasks
+- Makes choosing easier
+- Customize to your life
+
+### The Two-Minute Rule
+
+**If an action takes less than 2 minutes, do it now**
+
+Why 2 minutes?
+- Takes longer to organize than do
+- Immediate progress
+- Reduces backlog
+- Momentum building
+
+### Project Planning
+
+**Natural Planning Model**
+1. Define purpose and principles
+2. Envision outcome
+3. Brainstorm
+4. Organize
+5. Identify next actions
+
+**When to Plan**
+- Complex projects
+- Stuck projects
+- Uncertain projects
+- Collaborative projects
+
+### Weekly Review
+
+**The Most Critical Habit**
+
+Steps:
+1. Get clear (process all inboxes)
+2. Get current (review lists)
+3. Get creative (think bigger)
+
+Duration: 1-2 hours typically
+
+### Common GTD Mistakes
+
+**Capture**
+- Multiple collection points
+- Keeping it in your head
+- Not processing regularly
+
+**Clarify**
+- Vague next actions
+- Skipping the "is it actionable" question
+- Not identifying projects
+
+**Organize**
+- Too many/few contexts
+- Calendar misuse
+- Not keeping lists current
+
+**Review**
+- Skipping weekly review
+- Incomplete reviews
+- Not trusting the system
+
+**Engage**
+- Ignoring context
+- Not considering energy
+- Working from memory
+
+### Energy Levels
+
+**Match tasks to energy:**
+- High energy: Creative, complex tasks
+- Medium energy: Administrative, routine
+- Low energy: Simple, mechanical tasks