superkit-mcp-server 1.0.2 → 1.1.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 (116) hide show
  1. package/ARCHITECTURE.md +102 -102
  2. package/README.md +67 -63
  3. package/SUPERKIT.md +168 -168
  4. package/agents/code-archaeologist.md +106 -0
  5. package/agents/coder.md +90 -90
  6. package/agents/data-engineer.md +28 -28
  7. package/agents/devops-engineer.md +242 -0
  8. package/agents/git-manager.md +203 -203
  9. package/agents/orchestrator.md +4 -0
  10. package/agents/penetration-tester.md +188 -0
  11. package/agents/performance-optimizer.md +187 -0
  12. package/agents/planner.md +270 -270
  13. package/agents/qa-automation-engineer.md +103 -0
  14. package/agents/quant-developer.md +32 -28
  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/index.js +53 -1
  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/package.json +33 -33
  30. package/skills/meta/README.md +30 -30
  31. package/skills/meta/api-design/SKILL.md +134 -134
  32. package/skills/meta/code-review/SKILL.md +44 -37
  33. package/skills/meta/code-review/checklists/pre-merge.md +25 -25
  34. package/skills/meta/code-review/workflows/architecture-pass.md +26 -26
  35. package/skills/meta/code-review/workflows/performance-pass.md +27 -27
  36. package/skills/meta/code-review/workflows/security-pass.md +29 -29
  37. package/skills/meta/compound-docs/SKILL.md +133 -133
  38. package/skills/meta/debug/SKILL.md +40 -40
  39. package/skills/meta/debug/templates/bug-report.template.md +31 -31
  40. package/skills/meta/debug/workflows/reproduce-issue.md +20 -20
  41. package/skills/meta/docker/SKILL.md +126 -126
  42. package/skills/meta/examples/supabase/SKILL.md +46 -46
  43. package/skills/meta/examples/supabase/references/best-practices.md +319 -319
  44. package/skills/meta/examples/supabase/references/common-patterns.md +373 -373
  45. package/skills/meta/examples/supabase/templates/migration-template.sql +49 -49
  46. package/skills/meta/examples/supabase/templates/rls-policy-template.sql +77 -77
  47. package/skills/meta/examples/supabase/workflows/debugging.md +260 -260
  48. package/skills/meta/examples/supabase/workflows/migration-workflow.md +211 -211
  49. package/skills/meta/examples/supabase/workflows/rls-policies.md +244 -244
  50. package/skills/meta/examples/supabase/workflows/schema-design.md +321 -321
  51. package/skills/meta/file-todos/SKILL.md +88 -88
  52. package/skills/meta/mobile/SKILL.md +140 -140
  53. package/skills/meta/nextjs/SKILL.md +101 -101
  54. package/skills/meta/performance/SKILL.md +130 -130
  55. package/skills/meta/react-patterns/SKILL.md +83 -83
  56. package/skills/meta/security/SKILL.md +114 -114
  57. package/skills/meta/session-resume/SKILL.md +96 -96
  58. package/skills/meta/tailwind/SKILL.md +139 -139
  59. package/skills/meta/testing/SKILL.md +43 -43
  60. package/skills/meta/testing/references/vitest-patterns.md +45 -45
  61. package/skills/meta/testing/templates/component-test.template.tsx +37 -37
  62. package/skills/tech/alpha-vantage/SKILL.md +142 -0
  63. package/skills/tech/alpha-vantage/references/commodities.md +153 -0
  64. package/skills/tech/alpha-vantage/references/economic-indicators.md +158 -0
  65. package/skills/tech/alpha-vantage/references/forex-crypto.md +154 -0
  66. package/skills/tech/alpha-vantage/references/fundamentals.md +223 -0
  67. package/skills/tech/alpha-vantage/references/intelligence.md +138 -0
  68. package/skills/tech/alpha-vantage/references/options.md +93 -0
  69. package/skills/tech/alpha-vantage/references/technical-indicators.md +374 -0
  70. package/skills/tech/alpha-vantage/references/time-series.md +157 -0
  71. package/skills/tech/financial-modeling/SKILL.md +18 -0
  72. package/skills/tech/financial-modeling/skills/3-statements/SKILL.md +368 -0
  73. package/skills/tech/financial-modeling/skills/3-statements/references/formatting.md +118 -0
  74. package/skills/tech/financial-modeling/skills/3-statements/references/formulas.md +292 -0
  75. package/skills/tech/financial-modeling/skills/3-statements/references/sec-filings.md +125 -0
  76. package/skills/tech/financial-modeling/skills/dcf-model/SKILL.md +1211 -0
  77. package/skills/tech/financial-modeling/skills/dcf-model/TROUBLESHOOTING.md +40 -0
  78. package/skills/tech/financial-modeling/skills/dcf-model/requirements.txt +8 -0
  79. package/skills/tech/financial-modeling/skills/dcf-model/scripts/validate_dcf.py +292 -0
  80. package/skills/tech/financial-modeling/skills/lbo-model/SKILL.md +236 -0
  81. package/skills/tech/financial-modeling/skills/merger-model/SKILL.md +108 -0
  82. package/skills/tech/intelligent-routing/SKILL.md +5 -5
  83. package/workflows/README.md +191 -191
  84. package/workflows/adr.md +174 -174
  85. package/workflows/changelog.md +74 -74
  86. package/workflows/compound.md +323 -323
  87. package/workflows/compound_health.md +74 -74
  88. package/workflows/create-agent-skill.md +139 -139
  89. package/workflows/cycle.md +144 -144
  90. package/workflows/deploy-docs.md +84 -84
  91. package/workflows/development-rules.md +37 -37
  92. package/workflows/doc.md +95 -95
  93. package/workflows/documentation-management.md +29 -29
  94. package/workflows/explore.md +146 -146
  95. package/workflows/generate_command.md +106 -106
  96. package/workflows/heal-skill.md +97 -97
  97. package/workflows/housekeeping.md +229 -229
  98. package/workflows/kit-setup.md +102 -102
  99. package/workflows/map-codebase.md +78 -0
  100. package/workflows/orchestration-protocol.md +38 -38
  101. package/workflows/plan-compound.md +439 -433
  102. package/workflows/plan_review.md +269 -248
  103. package/workflows/primary-workflow.md +32 -32
  104. package/workflows/promote_pattern.md +86 -86
  105. package/workflows/release-docs.md +82 -82
  106. package/workflows/report-bug.md +135 -135
  107. package/workflows/reproduce-bug.md +118 -118
  108. package/workflows/resolve_pr.md +133 -133
  109. package/workflows/resolve_todo.md +128 -128
  110. package/workflows/review-compound.md +376 -359
  111. package/workflows/skill-review.md +127 -127
  112. package/workflows/specs.md +257 -257
  113. package/workflows/triage-sprint.md +102 -102
  114. package/workflows/triage.md +152 -152
  115. package/workflows/work.md +399 -399
  116. package/workflows/xcode-test.md +93 -93
