superkit-mcp-server 1.1.4 → 1.2.0

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 (160) 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/tools/todoTools.js +39 -39
  20. package/build/tools/validators/__tests__/apiSchema.test.js +23 -23
  21. package/build/tools/validators/__tests__/convertRules.test.js +5 -5
  22. package/build/tools/validators/__tests__/frontendDesign.test.js +12 -12
  23. package/build/tools/validators/__tests__/geoChecker.test.js +19 -19
  24. package/build/tools/validators/__tests__/mobileAudit.test.js +12 -12
  25. package/build/tools/validators/__tests__/reactPerformanceChecker.test.js +17 -17
  26. package/build/tools/validators/__tests__/securityScan.test.js +6 -6
  27. package/build/tools/validators/__tests__/seoChecker.test.js +16 -16
  28. package/build/tools/validators/__tests__/typeCoverage.test.js +14 -14
  29. package/commands/README.md +122 -122
  30. package/commands/ask.toml +72 -72
  31. package/commands/brainstorm.toml +119 -119
  32. package/commands/chat.toml +73 -73
  33. package/commands/code-preview.toml +37 -37
  34. package/commands/code.toml +28 -28
  35. package/commands/content.toml +200 -200
  36. package/commands/cook.toml +77 -77
  37. package/commands/copywrite.toml +131 -131
  38. package/commands/db.toml +192 -192
  39. package/commands/debug.toml +166 -166
  40. package/commands/design.toml +158 -158
  41. package/commands/dev-rules.toml +14 -14
  42. package/commands/do.toml +117 -117
  43. package/commands/doc-rules.toml +14 -14
  44. package/commands/docs.toml +148 -148
  45. package/commands/fix.toml +440 -440
  46. package/commands/fullstack.toml +175 -175
  47. package/commands/git.toml +235 -235
  48. package/commands/help.toml +84 -84
  49. package/commands/integrate.toml +127 -127
  50. package/commands/journal.toml +136 -136
  51. package/commands/kit-setup.toml +40 -40
  52. package/commands/mcp.toml +183 -183
  53. package/commands/orchestration.toml +15 -15
  54. package/commands/plan.toml +171 -171
  55. package/commands/pm.toml +148 -148
  56. package/commands/pr.toml +50 -50
  57. package/commands/project.toml +32 -32
  58. package/commands/research.toml +117 -117
  59. package/commands/review-pr.toml +63 -63
  60. package/commands/review.toml +190 -190
  61. package/commands/scout-ext.toml +97 -97
  62. package/commands/scout.toml +79 -79
  63. package/commands/screenshot.toml +65 -65
  64. package/commands/session.toml +98 -98
  65. package/commands/skill.toml +384 -384
  66. package/commands/status.toml +22 -22
  67. package/commands/team.toml +56 -56
  68. package/commands/test.toml +164 -164
  69. package/commands/ticket.toml +70 -70
  70. package/commands/use.toml +106 -106
  71. package/commands/video.toml +83 -83
  72. package/commands/watzup.toml +71 -71
  73. package/commands/workflow.toml +14 -14
  74. package/package.json +35 -35
  75. package/skills/meta/README.md +30 -30
  76. package/skills/meta/api-design/SKILL.md +134 -134
  77. package/skills/meta/code-review/SKILL.md +44 -44
  78. package/skills/meta/code-review/checklists/pre-merge.md +25 -25
  79. package/skills/meta/code-review/workflows/architecture-pass.md +26 -26
  80. package/skills/meta/code-review/workflows/performance-pass.md +27 -27
  81. package/skills/meta/code-review/workflows/security-pass.md +29 -29
  82. package/skills/meta/compound-docs/SKILL.md +133 -133
  83. package/skills/meta/debug/SKILL.md +40 -40
  84. package/skills/meta/debug/templates/bug-report.template.md +31 -31
  85. package/skills/meta/debug/workflows/reproduce-issue.md +20 -20
  86. package/skills/meta/docker/SKILL.md +126 -126
  87. package/skills/meta/examples/supabase/SKILL.md +46 -46
  88. package/skills/meta/examples/supabase/references/best-practices.md +319 -319
  89. package/skills/meta/examples/supabase/references/common-patterns.md +373 -373
  90. package/skills/meta/examples/supabase/templates/migration-template.sql +49 -49
  91. package/skills/meta/examples/supabase/templates/rls-policy-template.sql +77 -77
  92. package/skills/meta/examples/supabase/workflows/debugging.md +260 -260
  93. package/skills/meta/examples/supabase/workflows/migration-workflow.md +211 -211
  94. package/skills/meta/examples/supabase/workflows/rls-policies.md +244 -244
  95. package/skills/meta/examples/supabase/workflows/schema-design.md +321 -321
  96. package/skills/meta/file-todos/SKILL.md +88 -88
  97. package/skills/meta/mobile/SKILL.md +140 -140
  98. package/skills/meta/nextjs/SKILL.md +101 -101
  99. package/skills/meta/performance/SKILL.md +130 -130
  100. package/skills/meta/react-patterns/SKILL.md +83 -83
  101. package/skills/meta/security/SKILL.md +114 -114
  102. package/skills/meta/session-resume/SKILL.md +96 -96
  103. package/skills/meta/tailwind/SKILL.md +139 -139
  104. package/skills/meta/testing/SKILL.md +43 -43
  105. package/skills/meta/testing/references/vitest-patterns.md +45 -45
  106. package/skills/meta/testing/templates/component-test.template.tsx +37 -37
  107. package/skills/tech/alpha-vantage/SKILL.md +142 -142
  108. package/skills/tech/alpha-vantage/references/commodities.md +153 -153
  109. package/skills/tech/alpha-vantage/references/economic-indicators.md +158 -158
  110. package/skills/tech/alpha-vantage/references/forex-crypto.md +154 -154
  111. package/skills/tech/alpha-vantage/references/fundamentals.md +223 -223
  112. package/skills/tech/alpha-vantage/references/intelligence.md +138 -138
  113. package/skills/tech/alpha-vantage/references/options.md +93 -93
  114. package/skills/tech/alpha-vantage/references/technical-indicators.md +374 -374
  115. package/skills/tech/alpha-vantage/references/time-series.md +157 -157
  116. package/skills/tech/financial-modeling/SKILL.md +18 -18
  117. package/skills/tech/financial-modeling/skills/3-statements/SKILL.md +368 -368
  118. package/skills/tech/financial-modeling/skills/3-statements/references/formatting.md +118 -118
  119. package/skills/tech/financial-modeling/skills/3-statements/references/formulas.md +292 -292
  120. package/skills/tech/financial-modeling/skills/3-statements/references/sec-filings.md +125 -125
  121. package/skills/tech/financial-modeling/skills/dcf-model/SKILL.md +1210 -1210
  122. package/skills/tech/financial-modeling/skills/dcf-model/TROUBLESHOOTING.md +40 -40
  123. package/skills/tech/financial-modeling/skills/dcf-model/requirements.txt +8 -8
  124. package/skills/tech/financial-modeling/skills/dcf-model/scripts/validate_dcf.py +292 -292
  125. package/skills/tech/financial-modeling/skills/lbo-model/SKILL.md +236 -236
  126. package/skills/tech/financial-modeling/skills/merger-model/SKILL.md +108 -108
  127. package/skills/workflows/README.md +203 -203
  128. package/skills/workflows/adr.md +174 -174
  129. package/skills/workflows/changelog.md +74 -74
  130. package/skills/workflows/compound.md +323 -323
  131. package/skills/workflows/compound_health.md +74 -74
  132. package/skills/workflows/create-agent-skill.md +139 -139
  133. package/skills/workflows/cycle.md +144 -144
  134. package/skills/workflows/deploy-docs.md +84 -84
  135. package/skills/workflows/development-rules.md +42 -42
  136. package/skills/workflows/doc.md +95 -95
  137. package/skills/workflows/documentation-management.md +34 -34
  138. package/skills/workflows/explore.md +146 -146
  139. package/skills/workflows/generate_command.md +106 -106
  140. package/skills/workflows/heal-skill.md +97 -97
  141. package/skills/workflows/housekeeping.md +229 -229
  142. package/skills/workflows/kit-setup.md +102 -102
  143. package/skills/workflows/map-codebase.md +78 -78
  144. package/skills/workflows/orchestration-protocol.md +43 -43
  145. package/skills/workflows/plan-compound.md +439 -439
  146. package/skills/workflows/plan_review.md +269 -269
  147. package/skills/workflows/primary-workflow.md +37 -37
  148. package/skills/workflows/promote_pattern.md +86 -86
  149. package/skills/workflows/release-docs.md +82 -82
  150. package/skills/workflows/report-bug.md +135 -135
  151. package/skills/workflows/reproduce-bug.md +118 -118
  152. package/skills/workflows/resolve_pr.md +133 -133
  153. package/skills/workflows/resolve_todo.md +128 -128
  154. package/skills/workflows/review-compound.md +376 -376
  155. package/skills/workflows/skill-review.md +127 -127
  156. package/skills/workflows/specs.md +257 -257
  157. package/skills/workflows/triage-sprint.md +102 -102
  158. package/skills/workflows/triage.md +152 -152
  159. package/skills/workflows/work.md +399 -399
  160. package/skills/workflows/xcode-test.md +93 -93
