specweave 0.9.1 → 0.10.1

package/plugins/specweave/skills/plugin-installer/SKILL.md

@@ -0,0 +1,340 @@
+---
+name: plugin-installer
+description: Proactive just-in-time plugin installation. Auto-detects when specialized plugins are needed (docs-preview, frontend, kubernetes, ML, payments, testing, etc.) and installs them automatically before use. Activates for preview docs, Docusaurus, React, Next.js, K8s, Kubernetes, Helm, TensorFlow, PyTorch, ML model, Stripe, billing, payment, Playwright, E2E testing, Figma, design system, ADO, Azure DevOps, infrastructure, Prometheus, Grafana, monitoring, Node.js, Python backend, REST API, cloud deployment, diagram, Mermaid, C4, architecture diagram.
+---
+
+# Plugin Installer - Proactive Just-in-Time Plugin Installation
+
+**Purpose**: Automatically detect when specialized SpecWeave plugins are needed and install them just-in-time, BEFORE attempting to use their features.
+
+**When to Activate**: Whenever user requests functionality that requires a specific plugin (e.g., "preview docs", "deploy to K8s", "add React component", "train ML model", etc.)
+
+---
+
+## 🚨 CRITICAL: The Plugin Installation Gap
+
+**The Problem**: Users request features that require plugins (e.g., "preview docs locally"), but those plugins are NOT installed. Claude tries to use plugin features anyway, which fails silently or produces incomplete results.
+
+**The Solution**: This skill proactively detects plugin requirements, checks if plugins are installed, and auto-installs them BEFORE attempting to use their features.
+
+---
+
+## Plugin Detection Keywords Map
+
+**Use this map to detect which plugin is needed based on user's request keywords:**
+
+| User Keywords | Required Plugin | Installation Command |
+|--------------|----------------|---------------------|
+| **Documentation Preview** |
+| "preview docs", "browse docs locally", "documentation UI", "Docusaurus server", "local docs preview" | `specweave-docs-preview` | `/plugin install specweave-docs-preview` |
+| **Frontend Development** |
+| "React", "Next.js", "Vue", "Angular", "frontend", "UI component", "design system", "Tailwind" | `specweave-frontend` | `/plugin install specweave-frontend` |
+| **Kubernetes/DevOps** |
+| "K8s", "Kubernetes", "Helm", "kubectl", "deploy", "container", "pod", "service", "ingress" | `specweave-kubernetes` | `/plugin install specweave-kubernetes` |
+| **Machine Learning** |
+| "TensorFlow", "PyTorch", "ML model", "training", "machine learning", "neural network", "dataset" | `specweave-ml` | `/plugin install specweave-ml` |
+| **Payments** |
+| "Stripe", "PayPal", "billing", "subscription", "payment", "checkout", "PCI compliance" | `specweave-payments` | `/plugin install specweave-payments` |
+| **Testing** |
+| "Playwright", "E2E testing", "browser automation", "visual regression", "test automation" | `specweave-testing` | `/plugin install specweave-testing` |
+| **Figma/Design** |
+| "Figma", "design tokens", "design system", "prototype", "wireframe", "mockup" | `specweave-figma` | `/plugin install specweave-figma` |
+| **Backend Development** |
+| "Node.js backend", "Python backend", ".NET", "Express", "FastAPI", "Django", "REST API" | `specweave-backend` | `/plugin install specweave-backend` |
+| **Infrastructure** |
+| "Hetzner", "cloud infrastructure", "Prometheus", "Grafana", "monitoring", "alerting", "SLO" | `specweave-infrastructure` | `/plugin install specweave-infrastructure` |
+| **Architecture Diagrams** |
+| "Mermaid diagram", "C4 model", "architecture diagram", "sequence diagram", "ER diagram" | `specweave-diagrams` | `/plugin install specweave-diagrams` |
+| **Issue Trackers** (Usually auto-installed during init) |
+| "GitHub Issues", "sync GitHub", "create issue", "PR automation" | `specweave-github` | `/plugin install specweave-github` |
+| "Jira", "epic", "sprint", "story points", "Jira sync" | `specweave-jira` | `/plugin install specweave-jira` |
+| "ADO", "Azure DevOps", "work items", "boards", "ADO sync" | `specweave-ado` | `/plugin install specweave-ado` |
+
+---
+
+## Workflow: Just-in-Time Plugin Installation
+
+**CRITICAL**: Follow this workflow EVERY TIME you detect plugin keywords in user's request:
+
+### Step 1: Detect Plugin Requirement
+
+When user mentions keywords from the map above, **IMMEDIATELY** check if the required plugin is needed.
+
+**Example**:
+```
+User: "Can you preview the internal docs locally?"
+
+Keywords detected: "preview", "docs", "locally"
+→ Required plugin: specweave-docs-preview
+```
+
+### Step 2: Check if Plugin is Installed
+
+```bash
+# Check installed plugins
+/plugin list --installed
+```
+
+**Parse the output** to see if the required plugin is in the list.
+
+### Step 3: Auto-Install if Missing
+
+If the plugin is NOT installed:
+
+```bash
+# Install the plugin
+/plugin install <plugin-name>
+
+# Example:
+/plugin install specweave-docs-preview
+```
+
+### Step 4: Notify User (Clear and Friendly)
+
+**Good notification format**:
+
+```
+🔌 Detected need for <plugin-name> plugin
+
+📦 Installing <plugin-name>...
+   This plugin provides: <brief description>
+
+✅ Plugin installed successfully!
+   You can now: <list capabilities>
+
+Proceeding with your request...
+```
+
+**Example**:
+
+```
+🔌 Detected need for specweave-docs-preview plugin
+
+📦 Installing specweave-docs-preview...
+   This plugin provides: Beautiful Docusaurus UI for browsing .specweave/docs/
+
+✅ Plugin installed successfully!
+   You can now:
+   • Browse documentation in beautiful UI
+   • Hot reload when editing markdown files
+   • Render Mermaid diagrams automatically
+
+Proceeding to launch docs preview server...
+```
+
+### Step 5: Proceed with User's Request
+
+**ONLY AFTER** the plugin is installed, proceed to use its features.
+
+---
+
+## Common Scenarios
+
+### Scenario 1: Documentation Preview
+
+**User Request**: "Show me the internal docs in a nice UI"
+
+**Workflow**:
+```
+1. Detect keywords: "docs", "UI"
+   → Required: specweave-docs-preview
+
+2. Check installed: /plugin list --installed
+   → Not found
+
+3. Install: /plugin install specweave-docs-preview
+
+4. Notify user:
+   🔌 Installing specweave-docs-preview for beautiful docs UI...
+   ✅ Installed!
+
+5. Launch: /specweave:docs preview
+```
+
+### Scenario 2: Kubernetes Deployment
+
+**User Request**: "Help me deploy this to Kubernetes"
+
+**Workflow**:
+```
+1. Detect keywords: "deploy", "Kubernetes"
+   → Required: specweave-kubernetes
+
+2. Check installed: /plugin list --installed
+   → Not found
+
+3. Install: /plugin install specweave-kubernetes
+
+4. Notify user:
+   🔌 Installing specweave-kubernetes for K8s deployment...
+   ✅ Installed! You can now generate manifests, Helm charts, and validate deployments.
+
+5. Proceed with K8s expert agent for deployment
+```
+
+### Scenario 3: React Component Development
+
+**User Request**: "Create a new React component for user profile"
+
+**Workflow**:
+```
+1. Detect keywords: "React", "component"
+   → Required: specweave-frontend
+
+2. Check installed: /plugin list --installed
+   → Not found
+
+3. Install: /plugin install specweave-frontend
+
+4. Notify user:
+   🔌 Installing specweave-frontend for React development...
+   ✅ Installed! You can now use frontend expert agent and design system integration.
+
+5. Proceed with component creation
+```
+
+### Scenario 4: Machine Learning Pipeline
+
+**User Request**: "Train a TensorFlow model for image classification"
+
+**Workflow**:
+```
+1. Detect keywords: "TensorFlow", "model", "training"
+   → Required: specweave-ml
+
+2. Check installed: /plugin list --installed
+   → Not found
+
+3. Install: /plugin install specweave-ml
+
+4. Notify user:
+   🔌 Installing specweave-ml for ML workflows...
+   ✅ Installed! You can now use ML expert agent for training pipelines and deployment.
+
+5. Proceed with ML pipeline setup
+```
+
+---
+
+## Error Handling
+
+### Plugin Installation Fails
+
+If `/plugin install` fails:
+
+```
+❌ Failed to install <plugin-name>
+
+Possible causes:
+1. Marketplace not registered
+   → Try: /plugin marketplace add anton-abyzov/specweave
+
+2. Network connectivity issues
+   → Check internet connection and retry
+
+3. Plugin doesn't exist
+   → Verify plugin name: /plugin list (shows all available plugins)
+
+Would you like to:
+a) Retry installation
+b) Proceed without the plugin (limited capabilities)
+c) Troubleshoot further
+```
+
+### Plugin Already Installed
+
+If plugin is already installed, skip installation and proceed:
+
+```
+✅ <plugin-name> is already installed
+   Proceeding with your request...
+```
+
+---
+
+## Integration with Other Skills
+
+**This skill should be consulted BEFORE other skills attempt to use plugin features.**
+
+### Example: increment-planner skill
+
+When increment-planner detects plugin requirements (Step 6), it should:
+
+1. **Detect plugins** (as it already does)
+2. **Consult plugin-installer skill** (NEW!)
+3. **Auto-install missing plugins** (via this skill)
+4. **Then proceed** with increment planning
+
+### Example: docs-preview skill (hypothetical)
+
+```markdown
+# BEFORE using Docusaurus features:
+
+1. Check if specweave-docs-preview is installed
+   → If not: Invoke plugin-installer skill
+   → Auto-install specweave-docs-preview
+
+2. Then launch Docusaurus server
+```
+
+---
+
+## Benefits of This Approach
+
+✅ **Zero friction**: Users don't need to manually install plugins
+✅ **Proactive**: Detects requirements automatically
+✅ **Clear UX**: Users see what's being installed and why
+✅ **Just-in-time**: Only installs plugins when actually needed
+✅ **Fail-safe**: Handles installation errors gracefully
+
+---
+
+## Testing This Skill
+
+**Test Case 1: Docs Preview**
+```
+User: "Show me the internal documentation in a browser"
+
+Expected:
+1. Detects "documentation", "browser" → specweave-docs-preview
+2. Checks installed
+3. Auto-installs if missing
+4. Launches preview
+```
+
+**Test Case 2: K8s Deployment**
+```
+User: "Deploy this application to Kubernetes cluster"
+
+Expected:
+1. Detects "Kubernetes" → specweave-kubernetes
+2. Checks installed
+3. Auto-installs if missing
+4. Proceeds with deployment
+```
+
+**Test Case 3: React Development**
+```
+User: "Add a React component for user settings"
+
+Expected:
+1. Detects "React", "component" → specweave-frontend
+2. Checks installed
+3. Auto-installs if missing
+4. Proceeds with component creation
+```
+
+---
+
+## References
+
+- **Plugin Expert Skill**: Consult for correct installation syntax
+- **Official Docs**: https://code.claude.com/docs/en/plugins
+- **SpecWeave Marketplace**: .claude-plugin/marketplace.json
+- **CLAUDE.md**: Plugin architecture and detection phases
+
+---
+
+**Key Principle**: ALWAYS install plugins BEFORE attempting to use their features. Never fail silently - always notify users of installation steps.
+
+**Last Updated**: 2025-11-10 (v0.10.0)