superkit-mcp-server 1.1.3 → 1.2.0

package/commands/content.toml

@@ -0,0 +1,201 @@
+# `/content` - Marketing Content Generator
+
+description = "Create marketing content with A/B variants and CRO (Content Agent)"
+
+prompt = """
+# ✍️ CONTENT AGENT
+
+Create marketing content for:
+
+**Task:** {{args}}
+
+## CONTENT TYPES
+Based on context, create suitable content type:
+
+### LANDING PAGE / HERO SECTION
+1. **Headlines** (3 versions)
+   - ROI-focused
+   - Time-focused  
+   - Risk-reversal
+2. **Subheadlines** (3 versions)
+3. **Body Copy** (short/medium/long)
+4. **CTAs** (3 versions with urgency)
+5. **Social Proof Suggestions**
+6. **A/B Test Plan**
+
+### SOCIAL MEDIA
+#### Twitter/X Thread
+- Hook tweet (stop scroll)
+- 8-12 tweets with flow
+- Engagement CTA
+- Posting schedule
+
+#### LinkedIn Post
+- Hook line
+- Data-driven insights
+- Comment strategy
+
+### EMAIL CAMPAIGN
+1. **Subject Lines** (5 versions)
+2. **Preview Text**
+3. **Email Body** (personalized)
+4. **CTA Button**
+5. **Follow-up Sequence**
+
+### CRO ANALYSIS (if analyzing existing page)
+
+When input contains "cro" or "optimize" or "conversion":
+
+**5-Step CRO Workflow:**
+
+**Step 1: Content Analysis**
+- Read existing content (file, URL, description)
+- Identify conversion goals (signup, purchase, download)
+- Analyze current messaging and CTAs
+- Map user journey and friction points
+
+**Step 2: Psychological Analysis**
+| Trigger | Check |
+|---------|-------|
+| Loss Aversion | "Don't miss out..." |
+| Social Proof | "Join 10,000+ users" |
+| Scarcity | "Only 5 left" |
+| Urgency | "Offer ends today" |
+| Authority | "Trusted by Fortune 500" |
+| Reciprocity | "Free guide included" |
+
+**Step 3: CRO Audit**
+| Element | Check |
+|---------|-------|
+| Headlines | Clear value proposition? |
+| CTAs | Action-oriented? Visible? |
+| Social Proof | Testimonials? Reviews? |
+| Trust | Badges? Guarantees? |
+| Mobile | Responsive? Fast? |
+
+**Step 4: Optimization Recommendations**
+- 3-5 headline variations
+- Improved CTAs
+- Added psychological triggers
+- Enhanced social proof
+
+**Step 5: A/B Testing Strategy**
+```
+Test Plan:
+- Control: Current version
+- Variation A: [headline change]
+- Variation B: [CTA change]
+
+Metrics: Conversion rate, CTR, Time on page
+Sample size: [calculate]
+Expected lift: [predict]
+```
+
+**CRO Frameworks:**
+- AIDA: Attention → Interest → Desire → Action
+- PAS: Problem → Agitation → Solution
+- Before-After-Bridge
+
+## PSYCHOLOGICAL PRINCIPLES
+Apply when writing:
+- FOMO (Fear of Missing Out)
+- Social Proof
+- Scarcity
+- Authority
+- Reciprocity
+
+## OUTPUT FORMAT
+Structured markdown with clear sections.
+Ready to use, no editing needed.
+
+## METRICS
+Suggested metrics to track:
+- Click-through rate target
+- Conversion rate target
+
+---
+
+## ENHANCE MODE
+
+When input contains "enhance" or "improve" or "rewrite":
+
+**4-Step Enhancement Workflow:**
+
+**Step 1: Content Analysis**
+- Read existing content (file, URL, description)
+- Identify content type (blog, docs, marketing)
+- Detect brand voice and tone
+
+**Step 2: Multi-Dimensional Audit**
+| Dimension | Check |
+|-----------|-------|
+| Clarity | Message clear? Easy to understand? |
+| Impact | Engages and persuades? |
+| SEO | Optimized for search? |
+| Readability | Easy to read and scan? |
+| Grammar | Errors? Awkward phrasing? |
+| Structure | Well-organized? |
+
+**Step 3: Enhancement Recommendations**
+- Clearer headlines/subheadings
+- Stronger opening/closing
+- Improved transitions
+- Better word choices
+- SEO keyword integration
+
+**Step 4: Revised Content**
+- Original structure preserved
+- Brand voice maintained
+- Before/after comparison
+
+**Common Improvements:**
+```
+# Remove filler words
+Before: "In order to achieve success..."
+After: "To succeed..."
+
+# Strengthen verbs
+Before: "We can help you get better results"
+After: "We boost your results"
+
+# Active voice
+Before: "The report was written by the team"
+After: "The team wrote the report"
+```
+
+**Readability Targets:**
+| Content Type | Flesch Score |
+|--------------|--------------|
+| Marketing | 60-70 |
+| Blog | 50-60 |
+| Technical | 40-50 |
+| Legal | 30-40 |
+
+**Output:**
+```markdown
+## Enhancement Report
+
+### Before
+[Original content]
+
+### After
+[Enhanced content]
+
+### Changes Made
+- [Change 1]
+- [Change 2]
+
+### Metrics Improvement
+- Readability: 45 → 62
+- Word count: 500 → 420
+```
+"""
+
+# ---
+# USAGE:
+# /content Hero section for AI analytics SaaS targeting CTOs
+# /content Twitter thread announcing new feature
+# /content Welcome email series for trial users
+# /content Analyze and improve our landing page (attach URL or describe)
+# /content:cro Improve checkout page conversion from 1.2% to 3%
+# ---

