superkit-mcp-server 1.2.3 → 1.2.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/ARCHITECTURE.md +102 -102
- package/README.md +71 -71
- package/SUPERKIT.md +168 -168
- package/agents/code-archaeologist.md +106 -106
- package/agents/coder.md +90 -90
- package/agents/data-engineer.md +28 -28
- package/agents/devops-engineer.md +242 -242
- package/agents/git-manager.md +203 -203
- package/agents/orchestrator.md +420 -420
- package/agents/penetration-tester.md +188 -188
- package/agents/performance-optimizer.md +187 -187
- package/agents/planner.md +270 -270
- package/agents/qa-automation-engineer.md +103 -103
- package/agents/quant-developer.md +32 -32
- package/agents/reviewer.md +100 -100
- package/agents/scout.md +222 -222
- package/agents/tester.md +274 -274
- package/agents/ui-designer.md +208 -208
- package/build/tools/sessionManager.js +79 -10
- package/build/tools/todoTools.js +39 -39
- package/build/tools/validators/__tests__/apiSchema.test.js +23 -23
- package/build/tools/validators/__tests__/convertRules.test.js +5 -5
- package/build/tools/validators/__tests__/frontendDesign.test.js +12 -12
- package/build/tools/validators/__tests__/geoChecker.test.js +19 -19
- package/build/tools/validators/__tests__/mobileAudit.test.js +12 -12
- package/build/tools/validators/__tests__/reactPerformanceChecker.test.js +17 -17
- package/build/tools/validators/__tests__/securityScan.test.js +6 -6
- package/build/tools/validators/__tests__/seoChecker.test.js +16 -16
- package/build/tools/validators/__tests__/typeCoverage.test.js +14 -14
- package/commands/README.md +122 -122
- package/commands/ask.toml +72 -72
- package/commands/brainstorm.toml +119 -119
- package/commands/chat.toml +77 -77
- package/commands/code-preview.toml +37 -37
- package/commands/code.toml +28 -28
- package/commands/content.toml +200 -200
- package/commands/cook.toml +77 -77
- package/commands/copywrite.toml +131 -131
- package/commands/db.toml +192 -192
- package/commands/debug.toml +166 -166
- package/commands/design.toml +158 -158
- package/commands/dev-rules.toml +14 -14
- package/commands/do.toml +117 -117
- package/commands/doc-rules.toml +14 -14
- package/commands/docs.toml +148 -148
- package/commands/fix.toml +440 -440
- package/commands/fullstack.toml +175 -175
- package/commands/git.toml +235 -235
- package/commands/help.toml +84 -84
- package/commands/integrate.toml +127 -127
- package/commands/journal.toml +136 -136
- package/commands/kit-setup.toml +40 -40
- package/commands/mcp.toml +183 -183
- package/commands/orchestration.toml +15 -15
- package/commands/plan.toml +171 -171
- package/commands/pm.toml +148 -148
- package/commands/pr.toml +50 -50
- package/commands/project.toml +32 -32
- package/commands/research.toml +117 -117
- package/commands/review-pr.toml +63 -63
- package/commands/review.toml +190 -190
- package/commands/scout-ext.toml +97 -97
- package/commands/scout.toml +79 -79
- package/commands/screenshot.toml +65 -65
- package/commands/session.toml +102 -102
- package/commands/skill.toml +384 -384
- package/commands/status.toml +22 -22
- package/commands/team.toml +56 -56
- package/commands/test.toml +164 -164
- package/commands/ticket.toml +70 -70
- package/commands/use.toml +106 -106
- package/commands/video.toml +83 -83
- package/commands/watzup.toml +71 -71
- package/commands/workflow.toml +14 -14
- package/package.json +35 -35
- package/skills/meta/README.md +30 -30
- package/skills/meta/api-design/SKILL.md +134 -134
- package/skills/meta/code-review/SKILL.md +44 -44
- package/skills/meta/code-review/checklists/pre-merge.md +25 -25
- package/skills/meta/code-review/workflows/architecture-pass.md +26 -26
- package/skills/meta/code-review/workflows/performance-pass.md +27 -27
- package/skills/meta/code-review/workflows/security-pass.md +29 -29
- package/skills/meta/compound-docs/SKILL.md +133 -133
- package/skills/meta/debug/SKILL.md +40 -40
- package/skills/meta/debug/templates/bug-report.template.md +31 -31
- package/skills/meta/debug/workflows/reproduce-issue.md +20 -20
- package/skills/meta/docker/SKILL.md +126 -126
- package/skills/meta/examples/supabase/SKILL.md +46 -46
- package/skills/meta/examples/supabase/references/best-practices.md +319 -319
- package/skills/meta/examples/supabase/references/common-patterns.md +373 -373
- package/skills/meta/examples/supabase/templates/migration-template.sql +49 -49
- package/skills/meta/examples/supabase/templates/rls-policy-template.sql +77 -77
- package/skills/meta/examples/supabase/workflows/debugging.md +260 -260
- package/skills/meta/examples/supabase/workflows/migration-workflow.md +211 -211
- package/skills/meta/examples/supabase/workflows/rls-policies.md +244 -244
- package/skills/meta/examples/supabase/workflows/schema-design.md +321 -321
- package/skills/meta/file-todos/SKILL.md +88 -88
- package/skills/meta/mobile/SKILL.md +140 -140
- package/skills/meta/nextjs/SKILL.md +101 -101
- package/skills/meta/performance/SKILL.md +130 -130
- package/skills/meta/react-patterns/SKILL.md +83 -83
- package/skills/meta/security/SKILL.md +114 -114
- package/skills/meta/session-resume/SKILL.md +96 -96
- package/skills/meta/tailwind/SKILL.md +139 -139
- package/skills/meta/testing/SKILL.md +43 -43
- package/skills/meta/testing/references/vitest-patterns.md +45 -45
- package/skills/meta/testing/templates/component-test.template.tsx +37 -37
- package/skills/tech/alpha-vantage/SKILL.md +142 -142
- package/skills/tech/alpha-vantage/references/commodities.md +153 -153
- package/skills/tech/alpha-vantage/references/economic-indicators.md +158 -158
- package/skills/tech/alpha-vantage/references/forex-crypto.md +154 -154
- package/skills/tech/alpha-vantage/references/fundamentals.md +223 -223
- package/skills/tech/alpha-vantage/references/intelligence.md +138 -138
- package/skills/tech/alpha-vantage/references/options.md +93 -93
- package/skills/tech/alpha-vantage/references/technical-indicators.md +374 -374
- package/skills/tech/alpha-vantage/references/time-series.md +157 -157
- package/skills/tech/financial-modeling/SKILL.md +18 -18
- package/skills/tech/financial-modeling/skills/3-statements/SKILL.md +368 -368
- package/skills/tech/financial-modeling/skills/3-statements/references/formatting.md +118 -118
- package/skills/tech/financial-modeling/skills/3-statements/references/formulas.md +292 -292
- package/skills/tech/financial-modeling/skills/3-statements/references/sec-filings.md +125 -125
- package/skills/tech/financial-modeling/skills/dcf-model/SKILL.md +1210 -1210
- package/skills/tech/financial-modeling/skills/dcf-model/TROUBLESHOOTING.md +40 -40
- package/skills/tech/financial-modeling/skills/dcf-model/requirements.txt +8 -8
- package/skills/tech/financial-modeling/skills/dcf-model/scripts/validate_dcf.py +292 -292
- package/skills/tech/financial-modeling/skills/lbo-model/SKILL.md +236 -236
- package/skills/tech/financial-modeling/skills/merger-model/SKILL.md +108 -108
- package/skills/workflows/README.md +203 -203
- package/skills/workflows/adr.md +174 -174
- package/skills/workflows/changelog.md +74 -74
- package/skills/workflows/compound.md +323 -323
- package/skills/workflows/compound_health.md +74 -74
- package/skills/workflows/create-agent-skill.md +138 -138
- package/skills/workflows/cycle.md +144 -144
- package/skills/workflows/deploy-docs.md +84 -84
- package/skills/workflows/development-rules.md +42 -42
- package/skills/workflows/doc.md +95 -95
- package/skills/workflows/documentation-management.md +34 -34
- package/skills/workflows/explore.md +146 -146
- package/skills/workflows/generate_command.md +106 -106
- package/skills/workflows/heal-skill.md +97 -97
- package/skills/workflows/housekeeping.md +229 -229
- package/skills/workflows/kit-setup.md +102 -102
- package/skills/workflows/map-codebase.md +78 -78
- package/skills/workflows/orchestration-protocol.md +43 -43
- package/skills/workflows/plan-compound.md +439 -439
- package/skills/workflows/plan_review.md +269 -269
- package/skills/workflows/primary-workflow.md +37 -37
- package/skills/workflows/promote_pattern.md +86 -86
- package/skills/workflows/release-docs.md +82 -82
- package/skills/workflows/report-bug.md +135 -135
- package/skills/workflows/reproduce-bug.md +118 -118
- package/skills/workflows/resolve_pr.md +133 -133
- package/skills/workflows/resolve_todo.md +128 -128
- package/skills/workflows/review-compound.md +376 -376
- package/skills/workflows/skill-review.md +127 -127
- package/skills/workflows/specs.md +257 -257
- package/skills/workflows/triage-sprint.md +102 -102
- package/skills/workflows/triage.md +152 -152
- package/skills/workflows/work.md +399 -399
- package/skills/workflows/xcode-test.md +93 -93
package/commands/debug.toml
CHANGED
|
@@ -1,167 +1,167 @@
|
|
|
1
|
-
description = "Debug and fix issues with structured analysis (Debugger Agent)"
|
|
2
|
-
|
|
3
|
-
prompt = """
|
|
4
|
-
# 🐛 DEBUGGER AGENT
|
|
5
|
-
|
|
6
|
-
Debug issue:
|
|
7
|
-
|
|
8
|
-
**Issue:** {{args}}
|
|
9
|
-
|
|
10
|
-
## MODE DETECTION
|
|
11
|
-
|
|
12
|
-
| Mode | Trigger | Features |
|
|
13
|
-
|------|---------|----------|
|
|
14
|
-
| **API** | "500", "error", "response", "endpoint" | Root cause, fix, rollback |
|
|
15
|
-
| **DB** | "connection", "pool", "query", "timeout" | Leak detection, kill commands |
|
|
16
|
-
| **CI** | "ci", "actions", "pipeline", "build" | Workflow analysis, fix |
|
|
17
|
-
| **PERF** | "slow", "latency", "performance", "degradation" | N+1, EXPLAIN, optimization |
|
|
18
|
-
| **GENERAL** | default | Standard debug flow |
|
|
19
|
-
|
|
20
|
-
---
|
|
21
|
-
|
|
22
|
-
## DEBUG REPORT FORMAT (Runbook)
|
|
23
|
-
|
|
24
|
-
### 📋 Issue Summary
|
|
25
|
-
- **Symptom:** [What's happening]
|
|
26
|
-
- **Started:** [When/after what change]
|
|
27
|
-
- **Severity:** Critical / High / Medium / Low
|
|
28
|
-
- **Affected:** [Users, services, endpoints]
|
|
29
|
-
|
|
30
|
-
---
|
|
31
|
-
|
|
32
|
-
### 🔍 Investigation
|
|
33
|
-
|
|
34
|
-
#### Logs Analysis
|
|
35
|
-
```
|
|
36
|
-
[Key error logs]
|
|
37
|
-
```
|
|
38
|
-
|
|
39
|
-
#### Recent Changes
|
|
40
|
-
- [Deploy/commit that may have caused this]
|
|
41
|
-
- [Config changes]
|
|
42
|
-
- [Dependency updates]
|
|
43
|
-
|
|
44
|
-
---
|
|
45
|
-
|
|
46
|
-
### 🎯 Root Cause
|
|
47
|
-
[Clear explanation of why this is happening]
|
|
48
|
-
|
|
49
|
-
---
|
|
50
|
-
|
|
51
|
-
### 🔧 Fix Plan
|
|
52
|
-
|
|
53
|
-
#### Step 1: [Immediate mitigation]
|
|
54
|
-
```bash
|
|
55
|
-
# Command to run
|
|
56
|
-
```
|
|
57
|
-
|
|
58
|
-
#### Step 2: [Code fix]
|
|
59
|
-
```typescript
|
|
60
|
-
// Before
|
|
61
|
-
[broken code]
|
|
62
|
-
|
|
63
|
-
// After
|
|
64
|
-
[fixed code]
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
#### Step 3: [Validation]
|
|
68
|
-
```bash
|
|
69
|
-
# Test the fix
|
|
70
|
-
```
|
|
71
|
-
|
|
72
|
-
---
|
|
73
|
-
|
|
74
|
-
### ⏪ Rollback Steps
|
|
75
|
-
If fix doesn't work:
|
|
76
|
-
1. [Rollback step 1]
|
|
77
|
-
2. [Rollback step 2]
|
|
78
|
-
```bash
|
|
79
|
-
# Rollback command
|
|
80
|
-
git revert [commit]
|
|
81
|
-
# or
|
|
82
|
-
kubectl rollout undo deployment/[name]
|
|
83
|
-
```
|
|
84
|
-
|
|
85
|
-
---
|
|
86
|
-
|
|
87
|
-
### ✅ Validation Commands
|
|
88
|
-
```bash
|
|
89
|
-
# Verify fix worked
|
|
90
|
-
curl -X POST https://api.example.com/endpoint
|
|
91
|
-
# Expected: 200 OK
|
|
92
|
-
|
|
93
|
-
# Check logs
|
|
94
|
-
tail -f /var/log/app.log | grep ERROR
|
|
95
|
-
# Expected: No new errors
|
|
96
|
-
|
|
97
|
-
# Monitor metrics
|
|
98
|
-
# Expected: Error rate < 0.1%
|
|
99
|
-
```
|
|
100
|
-
|
|
101
|
-
---
|
|
102
|
-
|
|
103
|
-
### 🛡️ Prevention
|
|
104
|
-
To prevent this in future:
|
|
105
|
-
- [ ] Add test case for this scenario
|
|
106
|
-
- [ ] Add monitoring alert
|
|
107
|
-
- [ ] Update documentation
|
|
108
|
-
- [ ] Add input validation
|
|
109
|
-
|
|
110
|
-
---
|
|
111
|
-
|
|
112
|
-
## MODE-SPECIFIC SECTIONS
|
|
113
|
-
|
|
114
|
-
### API MODE (500 Errors)
|
|
115
|
-
- Request/Response analysis
|
|
116
|
-
- Auth validation
|
|
117
|
-
- Middleware chain trace
|
|
118
|
-
- Connection pool status
|
|
119
|
-
|
|
120
|
-
### DB MODE (Connection Issues)
|
|
121
|
-
```sql
|
|
122
|
-
-- Active connections
|
|
123
|
-
SELECT * FROM pg_stat_activity;
|
|
124
|
-
|
|
125
|
-
-- Long running queries
|
|
126
|
-
SELECT pid, now() - pg_stat_activity.query_start AS duration, query
|
|
127
|
-
FROM pg_stat_activity
|
|
128
|
-
WHERE state != 'idle'
|
|
129
|
-
ORDER BY duration DESC;
|
|
130
|
-
|
|
131
|
-
-- Kill stuck query
|
|
132
|
-
SELECT pg_terminate_backend(pid);
|
|
133
|
-
```
|
|
134
|
-
|
|
135
|
-
### CI MODE (Pipeline Failures)
|
|
136
|
-
- Workflow file analysis
|
|
137
|
-
- Dependency check
|
|
138
|
-
- Cache invalidation
|
|
139
|
-
- Environment variables
|
|
140
|
-
|
|
141
|
-
### PERF MODE (Performance)
|
|
142
|
-
```sql
|
|
143
|
-
-- EXPLAIN ANALYZE
|
|
144
|
-
EXPLAIN ANALYZE SELECT ...;
|
|
145
|
-
```
|
|
146
|
-
- N+1 query detection
|
|
147
|
-
- Missing index identification
|
|
148
|
-
- Memory/CPU profiling
|
|
149
|
-
|
|
150
|
-
---
|
|
151
|
-
|
|
152
|
-
## PRO TIPS
|
|
153
|
-
- **Collect context first** - errors, timestamps, recent deploys
|
|
154
|
-
- **Check usual suspects** - deploys, config, migrations
|
|
155
|
-
- **Validate in staging** - test fix before prod
|
|
156
|
-
- **Save as runbook** - reuse for similar issues
|
|
157
|
-
|
|
158
|
-
> **Key Takeaway:** Turns hours of troubleshooting into 30-minute structured analysis.
|
|
159
|
-
"""
|
|
160
|
-
|
|
161
|
-
# ---
|
|
162
|
-
# USAGE:
|
|
163
|
-
# /debug POST /api/orders returning 500 after v2.3.4 deploy
|
|
164
|
-
# /debug PostgreSQL pool exhausted, 47/20 connections
|
|
165
|
-
# /debug CI build failing on test step, Module not found
|
|
166
|
-
# /debug API latency increased from 200ms to 3s
|
|
1
|
+
description = "Debug and fix issues with structured analysis (Debugger Agent)"
|
|
2
|
+
|
|
3
|
+
prompt = """
|
|
4
|
+
# 🐛 DEBUGGER AGENT
|
|
5
|
+
|
|
6
|
+
Debug issue:
|
|
7
|
+
|
|
8
|
+
**Issue:** {{args}}
|
|
9
|
+
|
|
10
|
+
## MODE DETECTION
|
|
11
|
+
|
|
12
|
+
| Mode | Trigger | Features |
|
|
13
|
+
|------|---------|----------|
|
|
14
|
+
| **API** | "500", "error", "response", "endpoint" | Root cause, fix, rollback |
|
|
15
|
+
| **DB** | "connection", "pool", "query", "timeout" | Leak detection, kill commands |
|
|
16
|
+
| **CI** | "ci", "actions", "pipeline", "build" | Workflow analysis, fix |
|
|
17
|
+
| **PERF** | "slow", "latency", "performance", "degradation" | N+1, EXPLAIN, optimization |
|
|
18
|
+
| **GENERAL** | default | Standard debug flow |
|
|
19
|
+
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
## DEBUG REPORT FORMAT (Runbook)
|
|
23
|
+
|
|
24
|
+
### 📋 Issue Summary
|
|
25
|
+
- **Symptom:** [What's happening]
|
|
26
|
+
- **Started:** [When/after what change]
|
|
27
|
+
- **Severity:** Critical / High / Medium / Low
|
|
28
|
+
- **Affected:** [Users, services, endpoints]
|
|
29
|
+
|
|
30
|
+
---
|
|
31
|
+
|
|
32
|
+
### 🔍 Investigation
|
|
33
|
+
|
|
34
|
+
#### Logs Analysis
|
|
35
|
+
```
|
|
36
|
+
[Key error logs]
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
#### Recent Changes
|
|
40
|
+
- [Deploy/commit that may have caused this]
|
|
41
|
+
- [Config changes]
|
|
42
|
+
- [Dependency updates]
|
|
43
|
+
|
|
44
|
+
---
|
|
45
|
+
|
|
46
|
+
### 🎯 Root Cause
|
|
47
|
+
[Clear explanation of why this is happening]
|
|
48
|
+
|
|
49
|
+
---
|
|
50
|
+
|
|
51
|
+
### 🔧 Fix Plan
|
|
52
|
+
|
|
53
|
+
#### Step 1: [Immediate mitigation]
|
|
54
|
+
```bash
|
|
55
|
+
# Command to run
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
#### Step 2: [Code fix]
|
|
59
|
+
```typescript
|
|
60
|
+
// Before
|
|
61
|
+
[broken code]
|
|
62
|
+
|
|
63
|
+
// After
|
|
64
|
+
[fixed code]
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
#### Step 3: [Validation]
|
|
68
|
+
```bash
|
|
69
|
+
# Test the fix
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
---
|
|
73
|
+
|
|
74
|
+
### ⏪ Rollback Steps
|
|
75
|
+
If fix doesn't work:
|
|
76
|
+
1. [Rollback step 1]
|
|
77
|
+
2. [Rollback step 2]
|
|
78
|
+
```bash
|
|
79
|
+
# Rollback command
|
|
80
|
+
git revert [commit]
|
|
81
|
+
# or
|
|
82
|
+
kubectl rollout undo deployment/[name]
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
---
|
|
86
|
+
|
|
87
|
+
### ✅ Validation Commands
|
|
88
|
+
```bash
|
|
89
|
+
# Verify fix worked
|
|
90
|
+
curl -X POST https://api.example.com/endpoint
|
|
91
|
+
# Expected: 200 OK
|
|
92
|
+
|
|
93
|
+
# Check logs
|
|
94
|
+
tail -f /var/log/app.log | grep ERROR
|
|
95
|
+
# Expected: No new errors
|
|
96
|
+
|
|
97
|
+
# Monitor metrics
|
|
98
|
+
# Expected: Error rate < 0.1%
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
---
|
|
102
|
+
|
|
103
|
+
### 🛡️ Prevention
|
|
104
|
+
To prevent this in future:
|
|
105
|
+
- [ ] Add test case for this scenario
|
|
106
|
+
- [ ] Add monitoring alert
|
|
107
|
+
- [ ] Update documentation
|
|
108
|
+
- [ ] Add input validation
|
|
109
|
+
|
|
110
|
+
---
|
|
111
|
+
|
|
112
|
+
## MODE-SPECIFIC SECTIONS
|
|
113
|
+
|
|
114
|
+
### API MODE (500 Errors)
|
|
115
|
+
- Request/Response analysis
|
|
116
|
+
- Auth validation
|
|
117
|
+
- Middleware chain trace
|
|
118
|
+
- Connection pool status
|
|
119
|
+
|
|
120
|
+
### DB MODE (Connection Issues)
|
|
121
|
+
```sql
|
|
122
|
+
-- Active connections
|
|
123
|
+
SELECT * FROM pg_stat_activity;
|
|
124
|
+
|
|
125
|
+
-- Long running queries
|
|
126
|
+
SELECT pid, now() - pg_stat_activity.query_start AS duration, query
|
|
127
|
+
FROM pg_stat_activity
|
|
128
|
+
WHERE state != 'idle'
|
|
129
|
+
ORDER BY duration DESC;
|
|
130
|
+
|
|
131
|
+
-- Kill stuck query
|
|
132
|
+
SELECT pg_terminate_backend(pid);
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
### CI MODE (Pipeline Failures)
|
|
136
|
+
- Workflow file analysis
|
|
137
|
+
- Dependency check
|
|
138
|
+
- Cache invalidation
|
|
139
|
+
- Environment variables
|
|
140
|
+
|
|
141
|
+
### PERF MODE (Performance)
|
|
142
|
+
```sql
|
|
143
|
+
-- EXPLAIN ANALYZE
|
|
144
|
+
EXPLAIN ANALYZE SELECT ...;
|
|
145
|
+
```
|
|
146
|
+
- N+1 query detection
|
|
147
|
+
- Missing index identification
|
|
148
|
+
- Memory/CPU profiling
|
|
149
|
+
|
|
150
|
+
---
|
|
151
|
+
|
|
152
|
+
## PRO TIPS
|
|
153
|
+
- **Collect context first** - errors, timestamps, recent deploys
|
|
154
|
+
- **Check usual suspects** - deploys, config, migrations
|
|
155
|
+
- **Validate in staging** - test fix before prod
|
|
156
|
+
- **Save as runbook** - reuse for similar issues
|
|
157
|
+
|
|
158
|
+
> **Key Takeaway:** Turns hours of troubleshooting into 30-minute structured analysis.
|
|
159
|
+
"""
|
|
160
|
+
|
|
161
|
+
# ---
|
|
162
|
+
# USAGE:
|
|
163
|
+
# /debug POST /api/orders returning 500 after v2.3.4 deploy
|
|
164
|
+
# /debug PostgreSQL pool exhausted, 47/20 connections
|
|
165
|
+
# /debug CI build failing on test step, Module not found
|
|
166
|
+
# /debug API latency increased from 200ms to 3s
|
|
167
167
|
# ---
|
package/commands/design.toml
CHANGED
|
@@ -1,159 +1,159 @@
|
|
|
1
|
-
description = "Design UI/UX with multiple modes (Designer Agent)"
|
|
2
|
-
|
|
3
|
-
prompt = """
|
|
4
|
-
# 🎨 DESIGNER AGENT
|
|
5
|
-
|
|
6
|
-
Design request:
|
|
7
|
-
|
|
8
|
-
**Task:** {{args}}
|
|
9
|
-
|
|
10
|
-
## MODE DETECTION
|
|
11
|
-
|
|
12
|
-
| Mode | Trigger | Speed | Output |
|
|
13
|
-
|------|---------|-------|--------|
|
|
14
|
-
| **FAST** | "fast", "quick" | 60-120s | Rapid mockup |
|
|
15
|
-
| **GOOD** | "good", "production" | 3-5min | Production-ready |
|
|
16
|
-
| **UI** | "ui", "visual" | 2-3min | Wireframes, layout |
|
|
17
|
-
| **UX** | "ux", "flow" | 2-3min | User flows |
|
|
18
|
-
| **3D** | "3d", "three" | 3-5min | Three.js scene |
|
|
19
|
-
| **DESCRIBE** | "describe", "extract" | 1min | Extract from image |
|
|
20
|
-
| **AUDIT** | "audit", "wcag" | 2min | Accessibility check |
|
|
21
|
-
| **SYSTEM** | "system", "tokens" | 3min | Design tokens |
|
|
22
|
-
|
|
23
|
-
---
|
|
24
|
-
|
|
25
|
-
## FAST MODE - Rapid Prototyping (60-120s)
|
|
26
|
-
Quick mockup with:
|
|
27
|
-
- Basic layout structure
|
|
28
|
-
- Placeholder content
|
|
29
|
-
- Core components only
|
|
30
|
-
|
|
31
|
-
## GOOD MODE - Production Ready (3-5min)
|
|
32
|
-
Full implementation with:
|
|
33
|
-
- Semantic HTML
|
|
34
|
-
- Responsive breakpoints
|
|
35
|
-
- Accessibility
|
|
36
|
-
- Animations
|
|
37
|
-
|
|
38
|
-
---
|
|
39
|
-
|
|
40
|
-
## 3D MODE - Three.js Scene
|
|
41
|
-
|
|
42
|
-
```javascript
|
|
43
|
-
// Three.js setup
|
|
44
|
-
const scene = new THREE.Scene();
|
|
45
|
-
const camera = new THREE.PerspectiveCamera(75, w/h, 0.1, 1000);
|
|
46
|
-
|
|
47
|
-
// Orbit controls
|
|
48
|
-
const controls = new OrbitControls(camera, renderer.domElement);
|
|
49
|
-
|
|
50
|
-
// PBR Materials + HDR Lighting
|
|
51
|
-
const material = new THREE.MeshStandardMaterial({
|
|
52
|
-
map: texture,
|
|
53
|
-
roughness: 0.5,
|
|
54
|
-
metalness: 0.3
|
|
55
|
-
});
|
|
56
|
-
```
|
|
57
|
-
|
|
58
|
-
**Output:** 360° rotation, zoom/pan, color variants
|
|
59
|
-
|
|
60
|
-
---
|
|
61
|
-
|
|
62
|
-
## DESCRIBE MODE - Extract from Image
|
|
63
|
-
|
|
64
|
-
**Input:** Screenshot/image path
|
|
65
|
-
**Output:**
|
|
66
|
-
| Property | Value |
|
|
67
|
-
|----------|-------|
|
|
68
|
-
| Primary Color | #3B82F6 |
|
|
69
|
-
| Secondary | #10B981 |
|
|
70
|
-
| Font | Inter |
|
|
71
|
-
| Heading Size | 48px |
|
|
72
|
-
| Spacing | 8px grid |
|
|
73
|
-
| Border Radius | 8px |
|
|
74
|
-
|
|
75
|
-
---
|
|
76
|
-
|
|
77
|
-
## CRO BEST PRACTICES (Built-in)
|
|
78
|
-
|
|
79
|
-
### Above the Fold
|
|
80
|
-
- [ ] Clear headline
|
|
81
|
-
- [ ] Primary CTA visible
|
|
82
|
-
- [ ] Social proof (logos/testimonials)
|
|
83
|
-
- [ ] Trust signals (security badges)
|
|
84
|
-
|
|
85
|
-
### Layout Patterns
|
|
86
|
-
- **Bento Grid:** Mixed-size cards (Apple/Linear style)
|
|
87
|
-
- **Glassmorphism:** `backdrop-blur-md bg-white/10`
|
|
88
|
-
- **Sticky Nav:** Fixed header on scroll
|
|
89
|
-
|
|
90
|
-
---
|
|
91
|
-
|
|
92
|
-
## CORE WEB VITALS TARGETS
|
|
93
|
-
|
|
94
|
-
| Metric | Target | How |
|
|
95
|
-
|--------|--------|-----|
|
|
96
|
-
| **LCP** | <2.5s | Lazy loading, optimized images |
|
|
97
|
-
| **FID** | <100ms | Minimal JS, async loading |
|
|
98
|
-
| **CLS** | <0.1 | Reserved space, font-display |
|
|
99
|
-
|
|
100
|
-
---
|
|
101
|
-
|
|
102
|
-
## VISUAL SPECS (UI Mode)
|
|
103
|
-
```ascii
|
|
104
|
-
+-----------------------------------+
|
|
105
|
-
| [Logo] [Profile] |
|
|
106
|
-
|-----------------------------------|
|
|
107
|
-
| Hero Title |
|
|
108
|
-
| [ CTA Button ] |
|
|
109
|
-
|-----------------------------------|
|
|
110
|
-
| [Card 1] [Card 2] [Card 3] |
|
|
111
|
-
+-----------------------------------+
|
|
112
|
-
```
|
|
113
|
-
|
|
114
|
-
---
|
|
115
|
-
|
|
116
|
-
## USER FLOW (UX Mode)
|
|
117
|
-
```mermaid
|
|
118
|
-
graph TD
|
|
119
|
-
A[Start] --> B{Condition}
|
|
120
|
-
B -- Yes --> C[Screen 1]
|
|
121
|
-
B -- No --> D[Screen 2]
|
|
122
|
-
C --> E[End]
|
|
123
|
-
```
|
|
124
|
-
|
|
125
|
-
---
|
|
126
|
-
|
|
127
|
-
## COMPONENT SPECS (System Mode)
|
|
128
|
-
```typescript
|
|
129
|
-
interface ButtonProps {
|
|
130
|
-
variant: 'primary' | 'secondary' | 'ghost';
|
|
131
|
-
size: 'sm' | 'md' | 'lg';
|
|
132
|
-
}
|
|
133
|
-
```
|
|
134
|
-
**Tailwind:**
|
|
135
|
-
- Primary: `bg-blue-600 hover:bg-blue-700 text-white`
|
|
136
|
-
- Bento: `grid grid-cols-4 gap-4 auto-rows-[200px]`
|
|
137
|
-
- Glass: `backdrop-blur-md bg-white/10 border border-white/20`
|
|
138
|
-
|
|
139
|
-
---
|
|
140
|
-
|
|
141
|
-
## ACCESSIBILITY (Audit Mode)
|
|
142
|
-
- [ ] Color Contrast AA/AAA
|
|
143
|
-
- [ ] Focus States
|
|
144
|
-
- [ ] Semantic HTML
|
|
145
|
-
- [ ] ARIA Labels
|
|
146
|
-
- [ ] Keyboard Navigation
|
|
147
|
-
|
|
148
|
-
> **Key Takeaway:** Ship award-winning interfaces in minutes. WCAG + Lighthouse 90+ out of the box.
|
|
149
|
-
"""
|
|
150
|
-
|
|
151
|
-
# ---
|
|
152
|
-
# USAGE:
|
|
153
|
-
# /design fast landing page
|
|
154
|
-
# /design good dashboard with charts
|
|
155
|
-
# /design 3d product viewer
|
|
156
|
-
# /design describe ./screenshot.png
|
|
157
|
-
# /design audit login page
|
|
158
|
-
# /design system button component
|
|
1
|
+
description = "Design UI/UX with multiple modes (Designer Agent)"
|
|
2
|
+
|
|
3
|
+
prompt = """
|
|
4
|
+
# 🎨 DESIGNER AGENT
|
|
5
|
+
|
|
6
|
+
Design request:
|
|
7
|
+
|
|
8
|
+
**Task:** {{args}}
|
|
9
|
+
|
|
10
|
+
## MODE DETECTION
|
|
11
|
+
|
|
12
|
+
| Mode | Trigger | Speed | Output |
|
|
13
|
+
|------|---------|-------|--------|
|
|
14
|
+
| **FAST** | "fast", "quick" | 60-120s | Rapid mockup |
|
|
15
|
+
| **GOOD** | "good", "production" | 3-5min | Production-ready |
|
|
16
|
+
| **UI** | "ui", "visual" | 2-3min | Wireframes, layout |
|
|
17
|
+
| **UX** | "ux", "flow" | 2-3min | User flows |
|
|
18
|
+
| **3D** | "3d", "three" | 3-5min | Three.js scene |
|
|
19
|
+
| **DESCRIBE** | "describe", "extract" | 1min | Extract from image |
|
|
20
|
+
| **AUDIT** | "audit", "wcag" | 2min | Accessibility check |
|
|
21
|
+
| **SYSTEM** | "system", "tokens" | 3min | Design tokens |
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
## FAST MODE - Rapid Prototyping (60-120s)
|
|
26
|
+
Quick mockup with:
|
|
27
|
+
- Basic layout structure
|
|
28
|
+
- Placeholder content
|
|
29
|
+
- Core components only
|
|
30
|
+
|
|
31
|
+
## GOOD MODE - Production Ready (3-5min)
|
|
32
|
+
Full implementation with:
|
|
33
|
+
- Semantic HTML
|
|
34
|
+
- Responsive breakpoints
|
|
35
|
+
- Accessibility
|
|
36
|
+
- Animations
|
|
37
|
+
|
|
38
|
+
---
|
|
39
|
+
|
|
40
|
+
## 3D MODE - Three.js Scene
|
|
41
|
+
|
|
42
|
+
```javascript
|
|
43
|
+
// Three.js setup
|
|
44
|
+
const scene = new THREE.Scene();
|
|
45
|
+
const camera = new THREE.PerspectiveCamera(75, w/h, 0.1, 1000);
|
|
46
|
+
|
|
47
|
+
// Orbit controls
|
|
48
|
+
const controls = new OrbitControls(camera, renderer.domElement);
|
|
49
|
+
|
|
50
|
+
// PBR Materials + HDR Lighting
|
|
51
|
+
const material = new THREE.MeshStandardMaterial({
|
|
52
|
+
map: texture,
|
|
53
|
+
roughness: 0.5,
|
|
54
|
+
metalness: 0.3
|
|
55
|
+
});
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
**Output:** 360° rotation, zoom/pan, color variants
|
|
59
|
+
|
|
60
|
+
---
|
|
61
|
+
|
|
62
|
+
## DESCRIBE MODE - Extract from Image
|
|
63
|
+
|
|
64
|
+
**Input:** Screenshot/image path
|
|
65
|
+
**Output:**
|
|
66
|
+
| Property | Value |
|
|
67
|
+
|----------|-------|
|
|
68
|
+
| Primary Color | #3B82F6 |
|
|
69
|
+
| Secondary | #10B981 |
|
|
70
|
+
| Font | Inter |
|
|
71
|
+
| Heading Size | 48px |
|
|
72
|
+
| Spacing | 8px grid |
|
|
73
|
+
| Border Radius | 8px |
|
|
74
|
+
|
|
75
|
+
---
|
|
76
|
+
|
|
77
|
+
## CRO BEST PRACTICES (Built-in)
|
|
78
|
+
|
|
79
|
+
### Above the Fold
|
|
80
|
+
- [ ] Clear headline
|
|
81
|
+
- [ ] Primary CTA visible
|
|
82
|
+
- [ ] Social proof (logos/testimonials)
|
|
83
|
+
- [ ] Trust signals (security badges)
|
|
84
|
+
|
|
85
|
+
### Layout Patterns
|
|
86
|
+
- **Bento Grid:** Mixed-size cards (Apple/Linear style)
|
|
87
|
+
- **Glassmorphism:** `backdrop-blur-md bg-white/10`
|
|
88
|
+
- **Sticky Nav:** Fixed header on scroll
|
|
89
|
+
|
|
90
|
+
---
|
|
91
|
+
|
|
92
|
+
## CORE WEB VITALS TARGETS
|
|
93
|
+
|
|
94
|
+
| Metric | Target | How |
|
|
95
|
+
|--------|--------|-----|
|
|
96
|
+
| **LCP** | <2.5s | Lazy loading, optimized images |
|
|
97
|
+
| **FID** | <100ms | Minimal JS, async loading |
|
|
98
|
+
| **CLS** | <0.1 | Reserved space, font-display |
|
|
99
|
+
|
|
100
|
+
---
|
|
101
|
+
|
|
102
|
+
## VISUAL SPECS (UI Mode)
|
|
103
|
+
```ascii
|
|
104
|
+
+-----------------------------------+
|
|
105
|
+
| [Logo] [Profile] |
|
|
106
|
+
|-----------------------------------|
|
|
107
|
+
| Hero Title |
|
|
108
|
+
| [ CTA Button ] |
|
|
109
|
+
|-----------------------------------|
|
|
110
|
+
| [Card 1] [Card 2] [Card 3] |
|
|
111
|
+
+-----------------------------------+
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
---
|
|
115
|
+
|
|
116
|
+
## USER FLOW (UX Mode)
|
|
117
|
+
```mermaid
|
|
118
|
+
graph TD
|
|
119
|
+
A[Start] --> B{Condition}
|
|
120
|
+
B -- Yes --> C[Screen 1]
|
|
121
|
+
B -- No --> D[Screen 2]
|
|
122
|
+
C --> E[End]
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
---
|
|
126
|
+
|
|
127
|
+
## COMPONENT SPECS (System Mode)
|
|
128
|
+
```typescript
|
|
129
|
+
interface ButtonProps {
|
|
130
|
+
variant: 'primary' | 'secondary' | 'ghost';
|
|
131
|
+
size: 'sm' | 'md' | 'lg';
|
|
132
|
+
}
|
|
133
|
+
```
|
|
134
|
+
**Tailwind:**
|
|
135
|
+
- Primary: `bg-blue-600 hover:bg-blue-700 text-white`
|
|
136
|
+
- Bento: `grid grid-cols-4 gap-4 auto-rows-[200px]`
|
|
137
|
+
- Glass: `backdrop-blur-md bg-white/10 border border-white/20`
|
|
138
|
+
|
|
139
|
+
---
|
|
140
|
+
|
|
141
|
+
## ACCESSIBILITY (Audit Mode)
|
|
142
|
+
- [ ] Color Contrast AA/AAA
|
|
143
|
+
- [ ] Focus States
|
|
144
|
+
- [ ] Semantic HTML
|
|
145
|
+
- [ ] ARIA Labels
|
|
146
|
+
- [ ] Keyboard Navigation
|
|
147
|
+
|
|
148
|
+
> **Key Takeaway:** Ship award-winning interfaces in minutes. WCAG + Lighthouse 90+ out of the box.
|
|
149
|
+
"""
|
|
150
|
+
|
|
151
|
+
# ---
|
|
152
|
+
# USAGE:
|
|
153
|
+
# /design fast landing page
|
|
154
|
+
# /design good dashboard with charts
|
|
155
|
+
# /design 3d product viewer
|
|
156
|
+
# /design describe ./screenshot.png
|
|
157
|
+
# /design audit login page
|
|
158
|
+
# /design system button component
|
|
159
159
|
# ---
|
package/commands/dev-rules.toml
CHANGED
|
@@ -1,14 +1,14 @@
|
|
|
1
|
-
description = "View development rules and coding standards"
|
|
2
|
-
|
|
3
|
-
prompt = """
|
|
4
|
-
You are a Development Standards Expert. Read and explain the development rules.
|
|
5
|
-
|
|
6
|
-
@{skills/workflows/development-rules.md}
|
|
7
|
-
|
|
8
|
-
Based on the rules above, help the user with: {{args}}
|
|
9
|
-
|
|
10
|
-
If no specific question, summarize the key rules:
|
|
11
|
-
1. Code Quality Standards
|
|
12
|
-
2. Pre-commit Procedures
|
|
13
|
-
3. Subagent Orchestration patterns
|
|
14
|
-
"""
|
|
1
|
+
description = "View development rules and coding standards"
|
|
2
|
+
|
|
3
|
+
prompt = """
|
|
4
|
+
You are a Development Standards Expert. Read and explain the development rules.
|
|
5
|
+
|
|
6
|
+
@{skills/workflows/development-rules.md}
|
|
7
|
+
|
|
8
|
+
Based on the rules above, help the user with: {{args}}
|
|
9
|
+
|
|
10
|
+
If no specific question, summarize the key rules:
|
|
11
|
+
1. Code Quality Standards
|
|
12
|
+
2. Pre-commit Procedures
|
|
13
|
+
3. Subagent Orchestration patterns
|
|
14
|
+
"""
|