superkit-mcp-server 1.2.1 → 1.2.3

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 (170) 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/security-auditor.md +3 -2
  18. package/agents/tester.md +274 -274
  19. package/agents/ui-designer.md +208 -208
  20. package/build/index.js +21 -2
  21. package/build/tools/__tests__/loggerTools.test.js +5 -5
  22. package/build/tools/archTools.js +2 -19
  23. package/build/tools/autoPreview.js +2 -2
  24. package/build/tools/compoundTools.js +4 -4
  25. package/build/tools/docsTools.js +5 -10
  26. package/build/tools/loggerTools.js +1 -1
  27. package/build/tools/todoTools.js +39 -39
  28. package/build/tools/validators/__tests__/apiSchema.test.js +23 -23
  29. package/build/tools/validators/__tests__/convertRules.test.js +5 -5
  30. package/build/tools/validators/__tests__/frontendDesign.test.js +12 -12
  31. package/build/tools/validators/__tests__/geoChecker.test.js +19 -19
  32. package/build/tools/validators/__tests__/mobileAudit.test.js +12 -12
  33. package/build/tools/validators/__tests__/reactPerformanceChecker.test.js +17 -17
  34. package/build/tools/validators/__tests__/securityScan.test.js +6 -6
  35. package/build/tools/validators/__tests__/seoChecker.test.js +16 -16
  36. package/build/tools/validators/__tests__/typeCoverage.test.js +14 -14
  37. package/build/tools/validators/convertRules.js +2 -2
  38. package/commands/README.md +122 -122
  39. package/commands/ask.toml +72 -72
  40. package/commands/brainstorm.toml +119 -119
  41. package/commands/chat.toml +77 -77
  42. package/commands/code-preview.toml +37 -37
  43. package/commands/code.toml +28 -28
  44. package/commands/content.toml +200 -200
  45. package/commands/cook.toml +77 -77
  46. package/commands/copywrite.toml +131 -131
  47. package/commands/db.toml +192 -192
  48. package/commands/debug.toml +166 -166
  49. package/commands/design.toml +158 -158
  50. package/commands/dev-rules.toml +14 -14
  51. package/commands/do.toml +117 -117
  52. package/commands/doc-rules.toml +14 -14
  53. package/commands/docs.toml +148 -148
  54. package/commands/fix.toml +440 -440
  55. package/commands/fullstack.toml +175 -175
  56. package/commands/git.toml +235 -235
  57. package/commands/help.toml +84 -84
  58. package/commands/integrate.toml +127 -127
  59. package/commands/journal.toml +136 -136
  60. package/commands/kit-setup.toml +40 -40
  61. package/commands/mcp.toml +183 -183
  62. package/commands/orchestration.toml +15 -15
  63. package/commands/plan.toml +171 -171
  64. package/commands/pm.toml +148 -148
  65. package/commands/pr.toml +50 -50
  66. package/commands/project.toml +32 -32
  67. package/commands/research.toml +117 -117
  68. package/commands/review-pr.toml +63 -63
  69. package/commands/review.toml +190 -190
  70. package/commands/scout-ext.toml +97 -97
  71. package/commands/scout.toml +79 -79
  72. package/commands/screenshot.toml +65 -65
  73. package/commands/session.toml +102 -102
  74. package/commands/skill.toml +384 -384
  75. package/commands/status.toml +22 -22
  76. package/commands/team.toml +56 -56
  77. package/commands/test.toml +164 -164
  78. package/commands/ticket.toml +70 -70
  79. package/commands/use.toml +106 -106
  80. package/commands/video.toml +83 -83
  81. package/commands/watzup.toml +71 -71
  82. package/commands/workflow.toml +14 -14
  83. package/package.json +35 -35
  84. package/skills/meta/README.md +30 -30
  85. package/skills/meta/api-design/SKILL.md +134 -134
  86. package/skills/meta/code-review/SKILL.md +44 -44
  87. package/skills/meta/code-review/checklists/pre-merge.md +25 -25
  88. package/skills/meta/code-review/workflows/architecture-pass.md +26 -26
  89. package/skills/meta/code-review/workflows/performance-pass.md +27 -27
  90. package/skills/meta/code-review/workflows/security-pass.md +29 -29
  91. package/skills/meta/compound-docs/SKILL.md +133 -133
  92. package/skills/meta/debug/SKILL.md +40 -40
  93. package/skills/meta/debug/templates/bug-report.template.md +31 -31
  94. package/skills/meta/debug/workflows/reproduce-issue.md +20 -20
  95. package/skills/meta/docker/SKILL.md +126 -126
  96. package/skills/meta/examples/supabase/SKILL.md +46 -46
  97. package/skills/meta/examples/supabase/references/best-practices.md +319 -319
  98. package/skills/meta/examples/supabase/references/common-patterns.md +373 -373
  99. package/skills/meta/examples/supabase/templates/migration-template.sql +49 -49
  100. package/skills/meta/examples/supabase/templates/rls-policy-template.sql +77 -77
  101. package/skills/meta/examples/supabase/workflows/debugging.md +260 -260
  102. package/skills/meta/examples/supabase/workflows/migration-workflow.md +211 -211
  103. package/skills/meta/examples/supabase/workflows/rls-policies.md +244 -244
  104. package/skills/meta/examples/supabase/workflows/schema-design.md +321 -321
  105. package/skills/meta/file-todos/SKILL.md +88 -88
  106. package/skills/meta/mobile/SKILL.md +140 -140
  107. package/skills/meta/nextjs/SKILL.md +101 -101
  108. package/skills/meta/performance/SKILL.md +130 -130
  109. package/skills/meta/react-patterns/SKILL.md +83 -83
  110. package/skills/meta/security/SKILL.md +114 -114
  111. package/skills/meta/session-resume/SKILL.md +96 -96
  112. package/skills/meta/tailwind/SKILL.md +139 -139
  113. package/skills/meta/testing/SKILL.md +43 -43
  114. package/skills/meta/testing/references/vitest-patterns.md +45 -45
  115. package/skills/meta/testing/templates/component-test.template.tsx +37 -37
  116. package/skills/tech/alpha-vantage/SKILL.md +142 -142
  117. package/skills/tech/alpha-vantage/references/commodities.md +153 -153
  118. package/skills/tech/alpha-vantage/references/economic-indicators.md +158 -158
  119. package/skills/tech/alpha-vantage/references/forex-crypto.md +154 -154
  120. package/skills/tech/alpha-vantage/references/fundamentals.md +223 -223
  121. package/skills/tech/alpha-vantage/references/intelligence.md +138 -138
  122. package/skills/tech/alpha-vantage/references/options.md +93 -93
  123. package/skills/tech/alpha-vantage/references/technical-indicators.md +374 -374
  124. package/skills/tech/alpha-vantage/references/time-series.md +157 -157
  125. package/skills/tech/doc.md +6 -6
  126. package/skills/tech/financial-modeling/SKILL.md +18 -18
  127. package/skills/tech/financial-modeling/skills/3-statements/SKILL.md +368 -368
  128. package/skills/tech/financial-modeling/skills/3-statements/references/formatting.md +118 -118
  129. package/skills/tech/financial-modeling/skills/3-statements/references/formulas.md +292 -292
  130. package/skills/tech/financial-modeling/skills/3-statements/references/sec-filings.md +125 -125
  131. package/skills/tech/financial-modeling/skills/dcf-model/SKILL.md +1210 -1210
  132. package/skills/tech/financial-modeling/skills/dcf-model/TROUBLESHOOTING.md +40 -40
  133. package/skills/tech/financial-modeling/skills/dcf-model/requirements.txt +8 -8
  134. package/skills/tech/financial-modeling/skills/dcf-model/scripts/validate_dcf.py +292 -292
  135. package/skills/tech/financial-modeling/skills/lbo-model/SKILL.md +236 -236
  136. package/skills/tech/financial-modeling/skills/merger-model/SKILL.md +108 -108
  137. package/skills/workflows/README.md +203 -203
  138. package/skills/workflows/adr.md +174 -174
  139. package/skills/workflows/changelog.md +74 -74
  140. package/skills/workflows/compound.md +323 -323
  141. package/skills/workflows/compound_health.md +74 -74
  142. package/skills/workflows/create-agent-skill.md +138 -139
  143. package/skills/workflows/cycle.md +144 -144
  144. package/skills/workflows/deploy-docs.md +84 -84
  145. package/skills/workflows/development-rules.md +42 -42
  146. package/skills/workflows/doc.md +95 -95
  147. package/skills/workflows/documentation-management.md +34 -34
  148. package/skills/workflows/explore.md +146 -146
  149. package/skills/workflows/generate_command.md +106 -106
  150. package/skills/workflows/heal-skill.md +97 -97
  151. package/skills/workflows/housekeeping.md +229 -229
  152. package/skills/workflows/kit-setup.md +102 -102
  153. package/skills/workflows/map-codebase.md +78 -78
  154. package/skills/workflows/orchestration-protocol.md +43 -43
  155. package/skills/workflows/plan-compound.md +439 -439
  156. package/skills/workflows/plan_review.md +269 -269
  157. package/skills/workflows/primary-workflow.md +37 -37
  158. package/skills/workflows/promote_pattern.md +86 -86
  159. package/skills/workflows/release-docs.md +82 -82
  160. package/skills/workflows/report-bug.md +135 -135
  161. package/skills/workflows/reproduce-bug.md +118 -118
  162. package/skills/workflows/resolve_pr.md +133 -133
  163. package/skills/workflows/resolve_todo.md +128 -128
  164. package/skills/workflows/review-compound.md +376 -376
  165. package/skills/workflows/skill-review.md +127 -127
  166. package/skills/workflows/specs.md +257 -257
  167. package/skills/workflows/triage-sprint.md +102 -102
  168. package/skills/workflows/triage.md +152 -152
  169. package/skills/workflows/work.md +399 -399
  170. package/skills/workflows/xcode-test.md +93 -93