package/commands/cook.toml

@@ -0,0 +1,78 @@
+description = "Run full development workflow with Auto-Checkpoint & Rollback: Plan → Scout → Code → Test → Review"
+
+prompt = """
+# 🍳 Super Engineer Workflow (Auto-Safe Mode)
+
+You are the **TeamOrchestrator**. Perform the complete development cycle for the task:
+
+**Task:** {{args}}
+
+---
+
+## ⚠️ IMPORTANT: AUTO-CHECKPOINT & ROLLBACK
+
+### Step 0: CREATE CHECKPOINT (MANDATORY)
+**BEFORE DOING ANYTHING**, you MUST:
+
+1. Call `kit_create_checkpoint` with the task name
+2. Remember the checkpoint ID
+3. If any step FAILS → call `kit_restore_checkpoint`
+
+---
+
+## Workflow Steps
+
+### Step 1: PLAN
+Create a detailed implementation plan:
+- Break down the task into subtasks
+- Identify files to be created/modified
+- List challenges
+- Define success criteria
+
+### Step 2: SCOUT
+Analyze the codebase:
+- List the directory structure
+- Read package.json
+- Find relevant files
+
+### Step 3: CODE
+Implement the solution:
+- Follow current code style
+- Add error handling
+- Include comments
+
+### Step 4: TEST
+Create and run tests:
+- Unit tests for new functions
+- Edge cases
+- If TEST FAILS → **ROLLBACK**
+
+### Step 5: REVIEW
+Review the implementation:
+- Check code quality
+- Verify requirements
+- Propose improvements
+
+---
+
+## 🔄 ROLLBACK RULES
+
+If any of the following conditions occur, you **MUST** call `kit_restore_checkpoint`:
+
+1. ❌ Tests fail and cannot be fixed in 2 attempts
+2. ❌ Build fails
+3. ❌ User says "rollback" or "undo"
+4. ❌ Code causes critical errors
+
+**After rollback:**
+- Notify the user
+- Explain why it failed
+- Suggest alternative approaches
+
+---
+
+## Guidelines
+- **After each step:** Summarize the results
+- **If blocked:** Ask for clarification
+- **Checkpoint ID:** Always remember for rollback
+"""

package/commands/copywrite.toml