@@ -1,118 +1,118 @@
1
- ---
2
- description: Reproduce reported bugs systematically. Use when investigating bug reports.
3
- ---
4
-
5
- # /reproduce-bug - Systematic Bug Reproduction
6
-
7
- Attempt to reproduce a reported bug following the steps provided.
8
-
9
- ## Workflow
10
-
11
- ### Step 0: Establish Context (MANDATORY)
12
-
13
- > [!IMPORTANT]
14
- > If you are starting a new session to reproduce this bug, you MUST establish context first.
15
-
16
- **Run the context resumer:**
17
-
18
- ```bash
19
- // turbo
20
- ./scripts/log-workflow.sh "/reproduce-bug" "$$"
21
- ./scripts/compound-search.sh "bug reproduction"
22
- ```
23
-
24
- **Action:** Follow `skills/session-resume/SKILL.md` to ensure all previous context and state are restored.
25
-
26
- ---
27
-
28
- ### Step 1: Setup Environment
29
-
30
- Match the reported environment as closely as possible.
31
-
32
- ### Step 2: Follow Reproduction Steps
33
-
34
- Execute each step exactly as documented.
35
-
36
- ### Step 3: Document Results
37
-
38
- ```markdown
39
- ## Reproduction Attempt
40
-
41
- **Bug Report:** #{issue_number}
42
- **Date:** {date}
43
- **Environment:** {your environment}
44
-
45
- ### Steps Followed
46
- 1. ✅ Step 1 - {result}
47
- 2. ✅ Step 2 - {result}
48
- 3. ❌/✅ Step 3 - {result}
49
-
50
- ### Result
51
- - [ ] **Reproduced:** Yes/No
52
- - [ ] **Consistent:** Every time / Intermittent / Once
53
-
54
- ### Additional Observations
55
- {Any patterns noticed}
56
-
57
- ### Next Steps
58
- - [ ] Debug further
59
- - [ ] Request more info
60
- - [ ] Plan fix with /plan
61
- ```
62
-
63
- ---
64
-
65
- ### Step 4: Persist Next Steps (MANDATORY)
66
-
67
- > [!IMPORTANT]
68
- > **Do not skip.** Reproduction results are lost if not converted to todos.
69
-
70
- **If reproduced:**
71
- **If reproduced:**
72
- ```bash
73
- # Create todo to fix the bug
74
- ./scripts/create-todo.sh "p1" "Fix: {Bug Title}" \
75
- "Reproduction successful for issue #{issue_number}.\n\nReproduction Details:\n(Link to reproduction steps and results)" \
76
- "Fix the bug" \
77
- "Verify fix with reproduction steps"
78
- ```
79
-
80
- **If NOT reproduced / Need info:**
81
- ```bash
82
- # Create todo to follow up
83
- ./scripts/create-todo.sh "p2" "Follow Up: Issue #{issue_number}" \
84
- "Could not reproduce or need more info for issue #{issue_number}." \
85
- "Request more information" \
86
- "Attempt reproduction on different environment"
87
- ```
88
-
89
- ### Phase 5: Completion & Handoff
90
-
91
- #### Step 1: Establish Terminal UI State
92
-
93
- ```javascript
94
- await task_boundary({
95
- TaskName: "[COMPLETED] Reproduce Bug",
96
- TaskStatus: "Reproduction attempt recorded. Offering next steps.",
97
- Mode: "VERIFICATION",
98
- TaskSummary: "Reproduction attempt for #{issue}. Result: {Reproduced/Not Reproduced}. Next steps persisted in todo."
99
- });
100
- ```
101
-
102
- #### Step 2: Mandatory Handoff
103
-
104
- ```bash
105
- ✓ Reproduction attempt complete
106
-
107
- Next steps:
108
- 1. /plan - Plan the fix (if reproduced)
109
- 2. /report-bug - If new bug discovered during attempts
110
- 3. /housekeeping - Cleanup context
111
- ```
112
-
113
- ---
114
-
115
- ## References
116
-
117
- - Report bugs: `/report-bug`
118
- - Plan fix: `/plan`
1
+ ---
2
+ description: Reproduce reported bugs systematically. Use when investigating bug reports.
3
+ ---
4
+
5
+ # /reproduce-bug - Systematic Bug Reproduction
6
+
7
+ Attempt to reproduce a reported bug following the steps provided.
8
+
9
+ ## Workflow
10
+
11
+ ### Step 0: Establish Context (MANDATORY)
12
+
13
+ > [!IMPORTANT]
14
+ > If you are starting a new session to reproduce this bug, you MUST establish context first.
15
+
16
+ **Run the context resumer:**
17
+
18
+ ```bash
19
+ // turbo
20
+ ./scripts/log-workflow.sh "/reproduce-bug" "$$"
21
+ ./scripts/compound-search.sh "bug reproduction"
22
+ ```
23
+
24
+ **Action:** Follow `skills/session-resume/SKILL.md` to ensure all previous context and state are restored.
25
+
26
+ ---
27
+
28
+ ### Step 1: Setup Environment
29
+
30
+ Match the reported environment as closely as possible.
31
+
32
+ ### Step 2: Follow Reproduction Steps
33
+
34
+ Execute each step exactly as documented.
35
+
36
+ ### Step 3: Document Results
37
+
38
+ ```markdown
39
+ ## Reproduction Attempt
40
+
41
+ **Bug Report:** #{issue_number}
42
+ **Date:** {date}
43
+ **Environment:** {your environment}
44
+
45
+ ### Steps Followed
46
+ 1. ✅ Step 1 - {result}
47
+ 2. ✅ Step 2 - {result}
48
+ 3. ❌/✅ Step 3 - {result}
49
+
50
+ ### Result
51
+ - [ ] **Reproduced:** Yes/No
52
+ - [ ] **Consistent:** Every time / Intermittent / Once
53
+
54
+ ### Additional Observations
55
+ {Any patterns noticed}
56
+
57
+ ### Next Steps
58
+ - [ ] Debug further
59
+ - [ ] Request more info
60
+ - [ ] Plan fix with /plan
61
+ ```
62
+
63
+ ---
64
+
65
+ ### Step 4: Persist Next Steps (MANDATORY)
66
+
67
+ > [!IMPORTANT]
68
+ > **Do not skip.** Reproduction results are lost if not converted to todos.
69
+
70
+ **If reproduced:**
71
+ **If reproduced:**
72
+ ```bash
73
+ # Create todo to fix the bug
74
+ ./scripts/create-todo.sh "p1" "Fix: {Bug Title}" \
75
+ "Reproduction successful for issue #{issue_number}.\n\nReproduction Details:\n(Link to reproduction steps and results)" \
76
+ "Fix the bug" \
77
+ "Verify fix with reproduction steps"
78
+ ```
79
+
80
+ **If NOT reproduced / Need info:**
81
+ ```bash
82
+ # Create todo to follow up
83
+ ./scripts/create-todo.sh "p2" "Follow Up: Issue #{issue_number}" \
84
+ "Could not reproduce or need more info for issue #{issue_number}." \
85
+ "Request more information" \
86
+ "Attempt reproduction on different environment"
87
+ ```
88
+
89
+ ### Phase 5: Completion & Handoff
90
+
91
+ #### Step 1: Establish Terminal UI State
92
+
93
+ ```javascript
94
+ await task_boundary({
95
+ TaskName: "[COMPLETED] Reproduce Bug",
96
+ TaskStatus: "Reproduction attempt recorded. Offering next steps.",
97
+ Mode: "VERIFICATION",
98
+ TaskSummary: "Reproduction attempt for #{issue}. Result: {Reproduced/Not Reproduced}. Next steps persisted in todo."
99
+ });
100
+ ```
101
+
102
+ #### Step 2: Mandatory Handoff
103
+
104
+ ```bash
105
+ ✓ Reproduction attempt complete
106
+
107
+ Next steps:
108
+ 1. /plan - Plan the fix (if reproduced)
109
+ 2. /report-bug - If new bug discovered during attempts
110
+ 3. /housekeeping - Cleanup context
111
+ ```
112
+
113
+ ---
114
+
115
+ ## References
116
+
117
+ - Report bugs: `/report-bug`
118
+ - Plan fix: `/plan`
@@ -1,133 +1,133 @@
1
- ---
2
- description: Handle PR comments and review feedback efficiently. Use when addressing reviewer feedback.
3
- ---
4
-
5
- # /resolve_pr - Address PR Feedback
6
-
7
- Work through PR comments and review feedback systematically.
8
-
9
- ## When To Use
10
-
11
- - When a PR has review comments
12
- - After receiving change requests
13
- - To batch-process reviewer feedback
14
-
15
- ---
16
-
17
- ## Workflow
18
-
19
- ### Step 0: Search & Log
20
-
21
- ```bash
22
- // turbo
23
- ./scripts/log-workflow.sh "/resolve_pr" "$$"
24
- ./scripts/compound-search.sh "pull request review"
25
- ```
26
-
27
- ### Step 1: Fetch PR Comments
28
-
29
- ```bash
30
- # Get PR details
31
- gh pr view {PR_NUMBER} --json comments,reviews
32
-
33
- # List requested changes
34
- gh pr view {PR_NUMBER} --json reviewRequests
35
- ```
36
-
37
- ### Step 2: Categorize Feedback
38
-
39
- Group comments by type:
40
-
41
- | Type | Action |
42
- |------|--------|
43
- | **Must fix** | Required for approval |
44
- | **Suggestion** | Consider implementing |
45
- | **Question** | Respond with clarification |
46
- | **Praise** | Acknowledge, no action needed |
47
-
48
- ### Step 3: Address Each Comment
49
-
50
- For each must-fix comment:
51
-
52
- 1. **Understand:** Read the feedback carefully
53
- 2. **Fix:** Make the requested change
54
- 3. **Test:** Verify the change works
55
- 4. **Respond:** Reply to the comment
56
-
57
- ```bash
58
- # After fixing
59
- git add -A
60
- git commit -m "fix: address review feedback - {description}"
61
- git push
62
- ```
63
-
64
- ### Step 4: Reply to Comments
65
-
66
- For each comment addressed:
67
- ```bash
68
- gh pr comment {PR_NUMBER} --body "Fixed in {commit_sha}"
69
- ```
70
-
71
- For questions:
72
- ```bash
73
- gh pr comment {PR_NUMBER} --body "Good question - {explanation}"
74
- ```
75
-
76
- ### Step 5: Request Re-review
77
-
78
- ```bash
79
- gh pr ready {PR_NUMBER}
80
- gh pr review {PR_NUMBER} --request
81
- ```
82
-
83
- ### Step 6: Summary
84
-
85
- ```markdown
86
- ## PR Feedback Addressed
87
-
88
- **Comments processed:** {X}
89
- **Changes made:** {Y}
90
- **Responses added:** {Z}
91
-
92
- ### Changes Made:
93
- - Fixed: {description}
94
- - Updated: {description}
95
-
96
- ### Awaiting Response:
97
- - Question about {topic}
98
-
99
- ### Next Steps:
100
- 1. Push changes: `git push`
101
- 2. Request re-review
102
- 3. Monitor for additional feedback
103
- ```
104
-
105
- ### Phase 5: Completion & Handoff
106
-
107
- #### Step 1: Establish Terminal UI State
108
-
109
- ```javascript
110
- await task_boundary({
111
- TaskName: "[COMPLETED] Resolve PR",
112
- TaskStatus: "PR feedback addressed. Offering next steps.",
113
- Mode: "VERIFICATION",
114
- TaskSummary: "Addressed {count} comments on PR #{number}. Fixes verified and pushed."
115
- });
116
- ```
117
-
118
- #### Step 2: Mandatory Handoff
119
-
120
- ```bash
121
- ✓ PR feedback resolved
122
-
123
- Next steps:
124
- 1. /housekeeping - Cleanup branches
125
- 2. /triage - Process any remaining feedback
126
- ```
127
-
128
- ---
129
-
130
- ## References
131
-
132
- - Review PRs: `/review`
133
- - Work on changes: `/work`
1
+ ---
2
+ description: Handle PR comments and review feedback efficiently. Use when addressing reviewer feedback.
3
+ ---
4
+
5
+ # /resolve_pr - Address PR Feedback
6
+
7
+ Work through PR comments and review feedback systematically.
8
+
9
+ ## When To Use
10
+
11
+ - When a PR has review comments
12
+ - After receiving change requests
13
+ - To batch-process reviewer feedback
14
+
15
+ ---
16
+
17
+ ## Workflow
18
+
19
+ ### Step 0: Search & Log
20
+
21
+ ```bash
22
+ // turbo
23
+ ./scripts/log-workflow.sh "/resolve_pr" "$$"
24
+ ./scripts/compound-search.sh "pull request review"
25
+ ```
26
+
27
+ ### Step 1: Fetch PR Comments
28
+
29
+ ```bash
30
+ # Get PR details
31
+ gh pr view {PR_NUMBER} --json comments,reviews
32
+
33
+ # List requested changes
34
+ gh pr view {PR_NUMBER} --json reviewRequests
35
+ ```
36
+
37
+ ### Step 2: Categorize Feedback
38
+
39
+ Group comments by type:
40
+
41
+ | Type | Action |
42
+ |------|--------|
43
+ | **Must fix** | Required for approval |
44
+ | **Suggestion** | Consider implementing |
45
+ | **Question** | Respond with clarification |
46
+ | **Praise** | Acknowledge, no action needed |
47
+
48
+ ### Step 3: Address Each Comment
49
+
50
+ For each must-fix comment:
51
+
52
+ 1. **Understand:** Read the feedback carefully
53
+ 2. **Fix:** Make the requested change
54
+ 3. **Test:** Verify the change works
55
+ 4. **Respond:** Reply to the comment
56
+
57
+ ```bash
58
+ # After fixing
59
+ git add -A
60
+ git commit -m "fix: address review feedback - {description}"
61
+ git push
62
+ ```
63
+
64
+ ### Step 4: Reply to Comments
65
+
66
+ For each comment addressed:
67
+ ```bash
68
+ gh pr comment {PR_NUMBER} --body "Fixed in {commit_sha}"
69
+ ```
70
+
71
+ For questions:
72
+ ```bash
73
+ gh pr comment {PR_NUMBER} --body "Good question - {explanation}"
74
+ ```
75
+
76
+ ### Step 5: Request Re-review
77
+
78
+ ```bash
79
+ gh pr ready {PR_NUMBER}
80
+ gh pr review {PR_NUMBER} --request
81
+ ```
82
+
83
+ ### Step 6: Summary
84
+
85
+ ```markdown
86
+ ## PR Feedback Addressed
87
+
88
+ **Comments processed:** {X}
89
+ **Changes made:** {Y}
90
+ **Responses added:** {Z}
91
+
92
+ ### Changes Made:
93
+ - Fixed: {description}
94
+ - Updated: {description}
95
+
96
+ ### Awaiting Response:
97
+ - Question about {topic}
98
+
99
+ ### Next Steps:
100
+ 1. Push changes: `git push`
101
+ 2. Request re-review
102
+ 3. Monitor for additional feedback
103
+ ```
104
+
105
+ ### Phase 5: Completion & Handoff
106
+
107
+ #### Step 1: Establish Terminal UI State
108
+
109
+ ```javascript
110
+ await task_boundary({
111
+ TaskName: "[COMPLETED] Resolve PR",
112
+ TaskStatus: "PR feedback addressed. Offering next steps.",
113
+ Mode: "VERIFICATION",
114
+ TaskSummary: "Addressed {count} comments on PR #{number}. Fixes verified and pushed."
115
+ });
116
+ ```
117
+
118
+ #### Step 2: Mandatory Handoff
119
+
120
+ ```bash
121
+ ✓ PR feedback resolved
122
+
123
+ Next steps:
124
+ 1. /housekeeping - Cleanup branches
125
+ 2. /triage - Process any remaining feedback
126
+ ```
127
+
128
+ ---
129
+
130
+ ## References
131
+
132
+ - Review PRs: `/review`
133
+ - Work on changes: `/work`