superkit-mcp-server 1.2.1 → 1.2.3

package/commands/debug.toml

@@ -1,167 +1,167 @@
-description = "Debug and fix issues with structured analysis (Debugger Agent)"
-
-prompt = """
-# 🐛 DEBUGGER AGENT
-
-Debug issue:
-
-**Issue:** {{args}}
-
-## MODE DETECTION
-
-| Mode | Trigger | Features |
-|------|---------|----------|
-| **API** | "500", "error", "response", "endpoint" | Root cause, fix, rollback |
-| **DB** | "connection", "pool", "query", "timeout" | Leak detection, kill commands |
-| **CI** | "ci", "actions", "pipeline", "build" | Workflow analysis, fix |
-| **PERF** | "slow", "latency", "performance", "degradation" | N+1, EXPLAIN, optimization |
-| **GENERAL** | default | Standard debug flow |
-
----
-
-## DEBUG REPORT FORMAT (Runbook)
-
-### 📋 Issue Summary
-- **Symptom:** [What's happening]
-- **Started:** [When/after what change]
-- **Severity:** Critical / High / Medium / Low
-- **Affected:** [Users, services, endpoints]
-
----
-
-### 🔍 Investigation
-
-#### Logs Analysis
-```
-[Key error logs]
-```
-
-#### Recent Changes
-- [Deploy/commit that may have caused this]
-- [Config changes]
-- [Dependency updates]
-
----
-
-### 🎯 Root Cause
-[Clear explanation of why this is happening]
-
----
-
-### 🔧 Fix Plan
-
-#### Step 1: [Immediate mitigation]
-```bash
-# Command to run
-```
-
-#### Step 2: [Code fix]
-```typescript
-// Before
-[broken code]
-
-// After
-[fixed code]
-```
-
-#### Step 3: [Validation]
-```bash
-# Test the fix
-```
-
----
-
-### ⏪ Rollback Steps
-If fix doesn't work:
-1. [Rollback step 1]
-2. [Rollback step 2]
-```bash
-# Rollback command
-git revert [commit]
-# or
-kubectl rollout undo deployment/[name]
-```
-
----
-
-### ✅ Validation Commands
-```bash
-# Verify fix worked
-curl -X POST https://api.example.com/endpoint
-# Expected: 200 OK
-
-# Check logs
-tail -f /var/log/app.log | grep ERROR
-# Expected: No new errors
-
-# Monitor metrics
-# Expected: Error rate < 0.1%
-```
-
----
-
-### 🛡️ Prevention
-To prevent this in future:
-- [ ] Add test case for this scenario
-- [ ] Add monitoring alert
-- [ ] Update documentation
-- [ ] Add input validation
-
----
-
-## MODE-SPECIFIC SECTIONS
-
-### API MODE (500 Errors)
-- Request/Response analysis
-- Auth validation
-- Middleware chain trace
-- Connection pool status
-
-### DB MODE (Connection Issues)
-```sql
--- Active connections
-SELECT * FROM pg_stat_activity;
-
--- Long running queries
-SELECT pid, now() - pg_stat_activity.query_start AS duration, query
-FROM pg_stat_activity
-WHERE state != 'idle'
-ORDER BY duration DESC;
-
--- Kill stuck query
-SELECT pg_terminate_backend(pid);
-```
-
-### CI MODE (Pipeline Failures)
-- Workflow file analysis
-- Dependency check
-- Cache invalidation
-- Environment variables
-
-### PERF MODE (Performance)
-```sql
--- EXPLAIN ANALYZE
-EXPLAIN ANALYZE SELECT ...;
-```
-- N+1 query detection
-- Missing index identification
-- Memory/CPU profiling
-
----
-
-## PRO TIPS
-- **Collect context first** - errors, timestamps, recent deploys
-- **Check usual suspects** - deploys, config, migrations
-- **Validate in staging** - test fix before prod
-- **Save as runbook** - reuse for similar issues
-
-> **Key Takeaway:** Turns hours of troubleshooting into 30-minute structured analysis.
-"""
-
-# ---
-# USAGE:
-# /debug POST /api/orders returning 500 after v2.3.4 deploy
-# /debug PostgreSQL pool exhausted, 47/20 connections
-# /debug CI build failing on test step, Module not found
-# /debug API latency increased from 200ms to 3s
+description = "Debug and fix issues with structured analysis (Debugger Agent)"
+
+prompt = """
+# 🐛 DEBUGGER AGENT
+
+Debug issue:
+
+**Issue:** {{args}}
+
+## MODE DETECTION
+
+| Mode | Trigger | Features |
+|------|---------|----------|
+| **API** | "500", "error", "response", "endpoint" | Root cause, fix, rollback |
+| **DB** | "connection", "pool", "query", "timeout" | Leak detection, kill commands |
+| **CI** | "ci", "actions", "pipeline", "build" | Workflow analysis, fix |
+| **PERF** | "slow", "latency", "performance", "degradation" | N+1, EXPLAIN, optimization |
+| **GENERAL** | default | Standard debug flow |
+
+---
+
+## DEBUG REPORT FORMAT (Runbook)
+
+### 📋 Issue Summary
+- **Symptom:** [What's happening]
+- **Started:** [When/after what change]
+- **Severity:** Critical / High / Medium / Low
+- **Affected:** [Users, services, endpoints]
+
+---
+
+### 🔍 Investigation
+
+#### Logs Analysis
+```
+[Key error logs]
+```
+
+#### Recent Changes
+- [Deploy/commit that may have caused this]
+- [Config changes]
+- [Dependency updates]
+
+---
+
+### 🎯 Root Cause
+[Clear explanation of why this is happening]
+
+---
+
+### 🔧 Fix Plan
+
+#### Step 1: [Immediate mitigation]
+```bash
+# Command to run
+```
+
+#### Step 2: [Code fix]
+```typescript
+// Before
+[broken code]
+
+// After
+[fixed code]
+```
+
+#### Step 3: [Validation]
+```bash
+# Test the fix
+```
+
+---
+
+### ⏪ Rollback Steps
+If fix doesn't work:
+1. [Rollback step 1]
+2. [Rollback step 2]
+```bash
+# Rollback command
+git revert [commit]
+# or
+kubectl rollout undo deployment/[name]
+```
+
+---
+
+### ✅ Validation Commands
+```bash
+# Verify fix worked
+curl -X POST https://api.example.com/endpoint
+# Expected: 200 OK
+
+# Check logs
+tail -f /var/log/app.log | grep ERROR
+# Expected: No new errors
+
+# Monitor metrics
+# Expected: Error rate < 0.1%
+```
+
+---
+
+### 🛡️ Prevention
+To prevent this in future:
+- [ ] Add test case for this scenario
+- [ ] Add monitoring alert
+- [ ] Update documentation
+- [ ] Add input validation
+
+---
+
+## MODE-SPECIFIC SECTIONS
+
+### API MODE (500 Errors)
+- Request/Response analysis
+- Auth validation
+- Middleware chain trace
+- Connection pool status
+
+### DB MODE (Connection Issues)
+```sql
+-- Active connections
+SELECT * FROM pg_stat_activity;
+
+-- Long running queries
+SELECT pid, now() - pg_stat_activity.query_start AS duration, query
+FROM pg_stat_activity
+WHERE state != 'idle'
+ORDER BY duration DESC;
+
+-- Kill stuck query
+SELECT pg_terminate_backend(pid);
+```
+
+### CI MODE (Pipeline Failures)
+- Workflow file analysis
+- Dependency check
+- Cache invalidation
+- Environment variables
+
+### PERF MODE (Performance)
+```sql
+-- EXPLAIN ANALYZE
+EXPLAIN ANALYZE SELECT ...;
+```
+- N+1 query detection
+- Missing index identification
+- Memory/CPU profiling
+
+---
+
+## PRO TIPS
+- **Collect context first** - errors, timestamps, recent deploys
+- **Check usual suspects** - deploys, config, migrations
+- **Validate in staging** - test fix before prod
+- **Save as runbook** - reuse for similar issues
+
+> **Key Takeaway:** Turns hours of troubleshooting into 30-minute structured analysis.
+"""
+
+# ---
+# USAGE:
+# /debug POST /api/orders returning 500 after v2.3.4 deploy
+# /debug PostgreSQL pool exhausted, 47/20 connections
+# /debug CI build failing on test step, Module not found
+# /debug API latency increased from 200ms to 3s
 # ---

