specweave 0.1.0 → 0.1.1

package/src/skills/specweave-detector/SKILL.md

@@ -24,11 +24,157 @@ Act as the "factory of agents" that:
 if (fileExists('.specweave/config.yaml')) {
   activateSpecWeaveMode();
   loadConfiguration();
+
+  // AUTO-INSTALL MISSING COMPONENTS (NEW!)
+  await autoInstallComponents(userPrompt);
+
   parseUserIntent();
   routeToSkills();
 }
 ```
 
+## Just-In-Time Component Installation (CRITICAL!)
+
+**SpecWeave uses intelligent auto-installation** - components are installed on-demand based on user intent.
+
+### How It Works
+
+1. **User makes a request** (e.g., "Create Next.js authentication")
+2. **Analyze user intent** - Extract keywords (Next.js, authentication)
+3. **Map to required components**:
+   - "Next.js" → nextjs skill, nodejs-backend skill
+   - "authentication" → security agent
+   - "Create" → pm agent, architect agent
+4. **Check if components installed** in `.claude/skills/` and `.claude/agents/`
+5. **Auto-install missing components** from npm package (`node_modules/specweave/src/`)
+6. **Proceed with routing** - now all needed components are available
+
+### Keyword → Component Mapping
+
+```typescript
+// From src/utils/auto-install.ts
+const COMPONENT_MAPPING = {
+  // Framework detection
+  'next.js': { skills: ['nextjs', 'nodejs-backend'], agents: [] },
+  'react': { skills: ['frontend'], agents: [] },
+  'fastapi': { skills: ['python-backend'], agents: [] },
+  'django': { skills: ['python-backend'], agents: [] },
+  '.net': { skills: ['dotnet-backend'], agents: [] },
+
+  // Feature detection
+  'authentication': { skills: ['nodejs-backend'], agents: ['security'] },
+  'auth': { skills: [], agents: ['security'] },
+  'oauth': { skills: [], agents: ['security'] },
+  'payment': { skills: ['stripe-integrator'], agents: ['security'] },
+  'stripe': { skills: ['stripe-integrator'], agents: ['security'] },
+
+  // Infrastructure detection
+  'deploy': { skills: [], agents: ['devops'] },
+  'hetzner': { skills: ['hetzner-provisioner'], agents: ['devops'] },
+  'aws': { skills: [], agents: ['devops'] },
+
+  // Testing detection
+  'test': { skills: [], agents: ['qa-lead'] },
+  'e2e': { skills: ['e2e-playwright'], agents: ['qa-lead'] },
+  'playwright': { skills: ['e2e-playwright'], agents: ['qa-lead'] },
+
+  // Design detection
+  'figma': { skills: ['figma-implementer', 'figma-designer'], agents: [] },
+  'design system': { skills: ['design-system-architect'], agents: [] },
+
+  // Integration detection
+  'jira': { skills: ['jira-sync'], agents: [] },
+  'github': { skills: ['github-sync'], agents: [] },
+};
+
+// Always include strategic agents for new features
+if (prompt.includes('create') || prompt.includes('build')) {
+  agents.push('pm', 'architect');
+}
+```
+
+### Example User Experience
+
+**Example 1: Next.js Authentication**
+```
+User: "Create Next.js authentication with OAuth"
+
+🔷 SpecWeave Active
+
+📦 Installing required components...
+   ✅ Installed nextjs skill
+   ✅ Installed nodejs-backend skill
+   ✅ Installed security agent
+   ✅ Installed pm agent
+   ✅ Installed architect agent
+
+🚀 Creating increment 0001-nextjs-authentication...
+```
+
+**Example 2: Already Installed**
+```
+User: "Add another Next.js feature"
+
+🔷 SpecWeave Active
+   (Components already installed, proceeding...)
+
+🚀 Creating increment 0002-next-feature...
+```
+
+**Example 3: Python FastAPI**
+```
+User: "Create FastAPI backend with PostgreSQL"
+
+🔷 SpecWeave Active
+
+📦 Installing required components...
+   ✅ Installed python-backend skill
+   ✅ Installed pm agent
+   ✅ Installed architect agent
+
+🚀 Creating increment 0001-fastapi-backend...
+```
+
+### Configuration
+
+Auto-install can be disabled in `.specweave/config.yaml`:
+
+```yaml
+# .specweave/config.yaml
+auto_install: true  # Default: enabled
+
+# Tracked installed components (auto-updated)
+installed_components:
+  skills:
+    - nextjs
+    - nodejs-backend
+    - security
+  agents:
+    - pm
+    - architect
+    - security
+```
+
+Set `auto_install: false` to require manual installation (advanced users only).
+
+### Installation Process
+
+When auto-installing:
+
+1. **Find npm package**: Locate `node_modules/specweave/`
+2. **Copy component**: `src/skills/nextjs/` → `.claude/skills/nextjs/`
+3. **Verify**: Check component has SKILL.md or AGENT.md
+4. **Update config**: Add to `installed_components` list
+5. **Continue routing**: Component now available for use
+
+### Benefits
+
+- ✅ **Zero manual installation** - users never run `specweave install`
+- ✅ **Just-in-time** - only install what's actually needed
+- ✅ **Automatic** - completely transparent to users
+- ✅ **Intelligent** - understands intent from natural language
+- ✅ **Efficient** - unused components never installed
+
 ## Auto-Activation
 
 **Key Feature**: This skill uses Claude Code's `proactive: true` feature to load automatically.

package/src/skills/specweave-jira-mapper/test-cases/test-1-export-to-jira.yaml

@@ -0,0 +1,13 @@
+name: "Export SpecWeave Increment to JIRA"
+description: "Test exporting a SpecWeave increment to JIRA Epic/Stories/Subtasks"
+user_input: "Export increment 0003-dashboard to JIRA"
+expected_behavior:
+  - Creates JIRA Epic from increment spec
+  - Creates Stories from main sections
+  - Creates Subtasks from tasks
+  - Maps test cases to JIRA Test issues
+validation:
+  - Epic summary matches increment name
+  - Stories have proper descriptions
+  - Subtasks linked to Stories
+  - JIRA keys stored in SpecWeave

package/src/skills/specweave-jira-mapper/test-cases/test-2-import-from-jira.yaml

@@ -0,0 +1,13 @@
+name: "Import JIRA Epic to SpecWeave"
+description: "Test importing JIRA Epic as a SpecWeave increment"
+user_input: "Import JIRA Epic PROJ-123 into SpecWeave"
+expected_behavior:
+  - Creates increment folder from Epic key
+  - Generates spec.md from Epic description
+  - Converts Stories to spec sections
+  - Creates tasks.md from Subtasks
+validation:
+  - Increment follows naming convention
+  - spec.md includes Epic details
+  - tasks.md has all subtasks
+  - JIRA links preserved

package/src/skills/specweave-jira-mapper/test-cases/test-3-sync-status.yaml

@@ -0,0 +1,13 @@
+name: "Sync Status Updates Between Systems"
+description: "Test syncing task status between SpecWeave and JIRA"
+user_input: "Sync status updates for increment 0004-notifications"
+expected_behavior:
+  - Detects status changes in SpecWeave (tasks.md)
+  - Updates JIRA issue status accordingly
+  - Syncs JIRA status back to SpecWeave
+  - Handles workflow state mapping
+validation:
+  - Status mapping works correctly
+  - Bidirectional sync maintains consistency
+  - Workflow transitions respected
+  - Sync logs available

package/src/templates/config.yaml

@@ -330,4 +330,22 @@ skills:
     - jira-sync                # If integrations.jira.enabled
     - ado-sync                 # If integrations.ado.enabled
 
+# Component auto-installation (CRITICAL!)
+# SpecWeave intelligently installs components based on user intent
+auto_install: true            # Enable just-in-time installation (recommended)
+
+# NPM package location for auto-installation
+npm_package_path: "node_modules/specweave"  # Auto-detected
+
+# Installed components (auto-updated as components are installed)
+installed_components:
+  skills: []                  # Auto-populated: [nextjs, nodejs-backend, security, ...]
+  agents: []                  # Auto-populated: [pm, architect, devops, ...]
+
+# Installation mode
+install_mode: "on-demand"     # on-demand (default), all-upfront, or manual
+  # on-demand: Install components as needed based on user requests
+  # all-upfront: Install all components at init (not recommended)
+  # manual: Disable auto-install (advanced users only)
+
 ---