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,144 +1,144 @@
1
- ---
2
- description: Orchestrate the full "plan → review → work → review → compound" lifecycle for small tasks.
3
- ---
4
-
5
- # /cycle - Unified Small-Task Lifecycle
6
-
7
- Orchestrate the full "essential" development lifecycle for small, self-contained tasks. This workflow ensures rigorous quality without friction by chaining the standard workflows together.
8
-
9
- > **Why /cycle?** "Quick" tasks often skip steps like planning or review, leading to bugs. /cycle makes it easy to do it right.
10
-
11
- ## When To Use
12
-
13
- - For small, well-defined tasks (15-60 mins)
14
- - When "just fixing one thing"
15
- - To ensure you don't skip the "boring" but critical steps
16
-
17
- ---
18
-
19
- ## Workflow
20
-
21
- ### Step 0: Search & Log
22
-
23
- ```bash
24
- // turbo
25
- ./scripts/log-workflow.sh "/cycle" "$$"
26
- ./scripts/compound-search.sh "unified workflow" "cycle"
27
- ```
28
-
29
- ### Step 1: Planning
30
-
31
- Trigger the planning workflow.
32
-
33
- ```bash
34
- /plan
35
- ```
36
-
37
- *Guidance:* Use the **Minimal** or **Standard** template. Don't over-engineer, but DO capture:
38
- - Goal
39
- - Approach
40
- - Verification plan
41
-
42
- ### Step 2: Self-Review
43
-
44
- Review your own plan immediately.
45
-
46
- ```bash
47
- /plan_review
48
- ```
49
-
50
- *Guidance:*
51
- - Did you run `compound-search`?
52
- - Is the verification plan solid?
53
- - If yes → **Approved**.
54
-
55
- ### Step 3: Execution
56
-
57
- Execute the plan systematically.
58
-
59
- ```bash
60
- /work
61
- ```
62
-
63
- *Guidance:*
64
- - Mark the todo as in-progress: `./scripts/start-todo.sh todos/{todo}.md`
65
- - Create tests first if possible.
66
- - Update todos as you go.
67
-
68
- ### Step 4: Rapid Review
69
-
70
- Review the code changes.
71
-
72
- ```bash
73
- /review
74
- ```
75
-
76
- *Guidance:*
77
- - Run the **Security** and **Simplicity** passes.
78
- - Verify tests pass.
79
- - If self-approving (for non-critical path), be extra critical.
80
-
81
- ### Step 4.5: Complete Source Todo (CONDITIONAL)
82
-
83
- > [!CAUTION]
84
- > **IF WORKING FROM A TODO:** You must atomically mark it complete.
85
-
86
- **If this /cycle was triggered by a todo file:**
87
-
88
- ```bash
89
- ./scripts/done-todo.sh todos/{todo-filename}.md
90
- ```
91
-
92
- **Why:** This script updates YAML status AND renames the file atomically, preventing state drift ([Pattern #10](../../docs/solutions/patterns/critical-patterns.md#pattern-10-atomic-state-transitions)).
93
-
94
- **Skip this step if:**
95
- - Working from a plan file
96
- - No source todo exists
97
- - Todo is exploratory work
98
-
99
- ### Step 5: Capture Knowledge
100
-
101
- Don't skip this just because it was small.
102
-
103
- ```bash
104
- /compound
105
- ```
106
-
107
- *Guidance:*
108
- - Did you learn a new grep pattern?
109
- - Did you fix a tricky type error?
110
- - Document it!
111
-
112
- ### Step 6: Cleanup
113
-
114
- Archive and cleanup.
115
-
116
- ```bash
117
- /housekeeping
118
- ```
119
-
120
- ---
121
-
122
- ### Phase 5: Completion & Handoff
123
-
124
- #### Step 1: Establish Terminal UI State
125
-
126
- ```javascript
127
- await task_boundary({
128
- TaskName: "[COMPLETED] Cycle: {Task Name}",
129
- TaskStatus: "Cycle complete. All quality gates passed.",
130
- Mode: "VERIFICATION",
131
- TaskSummary: "Completed full development cycle for {task}. Passed plan, review, work, and compound stages."
132
- });
133
- ```
134
-
135
- #### Step 2: Mandatory Handoff
136
-
137
- ```bash
138
- ✓ Cycle complete
139
-
140
- Next steps:
141
- 1. /housekeeping - Final check before push
142
- 2. /review - Request peer review if necessary
143
- 3. Continue working
144
- ```
1
+ ---
2
+ description: Orchestrate the full "plan → review → work → review → compound" lifecycle for small tasks.
3
+ ---
4
+
5
+ # /cycle - Unified Small-Task Lifecycle
6
+
7
+ Orchestrate the full "essential" development lifecycle for small, self-contained tasks. This workflow ensures rigorous quality without friction by chaining the standard workflows together.
8
+
9
+ > **Why /cycle?** "Quick" tasks often skip steps like planning or review, leading to bugs. /cycle makes it easy to do it right.
10
+
11
+ ## When To Use
12
+
13
+ - For small, well-defined tasks (15-60 mins)
14
+ - When "just fixing one thing"
15
+ - To ensure you don't skip the "boring" but critical steps
16
+
17
+ ---
18
+
19
+ ## Workflow
20
+
21
+ ### Step 0: Search & Log
22
+
23
+ ```bash
24
+ // turbo
25
+ ./scripts/log-workflow.sh "/cycle" "$$"
26
+ ./scripts/compound-search.sh "unified workflow" "cycle"
27
+ ```
28
+
29
+ ### Step 1: Planning
30
+
31
+ Trigger the planning workflow.
32
+
33
+ ```bash
34
+ /plan
35
+ ```
36
+
37
+ *Guidance:* Use the **Minimal** or **Standard** template. Don't over-engineer, but DO capture:
38
+ - Goal
39
+ - Approach
40
+ - Verification plan
41
+
42
+ ### Step 2: Self-Review
43
+
44
+ Review your own plan immediately.
45
+
46
+ ```bash
47
+ /plan_review
48
+ ```
49
+
50
+ *Guidance:*
51
+ - Did you run `compound-search`?
52
+ - Is the verification plan solid?
53
+ - If yes → **Approved**.
54
+
55
+ ### Step 3: Execution
56
+
57
+ Execute the plan systematically.
58
+
59
+ ```bash
60
+ /work
61
+ ```
62
+
63
+ *Guidance:*
64
+ - Mark the todo as in-progress: `./scripts/start-todo.sh todos/{todo}.md`
65
+ - Create tests first if possible.
66
+ - Update todos as you go.
67
+
68
+ ### Step 4: Rapid Review
69
+
70
+ Review the code changes.
71
+
72
+ ```bash
73
+ /review
74
+ ```
75
+
76
+ *Guidance:*
77
+ - Run the **Security** and **Simplicity** passes.
78
+ - Verify tests pass.
79
+ - If self-approving (for non-critical path), be extra critical.
80
+
81
+ ### Step 4.5: Complete Source Todo (CONDITIONAL)
82
+
83
+ > [!CAUTION]
84
+ > **IF WORKING FROM A TODO:** You must atomically mark it complete.
85
+
86
+ **If this /cycle was triggered by a todo file:**
87
+
88
+ ```bash
89
+ ./scripts/done-todo.sh todos/{todo-filename}.md
90
+ ```
91
+
92
+ **Why:** This script updates YAML status AND renames the file atomically, preventing state drift ([Pattern #10](../../docs/solutions/patterns/critical-patterns.md#pattern-10-atomic-state-transitions)).
93
+
94
+ **Skip this step if:**
95
+ - Working from a plan file
96
+ - No source todo exists
97
+ - Todo is exploratory work
98
+
99
+ ### Step 5: Capture Knowledge
100
+
101
+ Don't skip this just because it was small.
102
+
103
+ ```bash
104
+ /compound
105
+ ```
106
+
107
+ *Guidance:*
108
+ - Did you learn a new grep pattern?
109
+ - Did you fix a tricky type error?
110
+ - Document it!
111
+
112
+ ### Step 6: Cleanup
113
+
114
+ Archive and cleanup.
115
+
116
+ ```bash
117
+ /housekeeping
118
+ ```
119
+
120
+ ---
121
+
122
+ ### Phase 5: Completion & Handoff
123
+
124
+ #### Step 1: Establish Terminal UI State
125
+
126
+ ```javascript
127
+ await task_boundary({
128
+ TaskName: "[COMPLETED] Cycle: {Task Name}",
129
+ TaskStatus: "Cycle complete. All quality gates passed.",
130
+ Mode: "VERIFICATION",
131
+ TaskSummary: "Completed full development cycle for {task}. Passed plan, review, work, and compound stages."
132
+ });
133
+ ```
134
+
135
+ #### Step 2: Mandatory Handoff
136
+
137
+ ```bash
138
+ ✓ Cycle complete
139
+
140
+ Next steps:
141
+ 1. /housekeeping - Final check before push
142
+ 2. /review - Request peer review if necessary
143
+ 3. Continue working
144
+ ```
@@ -1,84 +1,84 @@
1
- ---
2
- description: Deploy documentation updates. Use when publishing docs changes.
3
- ---
4
-
5
- # /deploy-docs - Documentation Deployment
6
-
7
- Deploy documentation to hosting platform.
8
-
9
- ## Workflow
10
-
11
- ### Step 0: Search & Log
12
-
13
- ```bash
14
- // turbo
15
- ./scripts/log-workflow.sh "/deploy-docs" "$$"
16
- ./scripts/compound-search.sh "deployment"
17
- ```
18
-
19
- ### Step 1: Build Documentation
20
-
21
- ```bash
22
- # For most doc systems
23
- npm run docs:build
24
- # or
25
- mkdocs build
26
- # or
27
- mdbook build
28
- ```
29
-
30
- ### Step 2: Preview Locally
31
-
32
- ```bash
33
- npm run docs:serve
34
- # or
35
- mkdocs serve
36
- # or
37
- python -m http.server 8000 -d dist/
38
- ```
39
-
40
- ### Step 3: Deploy
41
-
42
- ```bash
43
- # GitHub Pages
44
- npm run docs:deploy
45
-
46
- # Vercel
47
- vercel --prod
48
-
49
- # Netlify
50
- netlify deploy --prod
51
-
52
- # Manual
53
- rsync -avz dist/ user@server:/var/www/docs/
54
- ```
55
-
56
- ### Step 4: Verify
57
-
58
- - [ ] Docs accessible at URL
59
- - [ ] All pages load
60
- - [ ] Search works
61
- - [ ] Links not broken
62
-
63
- ### Phase 5: Completion & Handoff
64
-
65
- #### Step 1: Establish Terminal UI State
66
-
67
- ```javascript
68
- await task_boundary({
69
- TaskName: "[COMPLETED] Deploy Documentation",
70
- TaskStatus: "Docs deployed and verified. Offering next steps.",
71
- Mode: "VERIFICATION",
72
- TaskSummary: "Deployed docs to {target}. Verified accessibility and links."
73
- });
74
- ```
75
-
76
- #### Step 2: Mandatory Handoff
77
-
78
- ```bash
79
- ✓ Docs deployed
80
-
81
- Next steps:
82
- 1. /housekeeping - Cleanup artifacts
83
- 2. /work - Resume development
84
- ```
1
+ ---
2
+ description: Deploy documentation updates. Use when publishing docs changes.
3
+ ---
4
+
5
+ # /deploy-docs - Documentation Deployment
6
+
7
+ Deploy documentation to hosting platform.
8
+
9
+ ## Workflow
10
+
11
+ ### Step 0: Search & Log
12
+
13
+ ```bash
14
+ // turbo
15
+ ./scripts/log-workflow.sh "/deploy-docs" "$$"
16
+ ./scripts/compound-search.sh "deployment"
17
+ ```
18
+
19
+ ### Step 1: Build Documentation
20
+
21
+ ```bash
22
+ # For most doc systems
23
+ npm run docs:build
24
+ # or
25
+ mkdocs build
26
+ # or
27
+ mdbook build
28
+ ```
29
+
30
+ ### Step 2: Preview Locally
31
+
32
+ ```bash
33
+ npm run docs:serve
34
+ # or
35
+ mkdocs serve
36
+ # or
37
+ python -m http.server 8000 -d dist/
38
+ ```
39
+
40
+ ### Step 3: Deploy
41
+
42
+ ```bash
43
+ # GitHub Pages
44
+ npm run docs:deploy
45
+
46
+ # Vercel
47
+ vercel --prod
48
+
49
+ # Netlify
50
+ netlify deploy --prod
51
+
52
+ # Manual
53
+ rsync -avz dist/ user@server:/var/www/docs/
54
+ ```
55
+
56
+ ### Step 4: Verify
57
+
58
+ - [ ] Docs accessible at URL
59
+ - [ ] All pages load
60
+ - [ ] Search works
61
+ - [ ] Links not broken
62
+
63
+ ### Phase 5: Completion & Handoff
64
+
65
+ #### Step 1: Establish Terminal UI State
66
+
67
+ ```javascript
68
+ await task_boundary({
69
+ TaskName: "[COMPLETED] Deploy Documentation",
70
+ TaskStatus: "Docs deployed and verified. Offering next steps.",
71
+ Mode: "VERIFICATION",
72
+ TaskSummary: "Deployed docs to {target}. Verified accessibility and links."
73
+ });
74
+ ```
75
+
76
+ #### Step 2: Mandatory Handoff
77
+
78
+ ```bash
79
+ ✓ Docs deployed
80
+
81
+ Next steps:
82
+ 1. /housekeeping - Cleanup artifacts
83
+ 2. /work - Resume development
84
+ ```
@@ -1,37 +1,37 @@
1
- # Development Rules
2
-
3
- ## Code Quality Standards
4
-
5
- ### TypeScript
6
- - Strict mode enabled
7
- - No implicit `any`
8
- - Proper null checks
9
-
10
- ### Testing
11
- - Unit tests for new features
12
- - Integration tests for workflows
13
- - Coverage target: 80%
14
-
15
- ### Code Style
16
- - ESLint + Prettier
17
- - Max line length: 100
18
- - Use arrow functions
19
-
20
- ## Pre-commit Procedures
21
-
22
- 1. Run tests: `npm test`
23
- 2. Type check: `npm run build`
24
- 3. Lint: `npm run lint`
25
- 4. Update docs if API changed
26
-
27
- ## Subagent Orchestration
28
-
29
- ### Sequential (Default)
30
- ```
31
- Planner → Scout → Coder → Tester → Reviewer → Git
32
- ```
33
-
34
- ### Parallel (Independent tasks)
35
- - Multiple file reviews
36
- - Concurrent doc updates
37
- - Parallel tests
1
+ # Development Rules
2
+
3
+ ## Code Quality Standards
4
+
5
+ ### TypeScript
6
+ - Strict mode enabled
7
+ - No implicit `any`
8
+ - Proper null checks
9
+
10
+ ### Testing
11
+ - Unit tests for new features
12
+ - Integration tests for workflows
13
+ - Coverage target: 80%
14
+
15
+ ### Code Style
16
+ - ESLint + Prettier
17
+ - Max line length: 100
18
+ - Use arrow functions
19
+
20
+ ## Pre-commit Procedures
21
+
22
+ 1. Run tests: `npm test`
23
+ 2. Type check: `npm run build`
24
+ 3. Lint: `npm run lint`
25
+ 4. Update docs if API changed
26
+
27
+ ## Subagent Orchestration
28
+
29
+ ### Sequential (Default)
30
+ ```
31
+ Planner → Scout → Coder → Tester → Reviewer → Git
32
+ ```
33
+
34
+ ### Parallel (Independent tasks)
35
+ - Multiple file reviews
36
+ - Concurrent doc updates
37
+ - Parallel tests