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,118 +1,118 @@
1
- # Formatting Standards Reference
2
-
3
- | Element | Format |
4
- |---------|--------|
5
- | Hard-coded inputs | Blue font |
6
- | Formulas | Black font |
7
- | Links to other sheets | Green font |
8
- | Check cells | Red if error, green if balanced |
9
- | Negative values | Parentheses, not minus signs |
10
- | Currency | No decimals for large figures, 2 decimals for per-share |
11
- | Percentages | 1 decimal place |
12
- | Headers | Bold, bottom border |
13
- | Units row | Include units row below headers ($ millions, %, etc.) |
14
-
15
- ## Visual Separation Guidelines
16
-
17
- - Thin vertical border between historical and projected columns
18
- - Thick bottom border after section totals (e.g., Total Assets)
19
- - Single bottom border for subtotals
20
- - Double bottom border for grand totals
21
-
22
- ## Total and Subtotal Row Formatting
23
-
24
- All total and subtotal rows must use **bold font formatting** for their numerical values to clearly distinguish aggregated figures from individual line items.
25
-
26
- ### Income Statement (P&L) Tab
27
- | Row | Formatting |
28
- |-----|------------|
29
- | Gross Revenue | Bold |
30
- | Total Cost of Revenue | Bold |
31
- | Gross Profit | Bold |
32
- | Total SG&A | Bold |
33
- | EBITDA | Bold |
34
- | EBIT | Bold |
35
- | EBT | Bold |
36
- | Net Profit After Tax | Bold |
37
-
38
- ### Balance Sheet Tab
39
- | Row | Formatting |
40
- |-----|------------|
41
- | Total Current Assets | Bold |
42
- | Total Non-Current Assets | Bold |
43
- | Total Other Assets | Bold |
44
- | Total Assets | Bold |
45
- | Total Current Liabilities | Bold |
46
- | Total Non-Current Liabilities | Bold |
47
- | Total Equity | Bold |
48
- | Total Liabilities and Equity | Bold |
49
-
50
- ### Cash Flow Statement Tab
51
- | Row | Formatting |
52
- |-----|------------|
53
- | Cash Generated from Operations Before Working Capital Changes | Bold |
54
- | Total Working Capital Changes | Bold |
55
- | Net Cash Generated from Operations | Bold |
56
- | Net Cash Flow from Investing Activities | Bold |
57
- | Net Cash Flow from Financing Activities | Bold |
58
- | Closing Cash Balance | Bold |
59
-
60
- **Note:** This list is non-exhaustive. Apply bold formatting to any row that represents a total, subtotal, or summary calculation across the model.
61
-
62
- ## Balance Sheet Check Row Formatting
63
-
64
- The Balance Sheet check row (below Total Liabilities and Equity) uses conditional number formatting that displays non-zero values in red. When the balance sheet balances correctly (check = 0), the values display in black or standard formatting.
65
-
66
- | Check Value | Font Color |
67
- |-------------|------------|
68
- | = 0 (balanced) | Black (standard) |
69
- | ≠ 0 (error) | Red |
70
-
71
- **Implementation:** Apply custom number format `[Red][<>0]0.00;[Red][<>0](0.00);0.00` or use Excel conditional formatting with the rule "Cell Value ≠ 0" → Red font.
72
-
73
- ## Margin Row Formatting
74
-
75
- | Element | Format |
76
- |---------|--------|
77
- | Margin % rows | Indent, italics, 1 decimal place |
78
- | Positive trend | No special formatting (or subtle green) |
79
- | Negative trend | Flag for review (subtle yellow) |
80
- | Below peer average | Consider highlighting for discussion |
81
-
82
- ## Credit Metric Formatting
83
-
84
- | Element | Format |
85
- |---------|--------|
86
- | Leverage multiples | 1 decimal with "x" suffix (e.g., 2.5x) |
87
- | Percentages | 1 decimal with "%" suffix |
88
- | Net Debt negative | Parentheses, indicates net cash position |
89
- | Section header | Bold, "CREDIT METRICS" |
90
- | Separator line | Thin border above credit metrics section |
91
-
92
- ## Credit Metric Threshold Colors
93
-
94
- | Metric | Green | Yellow | Red |
95
- |--------|-------|--------|-----|
96
- | Total Debt / EBITDA | < 2.5x | 2.5x-4.0x | > 4.0x |
97
- | Net Debt / EBITDA | < 2.0x | 2.0x-3.5x | > 3.5x |
98
- | Interest Coverage | > 4.0x | 2.5x-4.0x | < 2.5x |
99
- | Debt / Total Cap | < 40% | 40%-60% | > 60% |
100
- | Current Ratio | > 1.5x | 1.0x-1.5x | < 1.0x |
101
- | Quick Ratio | > 1.0x | 0.75x-1.0x | < 0.75x |
102
-
103
- ## Conditional Formatting for Checks Tab
104
-
105
- - Cell contains pass indicator → Green fill
106
- - Cell contains fail indicator → Red fill
107
- - Cell contains warning → Yellow fill
108
- - Difference cells = 0 → Light green fill
109
- - Difference cells ≠ 0 → Light red fill
110
-
111
- ## Margin Reasonability Flags
112
-
113
- - Gross Margin < 0% → ERROR: Review COGS
114
- - Gross Margin > 80% → WARNING: Verify revenue/COGS
115
- - EBITDA Margin < 0% → FLAG: Operating losses
116
- - EBITDA Margin > 50% → WARNING: Unusually high
117
- - Net Margin < 0% → FLAG: Net losses (may be acceptable in growth phase)
118
- - Net Margin > Gross Margin → ERROR: Formula issue
1
+ # Formatting Standards Reference
2
+
3
+ | Element | Format |
4
+ |---------|--------|
5
+ | Hard-coded inputs | Blue font |
6
+ | Formulas | Black font |
7
+ | Links to other sheets | Green font |
8
+ | Check cells | Red if error, green if balanced |
9
+ | Negative values | Parentheses, not minus signs |
10
+ | Currency | No decimals for large figures, 2 decimals for per-share |
11
+ | Percentages | 1 decimal place |
12
+ | Headers | Bold, bottom border |
13
+ | Units row | Include units row below headers ($ millions, %, etc.) |
14
+
15
+ ## Visual Separation Guidelines
16
+
17
+ - Thin vertical border between historical and projected columns
18
+ - Thick bottom border after section totals (e.g., Total Assets)
19
+ - Single bottom border for subtotals
20
+ - Double bottom border for grand totals
21
+
22
+ ## Total and Subtotal Row Formatting
23
+
24
+ All total and subtotal rows must use **bold font formatting** for their numerical values to clearly distinguish aggregated figures from individual line items.
25
+
26
+ ### Income Statement (P&L) Tab
27
+ | Row | Formatting |
28
+ |-----|------------|
29
+ | Gross Revenue | Bold |
30
+ | Total Cost of Revenue | Bold |
31
+ | Gross Profit | Bold |
32
+ | Total SG&A | Bold |
33
+ | EBITDA | Bold |
34
+ | EBIT | Bold |
35
+ | EBT | Bold |
36
+ | Net Profit After Tax | Bold |
37
+
38
+ ### Balance Sheet Tab
39
+ | Row | Formatting |
40
+ |-----|------------|
41
+ | Total Current Assets | Bold |
42
+ | Total Non-Current Assets | Bold |
43
+ | Total Other Assets | Bold |
44
+ | Total Assets | Bold |
45
+ | Total Current Liabilities | Bold |
46
+ | Total Non-Current Liabilities | Bold |
47
+ | Total Equity | Bold |
48
+ | Total Liabilities and Equity | Bold |
49
+
50
+ ### Cash Flow Statement Tab
51
+ | Row | Formatting |
52
+ |-----|------------|
53
+ | Cash Generated from Operations Before Working Capital Changes | Bold |
54
+ | Total Working Capital Changes | Bold |
55
+ | Net Cash Generated from Operations | Bold |
56
+ | Net Cash Flow from Investing Activities | Bold |
57
+ | Net Cash Flow from Financing Activities | Bold |
58
+ | Closing Cash Balance | Bold |
59
+
60
+ **Note:** This list is non-exhaustive. Apply bold formatting to any row that represents a total, subtotal, or summary calculation across the model.
61
+
62
+ ## Balance Sheet Check Row Formatting
63
+
64
+ The Balance Sheet check row (below Total Liabilities and Equity) uses conditional number formatting that displays non-zero values in red. When the balance sheet balances correctly (check = 0), the values display in black or standard formatting.
65
+
66
+ | Check Value | Font Color |
67
+ |-------------|------------|
68
+ | = 0 (balanced) | Black (standard) |
69
+ | ≠ 0 (error) | Red |
70
+
71
+ **Implementation:** Apply custom number format `[Red][<>0]0.00;[Red][<>0](0.00);0.00` or use Excel conditional formatting with the rule "Cell Value ≠ 0" → Red font.
72
+
73
+ ## Margin Row Formatting
74
+
75
+ | Element | Format |
76
+ |---------|--------|
77
+ | Margin % rows | Indent, italics, 1 decimal place |
78
+ | Positive trend | No special formatting (or subtle green) |
79
+ | Negative trend | Flag for review (subtle yellow) |
80
+ | Below peer average | Consider highlighting for discussion |
81
+
82
+ ## Credit Metric Formatting
83
+
84
+ | Element | Format |
85
+ |---------|--------|
86
+ | Leverage multiples | 1 decimal with "x" suffix (e.g., 2.5x) |
87
+ | Percentages | 1 decimal with "%" suffix |
88
+ | Net Debt negative | Parentheses, indicates net cash position |
89
+ | Section header | Bold, "CREDIT METRICS" |
90
+ | Separator line | Thin border above credit metrics section |
91
+
92
+ ## Credit Metric Threshold Colors
93
+
94
+ | Metric | Green | Yellow | Red |
95
+ |--------|-------|--------|-----|
96
+ | Total Debt / EBITDA | < 2.5x | 2.5x-4.0x | > 4.0x |
97
+ | Net Debt / EBITDA | < 2.0x | 2.0x-3.5x | > 3.5x |
98
+ | Interest Coverage | > 4.0x | 2.5x-4.0x | < 2.5x |
99
+ | Debt / Total Cap | < 40% | 40%-60% | > 60% |
100
+ | Current Ratio | > 1.5x | 1.0x-1.5x | < 1.0x |
101
+ | Quick Ratio | > 1.0x | 0.75x-1.0x | < 0.75x |
102
+
103
+ ## Conditional Formatting for Checks Tab
104
+
105
+ - Cell contains pass indicator → Green fill
106
+ - Cell contains fail indicator → Red fill
107
+ - Cell contains warning → Yellow fill
108
+ - Difference cells = 0 → Light green fill
109
+ - Difference cells ≠ 0 → Light red fill
110
+
111
+ ## Margin Reasonability Flags
112
+
113
+ - Gross Margin < 0% → ERROR: Review COGS
114
+ - Gross Margin > 80% → WARNING: Verify revenue/COGS
115
+ - EBITDA Margin < 0% → FLAG: Operating losses
116
+ - EBITDA Margin > 50% → WARNING: Unusually high
117
+ - Net Margin < 0% → FLAG: Net losses (may be acceptable in growth phase)
118
+ - Net Margin > Gross Margin → ERROR: Formula issue