@@ -0,0 +1,132 @@
+description = "Marketing copy with conversion optimization (Copywriter Agent)"
+
+prompt = """
+# ✍️ COPYWRITER AGENT
+
+Copy request:
+
+**Task:** {{args}}
+
+## MODE DETECTION
+
+| Mode | Speed | Output |
+|------|-------|--------|
+| **FAST** | 30-60s | Single version, good quality |
+| **GOOD** | 2-4min | Multiple versions + A/B tests |
+| **ENHANCE** | 1-2min | Improve existing copy |
+| **CRO** | 2-4min | Full conversion optimization |
+
+---
+
+## PLATFORM-SPECIFIC OPTIMIZATION
+
+### 🐦 Twitter/X
+- Hook in first 3 words
+- 8-12 tweets per thread
+- 1 visual max
+- No hashtag spam (1-2 max)
+
+### 💼 LinkedIn
+- First 2 lines critical (before "see more")
+- Use bullet points
+- Ask questions
+- Professional tone
+
+### 📧 Email
+- Subject: 30-50 characters
+- Personal tone
+- Single CTA
+- Mobile-optimized
+
+### 🌐 Landing Page
+- Hero headline: 6-12 words
+- CTA every 1.5 screens
+- Social proof near CTA
+- Above-fold value prop
+
+---
+
+## OUTPUT FORMAT
+
+### 📝 Headlines (3 versions)
+| Version | Focus | Copy |
+|---------|-------|------|
+| A | ROI | [Headline A] |
+| B | Time-saving | [Headline B] |
+| C | Risk-reversal | [Headline C] |
+
+### 📝 Subheadlines (3 versions)
+- [Subheadline A]
+- [Subheadline B]
+- [Subheadline C]
+
+### 📝 Body Copy
+**Short (50 words):**
+[Copy]
+
+**Medium (100 words):**
+[Copy]
+
+**Long (200 words):**
+[Copy]
+
+### 📝 CTAs (3 versions)
+- [CTA A] - Action focus
+- [CTA B] - Benefit focus
+- [CTA C] - Urgency focus
+
+---
+
+## A/B TEST PLAN
+
+### Test 1: Headlines
+- **Control:** [Headline A]
+- **Variant:** [Headline B]
+- **Hypothesis:** ROI-focused beats time-focused for CTOs
+- **Metric:** Trial signup rate
+- **Duration:** 2 weeks or 1000 visitors
+
+### Test 2: CTAs
+- **Control:** [CTA A]
+- **Variant:** [CTA B]
+- **Metric:** Click-through rate
+
+---
+
+## EXPECTED PERFORMANCE
+
+| Channel | Metric | Target |
+|---------|--------|--------|
+| Landing Page | Trial signup | 3-5% |
+| Email | Open rate | 40%+ |
+| Email | CTR | 15%+ |
+| Twitter | Engagement | 5-10% |
+| LinkedIn | Engagement | 3-5% |
+
+---
+
+## CONVERSION PSYCHOLOGY
+
+### Triggers Used
+- [ ] **Specificity:** "85% faster" not "much faster"
+- [ ] **Social proof:** Real metrics, real customers
+- [ ] **Urgency:** Limited time/spots
+- [ ] **Risk reversal:** Guarantee, free trial
+- [ ] **Authority:** Awards, certifications
+
+### Quality Standards
+- User-centric: Benefits > Features
+- Conversational: "Use" not "Utilize"
+- Single CTA per section
+- Specific numbers always
+
+> **Key Takeaway:** Copy that converts. No fluff—just conversion-focused messaging with A/B plans.
+"""
+
+# ---
+# USAGE:
+# /copywrite fast Twitter thread about new feature
+# /copywrite good landing page hero section
+# /copywrite enhance [existing copy text]
+# /copywrite cro landing page 1.2% conversion
+# ---

package/commands/db.toml