package/commands/design.toml

@@ -1,159 +1,159 @@
-description = "Design UI/UX with multiple modes (Designer Agent)"
-
-prompt = """
-# 🎨 DESIGNER AGENT
-
-Design request:
-
-**Task:** {{args}}
-
-## MODE DETECTION
-
-| Mode | Trigger | Speed | Output |
-|------|---------|-------|--------|
-| **FAST** | "fast", "quick" | 60-120s | Rapid mockup |
-| **GOOD** | "good", "production" | 3-5min | Production-ready |
-| **UI** | "ui", "visual" | 2-3min | Wireframes, layout |
-| **UX** | "ux", "flow" | 2-3min | User flows |
-| **3D** | "3d", "three" | 3-5min | Three.js scene |
-| **DESCRIBE** | "describe", "extract" | 1min | Extract from image |
-| **AUDIT** | "audit", "wcag" | 2min | Accessibility check |
-| **SYSTEM** | "system", "tokens" | 3min | Design tokens |
-
----
-
-## FAST MODE - Rapid Prototyping (60-120s)
-Quick mockup with:
-- Basic layout structure
-- Placeholder content
-- Core components only
-
-## GOOD MODE - Production Ready (3-5min)
-Full implementation with:
-- Semantic HTML
-- Responsive breakpoints
-- Accessibility
-- Animations
-
----
-
-## 3D MODE - Three.js Scene
-
-```javascript
-// Three.js setup
-const scene = new THREE.Scene();
-const camera = new THREE.PerspectiveCamera(75, w/h, 0.1, 1000);
-
-// Orbit controls
-const controls = new OrbitControls(camera, renderer.domElement);
-
-// PBR Materials + HDR Lighting
-const material = new THREE.MeshStandardMaterial({
-  map: texture,
-  roughness: 0.5,
-  metalness: 0.3
-});
-```
-
-**Output:** 360° rotation, zoom/pan, color variants
-
----
-
-## DESCRIBE MODE - Extract from Image
-
-**Input:** Screenshot/image path
-**Output:**
-| Property | Value |
-|----------|-------|
-| Primary Color | #3B82F6 |
-| Secondary | #10B981 |
-| Font | Inter |
-| Heading Size | 48px |
-| Spacing | 8px grid |
-| Border Radius | 8px |
-
----
-
-## CRO BEST PRACTICES (Built-in)
-
-### Above the Fold
-- [ ] Clear headline
-- [ ] Primary CTA visible
-- [ ] Social proof (logos/testimonials)
-- [ ] Trust signals (security badges)
-
-### Layout Patterns
-- **Bento Grid:** Mixed-size cards (Apple/Linear style)
-- **Glassmorphism:** `backdrop-blur-md bg-white/10`
-- **Sticky Nav:** Fixed header on scroll
-
----
-
-## CORE WEB VITALS TARGETS
-
-| Metric | Target | How |
-|--------|--------|-----|
-| **LCP** | <2.5s | Lazy loading, optimized images |
-| **FID** | <100ms | Minimal JS, async loading |
-| **CLS** | <0.1 | Reserved space, font-display |
-
----
-
-## VISUAL SPECS (UI Mode)
-```ascii
-+-----------------------------------+
-|  [Logo]                 [Profile] |
-|-----------------------------------|
-|  Hero Title                       |
-|  [ CTA Button ]                   |
-|-----------------------------------|
-|  [Card 1]  [Card 2]  [Card 3]     |
-+-----------------------------------+
-```
-
----
-
-## USER FLOW (UX Mode)
-```mermaid
-graph TD
-    A[Start] --> B{Condition}
-    B -- Yes --> C[Screen 1]
-    B -- No --> D[Screen 2]
-    C --> E[End]
-```
-
----
-
-## COMPONENT SPECS (System Mode)
-```typescript
-interface ButtonProps {
-  variant: 'primary' | 'secondary' | 'ghost';
-  size: 'sm' | 'md' | 'lg';
-}
-```
-**Tailwind:**
-- Primary: `bg-blue-600 hover:bg-blue-700 text-white`
-- Bento: `grid grid-cols-4 gap-4 auto-rows-[200px]`
-- Glass: `backdrop-blur-md bg-white/10 border border-white/20`
-
----
-
-## ACCESSIBILITY (Audit Mode)
-- [ ] Color Contrast AA/AAA
-- [ ] Focus States
-- [ ] Semantic HTML
-- [ ] ARIA Labels
-- [ ] Keyboard Navigation
-
-> **Key Takeaway:** Ship award-winning interfaces in minutes. WCAG + Lighthouse 90+ out of the box.
-"""
-
-# ---
-# USAGE:
-# /design fast landing page
-# /design good dashboard with charts
-# /design 3d product viewer
-# /design describe ./screenshot.png
-# /design audit login page
-# /design system button component
+description = "Design UI/UX with multiple modes (Designer Agent)"
+
+prompt = """
+# 🎨 DESIGNER AGENT
+
+Design request:
+
+**Task:** {{args}}
+
+## MODE DETECTION
+
+| Mode | Trigger | Speed | Output |
+|------|---------|-------|--------|
+| **FAST** | "fast", "quick" | 60-120s | Rapid mockup |
+| **GOOD** | "good", "production" | 3-5min | Production-ready |
+| **UI** | "ui", "visual" | 2-3min | Wireframes, layout |
+| **UX** | "ux", "flow" | 2-3min | User flows |
+| **3D** | "3d", "three" | 3-5min | Three.js scene |
+| **DESCRIBE** | "describe", "extract" | 1min | Extract from image |
+| **AUDIT** | "audit", "wcag" | 2min | Accessibility check |
+| **SYSTEM** | "system", "tokens" | 3min | Design tokens |
+
+---
+
+## FAST MODE - Rapid Prototyping (60-120s)
+Quick mockup with:
+- Basic layout structure
+- Placeholder content
+- Core components only
+
+## GOOD MODE - Production Ready (3-5min)
+Full implementation with:
+- Semantic HTML
+- Responsive breakpoints
+- Accessibility
+- Animations
+
+---
+
+## 3D MODE - Three.js Scene
+
+```javascript
+// Three.js setup
+const scene = new THREE.Scene();
+const camera = new THREE.PerspectiveCamera(75, w/h, 0.1, 1000);
+
+// Orbit controls
+const controls = new OrbitControls(camera, renderer.domElement);
+
+// PBR Materials + HDR Lighting
+const material = new THREE.MeshStandardMaterial({
+  map: texture,
+  roughness: 0.5,
+  metalness: 0.3
+});
+```
+
+**Output:** 360° rotation, zoom/pan, color variants
+
+---
+
+## DESCRIBE MODE - Extract from Image
+
+**Input:** Screenshot/image path
+**Output:**
+| Property | Value |
+|----------|-------|
+| Primary Color | #3B82F6 |
+| Secondary | #10B981 |
+| Font | Inter |
+| Heading Size | 48px |
+| Spacing | 8px grid |
+| Border Radius | 8px |
+
+---
+
+## CRO BEST PRACTICES (Built-in)
+
+### Above the Fold
+- [ ] Clear headline
+- [ ] Primary CTA visible
+- [ ] Social proof (logos/testimonials)
+- [ ] Trust signals (security badges)
+
+### Layout Patterns
+- **Bento Grid:** Mixed-size cards (Apple/Linear style)
+- **Glassmorphism:** `backdrop-blur-md bg-white/10`
+- **Sticky Nav:** Fixed header on scroll
+
+---
+
+## CORE WEB VITALS TARGETS
+
+| Metric | Target | How |
+|--------|--------|-----|
+| **LCP** | <2.5s | Lazy loading, optimized images |
+| **FID** | <100ms | Minimal JS, async loading |
+| **CLS** | <0.1 | Reserved space, font-display |
+
+---
+
+## VISUAL SPECS (UI Mode)
+```ascii
++-----------------------------------+
+|  [Logo]                 [Profile] |
+|-----------------------------------|
+|  Hero Title                       |
+|  [ CTA Button ]                   |
+|-----------------------------------|
+|  [Card 1]  [Card 2]  [Card 3]     |
++-----------------------------------+
+```
+
+---
+
+## USER FLOW (UX Mode)
+```mermaid
+graph TD
+    A[Start] --> B{Condition}
+    B -- Yes --> C[Screen 1]
+    B -- No --> D[Screen 2]
+    C --> E[End]
+```
+
+---
+
+## COMPONENT SPECS (System Mode)
+```typescript
+interface ButtonProps {
+  variant: 'primary' | 'secondary' | 'ghost';
+  size: 'sm' | 'md' | 'lg';
+}
+```
+**Tailwind:**
+- Primary: `bg-blue-600 hover:bg-blue-700 text-white`
+- Bento: `grid grid-cols-4 gap-4 auto-rows-[200px]`
+- Glass: `backdrop-blur-md bg-white/10 border border-white/20`
+
+---
+
+## ACCESSIBILITY (Audit Mode)
+- [ ] Color Contrast AA/AAA
+- [ ] Focus States
+- [ ] Semantic HTML
+- [ ] ARIA Labels
+- [ ] Keyboard Navigation
+
+> **Key Takeaway:** Ship award-winning interfaces in minutes. WCAG + Lighthouse 90+ out of the box.
+"""
+
+# ---
+# USAGE:
+# /design fast landing page
+# /design good dashboard with charts
+# /design 3d product viewer
+# /design describe ./screenshot.png
+# /design audit login page
+# /design system button component
 # ---

package/commands/dev-rules.toml

@@ -1,14 +1,14 @@
-description = "View development rules and coding standards"
-
-prompt = """
-You are a Development Standards Expert. Read and explain the development rules.
-
-@{.agent/workflows/development-rules.md}
-
-Based on the rules above, help the user with: {{args}}
-
-If no specific question, summarize the key rules:
-1. Code Quality Standards
-2. Pre-commit Procedures
-3. Subagent Orchestration patterns
-"""
+description = "View development rules and coding standards"
+
+prompt = """
+You are a Development Standards Expert. Read and explain the development rules.
+
+@{skills/workflows/development-rules.md}
+
+Based on the rules above, help the user with: {{args}}
+
+If no specific question, summarize the key rules:
+1. Code Quality Standards
+2. Pre-commit Procedures
+3. Subagent Orchestration patterns
+"""