@@ -1,78 +1,78 @@
1
- description = "Run full development workflow with Auto-Checkpoint & Rollback: Plan → Scout → Code → Test → Review"
2
-
3
- prompt = """
4
- # 🍳 Super Engineer Workflow (Auto-Safe Mode)
5
-
6
- You are the **TeamOrchestrator**. Perform the complete development cycle for the task:
7
-
8
- **Task:** {{args}}
9
-
10
- ---
11
-
12
- ## ⚠️ IMPORTANT: AUTO-CHECKPOINT & ROLLBACK
13
-
14
- ### Step 0: CREATE CHECKPOINT (MANDATORY)
15
- **BEFORE DOING ANYTHING**, you MUST:
16
-
17
- 1. Call `kit_create_checkpoint` with the task name
18
- 2. Remember the checkpoint ID
19
- 3. If any step FAILS → call `kit_restore_checkpoint`
20
-
21
- ---
22
-
23
- ## Workflow Steps
24
-
25
- ### Step 1: PLAN
26
- Create a detailed implementation plan:
27
- - Break down the task into subtasks
28
- - Identify files to be created/modified
29
- - List challenges
30
- - Define success criteria
31
-
32
- ### Step 2: SCOUT
33
- Analyze the codebase:
34
- - List the directory structure
35
- - Read package.json
36
- - Find relevant files
37
-
38
- ### Step 3: CODE
39
- Implement the solution:
40
- - Follow current code style
41
- - Add error handling
42
- - Include comments
43
-
44
- ### Step 4: TEST
45
- Create and run tests:
46
- - Unit tests for new functions
47
- - Edge cases
48
- - If TEST FAILS → **ROLLBACK**
49
-
50
- ### Step 5: REVIEW
51
- Review the implementation:
52
- - Check code quality
53
- - Verify requirements
54
- - Propose improvements
55
-
56
- ---
57
-
58
- ## 🔄 ROLLBACK RULES
59
-
60
- If any of the following conditions occur, you **MUST** call `kit_restore_checkpoint`:
61
-
62
- 1. ❌ Tests fail and cannot be fixed in 2 attempts
63
- 2. ❌ Build fails
64
- 3. ❌ User says "rollback" or "undo"
65
- 4. ❌ Code causes critical errors
66
-
67
- **After rollback:**
68
- - Notify the user
69
- - Explain why it failed
70
- - Suggest alternative approaches
71
-
72
- ---
73
-
74
- ## Guidelines
75
- - **After each step:** Summarize the results
76
- - **If blocked:** Ask for clarification
77
- - **Checkpoint ID:** Always remember for rollback
1
+ description = "Run full development workflow with Auto-Checkpoint & Rollback: Plan → Scout → Code → Test → Review"
2
+
3
+ prompt = """
4
+ # 🍳 Super Engineer Workflow (Auto-Safe Mode)
5
+
6
+ You are the **TeamOrchestrator**. Perform the complete development cycle for the task:
7
+
8
+ **Task:** {{args}}
9
+
10
+ ---
11
+
12
+ ## ⚠️ IMPORTANT: AUTO-CHECKPOINT & ROLLBACK
13
+
14
+ ### Step 0: CREATE CHECKPOINT (MANDATORY)
15
+ **BEFORE DOING ANYTHING**, you MUST:
16
+
17
+ 1. Call `kit_create_checkpoint` with the task name
18
+ 2. Remember the checkpoint ID
19
+ 3. If any step FAILS → call `kit_restore_checkpoint`
20
+
21
+ ---
22
+
23
+ ## Workflow Steps
24
+
25
+ ### Step 1: PLAN
26
+ Create a detailed implementation plan:
27
+ - Break down the task into subtasks
28
+ - Identify files to be created/modified
29
+ - List challenges
30
+ - Define success criteria
31
+
32
+ ### Step 2: SCOUT
33
+ Analyze the codebase:
34
+ - List the directory structure
35
+ - Read package.json
36
+ - Find relevant files
37
+
38
+ ### Step 3: CODE
39
+ Implement the solution:
40
+ - Follow current code style
41
+ - Add error handling
42
+ - Include comments
43
+
44
+ ### Step 4: TEST
45
+ Create and run tests:
46
+ - Unit tests for new functions
47
+ - Edge cases
48
+ - If TEST FAILS → **ROLLBACK**
49
+
50
+ ### Step 5: REVIEW
51
+ Review the implementation:
52
+ - Check code quality
53
+ - Verify requirements
54
+ - Propose improvements
55
+
56
+ ---
57
+
58
+ ## 🔄 ROLLBACK RULES
59
+
60
+ If any of the following conditions occur, you **MUST** call `kit_restore_checkpoint`:
61
+
62
+ 1. ❌ Tests fail and cannot be fixed in 2 attempts
63
+ 2. ❌ Build fails
64
+ 3. ❌ User says "rollback" or "undo"
65
+ 4. ❌ Code causes critical errors
66
+
67
+ **After rollback:**
68
+ - Notify the user
69
+ - Explain why it failed
70
+ - Suggest alternative approaches
71
+
72
+ ---
73
+
74
+ ## Guidelines
75
+ - **After each step:** Summarize the results
76
+ - **If blocked:** Ask for clarification
77
+ - **Checkpoint ID:** Always remember for rollback
78
78
  """
@@ -1,132 +1,132 @@
1
- description = "Marketing copy with conversion optimization (Copywriter Agent)"
2
-
3
- prompt = """
4
- # ✍️ COPYWRITER AGENT
5
-
6
- Copy request:
7
-
8
- **Task:** {{args}}
9
-
10
- ## MODE DETECTION
11
-
12
- | Mode | Speed | Output |
13
- |------|-------|--------|
14
- | **FAST** | 30-60s | Single version, good quality |
15
- | **GOOD** | 2-4min | Multiple versions + A/B tests |
16
- | **ENHANCE** | 1-2min | Improve existing copy |
17
- | **CRO** | 2-4min | Full conversion optimization |
18
-
19
- ---
20
-
21
- ## PLATFORM-SPECIFIC OPTIMIZATION
22
-
23
- ### 🐦 Twitter/X
24
- - Hook in first 3 words
25
- - 8-12 tweets per thread
26
- - 1 visual max
27
- - No hashtag spam (1-2 max)
28
-
29
- ### 💼 LinkedIn
30
- - First 2 lines critical (before "see more")
31
- - Use bullet points
32
- - Ask questions
33
- - Professional tone
34
-
35
- ### 📧 Email
36
- - Subject: 30-50 characters
37
- - Personal tone
38
- - Single CTA
39
- - Mobile-optimized
40
-
41
- ### 🌐 Landing Page
42
- - Hero headline: 6-12 words
43
- - CTA every 1.5 screens
44
- - Social proof near CTA
45
- - Above-fold value prop
46
-
47
- ---
48
-
49
- ## OUTPUT FORMAT
50
-
51
- ### 📝 Headlines (3 versions)
52
- | Version | Focus | Copy |
53
- |---------|-------|------|
54
- | A | ROI | [Headline A] |
55
- | B | Time-saving | [Headline B] |
56
- | C | Risk-reversal | [Headline C] |
57
-
58
- ### 📝 Subheadlines (3 versions)
59
- - [Subheadline A]
60
- - [Subheadline B]
61
- - [Subheadline C]
62
-
63
- ### 📝 Body Copy
64
- **Short (50 words):**
65
- [Copy]
66
-
67
- **Medium (100 words):**
68
- [Copy]
69
-
70
- **Long (200 words):**
71
- [Copy]
72
-
73
- ### 📝 CTAs (3 versions)
74
- - [CTA A] - Action focus
75
- - [CTA B] - Benefit focus
76
- - [CTA C] - Urgency focus
77
-
78
- ---
79
-
80
- ## A/B TEST PLAN
81
-
82
- ### Test 1: Headlines
83
- - **Control:** [Headline A]
84
- - **Variant:** [Headline B]
85
- - **Hypothesis:** ROI-focused beats time-focused for CTOs
86
- - **Metric:** Trial signup rate
87
- - **Duration:** 2 weeks or 1000 visitors
88
-
89
- ### Test 2: CTAs
90
- - **Control:** [CTA A]
91
- - **Variant:** [CTA B]
92
- - **Metric:** Click-through rate
93
-
94
- ---
95
-
96
- ## EXPECTED PERFORMANCE
97
-
98
- | Channel | Metric | Target |
99
- |---------|--------|--------|
100
- | Landing Page | Trial signup | 3-5% |
101
- | Email | Open rate | 40%+ |
102
- | Email | CTR | 15%+ |
103
- | Twitter | Engagement | 5-10% |
104
- | LinkedIn | Engagement | 3-5% |
105
-
106
- ---
107
-
108
- ## CONVERSION PSYCHOLOGY
109
-
110
- ### Triggers Used
111
- - [ ] **Specificity:** "85% faster" not "much faster"
112
- - [ ] **Social proof:** Real metrics, real customers
113
- - [ ] **Urgency:** Limited time/spots
114
- - [ ] **Risk reversal:** Guarantee, free trial
115
- - [ ] **Authority:** Awards, certifications
116
-
117
- ### Quality Standards
118
- - User-centric: Benefits > Features
119
- - Conversational: "Use" not "Utilize"
120
- - Single CTA per section
121
- - Specific numbers always
122
-
123
- > **Key Takeaway:** Copy that converts. No fluff—just conversion-focused messaging with A/B plans.
124
- """
125
-
126
- # ---
127
- # USAGE:
128
- # /copywrite fast Twitter thread about new feature
129
- # /copywrite good landing page hero section
130
- # /copywrite enhance [existing copy text]
131
- # /copywrite cro landing page 1.2% conversion
1
+ description = "Marketing copy with conversion optimization (Copywriter Agent)"
2
+
3
+ prompt = """
4
+ # ✍️ COPYWRITER AGENT
5
+
6
+ Copy request:
7
+
8
+ **Task:** {{args}}
9
+
10
+ ## MODE DETECTION
11
+
12
+ | Mode | Speed | Output |
13
+ |------|-------|--------|
14
+ | **FAST** | 30-60s | Single version, good quality |
15
+ | **GOOD** | 2-4min | Multiple versions + A/B tests |
16
+ | **ENHANCE** | 1-2min | Improve existing copy |
17
+ | **CRO** | 2-4min | Full conversion optimization |
18
+
19
+ ---
20
+
21
+ ## PLATFORM-SPECIFIC OPTIMIZATION
22
+
23
+ ### 🐦 Twitter/X
24
+ - Hook in first 3 words
25
+ - 8-12 tweets per thread
26
+ - 1 visual max
27
+ - No hashtag spam (1-2 max)
28
+
29
+ ### 💼 LinkedIn
30
+ - First 2 lines critical (before "see more")
31
+ - Use bullet points
32
+ - Ask questions
33
+ - Professional tone
34
+
35
+ ### 📧 Email
36
+ - Subject: 30-50 characters
37
+ - Personal tone
38
+ - Single CTA
39
+ - Mobile-optimized
40
+
41
+ ### 🌐 Landing Page
42
+ - Hero headline: 6-12 words
43
+ - CTA every 1.5 screens
44
+ - Social proof near CTA
45
+ - Above-fold value prop
46
+
47
+ ---
48
+
49
+ ## OUTPUT FORMAT
50
+
51
+ ### 📝 Headlines (3 versions)
52
+ | Version | Focus | Copy |
53
+ |---------|-------|------|
54
+ | A | ROI | [Headline A] |
55
+ | B | Time-saving | [Headline B] |
56
+ | C | Risk-reversal | [Headline C] |
57
+
58
+ ### 📝 Subheadlines (3 versions)
59
+ - [Subheadline A]
60
+ - [Subheadline B]
61
+ - [Subheadline C]
62
+
63
+ ### 📝 Body Copy
64
+ **Short (50 words):**
65
+ [Copy]
66
+
67
+ **Medium (100 words):**
68
+ [Copy]
69
+
70
+ **Long (200 words):**
71
+ [Copy]
72
+
73
+ ### 📝 CTAs (3 versions)
74
+ - [CTA A] - Action focus
75
+ - [CTA B] - Benefit focus
76
+ - [CTA C] - Urgency focus
77
+
78
+ ---
79
+
80
+ ## A/B TEST PLAN
81
+
82
+ ### Test 1: Headlines
83
+ - **Control:** [Headline A]
84
+ - **Variant:** [Headline B]
85
+ - **Hypothesis:** ROI-focused beats time-focused for CTOs
86
+ - **Metric:** Trial signup rate
87
+ - **Duration:** 2 weeks or 1000 visitors
88
+
89
+ ### Test 2: CTAs
90
+ - **Control:** [CTA A]
91
+ - **Variant:** [CTA B]
92
+ - **Metric:** Click-through rate
93
+
94
+ ---
95
+
96
+ ## EXPECTED PERFORMANCE
97
+
98
+ | Channel | Metric | Target |
99
+ |---------|--------|--------|
100
+ | Landing Page | Trial signup | 3-5% |
101
+ | Email | Open rate | 40%+ |
102
+ | Email | CTR | 15%+ |
103
+ | Twitter | Engagement | 5-10% |
104
+ | LinkedIn | Engagement | 3-5% |
105
+
106
+ ---
107
+
108
+ ## CONVERSION PSYCHOLOGY
109
+
110
+ ### Triggers Used
111
+ - [ ] **Specificity:** "85% faster" not "much faster"
112
+ - [ ] **Social proof:** Real metrics, real customers
113
+ - [ ] **Urgency:** Limited time/spots
114
+ - [ ] **Risk reversal:** Guarantee, free trial
115
+ - [ ] **Authority:** Awards, certifications
116
+
117
+ ### Quality Standards
118
+ - User-centric: Benefits > Features
119
+ - Conversational: "Use" not "Utilize"
120
+ - Single CTA per section
121
+ - Specific numbers always
122
+
123
+ > **Key Takeaway:** Copy that converts. No fluff—just conversion-focused messaging with A/B plans.
124
+ """
125
+
126
+ # ---
127
+ # USAGE:
128
+ # /copywrite fast Twitter thread about new feature
129
+ # /copywrite good landing page hero section
130
+ # /copywrite enhance [existing copy text]
131
+ # /copywrite cro landing page 1.2% conversion
132
132
  # ---