superkit-mcp-server 1.2.4 → 1.2.6

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.
Files changed (162) hide show
  1. package/ARCHITECTURE.md +102 -102
  2. package/README.md +71 -71
  3. package/SUPERKIT.md +168 -168
  4. package/agents/code-archaeologist.md +106 -106
  5. package/agents/coder.md +90 -90
  6. package/agents/data-engineer.md +28 -28
  7. package/agents/devops-engineer.md +242 -242
  8. package/agents/git-manager.md +203 -203
  9. package/agents/orchestrator.md +420 -420
  10. package/agents/penetration-tester.md +188 -188
  11. package/agents/performance-optimizer.md +187 -187
  12. package/agents/planner.md +270 -270
  13. package/agents/qa-automation-engineer.md +103 -103
  14. package/agents/quant-developer.md +32 -32
  15. package/agents/reviewer.md +100 -100
  16. package/agents/scout.md +222 -222
  17. package/agents/tester.md +274 -274
  18. package/agents/ui-designer.md +208 -208
  19. package/build/__tests__/test_apply_prompt_args.js +104 -0
  20. package/build/index.js +106 -45
  21. package/build/tools/todoTools.js +39 -39
  22. package/build/tools/validators/__tests__/apiSchema.test.js +23 -23
  23. package/build/tools/validators/__tests__/convertRules.test.js +5 -5
  24. package/build/tools/validators/__tests__/frontendDesign.test.js +12 -12
  25. package/build/tools/validators/__tests__/geoChecker.test.js +19 -19
  26. package/build/tools/validators/__tests__/mobileAudit.test.js +12 -12
  27. package/build/tools/validators/__tests__/reactPerformanceChecker.test.js +17 -17
  28. package/build/tools/validators/__tests__/securityScan.test.js +6 -6
  29. package/build/tools/validators/__tests__/seoChecker.test.js +16 -16
  30. package/build/tools/validators/__tests__/typeCoverage.test.js +14 -14
  31. package/commands/README.md +122 -122
  32. package/commands/ask.toml +72 -72
  33. package/commands/brainstorm.toml +119 -119
  34. package/commands/chat.toml +77 -77
  35. package/commands/code-preview.toml +37 -37
  36. package/commands/code.toml +28 -28
  37. package/commands/content.toml +200 -200
  38. package/commands/cook.toml +77 -77
  39. package/commands/copywrite.toml +131 -131
  40. package/commands/db.toml +192 -192
  41. package/commands/debug.toml +166 -166
  42. package/commands/design.toml +158 -158
  43. package/commands/dev-rules.toml +14 -14
  44. package/commands/do.toml +117 -117
  45. package/commands/doc-rules.toml +14 -14
  46. package/commands/docs.toml +148 -148
  47. package/commands/fix.toml +440 -440
  48. package/commands/fullstack.toml +175 -175
  49. package/commands/git.toml +235 -235
  50. package/commands/help.toml +84 -84
  51. package/commands/integrate.toml +127 -127
  52. package/commands/journal.toml +136 -136
  53. package/commands/kit-setup.toml +40 -40
  54. package/commands/mcp.toml +183 -183
  55. package/commands/orchestration.toml +15 -15
  56. package/commands/plan.toml +206 -172
  57. package/commands/pm.toml +148 -148
  58. package/commands/pr.toml +50 -50
  59. package/commands/project.toml +32 -32
  60. package/commands/research.toml +117 -117
  61. package/commands/review-pr.toml +63 -63
  62. package/commands/review.toml +190 -190
  63. package/commands/scout-ext.toml +97 -97
  64. package/commands/scout.toml +79 -79
  65. package/commands/screenshot.toml +65 -65
  66. package/commands/session.toml +102 -102
  67. package/commands/skill.toml +384 -384
  68. package/commands/status.toml +22 -22
  69. package/commands/team.toml +56 -56
  70. package/commands/test.toml +164 -164
  71. package/commands/ticket.toml +70 -70
  72. package/commands/use.toml +106 -106
  73. package/commands/video.toml +83 -83
  74. package/commands/watzup.toml +71 -71
  75. package/commands/workflow.toml +14 -14
  76. package/package.json +35 -35
  77. package/skills/meta/README.md +30 -30
  78. package/skills/meta/api-design/SKILL.md +134 -134
  79. package/skills/meta/code-review/SKILL.md +44 -44
  80. package/skills/meta/code-review/checklists/pre-merge.md +25 -25
  81. package/skills/meta/code-review/workflows/architecture-pass.md +26 -26
  82. package/skills/meta/code-review/workflows/performance-pass.md +27 -27
  83. package/skills/meta/code-review/workflows/security-pass.md +29 -29
  84. package/skills/meta/compound-docs/SKILL.md +133 -133
  85. package/skills/meta/debug/SKILL.md +40 -40
  86. package/skills/meta/debug/templates/bug-report.template.md +31 -31
  87. package/skills/meta/debug/workflows/reproduce-issue.md +20 -20
  88. package/skills/meta/docker/SKILL.md +126 -126
  89. package/skills/meta/examples/supabase/SKILL.md +46 -46
  90. package/skills/meta/examples/supabase/references/best-practices.md +319 -319
  91. package/skills/meta/examples/supabase/references/common-patterns.md +373 -373
  92. package/skills/meta/examples/supabase/templates/migration-template.sql +49 -49
  93. package/skills/meta/examples/supabase/templates/rls-policy-template.sql +77 -77
  94. package/skills/meta/examples/supabase/workflows/debugging.md +260 -260
  95. package/skills/meta/examples/supabase/workflows/migration-workflow.md +211 -211
  96. package/skills/meta/examples/supabase/workflows/rls-policies.md +244 -244
  97. package/skills/meta/examples/supabase/workflows/schema-design.md +321 -321
  98. package/skills/meta/file-todos/SKILL.md +88 -88
  99. package/skills/meta/mobile/SKILL.md +140 -140
  100. package/skills/meta/nextjs/SKILL.md +101 -101
  101. package/skills/meta/performance/SKILL.md +130 -130
  102. package/skills/meta/react-patterns/SKILL.md +83 -83
  103. package/skills/meta/security/SKILL.md +114 -114
  104. package/skills/meta/session-resume/SKILL.md +96 -96
  105. package/skills/meta/tailwind/SKILL.md +139 -139
  106. package/skills/meta/testing/SKILL.md +43 -43
  107. package/skills/meta/testing/references/vitest-patterns.md +45 -45
  108. package/skills/meta/testing/templates/component-test.template.tsx +37 -37
  109. package/skills/tech/alpha-vantage/SKILL.md +142 -142
  110. package/skills/tech/alpha-vantage/references/commodities.md +153 -153
  111. package/skills/tech/alpha-vantage/references/economic-indicators.md +158 -158
  112. package/skills/tech/alpha-vantage/references/forex-crypto.md +154 -154
  113. package/skills/tech/alpha-vantage/references/fundamentals.md +223 -223
  114. package/skills/tech/alpha-vantage/references/intelligence.md +138 -138
  115. package/skills/tech/alpha-vantage/references/options.md +93 -93
  116. package/skills/tech/alpha-vantage/references/technical-indicators.md +374 -374
  117. package/skills/tech/alpha-vantage/references/time-series.md +157 -157
  118. package/skills/tech/financial-modeling/SKILL.md +18 -18
  119. package/skills/tech/financial-modeling/skills/3-statements/SKILL.md +368 -368
  120. package/skills/tech/financial-modeling/skills/3-statements/references/formatting.md +118 -118
  121. package/skills/tech/financial-modeling/skills/3-statements/references/formulas.md +292 -292
  122. package/skills/tech/financial-modeling/skills/3-statements/references/sec-filings.md +125 -125
  123. package/skills/tech/financial-modeling/skills/dcf-model/SKILL.md +1210 -1210
  124. package/skills/tech/financial-modeling/skills/dcf-model/TROUBLESHOOTING.md +40 -40
  125. package/skills/tech/financial-modeling/skills/dcf-model/requirements.txt +8 -8
  126. package/skills/tech/financial-modeling/skills/dcf-model/scripts/validate_dcf.py +292 -292
  127. package/skills/tech/financial-modeling/skills/lbo-model/SKILL.md +236 -236
  128. package/skills/tech/financial-modeling/skills/merger-model/SKILL.md +108 -108
  129. package/skills/workflows/README.md +203 -203
  130. package/skills/workflows/adr.md +174 -174
  131. package/skills/workflows/changelog.md +74 -74
  132. package/skills/workflows/compound.md +323 -323
  133. package/skills/workflows/compound_health.md +74 -74
  134. package/skills/workflows/create-agent-skill.md +138 -138
  135. package/skills/workflows/cycle.md +144 -144
  136. package/skills/workflows/deploy-docs.md +84 -84
  137. package/skills/workflows/development-rules.md +42 -42
  138. package/skills/workflows/doc.md +95 -95
  139. package/skills/workflows/documentation-management.md +34 -34
  140. package/skills/workflows/explore.md +146 -146
  141. package/skills/workflows/generate_command.md +106 -106
  142. package/skills/workflows/heal-skill.md +97 -97
  143. package/skills/workflows/housekeeping.md +229 -229
  144. package/skills/workflows/kit-setup.md +102 -102
  145. package/skills/workflows/map-codebase.md +78 -78
  146. package/skills/workflows/orchestration-protocol.md +43 -43
  147. package/skills/workflows/plan-compound.md +439 -439
  148. package/skills/workflows/plan_review.md +269 -269
  149. package/skills/workflows/primary-workflow.md +37 -37
  150. package/skills/workflows/promote_pattern.md +86 -86
  151. package/skills/workflows/release-docs.md +82 -82
  152. package/skills/workflows/report-bug.md +135 -135
  153. package/skills/workflows/reproduce-bug.md +118 -118
  154. package/skills/workflows/resolve_pr.md +133 -133
  155. package/skills/workflows/resolve_todo.md +128 -128
  156. package/skills/workflows/review-compound.md +376 -376
  157. package/skills/workflows/skill-review.md +127 -127
  158. package/skills/workflows/specs.md +257 -257
  159. package/skills/workflows/triage-sprint.md +102 -102
  160. package/skills/workflows/triage.md +152 -152
  161. package/skills/workflows/work.md +399 -399
  162. package/skills/workflows/xcode-test.md +93 -93
@@ -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
  # ---
@@ -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
  # ---
@@ -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
+ """