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,74 +1,74 @@
1
- ---
2
- description: Check the improved Compound System's health and usage metrics.
3
- ---
4
-
5
- # /compound_health - System Health Check
6
-
7
- Use this workflow weekly to ensure the Compound System is actually working.
8
-
9
- ## Workflow
10
-
11
- ### Step 0: Search & Log
12
-
13
- ```bash
14
- // turbo
15
- ./scripts/log-workflow.sh "/compound_health" "$$"
16
- ./scripts/compound-search.sh "system health"
17
- ```
18
-
19
- ### Step 1: Run Health Dashboard
20
-
21
- ```bash
22
- ./scripts/compound-health.sh
23
- ```
24
-
25
- ### Step 2: Analyze Metrics
26
-
27
- **Coverage:**
28
- - **Target:** >50%
29
- - **Action if Low:** Commit to running `/compound-search` before every `/plan`.
30
-
31
- **Usage:**
32
- - **Target:** >3 invocations/week
33
- - **Action if Low:** Remind yourself to use the scripts!
34
-
35
- **Staleness:**
36
- - **Action:** Any solution not referenced in >6 months -> Review for deprecation.
37
-
38
- ### Step 3: Maintenance
39
-
40
- 1. **Fix Orphans**: Run `./scripts/update-solution-ref.sh` on solutions you know you've used recently.
41
- 2. **Promote Patterns**: If new pattern candidates are identified, run `/compound`.
42
-
43
- ### Step 4: Record Status
44
-
45
- Add an entry to `docs/solutions/changelog.md` (or equivalent) noting the health stats.
46
-
47
- ### Phase 5: Completion & Handoff
48
-
49
- #### Step 1: Establish Terminal UI State
50
-
51
- ```javascript
52
- await task_boundary({
53
- TaskName: "[COMPLETED] System Health Check",
54
- TaskStatus: "Health checked and recorded. Offering next steps.",
55
- Mode: "VERIFICATION",
56
- TaskSummary: "Completed system health check. Grade: {grade}, Coverage: {coverage}%."
57
- });
58
- ```
59
-
60
- #### Step 2: Mandatory Handoff
61
-
62
- ```bash
63
- ✓ Health check complete
64
-
65
- Next steps:
66
- 1. /housekeeping - Fix any issues found
67
- 2. /plan - Plan improvements to lower technical debt
68
- ```
69
-
70
- ---
71
-
72
- ## References
73
-
74
- - [Health Script](../../scripts/compound-health.sh)
1
+ ---
2
+ description: Check the improved Compound System's health and usage metrics.
3
+ ---
4
+
5
+ # /compound_health - System Health Check
6
+
7
+ Use this workflow weekly to ensure the Compound System is actually working.
8
+
9
+ ## Workflow
10
+
11
+ ### Step 0: Search & Log
12
+
13
+ ```bash
14
+ // turbo
15
+ ./scripts/log-workflow.sh "/compound_health" "$$"
16
+ ./scripts/compound-search.sh "system health"
17
+ ```
18
+
19
+ ### Step 1: Run Health Dashboard
20
+
21
+ ```bash
22
+ ./scripts/compound-health.sh
23
+ ```
24
+
25
+ ### Step 2: Analyze Metrics
26
+
27
+ **Coverage:**
28
+ - **Target:** >50%
29
+ - **Action if Low:** Commit to running `/compound-search` before every `/plan`.
30
+
31
+ **Usage:**
32
+ - **Target:** >3 invocations/week
33
+ - **Action if Low:** Remind yourself to use the scripts!
34
+
35
+ **Staleness:**
36
+ - **Action:** Any solution not referenced in >6 months -> Review for deprecation.
37
+
38
+ ### Step 3: Maintenance
39
+
40
+ 1. **Fix Orphans**: Run `./scripts/update-solution-ref.sh` on solutions you know you've used recently.
41
+ 2. **Promote Patterns**: If new pattern candidates are identified, run `/compound`.
42
+
43
+ ### Step 4: Record Status
44
+
45
+ Add an entry to `docs/solutions/changelog.md` (or equivalent) noting the health stats.
46
+
47
+ ### Phase 5: Completion & Handoff
48
+
49
+ #### Step 1: Establish Terminal UI State
50
+
51
+ ```javascript
52
+ await task_boundary({
53
+ TaskName: "[COMPLETED] System Health Check",
54
+ TaskStatus: "Health checked and recorded. Offering next steps.",
55
+ Mode: "VERIFICATION",
56
+ TaskSummary: "Completed system health check. Grade: {grade}, Coverage: {coverage}%."
57
+ });
58
+ ```
59
+
60
+ #### Step 2: Mandatory Handoff
61
+
62
+ ```bash
63
+ ✓ Health check complete
64
+
65
+ Next steps:
66
+ 1. /housekeeping - Fix any issues found
67
+ 2. /plan - Plan improvements to lower technical debt
68
+ ```
69
+
70
+ ---
71
+
72
+ ## References
73
+
74
+ - [Health Script](../../scripts/compound-health.sh)
@@ -1,139 +1,139 @@
1
- ---
2
- description: Create new skills for extending agent capabilities. Use to add new domain expertise.
3
- ---
4
-
5
- # /create-agent-skill - Build New Skills
6
-
7
- Create modular skills that extend agent capabilities.
8
-
9
- ## Skill Architecture
10
-
11
- Skills are filesystem-based capabilities:
12
-
13
- ```
14
- skills/{skill-name}/
15
- ├── SKILL.md # Router + essential principles (always loaded)
16
- ├── workflows/ # Step-by-step procedures
17
- ├── references/ # Domain knowledge
18
- ├── templates/ # Output structures
19
- └── scripts/ # Reusable code
20
- ```
21
-
22
- ## Workflow
23
-
24
- ### Step 0: Check for Existing Skills/Logic
25
-
26
- Verify that a similar skill doesn't already exist or that existing scripts can't be reused to achieve the goal.
27
-
28
- ```bash
29
- // turbo
30
- ./scripts/log-workflow.sh "/create-agent-skill" "$$"
31
- ./scripts/compound-search.sh "new skill creation"
32
-
33
- ls skills/
34
- grep -r "{skill keywords}" skills/
35
- ```
36
-
37
- ---
38
-
39
- ### Step 1: Define Skill Purpose
40
-
41
- ```
42
- Skill name: {name}
43
- Domain: {area of expertise}
44
- Core capability: {what it enables}
45
- ```
46
-
47
- ### Step 2: Create Directory Structure
48
-
49
- ```bash
50
- mkdir -p skills/{skill-name}/{workflows,references,templates,scripts}
51
- ```
52
-
53
- ### Step 3: Create SKILL.md (Router)
54
-
55
- ```markdown
56
- ---
57
- name: {skill-name}
58
- description: {what this skill provides}
59
- ---
60
-
61
- # {Skill Name}
62
-
63
- ## Overview
64
-
65
- {Brief description of capability}
66
-
67
- - {Condition 2}
68
-
69
- ## Instrumentation
70
-
71
- ```bash
72
- # Log usage when using this skill
73
- ./scripts/log-skill.sh "{skill-name}" "manual" "$$"
74
- ```
75
-
76
- ## What do you want to do?
77
-
78
- 1. **{Action 1}** → Read `workflows/action1.md`
79
- 2. **{Action 2}** → Read `workflows/action2.md`
80
- 3. **{Action 3}** → Read `references/knowledge.md`
81
- ```
82
-
83
- ### Step 4: Add Workflows
84
-
85
- Create step-by-step procedures in `workflows/`:
86
-
87
- ```markdown
88
- # {Workflow Name}
89
-
90
- ## Prerequisites
91
- - {Required setup}
92
-
93
- ## Steps
94
- 1. {Step 1}
95
- 2. {Step 2}
96
- 3. {Step 3}
97
-
98
- ## Expected Output
99
- {What success looks like}
100
- ```
101
-
102
- ### Step 5: Add References
103
-
104
- Add domain knowledge in `references/`:
105
- - Best practices
106
- - Common patterns
107
- - Examples
108
-
109
- ### Phase 5: Completion & Handoff
110
-
111
- #### Step 1: Establish Terminal UI State
112
-
113
- ```javascript
114
- await task_boundary({
115
- TaskName: "[COMPLETED] New Skill: {Skill Name}",
116
- TaskStatus: "Skill created and instrumented. Offering next steps.",
117
- Mode: "VERIFICATION",
118
- TaskSummary: "Created new skill {name} with structure: SKILL.md, workflows/, references/."
119
- });
120
- ```
121
-
122
- #### Step 2: Mandatory Handoff
123
-
124
- ```bash
125
- ✓ Skill created: skills/{name}/
126
-
127
- Next steps:
128
- 1. /work - Implement workflows for the new skill
129
- 2. /compound - Document the new capability
130
- ```
131
-
132
- ---
133
-
134
- ## Principles
135
-
136
- 1. **Skills are prompts** - All prompting best practices apply
137
- 2. **SKILL.md is always loaded** - Keep essential principles inline
138
- 3. **Router pattern** - Ask what to do, then route
139
- 4. **Progressive disclosure** - Load only what's needed
1
+ ---
2
+ description: Create new skills for extending agent capabilities. Use to add new domain expertise.
3
+ ---
4
+
5
+ # /create-agent-skill - Build New Skills
6
+
7
+ Create modular skills that extend agent capabilities.
8
+
9
+ ## Skill Architecture
10
+
11
+ Skills are filesystem-based capabilities:
12
+
13
+ ```
14
+ skills/{skill-name}/
15
+ ├── SKILL.md # Router + essential principles (always loaded)
16
+ ├── workflows/ # Step-by-step procedures
17
+ ├── references/ # Domain knowledge
18
+ ├── templates/ # Output structures
19
+ └── scripts/ # Reusable code
20
+ ```
21
+
22
+ ## Workflow
23
+
24
+ ### Step 0: Check for Existing Skills/Logic
25
+
26
+ Verify that a similar skill doesn't already exist or that existing scripts can't be reused to achieve the goal.
27
+
28
+ ```bash
29
+ // turbo
30
+ ./scripts/log-workflow.sh "/create-agent-skill" "$$"
31
+ ./scripts/compound-search.sh "new skill creation"
32
+
33
+ ls skills/
34
+ grep -r "{skill keywords}" skills/
35
+ ```
36
+
37
+ ---
38
+
39
+ ### Step 1: Define Skill Purpose
40
+
41
+ ```
42
+ Skill name: {name}
43
+ Domain: {area of expertise}
44
+ Core capability: {what it enables}
45
+ ```
46
+
47
+ ### Step 2: Create Directory Structure
48
+
49
+ ```bash
50
+ mkdir -p skills/{skill-name}/{workflows,references,templates,scripts}
51
+ ```
52
+
53
+ ### Step 3: Create SKILL.md (Router)
54
+
55
+ ```markdown
56
+ ---
57
+ name: {skill-name}
58
+ description: {what this skill provides}
59
+ ---
60
+
61
+ # {Skill Name}
62
+
63
+ ## Overview
64
+
65
+ {Brief description of capability}
66
+
67
+ - {Condition 2}
68
+
69
+ ## Instrumentation
70
+
71
+ ```bash
72
+ # Log usage when using this skill
73
+ ./scripts/log-skill.sh "{skill-name}" "manual" "$$"
74
+ ```
75
+
76
+ ## What do you want to do?
77
+
78
+ 1. **{Action 1}** → Read `workflows/action1.md`
79
+ 2. **{Action 2}** → Read `workflows/action2.md`
80
+ 3. **{Action 3}** → Read `references/knowledge.md`
81
+ ```
82
+
83
+ ### Step 4: Add Workflows
84
+
85
+ Create step-by-step procedures in `workflows/`:
86
+
87
+ ```markdown
88
+ # {Workflow Name}
89
+
90
+ ## Prerequisites
91
+ - {Required setup}
92
+
93
+ ## Steps
94
+ 1. {Step 1}
95
+ 2. {Step 2}
96
+ 3. {Step 3}
97
+
98
+ ## Expected Output
99
+ {What success looks like}
100
+ ```
101
+
102
+ ### Step 5: Add References
103
+
104
+ Add domain knowledge in `references/`:
105
+ - Best practices
106
+ - Common patterns
107
+ - Examples
108
+
109
+ ### Phase 5: Completion & Handoff
110
+
111
+ #### Step 1: Establish Terminal UI State
112
+
113
+ ```javascript
114
+ await task_boundary({
115
+ TaskName: "[COMPLETED] New Skill: {Skill Name}",
116
+ TaskStatus: "Skill created and instrumented. Offering next steps.",
117
+ Mode: "VERIFICATION",
118
+ TaskSummary: "Created new skill {name} with structure: SKILL.md, workflows/, references/."
119
+ });
120
+ ```
121
+
122
+ #### Step 2: Mandatory Handoff
123
+
124
+ ```bash
125
+ ✓ Skill created: skills/{name}/
126
+
127
+ Next steps:
128
+ 1. /work - Implement workflows for the new skill
129
+ 2. /compound - Document the new capability
130
+ ```
131
+
132
+ ---
133
+
134
+ ## Principles
135
+
136
+ 1. **Skills are prompts** - All prompting best practices apply
137
+ 2. **SKILL.md is always loaded** - Keep essential principles inline
138
+ 3. **Router pattern** - Ask what to do, then route
139
+ 4. **Progressive disclosure** - Load only what's needed