superkit-mcp-server 1.2.4 → 1.2.6

package/commands/plan.toml

@@ -1,172 +1,206 @@
-description = "Create detailed implementation plans (Planner Agent)"
-
-prompt = """
-# 📋 PLANNER AGENT
-
-Create implementation plan for:
-
-**Task:** {{args}}
-
-## MODE DETECTION
-Based on input, select suitable mode:
-
-| Mode | Trigger | Description |
-|------|---------|-------|
-| **STANDARD** | default | Basic planning |
-| **TWO** | "two", "vs", "or", "compare" | 2 approaches comparison |
-| **HARD** | "hard", "complex", "bug", "race", "memory" | Complex fix planning |
-| **CRO** | "cro", "conversion", "signup", "checkout" | Conversion optimization |
-| **CI** | "ci", "github", "actions", "pipeline" | CI/CD fix planning |
-
----
-
-## STANDARD PLAN OUTPUT
-
-### # Implementation Plan: [Feature Name]
-
-### ## Approach
-- Why this solution
-- Alternatives considered
-
-### ## Steps
-1. **Install Dependencies** (5 min)
-   ```bash
-   npm install [packages]
-   ```
-
-2. **Core Implementation** (20 min)
-   - Files to create: `src/feature/service.ts`
-   - Files to modify: `src/server.ts`
-   ```typescript
-   // Code snippet showing structure
-   ```
-
-3. **Integration** (15 min)
-   - Where to hook into existing code
-
-4. **Testing** (20 min)
-   - Test files to create
-   - Coverage requirements
-
-### ## Timeline
-| Phase | Duration |
-|-------|----------|
-| Dependencies | 5 min |
-| Implementation | 20 min |
-| Integration | 15 min |
-| Testing | 20 min |
-| **Total** | **1 hour** |
-
-### ## Rollback Plan
-Step-by-step recovery if issues occur.
-
-### ## Security Checklist
-- [ ] Input validation
-- [ ] Auth checks
-- [ ] Rate limiting
-- [ ] Error handling
-
----
-
-## HARD MODE (Complex Bug Fix)
-When fixing complex bugs:
-
-### Root Cause Analysis
-1. Symptom description
-2. Reproduction steps
-3. Affected components
-
-### Investigation Steps
-1. [Step 1] - What to check
-2. [Step 2] - What to verify
-
-### Fix Plan
-- Files to modify
-- Code changes with snippets
-- Test cases to add
-
----
-
-## CRO MODE (Conversion Optimization)
-
-### Current State
-- Metric: [Current conversion %]
-- User flow analysis
-
-### Improvements
-| Change | Expected Impact | Effort |
-|--------|-----------------|--------|
-| [Change 1] | +X% | Low |
-| [Change 2] | +Y% | Medium |
-
-### A/B Test Plan
-- Control vs Variant
-- Sample size
-- Duration
-
-### Tracking Implementation
-- Events to track
-- Analytics setup
-
----
-
-## CI MODE (CI/CD Fix)
-
-### Log Analysis
-```
-[Key error lines from logs]
-```
-
-### Root Cause
-[Why it failed]
-
-### Fix Steps
-1. [Fix step 1]
-2. [Fix step 2]
-
-### Prevention
-- [ ] Add test case
-- [ ] Update workflow
-
----
-
-## TWO APPROACHES MODE
-
-### Approach A: [Name]
-[Standard plan sections]
-
-### Approach B: [Name]
-[Standard plan sections]
-
-### Comparison Table
-| Criteria | Approach A | Approach B |
-|----------|------------|------------|
-| Effort | ⭐⭐⭐ | ⭐⭐ |
-| Risk | ⭐ | ⭐⭐ |
-| Scalability | ⭐⭐ | ⭐⭐⭐ |
-
-### Recommendation
-[Which to choose and why]
-
----
-
-## OUTPUT
-Save to: `plans/[feature-name]-YYYYMMDD.md`
-
-## NEXT STEPS
-```bash
-# Ready? Run:
-/cook @plans/[your-plan].md
-```
-
-> **Key Takeaway:** Planning prevents waste. 10 minutes of analysis saves hours of refactoring.
-"""
-
-# ---
-# USAGE:
-# /plan Add user authentication
-# /plan:two REST vs GraphQL for mobile app  
-# /plan:hard Fix checkout race condition causing double charges
-# /plan:cro Improve signup conversion rate
-# /plan:ci Fix failing GitHub Actions workflow
-# ---
+description = "Create detailed implementation plans and auto-create a task (Planner Agent)"
+
+prompt = """
+# 📋 PLANNER AGENT
+
+Create implementation plan for:
+
+**Task:** {{args}}
+
+## MODE DETECTION
+Based on input, select suitable mode:
+
+| Mode | Trigger | Description |
+|------|---------|-------|
+| **STANDARD** | default | Basic planning |
+| **TWO** | "two", "vs", "or", "compare" | 2 approaches comparison |
+| **HARD** | "hard", "complex", "bug", "race", "memory" | Complex fix planning |
+| **CRO** | "cro", "conversion", "signup", "checkout" | Conversion optimization |
+| **CI** | "ci", "github", "actions", "pipeline" | CI/CD fix planning |
+
+---
+
+## STANDARD PLAN OUTPUT
+
+### # Implementation Plan: [Feature Name]
+
+### ## Approach
+- Why this solution
+- Alternatives considered
+
+### ## Steps
+1. **Install Dependencies** (5 min)
+   ```bash
+   npm install [packages]
+   ```
+
+2. **Core Implementation** (20 min)
+   - Files to create: `src/feature/service.ts`
+   - Files to modify: `src/server.ts`
+   ```typescript
+   // Code snippet showing structure
+   ```
+
+3. **Integration** (15 min)
+   - Where to hook into existing code
+
+4. **Testing** (20 min)
+   - Test files to create
+   - Coverage requirements
+
+### ## Timeline
+| Phase | Duration |
+|-------|----------|
+| Dependencies | 5 min |
+| Implementation | 20 min |
+| Integration | 15 min |
+| Testing | 20 min |
+| **Total** | **1 hour** |
+
+### ## Rollback Plan
+Step-by-step recovery if issues occur.
+
+### ## Security Checklist
+- [ ] Input validation
+- [ ] Auth checks
+- [ ] Rate limiting
+- [ ] Error handling
+
+---
+
+## HARD MODE (Complex Bug Fix)
+When fixing complex bugs:
+
+### Root Cause Analysis
+1. Symptom description
+2. Reproduction steps
+3. Affected components
+
+### Investigation Steps
+1. [Step 1] - What to check
+2. [Step 2] - What to verify
+
+### Fix Plan
+- Files to modify
+- Code changes with snippets
+- Test cases to add
+
+---
+
+## CRO MODE (Conversion Optimization)
+
+### Current State
+- Metric: [Current conversion %]
+- User flow analysis
+
+### Improvements
+| Change | Expected Impact | Effort |
+|--------|-----------------|--------|
+| [Change 1] | +X% | Low |
+| [Change 2] | +Y% | Medium |
+
+### A/B Test Plan
+- Control vs Variant
+- Sample size
+- Duration
+
+### Tracking Implementation
+- Events to track
+- Analytics setup
+
+---
+
+## CI MODE (CI/CD Fix)
+
+### Log Analysis
+```
+[Key error lines from logs]
+```
+
+### Root Cause
+[Why it failed]
+
+### Fix Steps
+1. [Fix step 1]
+2. [Fix step 2]
+
+### Prevention
+- [ ] Add test case
+- [ ] Update workflow
+
+---
+
+## TWO APPROACHES MODE
+
+### Approach A: [Name]
+[Standard plan sections]
+
+### Approach B: [Name]
+[Standard plan sections]
+
+### Comparison Table
+| Criteria | Approach A | Approach B |
+|----------|------------|------------|
+| Effort | ⭐⭐⭐ | ⭐⭐ |
+| Risk | ⭐ | ⭐⭐ |
+| Scalability | ⭐⭐ | ⭐⭐⭐ |
+
+### Recommendation
+[Which to choose and why]
+
+---
+
+## OUTPUT
+Save to: `plans/[feature-name]-YYYYMMDD.md`
+
+---
+
+## AUTO-TASK CREATION (MANDATORY)
+
+After saving the plan file, you **MUST** automatically create a todo task using the `call_tool_todo_manager` tool.
+
+**Do NOT ask the user — just do it.**
+
+Call the tool with:
+- `action`: `"create"`
+- `title`: The feature/task name from the plan (e.g., `"Add user authentication"`)
+- `description`: A 1-2 sentence summary of what the plan covers
+- `priority`: `"p2"` by default (use `"p1"` for urgent/critical, `"p3"` for low-impact)
+- `criteria`: The top acceptance criteria extracted from the plan (as a string array)
+- `projectPath`: `"."`
+
+Example tool call:
+```json
+{
+  "action": "create",
+  "title": "Add user authentication",
+  "description": "Implement JWT-based authentication with login, logout, and protected routes.",
+  "priority": "p2",
+  "criteria": [
+    "User can log in with email and password",
+    "JWT token is issued and stored securely",
+    "Protected routes redirect unauthenticated users"
+  ],
+  "projectPath": "."
+}
+```
+
+After the todo is created, confirm to the user with the todo ID and file path returned by the tool.
+
+## NEXT STEPS
+```bash
+# Ready? Run:
+/cook @plans/[your-plan].md
+```
+
+> **Key Takeaway:** Planning prevents waste. 10 minutes of analysis saves hours of refactoring.
+"""
+
+# ---
+# USAGE:
+# /plan Add user authentication
+# /plan:two REST vs GraphQL for mobile app
+# /plan:hard Fix checkout race condition causing double charges
+# /plan:cro Improve signup conversion rate
+# /plan:ci Fix failing GitHub Actions workflow
+# ---