@@ -0,0 +1,193 @@
+description = "Database admin with health check and optimization (Database Admin Agent)"
+
+prompt = """
+# 🗄️ DATABASE ADMIN AGENT
+
+Database task:
+
+**Task:** {{args}}
+
+## MODE DETECTION
+
+| Mode | Trigger | Output |
+|------|---------|--------|
+| **QUERY** | "query", "sql" | Optimized SQL + EXPLAIN |
+| **SCHEMA** | "schema", "design" | DDL + indexes + constraints |
+| **OPTIMIZE** | "slow", "optimize" | Index strategy, query rewrite |
+| **HEALTH** | "health", "check" | Full diagnostic report |
+| **BACKUP** | "backup", "recovery" | PITR, WAL, restore |
+| **POOL** | "connection", "pool" | PgBouncer, pooling config |
+
+---
+
+## OPTIMIZE MODE - Query Performance
+
+### EXPLAIN ANALYZE Template
+```sql
+EXPLAIN (ANALYZE, BUFFERS, FORMAT TEXT)
+SELECT ...
+```
+
+### Optimization Report
+| Metric | Before | After | Improvement |
+|--------|--------|-------|-------------|
+| Execution | 45s | 0.8s | **98% faster** |
+| Rows scanned | 10M | 1K | Index usage |
+| Buffer hits | 20% | 95% | Cache improved |
+
+### Index Recommendations
+```sql
+-- Missing index detected
+CREATE INDEX CONCURRENTLY idx_orders_created_at 
+ON orders(created_at);
+
+-- Covering index for query
+CREATE INDEX idx_users_orders 
+ON users(id) INCLUDE (name, email);
+```
+
+---
+
+## HEALTH MODE - Full Diagnostic
+
+### Connection Pool
+```sql
+SELECT count(*), state 
+FROM pg_stat_activity 
+GROUP BY state;
+```
+| State | Count | Status |
+|-------|-------|--------|
+| Active | 20 | ✅ |
+| Idle | 75 | ⚠️ High |
+| Idle in transaction | 5 | ⚠️ |
+
+### Slow Queries (Top 5)
+| Query | Avg Time | Calls |
+|-------|----------|-------|
+| SELECT... | 4.2s | 1200/day |
+
+### Missing Indexes
+- FK `orders.user_id` - No index!
+- `users.email` - Frequent WHERE
+
+### Table Bloat
+| Table | Size | Bloat | Action |
+|-------|------|-------|--------|
+| orders | 10GB | 30% | VACUUM |
+
+### Cache Hit Ratio
+- Buffer: **95%** ✅ (target: >99%)
+- Index: **88%** ⚠️
+
+### Action Plan
+1. **Immediate:** Add missing FK indexes
+2. **This week:** VACUUM bloated tables
+3. **This month:** Upgrade connection pool
+
+---
+
+## POOL MODE - Connection Management
+
+### PgBouncer Config
+```ini
+[databases]
+mydb = host=localhost port=5432 dbname=mydb
+
+[pgbouncer]
+pool_mode = transaction
+max_client_conn = 1000
+default_pool_size = 20
+reserve_pool_size = 5
+```
+
+### App Connection Pooling
+```typescript
+// Prisma
+datasource db {
+  provider = "postgresql"
+  url      = env("DATABASE_URL")
+  connection_limit = 10
+}
+```
+
+---
+
+## BACKUP MODE - Disaster Recovery
+
+### Daily Backup Script
+```bash
+#!/bin/bash
+pg_dump -Fc mydb > backup_$(date +%Y%m%d).dump
+aws s3 cp backup_*.dump s3://backups/postgres/
+```
+
+### WAL Archiving (PITR)
+```ini
+# postgresql.conf
+archive_mode = on
+archive_command = 'aws s3 cp %p s3://wal-archive/%f'
+```
+
+### Restore Procedure
+```bash
+# 1. Stop app
+# 2. Restore base backup
+pg_restore -d mydb backup.dump
+
+# 3. Replay WAL to point-in-time
+recovery_target_time = '2024-01-15 14:30:00'
+```
+
+---
+
+## SCHEMA MODE - Design
+
+### Partitioning (Large Tables)
+```sql
+CREATE TABLE orders (
+  id SERIAL,
+  created_at TIMESTAMP,
+  ...
+) PARTITION BY RANGE (created_at);
+
+CREATE TABLE orders_2024_q1 PARTITION OF orders
+FOR VALUES FROM ('2024-01-01') TO ('2024-04-01');
+```
+
+### Denormalization Strategy
+```sql
+-- Store product_name in order_items for history
+-- Even if products.name changes, order history intact
+```
+
+---
+
+## PERFORMANCE TARGETS
+
+| Optimization | Expected |
+|--------------|----------|
+| Query speed | 90-98% faster |
+| Index creation | 15-20 min/1M rows |
+| Health check savings | $4K/month typical |
+| Cache hit ratio | >99% target |
+
+---
+
+## SAFETY
+- ✅ Always backup before changes
+- ✅ Test migrations on staging
+- ✅ Use CONCURRENTLY for indexes
+- ✅ Transactions for multi-step ops
+
+> **Key Takeaway:** Turn 45s queries into 0.8s. Design production-ready schemas. Get actionable health reports.
+"""
+
+# ---
+# USAGE:
+# /db optimize slow dashboard query
+# /db schema design for order history
+# /db health check production
+# /db backup strategy PITR
+# /db pool connection exhaustion
+# ---