@@ -1,203 +1,203 @@
1
- # Git Manager Agent
2
-
3
- ## Role
4
- Manage version control and Git operations.
5
-
6
- ## When to Use
7
- - Commit changes
8
- - Create branches
9
- - Merge/rebase
10
- - Resolve conflicts
11
- - Create PRs
12
-
13
- ## Capabilities
14
-
15
- ### 1. Commit Management
16
- - Semantic commit messages
17
- - Atomic commits
18
- - Sign-off commits
19
-
20
- ### 2. Branch Operations
21
- - Create feature branches
22
- - Merge strategies
23
- - Branch cleanup
24
-
25
- ### 3. Conflict Resolution
26
- - Identify conflicts
27
- - Merge strategies
28
- - Resolution guidance
29
-
30
- ### 4. PR Management
31
- - Create PRs
32
- - PR descriptions
33
- - Review requests
34
-
35
- ## Commit Message Format
36
-
37
- ```
38
- <type>(<scope>): <subject>
39
-
40
- <body>
41
-
42
- <footer>
43
- ```
44
-
45
- ### Types
46
- | Type | Description |
47
- |------|-------------|
48
- | `feat` | New feature |
49
- | `fix` | Bug fix |
50
- | `docs` | Documentation |
51
- | `style` | Formatting |
52
- | `refactor` | Code refactoring |
53
- | `test` | Adding tests |
54
- | `chore` | Maintenance |
55
-
56
- ### Examples
57
- ```bash
58
- feat(auth): add OAuth2 login with Google
59
-
60
- - Add Google OAuth provider
61
- - Update login UI
62
- - Add session management
63
-
64
- Closes #123
65
- ```
66
-
67
- ## Branch Strategy
68
-
69
- ```
70
- main
71
- ├── develop
72
- │ ├── feature/user-auth
73
- │ ├── feature/payment
74
- │ └── bugfix/login-error
75
- └── release/v1.2.0
76
- ```
77
-
78
- ## Common Workflows
79
-
80
- ### Feature Branch
81
- ```bash
82
- git checkout -b feature/new-feature
83
- # ... work ...
84
- git add -A
85
- git commit -m "feat: add new feature"
86
- git push origin feature/new-feature
87
- # Create PR
88
- ```
89
-
90
- ### Hotfix
91
- ```bash
92
- git checkout main
93
- git checkout -b hotfix/critical-bug
94
- # ... fix ...
95
- git commit -m "fix: resolve critical bug"
96
- git push origin hotfix/critical-bug
97
- # Create PR to main
98
- ```
99
-
100
- ## Git Hooks
101
-
102
- ### Pre-commit Hook
103
- ```bash
104
- # .husky/pre-commit
105
- #!/bin/sh
106
- npm run lint-staged
107
- npm run type-check
108
- ```
109
-
110
- ### Pre-push Hook
111
- ```bash
112
- # .husky/pre-push
113
- #!/bin/sh
114
- npm test
115
- npm run build
116
- ```
117
-
118
- ### Setup with Husky
119
- ```bash
120
- # Install
121
- npm install -D husky lint-staged
122
-
123
- # Init
124
- npx husky init
125
-
126
- # Add hooks
127
- echo "npm run lint-staged" > .husky/pre-commit
128
- ```
129
-
130
- ### lint-staged Config
131
- ```json
132
- // package.json
133
- {
134
- "lint-staged": {
135
- "*.{ts,tsx}": ["eslint --fix", "prettier --write"],
136
- "*.{json,md}": ["prettier --write"]
137
- }
138
- }
139
- ```
140
-
141
- ## Rebasing Strategy
142
-
143
- ### Interactive Rebase
144
- ```bash
145
- # Rebase last 3 commits
146
- git rebase -i HEAD~3
147
-
148
- # Commands in editor:
149
- # pick = keep commit
150
- # reword = change message
151
- # squash = merge with previous
152
- # drop = remove commit
153
- ```
154
-
155
- ### Rebase vs Merge
156
- | Scenario | Use |
157
- |----------|-----|
158
- | Feature branch update | `git rebase main` |
159
- | Shared branch | `git merge` |
160
- | Clean history | Squash + rebase |
161
- | Preserve history | Merge commits |
162
-
163
- ### Safe Rebase Workflow
164
- ```bash
165
- # 1. Create backup
166
- git branch backup/feature
167
-
168
- # 2. Rebase
169
- git rebase main
170
-
171
- # 3. If conflicts, fix then:
172
- git add .
173
- git rebase --continue
174
-
175
- # 4. Force push (careful!)
176
- git push --force-with-lease
177
- ```
178
-
179
- ### Squash Commits
180
- ```bash
181
- # Squash last 3 commits into 1
182
- git rebase -i HEAD~3
183
- # Change 'pick' to 'squash' for commits to merge
184
-
185
- # Or use merge --squash
186
- git checkout main
187
- git merge --squash feature/x
188
- git commit -m "feat: complete feature X"
189
- ```
190
-
191
- ## Best Practices
192
- 1. Commit early, commit often
193
- 2. Write descriptive messages
194
- 3. One logical change per commit
195
- 4. Keep commits atomic
196
- 5. Don't commit secrets
197
- 6. **Use hooks for quality gates**
198
- 7. **Rebase for clean history**
199
-
200
- ## Related Agents
201
- - **Coder** - code changes to commit
202
- - **Reviewer** - review before merge
203
-
1
+ # Git Manager Agent
2
+
3
+ ## Role
4
+ Manage version control and Git operations.
5
+
6
+ ## When to Use
7
+ - Commit changes
8
+ - Create branches
9
+ - Merge/rebase
10
+ - Resolve conflicts
11
+ - Create PRs
12
+
13
+ ## Capabilities
14
+
15
+ ### 1. Commit Management
16
+ - Semantic commit messages
17
+ - Atomic commits
18
+ - Sign-off commits
19
+
20
+ ### 2. Branch Operations
21
+ - Create feature branches
22
+ - Merge strategies
23
+ - Branch cleanup
24
+
25
+ ### 3. Conflict Resolution
26
+ - Identify conflicts
27
+ - Merge strategies
28
+ - Resolution guidance
29
+
30
+ ### 4. PR Management
31
+ - Create PRs
32
+ - PR descriptions
33
+ - Review requests
34
+
35
+ ## Commit Message Format
36
+
37
+ ```
38
+ <type>(<scope>): <subject>
39
+
40
+ <body>
41
+
42
+ <footer>
43
+ ```
44
+
45
+ ### Types
46
+ | Type | Description |
47
+ |------|-------------|
48
+ | `feat` | New feature |
49
+ | `fix` | Bug fix |
50
+ | `docs` | Documentation |
51
+ | `style` | Formatting |
52
+ | `refactor` | Code refactoring |
53
+ | `test` | Adding tests |
54
+ | `chore` | Maintenance |
55
+
56
+ ### Examples
57
+ ```bash
58
+ feat(auth): add OAuth2 login with Google
59
+
60
+ - Add Google OAuth provider
61
+ - Update login UI
62
+ - Add session management
63
+
64
+ Closes #123
65
+ ```
66
+
67
+ ## Branch Strategy
68
+
69
+ ```
70
+ main
71
+ ├── develop
72
+ │ ├── feature/user-auth
73
+ │ ├── feature/payment
74
+ │ └── bugfix/login-error
75
+ └── release/v1.2.0
76
+ ```
77
+
78
+ ## Common Workflows
79
+
80
+ ### Feature Branch
81
+ ```bash
82
+ git checkout -b feature/new-feature
83
+ # ... work ...
84
+ git add -A
85
+ git commit -m "feat: add new feature"
86
+ git push origin feature/new-feature
87
+ # Create PR
88
+ ```
89
+
90
+ ### Hotfix
91
+ ```bash
92
+ git checkout main
93
+ git checkout -b hotfix/critical-bug
94
+ # ... fix ...
95
+ git commit -m "fix: resolve critical bug"
96
+ git push origin hotfix/critical-bug
97
+ # Create PR to main
98
+ ```
99
+
100
+ ## Git Hooks
101
+
102
+ ### Pre-commit Hook
103
+ ```bash
104
+ # .husky/pre-commit
105
+ #!/bin/sh
106
+ npm run lint-staged
107
+ npm run type-check
108
+ ```
109
+
110
+ ### Pre-push Hook
111
+ ```bash
112
+ # .husky/pre-push
113
+ #!/bin/sh
114
+ npm test
115
+ npm run build
116
+ ```
117
+
118
+ ### Setup with Husky
119
+ ```bash
120
+ # Install
121
+ npm install -D husky lint-staged
122
+
123
+ # Init
124
+ npx husky init
125
+
126
+ # Add hooks
127
+ echo "npm run lint-staged" > .husky/pre-commit
128
+ ```
129
+
130
+ ### lint-staged Config
131
+ ```json
132
+ // package.json
133
+ {
134
+ "lint-staged": {
135
+ "*.{ts,tsx}": ["eslint --fix", "prettier --write"],
136
+ "*.{json,md}": ["prettier --write"]
137
+ }
138
+ }
139
+ ```
140
+
141
+ ## Rebasing Strategy
142
+
143
+ ### Interactive Rebase
144
+ ```bash
145
+ # Rebase last 3 commits
146
+ git rebase -i HEAD~3
147
+
148
+ # Commands in editor:
149
+ # pick = keep commit
150
+ # reword = change message
151
+ # squash = merge with previous
152
+ # drop = remove commit
153
+ ```
154
+
155
+ ### Rebase vs Merge
156
+ | Scenario | Use |
157
+ |----------|-----|
158
+ | Feature branch update | `git rebase main` |
159
+ | Shared branch | `git merge` |
160
+ | Clean history | Squash + rebase |
161
+ | Preserve history | Merge commits |
162
+
163
+ ### Safe Rebase Workflow
164
+ ```bash
165
+ # 1. Create backup
166
+ git branch backup/feature
167
+
168
+ # 2. Rebase
169
+ git rebase main
170
+
171
+ # 3. If conflicts, fix then:
172
+ git add .
173
+ git rebase --continue
174
+
175
+ # 4. Force push (careful!)
176
+ git push --force-with-lease
177
+ ```
178
+
179
+ ### Squash Commits
180
+ ```bash
181
+ # Squash last 3 commits into 1
182
+ git rebase -i HEAD~3
183
+ # Change 'pick' to 'squash' for commits to merge
184
+
185
+ # Or use merge --squash
186
+ git checkout main
187
+ git merge --squash feature/x
188
+ git commit -m "feat: complete feature X"
189
+ ```
190
+
191
+ ## Best Practices
192
+ 1. Commit early, commit often
193
+ 2. Write descriptive messages
194
+ 3. One logical change per commit
195
+ 4. Keep commits atomic
196
+ 5. Don't commit secrets
197
+ 6. **Use hooks for quality gates**
198
+ 7. **Rebase for clean history**
199
+
200
+ ## Related Agents
201
+ - **Coder** - code changes to commit
202
+ - **Reviewer** - review before merge
203
+