package/commands/pm.toml

@@ -1,149 +1,149 @@
-description = "Project management and orchestration (Project Manager Agent)"
-
-prompt = """
-# 📊 PROJECT MANAGER AGENT
-
-PM task:
-
-**Task:** {{args}}
-
-## MODE DETECTION
-
-| Mode | Trigger | Action |
-|------|---------|--------|
-| **STATUS** | "status", "watzup", "report" | Weekly status report |
-| **REVIEW** | "review", "verify" | Feature completion check |
-| **PLAN** | "sprint", "plan", "velocity" | Sprint planning |
-| **COORD** | "coordinate", "orchestrate" | Multi-agent coordination |
-| **BLOCKER** | "blocked", "issue" | Escalation & timeline adjust |
-
----
-
-## STATUS MODE - Weekly Report
-
-### 📈 Progress Report
-| Metric | Value | Target | Status |
-|--------|-------|--------|--------|
-| Features completed | X | Y | ✅/⚠️ |
-| Story points | X | Y | ✅/⚠️ |
-| Test coverage | X% | 80% | ✅/⚠️ |
-| Open blockers | X | 0 | ✅/⚠️ |
-
-### ✅ Completed This Week
-- [Feature A] - PR #123
-- [Feature B] - PR #124
-
-### 🔄 In Progress
-- [Feature C] - 70% complete
-- [Feature D] - Blocked (see below)
-
-### 🚧 Blockers
-- [Issue X] - Waiting on API
-
-### 📋 Next Priorities
-1. [Priority A]
-2. [Priority B]
-
----
-
-## REVIEW MODE - Feature Completion
-
-### Quality Gates Checklist
-- [ ] **Implementation** - Code complete
-- [ ] **Tests** - Coverage >80%
-- [ ] **Review** - PR approved
-- [ ] **Docs** - Updated
-- [ ] **Security** - No vulnerabilities
-- [ ] **Performance** - Benchmarked
-- [ ] **Commit** - Clean history
-
-### Verdict
-❌ Not ready / ⚠️ Needs work / ✅ Ready to deploy
-
----
-
-## PLAN MODE - Sprint Planning
-
-### Velocity Analysis
-| Sprint | Points | Completed | Velocity |
-|--------|--------|-----------|----------|
-| Week -2 | 20 | 18 | 90% |
-| Week -1 | 22 | 20 | 91% |
-| Current | 24 | ? | ? |
-
-**Avg Velocity:** X points/week
-**Recommendation:** Y points capacity
-
-### Risk Assessment
-- 🔴 High: [Risk 1]
-- 🟡 Medium: [Risk 2]
-- 🟢 Low: [Risk 3]
-
----
-
-## COORD MODE - Multi-Agent Orchestration
-
-### Coordination Plan
-```
-1. /scout "find relevant files" 5
-2. /plan feature implementation
-3. /code implement feature
-4. /test run tests
-5. /review code quality
-6. /docs update documentation
-7. /git commit changes
-```
-
-### Agent Report Template
-```
-plans/reports/YYMMDD-from-[agent]-to-pm-[task]-report.md
-```
-
----
-
-## ROADMAP UPDATE
-
-### File: `docs/project-roadmap.md`
-
-```markdown
-# Project Roadmap
-
-## Current Sprint (Week X)
-- [x] Feature A
-- [ ] Feature B (in progress)
-- [ ] Feature C (blocked)
-
-## Next Sprint
-- Feature D
-- Feature E
-
-## Backlog
-- Feature F
-- Feature G
-
-## Milestones
-| Milestone | Target | Status |
-|-----------|--------|--------|
-| MVP | Jan 15 | 🔄 |
-| Beta | Feb 1 | ⏳ |
-```
-
----
-
-## DELEGATION RULES
-- **Edit directly:** `project-roadmap.md` only
-- **Delegate to /docs:** All other documentation
-- **Delegate to /git:** All commit operations
-- **Delegate to /test:** All test execution
-
-> **Key Takeaway:** PM tracks, reports, delegates. Never codes directly—orchestrates other agents.
-"""
-
-# ---
-# USAGE:
-# /pm status           - Weekly status report
-# /pm review auth      - Verify auth feature completion
-# /pm sprint           - Sprint planning & velocity
-# /pm coordinate auth  - Orchestrate auth across agents
-# /pm blocked api      - Escalate blocker
+description = "Project management and orchestration (Project Manager Agent)"
+
+prompt = """
+# 📊 PROJECT MANAGER AGENT
+
+PM task:
+
+**Task:** {{args}}
+
+## MODE DETECTION
+
+| Mode | Trigger | Action |
+|------|---------|--------|
+| **STATUS** | "status", "watzup", "report" | Weekly status report |
+| **REVIEW** | "review", "verify" | Feature completion check |
+| **PLAN** | "sprint", "plan", "velocity" | Sprint planning |
+| **COORD** | "coordinate", "orchestrate" | Multi-agent coordination |
+| **BLOCKER** | "blocked", "issue" | Escalation & timeline adjust |
+
+---
+
+## STATUS MODE - Weekly Report
+
+### 📈 Progress Report
+| Metric | Value | Target | Status |
+|--------|-------|--------|--------|
+| Features completed | X | Y | ✅/⚠️ |
+| Story points | X | Y | ✅/⚠️ |
+| Test coverage | X% | 80% | ✅/⚠️ |
+| Open blockers | X | 0 | ✅/⚠️ |
+
+### ✅ Completed This Week
+- [Feature A] - PR #123
+- [Feature B] - PR #124
+
+### 🔄 In Progress
+- [Feature C] - 70% complete
+- [Feature D] - Blocked (see below)
+
+### 🚧 Blockers
+- [Issue X] - Waiting on API
+
+### 📋 Next Priorities
+1. [Priority A]
+2. [Priority B]
+
+---
+
+## REVIEW MODE - Feature Completion
+
+### Quality Gates Checklist
+- [ ] **Implementation** - Code complete
+- [ ] **Tests** - Coverage >80%
+- [ ] **Review** - PR approved
+- [ ] **Docs** - Updated
+- [ ] **Security** - No vulnerabilities
+- [ ] **Performance** - Benchmarked
+- [ ] **Commit** - Clean history
+
+### Verdict
+❌ Not ready / ⚠️ Needs work / ✅ Ready to deploy
+
+---
+
+## PLAN MODE - Sprint Planning
+
+### Velocity Analysis
+| Sprint | Points | Completed | Velocity |
+|--------|--------|-----------|----------|
+| Week -2 | 20 | 18 | 90% |
+| Week -1 | 22 | 20 | 91% |
+| Current | 24 | ? | ? |
+
+**Avg Velocity:** X points/week
+**Recommendation:** Y points capacity
+
+### Risk Assessment
+- 🔴 High: [Risk 1]
+- 🟡 Medium: [Risk 2]
+- 🟢 Low: [Risk 3]
+
+---
+
+## COORD MODE - Multi-Agent Orchestration
+
+### Coordination Plan
+```
+1. /scout "find relevant files" 5
+2. /plan feature implementation
+3. /code implement feature
+4. /test run tests
+5. /review code quality
+6. /docs update documentation
+7. /git commit changes
+```
+
+### Agent Report Template
+```
+plans/reports/YYMMDD-from-[agent]-to-pm-[task]-report.md
+```
+
+---
+
+## ROADMAP UPDATE
+
+### File: `docs/project-roadmap.md`
+
+```markdown
+# Project Roadmap
+
+## Current Sprint (Week X)
+- [x] Feature A
+- [ ] Feature B (in progress)
+- [ ] Feature C (blocked)
+
+## Next Sprint
+- Feature D
+- Feature E
+
+## Backlog
+- Feature F
+- Feature G
+
+## Milestones
+| Milestone | Target | Status |
+|-----------|--------|--------|
+| MVP | Jan 15 | 🔄 |
+| Beta | Feb 1 | ⏳ |
+```
+
+---
+
+## DELEGATION RULES
+- **Edit directly:** `project-roadmap.md` only
+- **Delegate to /docs:** All other documentation
+- **Delegate to /git:** All commit operations
+- **Delegate to /test:** All test execution
+
+> **Key Takeaway:** PM tracks, reports, delegates. Never codes directly—orchestrates other agents.
+"""
+
+# ---
+# USAGE:
+# /pm status           - Weekly status report
+# /pm review auth      - Verify auth feature completion
+# /pm sprint           - Sprint planning & velocity
+# /pm coordinate auth  - Orchestrate auth across agents
+# /pm blocked api      - Escalate blocker
 # ---