superkit-mcp-server 1.2.2 → 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 +18 -9
  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,96 +1,96 @@
1
- ---
2
- name: session-resume
3
- description: Resume context from previous session
4
- ---
5
-
6
- # Session Resume Skill
7
-
8
- Helps agents quickly understand where work left off when starting a new session.
9
-
10
- ## When To Use
11
-
12
- - At the **start of any new conversation**
13
- - When context seems missing
14
- - When user asks "what were we working on?"
15
-
16
- ## Instrumentation
17
-
18
- ```bash
19
- # Log usage when using this skill
20
- Call MCP `call_tool_logger_manager` { action: "logSkill", name: "session-resume", outcome: "manual" }
21
- ```
22
-
23
- ---
24
-
25
- ## Quick Resume Checklist
26
-
27
- ### 1. Check Active Work
28
-
29
- ```bash
30
- # Ready todos (highest priority)
31
- ls todos/*-ready-*.md 2>/dev/null | head -5
32
-
33
- # In-progress plans
34
- ls plans/*.md 2>/dev/null
35
-
36
- # Recent solutions (for context)
37
- ls -t docs/solutions/**/*.md 2>/dev/null | head -3
38
- ```
39
-
40
- ### 2. Check Recent Git Activity
41
-
42
- ```bash
43
- # Recent commits
44
- git log --oneline -5
45
-
46
- # Uncommitted changes
47
- git status --short
48
- ```
49
-
50
- ### 3. Summarize Context
51
-
52
- After gathering info, summarize:
53
-
54
- ### 4. Check System Health
55
-
56
- ```bash
57
- Call MCP `call_tool_compound_manager` { action: "dashboard" }
58
- ```
59
-
60
- Review health grade and recommendations before starting work.
61
-
62
- ### 5. Final Summary
63
-
64
- ```
65
- 📍 Session Context:
66
-
67
- **Active Work:**
68
- - {X} ready todos waiting
69
- - Plan in progress: {plan name if any}
70
-
71
- **Recent Activity:**
72
- - Last commit: {subject}
73
- - {Changed files if uncommitted}
74
-
75
- **Suggested Next Steps:**
76
- 1. {Most logical next action}
77
- 2. {Alternative}
78
- ```
79
-
80
- ---
81
-
82
- ## Automatic Triggers
83
-
84
- Consider running this skill when you see:
85
- - User starts with "continue", "resume", "where were we"
86
- - First message in a new session
87
- - User seems to lack context
88
-
89
- ---
90
-
91
- ## References
92
-
93
- - Todos: `todos/`
94
- - Plans: `plans/`
95
- - Solutions: `docs/solutions/`
96
- - Workflows: `.agent/workflows/`
1
+ ---
2
+ name: session-resume
3
+ description: Resume context from previous session
4
+ ---
5
+
6
+ # Session Resume Skill
7
+
8
+ Helps agents quickly understand where work left off when starting a new session.
9
+
10
+ ## When To Use
11
+
12
+ - At the **start of any new conversation**
13
+ - When context seems missing
14
+ - When user asks "what were we working on?"
15
+
16
+ ## Instrumentation
17
+
18
+ ```bash
19
+ # Log usage when using this skill
20
+ Call MCP `call_tool_logger_manager` { action: "logSkill", name: "session-resume", outcome: "manual" }
21
+ ```
22
+
23
+ ---
24
+
25
+ ## Quick Resume Checklist
26
+
27
+ ### 1. Check Active Work
28
+
29
+ ```bash
30
+ # Ready todos (highest priority)
31
+ ls todos/*-ready-*.md 2>/dev/null | head -5
32
+
33
+ # In-progress plans
34
+ ls plans/*.md 2>/dev/null
35
+
36
+ # Recent solutions (for context)
37
+ ls -t docs/solutions/**/*.md 2>/dev/null | head -3
38
+ ```
39
+
40
+ ### 2. Check Recent Git Activity
41
+
42
+ ```bash
43
+ # Recent commits
44
+ git log --oneline -5
45
+
46
+ # Uncommitted changes
47
+ git status --short
48
+ ```
49
+
50
+ ### 3. Summarize Context
51
+
52
+ After gathering info, summarize:
53
+
54
+ ### 4. Check System Health
55
+
56
+ ```bash
57
+ Call MCP `call_tool_compound_manager` { action: "dashboard" }
58
+ ```
59
+
60
+ Review health grade and recommendations before starting work.
61
+
62
+ ### 5. Final Summary
63
+
64
+ ```
65
+ 📍 Session Context:
66
+
67
+ **Active Work:**
68
+ - {X} ready todos waiting
69
+ - Plan in progress: {plan name if any}
70
+
71
+ **Recent Activity:**
72
+ - Last commit: {subject}
73
+ - {Changed files if uncommitted}
74
+
75
+ **Suggested Next Steps:**
76
+ 1. {Most logical next action}
77
+ 2. {Alternative}
78
+ ```
79
+
80
+ ---
81
+
82
+ ## Automatic Triggers
83
+
84
+ Consider running this skill when you see:
85
+ - User starts with "continue", "resume", "where were we"
86
+ - First message in a new session
87
+ - User seems to lack context
88
+
89
+ ---
90
+
91
+ ## References
92
+
93
+ - Todos: `todos/`
94
+ - Plans: `plans/`
95
+ - Solutions: `docs/solutions/`
96
+ - Workflows: `skills/workflows/`
@@ -1,139 +1,139 @@
1
- # Tailwind CSS Skill
2
-
3
- ## Overview
4
- Tailwind CSS v4 patterns, design systems, and responsive design.
5
-
6
- ## Core Concepts
7
-
8
- ### 1. Utility-First Approach
9
- ```html
10
- <!-- Instead of writing CSS -->
11
- <div class="flex items-center gap-4 p-6 bg-white rounded-xl shadow-lg">
12
- <img class="size-16 rounded-full" src="avatar.jpg" alt="">
13
- <div>
14
- <h3 class="text-lg font-semibold text-gray-900">John Doe</h3>
15
- <p class="text-gray-500">Developer</p>
16
- </div>
17
- </div>
18
- ```
19
-
20
- ### 2. Responsive Design
21
- ```html
22
- <!-- Mobile-first approach -->
23
- <div class="
24
- grid grid-cols-1 gap-4
25
- sm:grid-cols-2
26
- md:grid-cols-3
27
- lg:grid-cols-4
28
- ">
29
- <!-- Cards -->
30
- </div>
31
-
32
- <!-- Container widths -->
33
- <div class="container mx-auto px-4 sm:px-6 lg:px-8">
34
- <!-- Content -->
35
- </div>
36
- ```
37
-
38
- ### 3. Dark Mode
39
- ```html
40
- <div class="bg-white dark:bg-gray-900">
41
- <h1 class="text-gray-900 dark:text-white">Title</h1>
42
- <p class="text-gray-600 dark:text-gray-300">Description</p>
43
- </div>
44
- ```
45
-
46
- ### 4. State Variants
47
- ```html
48
- <button class="
49
- bg-blue-500
50
- hover:bg-blue-600
51
- focus:ring-2 focus:ring-blue-500 focus:ring-offset-2
52
- active:bg-blue-700
53
- disabled:opacity-50 disabled:cursor-not-allowed
54
- transition-colors duration-200
55
- ">
56
- Submit
57
- </button>
58
- ```
59
-
60
- ## Component Patterns
61
-
62
- ### Card Component
63
- ```html
64
- <div class="
65
- bg-white rounded-2xl shadow-md
66
- overflow-hidden
67
- hover:shadow-xl transition-shadow duration-300
68
- ">
69
- <img class="w-full h-48 object-cover" src="..." alt="">
70
- <div class="p-6">
71
- <h3 class="text-xl font-bold mb-2">Card Title</h3>
72
- <p class="text-gray-600 line-clamp-2">Description...</p>
73
- </div>
74
- </div>
75
- ```
76
-
77
- ### Form Input
78
- ```html
79
- <div class="space-y-2">
80
- <label class="block text-sm font-medium text-gray-700">Email</label>
81
- <input
82
- type="email"
83
- class="
84
- w-full px-4 py-2
85
- border border-gray-300 rounded-lg
86
- focus:ring-2 focus:ring-blue-500 focus:border-blue-500
87
- placeholder:text-gray-400
88
- "
89
- placeholder="you@example.com"
90
- >
91
- </div>
92
- ```
93
-
94
- ### Button Variants
95
- ```html
96
- <!-- Primary -->
97
- <button class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700">
98
- Primary
99
- </button>
100
-
101
- <!-- Secondary -->
102
- <button class="px-4 py-2 bg-gray-100 text-gray-900 rounded-lg hover:bg-gray-200">
103
- Secondary
104
- </button>
105
-
106
- <!-- Outline -->
107
- <button class="px-4 py-2 border-2 border-blue-600 text-blue-600 rounded-lg hover:bg-blue-50">
108
- Outline
109
- </button>
110
- ```
111
-
112
- ## Custom Design System
113
-
114
- ### tailwind.config.js
115
- ```javascript
116
- module.exports = {
117
- theme: {
118
- extend: {
119
- colors: {
120
- primary: {
121
- 50: '#eff6ff',
122
- 500: '#3b82f6',
123
- 600: '#2563eb',
124
- 700: '#1d4ed8',
125
- },
126
- },
127
- fontFamily: {
128
- sans: ['Inter', 'sans-serif'],
129
- },
130
- },
131
- },
132
- };
133
- ```
134
-
135
- ## Best Practices
136
- - Use `@apply` sparingly (prefer utilities in HTML)
137
- - Extract components instead of `@apply`
138
- - Use arbitrary values `[]` for one-off designs
139
- - Enable JIT mode for development
1
+ # Tailwind CSS Skill
2
+
3
+ ## Overview
4
+ Tailwind CSS v4 patterns, design systems, and responsive design.
5
+
6
+ ## Core Concepts
7
+
8
+ ### 1. Utility-First Approach
9
+ ```html
10
+ <!-- Instead of writing CSS -->
11
+ <div class="flex items-center gap-4 p-6 bg-white rounded-xl shadow-lg">
12
+ <img class="size-16 rounded-full" src="avatar.jpg" alt="">
13
+ <div>
14
+ <h3 class="text-lg font-semibold text-gray-900">John Doe</h3>
15
+ <p class="text-gray-500">Developer</p>
16
+ </div>
17
+ </div>
18
+ ```
19
+
20
+ ### 2. Responsive Design
21
+ ```html
22
+ <!-- Mobile-first approach -->
23
+ <div class="
24
+ grid grid-cols-1 gap-4
25
+ sm:grid-cols-2
26
+ md:grid-cols-3
27
+ lg:grid-cols-4
28
+ ">
29
+ <!-- Cards -->
30
+ </div>
31
+
32
+ <!-- Container widths -->
33
+ <div class="container mx-auto px-4 sm:px-6 lg:px-8">
34
+ <!-- Content -->
35
+ </div>
36
+ ```
37
+
38
+ ### 3. Dark Mode
39
+ ```html
40
+ <div class="bg-white dark:bg-gray-900">
41
+ <h1 class="text-gray-900 dark:text-white">Title</h1>
42
+ <p class="text-gray-600 dark:text-gray-300">Description</p>
43
+ </div>
44
+ ```
45
+
46
+ ### 4. State Variants
47
+ ```html
48
+ <button class="
49
+ bg-blue-500
50
+ hover:bg-blue-600
51
+ focus:ring-2 focus:ring-blue-500 focus:ring-offset-2
52
+ active:bg-blue-700
53
+ disabled:opacity-50 disabled:cursor-not-allowed
54
+ transition-colors duration-200
55
+ ">
56
+ Submit
57
+ </button>
58
+ ```
59
+
60
+ ## Component Patterns
61
+
62
+ ### Card Component
63
+ ```html
64
+ <div class="
65
+ bg-white rounded-2xl shadow-md
66
+ overflow-hidden
67
+ hover:shadow-xl transition-shadow duration-300
68
+ ">
69
+ <img class="w-full h-48 object-cover" src="..." alt="">
70
+ <div class="p-6">
71
+ <h3 class="text-xl font-bold mb-2">Card Title</h3>
72
+ <p class="text-gray-600 line-clamp-2">Description...</p>
73
+ </div>
74
+ </div>
75
+ ```
76
+
77
+ ### Form Input
78
+ ```html
79
+ <div class="space-y-2">
80
+ <label class="block text-sm font-medium text-gray-700">Email</label>
81
+ <input
82
+ type="email"
83
+ class="
84
+ w-full px-4 py-2
85
+ border border-gray-300 rounded-lg
86
+ focus:ring-2 focus:ring-blue-500 focus:border-blue-500
87
+ placeholder:text-gray-400
88
+ "
89
+ placeholder="you@example.com"
90
+ >
91
+ </div>
92
+ ```
93
+
94
+ ### Button Variants
95
+ ```html
96
+ <!-- Primary -->
97
+ <button class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700">
98
+ Primary
99
+ </button>
100
+
101
+ <!-- Secondary -->
102
+ <button class="px-4 py-2 bg-gray-100 text-gray-900 rounded-lg hover:bg-gray-200">
103
+ Secondary
104
+ </button>
105
+
106
+ <!-- Outline -->
107
+ <button class="px-4 py-2 border-2 border-blue-600 text-blue-600 rounded-lg hover:bg-blue-50">
108
+ Outline
109
+ </button>
110
+ ```
111
+
112
+ ## Custom Design System
113
+
114
+ ### tailwind.config.js
115
+ ```javascript
116
+ module.exports = {
117
+ theme: {
118
+ extend: {
119
+ colors: {
120
+ primary: {
121
+ 50: '#eff6ff',
122
+ 500: '#3b82f6',
123
+ 600: '#2563eb',
124
+ 700: '#1d4ed8',
125
+ },
126
+ },
127
+ fontFamily: {
128
+ sans: ['Inter', 'sans-serif'],
129
+ },
130
+ },
131
+ },
132
+ };
133
+ ```
134
+
135
+ ## Best Practices
136
+ - Use `@apply` sparingly (prefer utilities in HTML)
137
+ - Extract components instead of `@apply`
138
+ - Use arbitrary values `[]` for one-off designs
139
+ - Enable JIT mode for development
@@ -1,43 +1,43 @@
1
- ---
2
- name: testing
3
- description: Unified testing commands and patterns across frontend and backend.
4
- last_updated: 2025-12-20
5
- ---
6
-
7
- # Testing Skill
8
-
9
- ## Overview
10
-
11
- Guidance and templates for testing in {PROJECT_NAME}. Covers React Component testing (Vitest/RTL) and Backend testing (Python/Pytest).
12
-
13
- ## When To Use
14
-
15
- - **Writing new code**: Every new feature needs tests.
16
- - **Fixing bugs**: Create a reproduction test first.
17
- - **Refactoring**: Ensure green tests before and after.
18
-
19
- ## Instrumentation
20
-
21
- ```bash
22
- # Log usage when using this skill
23
- Call MCP `call_tool_logger_manager` { action: "logSkill", name: "testing", outcome: "manual" }
24
- ```
25
-
26
- ## What do you want to do?
27
-
28
- 1. **Test React Components** → `workflows/run-frontend-tests.md`
29
- 2. **Test Backend/API** → `workflows/run-backend-tests.md`
30
- 3. **Write a New Test** → `templates/component-test.template.tsx`
31
- 4. **Fix Test Failures** → `references/vitest-patterns.md`
32
-
33
- ## Quick Commands
34
-
35
- ```bash
36
- # Frontend (Unit/Integration)
37
- npm test
38
- npm test -- -t "ComponentName" # Run specific test
39
-
40
- # Backend (API)
41
- pytest
42
- pytest -k "test_name"
43
- ```
1
+ ---
2
+ name: testing
3
+ description: Unified testing commands and patterns across frontend and backend.
4
+ last_updated: 2025-12-20
5
+ ---
6
+
7
+ # Testing Skill
8
+
9
+ ## Overview
10
+
11
+ Guidance and templates for testing in {PROJECT_NAME}. Covers React Component testing (Vitest/RTL) and Backend testing (Python/Pytest).
12
+
13
+ ## When To Use
14
+
15
+ - **Writing new code**: Every new feature needs tests.
16
+ - **Fixing bugs**: Create a reproduction test first.
17
+ - **Refactoring**: Ensure green tests before and after.
18
+
19
+ ## Instrumentation
20
+
21
+ ```bash
22
+ # Log usage when using this skill
23
+ Call MCP `call_tool_logger_manager` { action: "logSkill", name: "testing", outcome: "manual" }
24
+ ```
25
+
26
+ ## What do you want to do?
27
+
28
+ 1. **Test React Components** → `workflows/run-frontend-tests.md`
29
+ 2. **Test Backend/API** → `workflows/run-backend-tests.md`
30
+ 3. **Write a New Test** → `templates/component-test.template.tsx`
31
+ 4. **Fix Test Failures** → `references/vitest-patterns.md`
32
+
33
+ ## Quick Commands
34
+
35
+ ```bash
36
+ # Frontend (Unit/Integration)
37
+ npm test
38
+ npm test -- -t "ComponentName" # Run specific test
39
+
40
+ # Backend (API)
41
+ pytest
42
+ pytest -k "test_name"
43
+ ```
@@ -1,45 +1,45 @@
1
- # Vitest & Testing Library Patterns
2
-
3
- ## Common Mocking Patterns
4
-
5
- ### Mocking a Module
6
- ```tsx
7
- vi.mock('next/navigation', () => ({
8
- useRouter: () => ({
9
- push: vi.fn(),
10
- replace: vi.fn(),
11
- }),
12
- }));
13
- ```
14
-
15
- ### Mocking a Component
16
- ```tsx
17
- vi.mock('./ChildComponent', () => ({
18
- ChildComponent: () => <div data-testid="child-mock">Mocked Child</div>,
19
- }));
20
- ```
21
-
22
- ## Async Testing
23
-
24
- Wait for element to appear:
25
- ```tsx
26
- await waitFor(() => {
27
- expect(screen.getByText('Loaded')).toBeInTheDocument();
28
- });
29
- ```
30
-
31
- Verify element disappears:
32
- ```tsx
33
- await waitFor(() => {
34
- expect(screen.queryByText('Loading...')).not.toBeInTheDocument();
35
- });
36
- ```
37
-
38
- ## User Interaction
39
-
40
- Use `fireEvent` for simple events, or `userEvent` (if setup) for complex ones.
41
-
42
- ```tsx
43
- fireEvent.change(input, { target: { value: 'New Value' } });
44
- fireEvent.click(button);
45
- ```
1
+ # Vitest & Testing Library Patterns
2
+
3
+ ## Common Mocking Patterns
4
+
5
+ ### Mocking a Module
6
+ ```tsx
7
+ vi.mock('next/navigation', () => ({
8
+ useRouter: () => ({
9
+ push: vi.fn(),
10
+ replace: vi.fn(),
11
+ }),
12
+ }));
13
+ ```
14
+
15
+ ### Mocking a Component
16
+ ```tsx
17
+ vi.mock('./ChildComponent', () => ({
18
+ ChildComponent: () => <div data-testid="child-mock">Mocked Child</div>,
19
+ }));
20
+ ```
21
+
22
+ ## Async Testing
23
+
24
+ Wait for element to appear:
25
+ ```tsx
26
+ await waitFor(() => {
27
+ expect(screen.getByText('Loaded')).toBeInTheDocument();
28
+ });
29
+ ```
30
+
31
+ Verify element disappears:
32
+ ```tsx
33
+ await waitFor(() => {
34
+ expect(screen.queryByText('Loading...')).not.toBeInTheDocument();
35
+ });
36
+ ```
37
+
38
+ ## User Interaction
39
+
40
+ Use `fireEvent` for simple events, or `userEvent` (if setup) for complex ones.
41
+
42
+ ```tsx
43
+ fireEvent.change(input, { target: { value: 'New Value' } });
44
+ fireEvent.click(button);
45
+ ```