superkit-mcp-server 1.1.3 → 1.2.0

package/commands/debug.toml

@@ -0,0 +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
+# ---

package/commands/design.toml

@@ -0,0 +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
+# ---

package/commands/dev-rules.toml

@@ -0,0 +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
+"""

package/commands/do.toml

@@ -0,0 +1,117 @@
+# AI Router - Auto Agent Selection
+# Usage: /do <task description>
+# Automatically analyzes task and executes appropriate agents
+
+description = "Quick actions for common tasks"
+
+
+
+prompt = """
+{{#if args}}
+# 🧠 AI Router - Auto Agent Selection
+
+**Task:** {{args}}
+
+## Step 1: Analyze Task
+First, analyze the task and determine which agents/commands to use.
+
+## Available Agents:
+
+### Development
+| Agent | Command | Use When |
+|-------|---------|----------|
+| Planner | `/plan` | Need implementation plan |
+| Scout | `/scout` | Find files, understand codebase |
+| Coder | `/code` | Write/modify code |
+| Debugger | `/debug` | Fix bugs, errors |
+| Tester | `/test` | Generate/run tests |
+
+### Quality
+| Agent | Command | Use When |
+|-------|---------|----------|
+| Reviewer | `/review` | Code review, security check |
+| PR Review | `/review-pr` | Review pull request |
+
+### DevOps
+| Agent | Command | Use When |
+|-------|---------|----------|
+| Git Manager | `/git` | Git operations |
+| PR Creator | `/pr` | Create pull request |
+| DB Admin | `/db` | Database operations |
+
+### Documentation
+| Agent | Command | Use When |
+|-------|---------|----------|
+| Docs Manager | `/docs` | Update documentation |
+| Copywriter | `/copywrite` | Marketing content |
+
+### Research/Creative
+| Agent | Command | Use When |
+|-------|---------|----------|
+| Researcher | `/research` | Learn new topics |
+| Brainstormer | `/brainstorm` | Generate ideas |
+| Designer | `/design` | UI/UX design |
+
+---
+
+## Step 2: Route Decision
+
+Based on the task "{{args}}", you need to:
+
+1. **Identify task type** (bug fix? new feature? docs? research?)
+2. **Select 1-4 agents** in execution order
+3. **Explain your routing decision**
+4. **Execute the first agent**, then ask if user wants to continue with next agent
+
+### Common Patterns:
+- **New feature**: Planner → Scout → Coder → Tester → Reviewer
+- **Bug fix**: Debugger → Tester
+- **Refactor**: Scout → Coder → Reviewer
+- **Documentation**: Docs Manager
+- **Research**: Researcher → Brainstormer → Planner
+
+---
+
+## Step 3: Execute
+
+Now analyze the specific task "{{args}}" and:
+1. State which agents you will use and why
+2. Start executing as the FIRST agent in the sequence
+3. At the end, tell user about the next recommended agent
+
+**Begin analysis and execution:**
+{{else}}
+# 🧠 AI Router - Auto Agent Selection
+
+Automatically analyze your task and run the right agents.
+
+## Usage:
+```
+/do <describe your task>
+```
+
+## Examples:
+```
+/do Create a login form with validation
+/do Fix the null pointer error in user.ts
+/do Write tests for the payment module
+/do Refactor the API to use async/await
+/do Document the authentication flow
+```
+
+## How It Works:
+1. AI analyzes your task
+2. Selects 1-4 appropriate agents
+3. Executes them in optimal order
+4. Coordinates handoffs between agents
+
+## Agent Categories:
+- **Development**: Planner, Scout, Coder, Debugger, Tester
+- **Quality**: Reviewer, PR Review
+- **DevOps**: Git, PR, Database
+- **Docs**: Documentation, Copywriting
+- **Research**: Brainstorm, Research, Design
+
+Just describe what you want to do!
+{{/if}}
+"""

package/commands/doc-rules.toml

@@ -0,0 +1,14 @@
+description = "View documentation management guidelines"
+
+prompt = """
+You are a Documentation Manager. Read and explain the documentation guidelines.
+
+@{.agent/workflows/documentation-management.md}
+
+Based on the guidelines above, help the user with: {{args}}
+
+If no specific question, explain:
+1. When to update docs
+2. Documentation locations
+3. Standards and triggers
+"""

package/commands/docs.toml

@@ -0,0 +1,148 @@
+description = "Manage documentation with modes and templates (Docs Manager Agent)"
+
+prompt = '''
+# 📚 DOCS MANAGER AGENT
+
+Documentation task:
+
+**Task:** {{args}}
+
+## MODE DETECTION
+
+| Mode | Trigger | Action |
+|------|---------|--------|
+| **INIT** | "init", "setup" | Create full docs suite |
+| **UPDATE** | "update", "sync" | Scan git diff → update |
+| **SUMMARIZE** | "summarize", "overview" | Generate codebase summary |
+| **API** | "api", "endpoint" | API reference docs |
+
+---
+
+## INIT MODE - Create Docs Suite
+
+```
+./docs/
+├── README.md                  # Project overview
+├── project-overview.md        # Requirements, roadmap
+├── code-standards.md          # Conventions, patterns
+├── codebase-summary.md        # Generated overview
+├── system-architecture.md     # Technical design
+├── deployment-guide.md        # Production setup
+├── design-guidelines.md       # UI/UX specs
+└── api-reference.md           # API documentation
+```
+
+---
+
+## UPDATE MODE - Git Diff Scan
+
+1. **Check recent changes:**
+```bash
+git diff --name-only HEAD~5
+```
+
+2. **Identify affected docs:**
+- New files → Add to codebase-summary
+- API changes → Update api-reference
+- Config changes → Update deployment-guide
+
+3. **Update CHANGELOG.md:**
+```markdown
+## [Unreleased]
+### Added
+- Feature X (PR #123)
+### Changed
+- Updated Y
+```
+
+---
+
+## API MODE - Reference Template
+
+### Template:
+```markdown
+## POST /api/auth/login
+
+Authenticate user and return JWT token.
+
+### Request
+```json
+{
+  "email": "user@example.com",
+  "password": "securepass123"
+}
+```
+
+### Response (200)
+```json
+{
+  "token": "eyJhbGciOiJIUzI1NiIs...",
+  "expiresIn": 3600
+}
+```
+
+### Errors
+| Code | Message |
+|------|---------|
+| 400 | Invalid request format |
+| 401 | Invalid credentials |
+| 429 | Rate limit exceeded |
+
+### cURL Example
+```bash
+curl -X POST https://api.example.com/auth/login \
+  -H "Content-Type: application/json" \
+  -d '{"email": "user@example.com", "password": "pass"}'
+```
+```
+
+---
+
+## ARCHITECTURE MODE - ASCII Diagrams
+
+```ascii
+┌─────────────┐     ┌─────────────┐     ┌─────────────┐
+│   Client    │────▶│   API GW    │────▶│   Service   │
+└─────────────┘     └─────────────┘     └─────────────┘
+                           │                   │
+                           ▼                   ▼
+                    ┌─────────────┐     ┌─────────────┐
+                    │    Auth     │     │   Database  │
+                    └─────────────┘     └─────────────┘
+```
+
+---
+
+## VALIDATION CHECKLIST
+
+- [ ] **Links** - All internal links work
+- [ ] **Code examples** - All code runs
+- [ ] **Formatting** - Consistent markdown
+- [ ] **Naming** - camelCase/PascalCase/snake_case correct
+- [ ] **Completeness** - No TODO/FIXME left
+
+---
+
+## WORKFLOW
+
+```bash
+# After feature
+git commit -m "feat: add auth"
+/docs update
+git add docs/ && git commit -m "docs: update for auth"
+
+# Weekly maintenance
+/docs update
+/docs summarize  # Monthly
+```
+
+> **Key Takeaway:** Keep docs synchronized with code. Run after every feature, validate weekly.
+'''
+
+# ---
+# USAGE:
+# /docs init              - Create full docs suite
+# /docs update            - Scan git diff, update docs
+# /docs summarize         - Generate codebase summary
+# /docs api /auth         - Document auth endpoints
+# ---