@su-record/vibe 2.5.9 → 2.5.11

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 (233) hide show
  1. package/CLAUDE.md +448 -348
  2. package/LICENSE +21 -21
  3. package/README.md +262 -262
  4. package/agents/architect-low.md +41 -0
  5. package/agents/architect-medium.md +59 -0
  6. package/agents/architect.md +80 -0
  7. package/agents/build-error-resolver.md +115 -115
  8. package/agents/compounder.md +261 -261
  9. package/agents/diagrammer.md +178 -178
  10. package/agents/e2e-tester.md +266 -266
  11. package/agents/explorer-low.md +42 -0
  12. package/agents/explorer-medium.md +59 -0
  13. package/agents/explorer.md +48 -48
  14. package/agents/implementer-low.md +43 -0
  15. package/agents/implementer-medium.md +52 -0
  16. package/agents/implementer.md +54 -54
  17. package/agents/refactor-cleaner.md +143 -143
  18. package/agents/research/best-practices-agent.md +189 -189
  19. package/agents/research/codebase-patterns-agent.md +147 -147
  20. package/agents/research/framework-docs-agent.md +178 -178
  21. package/agents/research/security-advisory-agent.md +203 -203
  22. package/agents/review/architecture-reviewer.md +107 -107
  23. package/agents/review/complexity-reviewer.md +116 -116
  24. package/agents/review/data-integrity-reviewer.md +88 -88
  25. package/agents/review/git-history-reviewer.md +103 -103
  26. package/agents/review/performance-reviewer.md +86 -86
  27. package/agents/review/python-reviewer.md +150 -150
  28. package/agents/review/rails-reviewer.md +139 -139
  29. package/agents/review/react-reviewer.md +144 -144
  30. package/agents/review/security-reviewer.md +80 -80
  31. package/agents/review/simplicity-reviewer.md +140 -140
  32. package/agents/review/test-coverage-reviewer.md +116 -116
  33. package/agents/review/typescript-reviewer.md +127 -127
  34. package/agents/searcher.md +54 -54
  35. package/agents/simplifier.md +120 -120
  36. package/agents/tester.md +49 -49
  37. package/agents/ui-previewer.md +129 -129
  38. package/commands/vibe.analyze.md +356 -356
  39. package/commands/vibe.reason.md +329 -329
  40. package/commands/vibe.review.md +326 -326
  41. package/commands/vibe.run.md +1051 -1031
  42. package/commands/vibe.spec.md +1058 -1022
  43. package/commands/vibe.utils.md +296 -296
  44. package/commands/vibe.verify.md +375 -375
  45. package/dist/cli/collaborator.js +52 -52
  46. package/dist/cli/detect.js +32 -32
  47. package/dist/cli/index.js +102 -102
  48. package/dist/cli/llm.js +144 -144
  49. package/dist/lib/DeepInit.d.ts +62 -0
  50. package/dist/lib/DeepInit.d.ts.map +1 -0
  51. package/dist/lib/DeepInit.js +247 -0
  52. package/dist/lib/DeepInit.js.map +1 -0
  53. package/dist/lib/IterationTracker.d.ts +81 -0
  54. package/dist/lib/IterationTracker.d.ts.map +1 -0
  55. package/dist/lib/IterationTracker.js +190 -0
  56. package/dist/lib/IterationTracker.js.map +1 -0
  57. package/dist/lib/ModelRouter.d.ts +50 -0
  58. package/dist/lib/ModelRouter.d.ts.map +1 -0
  59. package/dist/lib/ModelRouter.js +218 -0
  60. package/dist/lib/ModelRouter.js.map +1 -0
  61. package/dist/lib/OrchestrateWorkflow.d.ts +90 -0
  62. package/dist/lib/OrchestrateWorkflow.d.ts.map +1 -0
  63. package/dist/lib/OrchestrateWorkflow.js +261 -0
  64. package/dist/lib/OrchestrateWorkflow.js.map +1 -0
  65. package/dist/lib/PythonParser.js +108 -108
  66. package/dist/lib/SkillFrontmatter.d.ts +64 -0
  67. package/dist/lib/SkillFrontmatter.d.ts.map +1 -0
  68. package/dist/lib/SkillFrontmatter.js +221 -0
  69. package/dist/lib/SkillFrontmatter.js.map +1 -0
  70. package/dist/lib/SkillQualityGate.d.ts +40 -0
  71. package/dist/lib/SkillQualityGate.d.ts.map +1 -0
  72. package/dist/lib/SkillQualityGate.js +218 -0
  73. package/dist/lib/SkillQualityGate.js.map +1 -0
  74. package/dist/lib/UltraQA.d.ts +70 -0
  75. package/dist/lib/UltraQA.d.ts.map +1 -0
  76. package/dist/lib/UltraQA.js +234 -0
  77. package/dist/lib/UltraQA.js.map +1 -0
  78. package/dist/lib/gpt-api.js +4 -4
  79. package/dist/lib/memory/KnowledgeGraph.js +4 -4
  80. package/dist/lib/memory/MemorySearch.js +20 -20
  81. package/dist/lib/memory/MemoryStorage.js +64 -64
  82. package/dist/tools/convention/analyzeComplexity.test.js +115 -115
  83. package/dist/tools/convention/validateCodeQuality.test.js +104 -104
  84. package/dist/tools/index.d.ts +7 -0
  85. package/dist/tools/index.d.ts.map +1 -1
  86. package/dist/tools/index.js +12 -0
  87. package/dist/tools/index.js.map +1 -1
  88. package/hooks/hooks.json +222 -204
  89. package/hooks/scripts/code-check.js +22 -22
  90. package/hooks/scripts/code-review.js +22 -22
  91. package/hooks/scripts/complexity.js +22 -22
  92. package/hooks/scripts/compound.js +23 -23
  93. package/hooks/scripts/context-save.js +33 -33
  94. package/hooks/scripts/hud-multiline.js +264 -0
  95. package/hooks/scripts/hud-status.js +293 -0
  96. package/hooks/scripts/keyword-detector.js +216 -0
  97. package/hooks/scripts/llm-orchestrate.js +171 -171
  98. package/hooks/scripts/post-edit.js +97 -97
  99. package/hooks/scripts/post-tool-verify.js +212 -0
  100. package/hooks/scripts/pre-tool-guard.js +127 -0
  101. package/hooks/scripts/recall.js +22 -22
  102. package/hooks/scripts/session-start.js +30 -30
  103. package/hooks/scripts/skill-injector.js +193 -0
  104. package/hooks/scripts/utils.js +97 -97
  105. package/languages/csharp-unity.md +515 -515
  106. package/languages/gdscript-godot.md +470 -470
  107. package/languages/ruby-rails.md +489 -489
  108. package/languages/typescript-angular.md +433 -433
  109. package/languages/typescript-astro.md +416 -416
  110. package/languages/typescript-electron.md +406 -406
  111. package/languages/typescript-nestjs.md +524 -524
  112. package/languages/typescript-svelte.md +407 -407
  113. package/languages/typescript-tauri.md +365 -365
  114. package/package.json +83 -83
  115. package/skills/context7-usage.md +102 -102
  116. package/skills/git-worktree.md +181 -181
  117. package/skills/parallel-research.md +77 -77
  118. package/skills/priority-todos.md +239 -239
  119. package/skills/tool-fallback.md +190 -190
  120. package/skills/vibe-capabilities.md +161 -161
  121. package/vibe/constitution.md +227 -227
  122. package/vibe/rules/core/communication-guide.md +98 -98
  123. package/vibe/rules/core/development-philosophy.md +52 -52
  124. package/vibe/rules/core/quick-start.md +102 -102
  125. package/vibe/rules/quality/bdd-contract-testing.md +393 -393
  126. package/vibe/rules/quality/checklist.md +276 -276
  127. package/vibe/rules/quality/testing-strategy.md +440 -440
  128. package/vibe/rules/standards/anti-patterns.md +541 -541
  129. package/vibe/rules/standards/code-structure.md +291 -291
  130. package/vibe/rules/standards/complexity-metrics.md +313 -313
  131. package/vibe/rules/standards/naming-conventions.md +198 -198
  132. package/vibe/setup.sh +31 -31
  133. package/vibe/templates/constitution-template.md +252 -252
  134. package/vibe/templates/contract-backend-template.md +526 -526
  135. package/vibe/templates/contract-frontend-template.md +599 -599
  136. package/vibe/templates/feature-template.md +96 -96
  137. package/vibe/templates/spec-template.md +221 -221
  138. package/dist/cli/mcp.d.ts +0 -49
  139. package/dist/cli/mcp.d.ts.map +0 -1
  140. package/dist/cli/mcp.js +0 -169
  141. package/dist/cli/mcp.js.map +0 -1
  142. package/dist/lib/gemini-mcp.d.ts +0 -10
  143. package/dist/lib/gemini-mcp.d.ts.map +0 -1
  144. package/dist/lib/gemini-mcp.js +0 -353
  145. package/dist/lib/gemini-mcp.js.map +0 -1
  146. package/dist/lib/gpt-mcp.d.ts +0 -10
  147. package/dist/lib/gpt-mcp.d.ts.map +0 -1
  148. package/dist/lib/gpt-mcp.js +0 -352
  149. package/dist/lib/gpt-mcp.js.map +0 -1
  150. package/dist/tools/analytics/getUsageAnalytics.d.ts +0 -10
  151. package/dist/tools/analytics/getUsageAnalytics.d.ts.map +0 -1
  152. package/dist/tools/analytics/getUsageAnalytics.js +0 -246
  153. package/dist/tools/analytics/getUsageAnalytics.js.map +0 -1
  154. package/dist/tools/analytics/index.d.ts +0 -5
  155. package/dist/tools/analytics/index.d.ts.map +0 -1
  156. package/dist/tools/analytics/index.js +0 -5
  157. package/dist/tools/analytics/index.js.map +0 -1
  158. package/dist/tools/convention/getCodingGuide.d.ts +0 -7
  159. package/dist/tools/convention/getCodingGuide.d.ts.map +0 -1
  160. package/dist/tools/convention/getCodingGuide.js +0 -69
  161. package/dist/tools/convention/getCodingGuide.js.map +0 -1
  162. package/dist/tools/planning/analyzeRequirements.d.ts +0 -9
  163. package/dist/tools/planning/analyzeRequirements.d.ts.map +0 -1
  164. package/dist/tools/planning/analyzeRequirements.js +0 -171
  165. package/dist/tools/planning/analyzeRequirements.js.map +0 -1
  166. package/dist/tools/planning/createUserStories.d.ts +0 -9
  167. package/dist/tools/planning/createUserStories.d.ts.map +0 -1
  168. package/dist/tools/planning/createUserStories.js +0 -124
  169. package/dist/tools/planning/createUserStories.js.map +0 -1
  170. package/dist/tools/planning/featureRoadmap.d.ts +0 -10
  171. package/dist/tools/planning/featureRoadmap.d.ts.map +0 -1
  172. package/dist/tools/planning/featureRoadmap.js +0 -207
  173. package/dist/tools/planning/featureRoadmap.js.map +0 -1
  174. package/dist/tools/planning/generatePrd.d.ts +0 -11
  175. package/dist/tools/planning/generatePrd.d.ts.map +0 -1
  176. package/dist/tools/planning/generatePrd.js +0 -161
  177. package/dist/tools/planning/generatePrd.js.map +0 -1
  178. package/dist/tools/planning/index.d.ts +0 -8
  179. package/dist/tools/planning/index.d.ts.map +0 -1
  180. package/dist/tools/planning/index.js +0 -8
  181. package/dist/tools/planning/index.js.map +0 -1
  182. package/dist/tools/prompt/analyzePrompt.d.ts +0 -7
  183. package/dist/tools/prompt/analyzePrompt.d.ts.map +0 -1
  184. package/dist/tools/prompt/analyzePrompt.js +0 -150
  185. package/dist/tools/prompt/analyzePrompt.js.map +0 -1
  186. package/dist/tools/prompt/enhancePrompt.d.ts +0 -8
  187. package/dist/tools/prompt/enhancePrompt.d.ts.map +0 -1
  188. package/dist/tools/prompt/enhancePrompt.js +0 -110
  189. package/dist/tools/prompt/enhancePrompt.js.map +0 -1
  190. package/dist/tools/prompt/enhancePromptGemini.d.ts +0 -8
  191. package/dist/tools/prompt/enhancePromptGemini.d.ts.map +0 -1
  192. package/dist/tools/prompt/enhancePromptGemini.js +0 -332
  193. package/dist/tools/prompt/enhancePromptGemini.js.map +0 -1
  194. package/dist/tools/prompt/index.d.ts +0 -7
  195. package/dist/tools/prompt/index.d.ts.map +0 -1
  196. package/dist/tools/prompt/index.js +0 -7
  197. package/dist/tools/prompt/index.js.map +0 -1
  198. package/dist/tools/reasoning/applyReasoningFramework.d.ts +0 -8
  199. package/dist/tools/reasoning/applyReasoningFramework.d.ts.map +0 -1
  200. package/dist/tools/reasoning/applyReasoningFramework.js +0 -266
  201. package/dist/tools/reasoning/applyReasoningFramework.js.map +0 -1
  202. package/dist/tools/reasoning/index.d.ts +0 -5
  203. package/dist/tools/reasoning/index.d.ts.map +0 -1
  204. package/dist/tools/reasoning/index.js +0 -5
  205. package/dist/tools/reasoning/index.js.map +0 -1
  206. package/dist/tools/thinking/analyzeProblem.d.ts +0 -7
  207. package/dist/tools/thinking/analyzeProblem.d.ts.map +0 -1
  208. package/dist/tools/thinking/analyzeProblem.js +0 -55
  209. package/dist/tools/thinking/analyzeProblem.js.map +0 -1
  210. package/dist/tools/thinking/breakDownProblem.d.ts +0 -8
  211. package/dist/tools/thinking/breakDownProblem.d.ts.map +0 -1
  212. package/dist/tools/thinking/breakDownProblem.js +0 -145
  213. package/dist/tools/thinking/breakDownProblem.js.map +0 -1
  214. package/dist/tools/thinking/createThinkingChain.d.ts +0 -7
  215. package/dist/tools/thinking/createThinkingChain.d.ts.map +0 -1
  216. package/dist/tools/thinking/createThinkingChain.js +0 -44
  217. package/dist/tools/thinking/createThinkingChain.js.map +0 -1
  218. package/dist/tools/thinking/formatAsPlan.d.ts +0 -9
  219. package/dist/tools/thinking/formatAsPlan.d.ts.map +0 -1
  220. package/dist/tools/thinking/formatAsPlan.js +0 -78
  221. package/dist/tools/thinking/formatAsPlan.js.map +0 -1
  222. package/dist/tools/thinking/index.d.ts +0 -10
  223. package/dist/tools/thinking/index.d.ts.map +0 -1
  224. package/dist/tools/thinking/index.js +0 -10
  225. package/dist/tools/thinking/index.js.map +0 -1
  226. package/dist/tools/thinking/stepByStepAnalysis.d.ts +0 -8
  227. package/dist/tools/thinking/stepByStepAnalysis.d.ts.map +0 -1
  228. package/dist/tools/thinking/stepByStepAnalysis.js +0 -63
  229. package/dist/tools/thinking/stepByStepAnalysis.js.map +0 -1
  230. package/dist/tools/thinking/thinkAloudProcess.d.ts +0 -8
  231. package/dist/tools/thinking/thinkAloudProcess.d.ts.map +0 -1
  232. package/dist/tools/thinking/thinkAloudProcess.js +0 -80
  233. package/dist/tools/thinking/thinkAloudProcess.js.map +0 -1
@@ -1,266 +1,266 @@
1
- ---
2
- description: End-to-end testing with Playwright automation
3
- argument-hint: "test scenario or URL"
4
- ---
5
-
6
- # /vibe.e2e
7
-
8
- **E2E Test Automation** - Playwright-based browser testing
9
-
10
- ## Usage
11
-
12
- ```
13
- /vibe.e2e # Run all E2E tests
14
- /vibe.e2e "login flow" # Test specific scenario
15
- /vibe.e2e http://localhost:3000/login # Test specific URL
16
- /vibe.e2e --visual # Visual regression testing
17
- /vibe.e2e --record # Record test video
18
- ```
19
-
20
- ## Core Features
21
-
22
- ```
23
- ┌─────────────────────────────────────────────────────────────────┐
24
- │ 🎭 Playwright E2E Testing │
25
- ├─────────────────────────────────────────────────────────────────┤
26
- │ │
27
- │ ✅ Screenshot Capture - Record UI state │
28
- │ ✅ Console Error Collection - Detect JS errors │
29
- │ ✅ Network Monitoring - Detect API failures │
30
- │ ✅ Visual Regression - Compare screenshots │
31
- │ ✅ Video Recording - Bug reproduction evidence │
32
- │ ✅ Accessibility Check - Detect a11y violations │
33
- │ │
34
- └─────────────────────────────────────────────────────────────────┘
35
- ```
36
-
37
- ## Process
38
-
39
- ### Phase 1: Environment Setup
40
-
41
- ```bash
42
- # Check Playwright installation
43
- npx playwright --version
44
-
45
- # Install browsers if needed
46
- npx playwright install chromium
47
- ```
48
-
49
- ### Phase 2: Test Scenario Analysis
50
-
51
- ```
52
- 📋 Scenario Detection
53
- ├── .claude/vibe/features/{feature}.feature → Extract BDD scenarios
54
- ├── .claude/vibe/specs/{feature}.md → Check acceptance criteria
55
- └── Analyze existing e2e/*.spec.ts
56
- ```
57
-
58
- ### Phase 3: Test Execution
59
-
60
- **Single Page Test:**
61
- ```typescript
62
- // Auto-generated test
63
- import { test, expect } from '@playwright/test';
64
-
65
- test('login flow', async ({ page }) => {
66
- // Navigate
67
- await page.goto('http://localhost:3000/login');
68
-
69
- // Screenshot: initial state
70
- await page.screenshot({ path: 'screenshots/login-initial.png' });
71
-
72
- // Fill form
73
- await page.fill('[data-testid="email"]', 'test@example.com');
74
- await page.fill('[data-testid="password"]', 'password123');
75
-
76
- // Submit
77
- await page.click('[data-testid="submit"]');
78
-
79
- // Wait for navigation
80
- await page.waitForURL('**/dashboard');
81
-
82
- // Screenshot: success state
83
- await page.screenshot({ path: 'screenshots/login-success.png' });
84
-
85
- // Assertions
86
- await expect(page.locator('h1')).toContainText('Dashboard');
87
- });
88
- ```
89
-
90
- **Console Error Collection:**
91
- ```typescript
92
- test.beforeEach(async ({ page }) => {
93
- // Collect console errors
94
- page.on('console', msg => {
95
- if (msg.type() === 'error') {
96
- console.log(`Console Error: ${msg.text()}`);
97
- }
98
- });
99
-
100
- // Collect network failures
101
- page.on('requestfailed', request => {
102
- console.log(`Request failed: ${request.url()}`);
103
- });
104
- });
105
- ```
106
-
107
- ### Phase 4: Visual Regression (--visual)
108
-
109
- ```
110
- ┌─────────────────────────────────────────────────────────────────┐
111
- │ 👁️ Visual Regression Test │
112
- ├─────────────────────────────────────────────────────────────────┤
113
- │ │
114
- │ Comparing screenshots: │
115
- │ │
116
- │ ├── login-page.png │
117
- │ │ ├── Baseline: .claude/vibe/e2e/baseline/login-page.png │
118
- │ │ ├── Current: .claude/vibe/e2e/current/login-page.png │
119
- │ │ └── Diff: ✅ 0.02% (threshold: 1%) │
120
- │ │ │
121
- │ ├── dashboard.png │
122
- │ │ ├── Baseline: .claude/vibe/e2e/baseline/dashboard.png │
123
- │ │ ├── Current: .claude/vibe/e2e/current/dashboard.png │
124
- │ │ └── Diff: ❌ 5.3% (threshold: 1%) │
125
- │ │ └── .claude/vibe/e2e/diff/dashboard-diff.png │
126
- │ │ │
127
- └─────────────────────────────────────────────────────────────────┘
128
- ```
129
-
130
- ### Phase 5: Accessibility Check
131
-
132
- ```typescript
133
- import { injectAxe, checkA11y } from 'axe-playwright';
134
-
135
- test('accessibility check', async ({ page }) => {
136
- await page.goto('/login');
137
- await injectAxe(page);
138
- await checkA11y(page, null, {
139
- detailedReport: true,
140
- detailedReportOptions: { html: true }
141
- });
142
- });
143
- ```
144
-
145
- ### Phase 6: Bug Reproduction (Optional)
146
-
147
- Link with bug reports:
148
-
149
- ```
150
- /vibe.e2e --reproduce "User sees blank page after login"
151
-
152
- ┌─────────────────────────────────────────────────────────────────┐
153
- │ 🐛 Bug Reproduction Mode │
154
- ├─────────────────────────────────────────────────────────────────┤
155
- │ │
156
- │ Steps executed: │
157
- │ 1. ✅ Navigate to /login │
158
- │ 2. ✅ Enter credentials │
159
- │ 3. ✅ Click login button │
160
- │ 4. ❌ Dashboard shows blank │
161
- │ │
162
- │ Evidence collected: │
163
- │ ├── 📸 screenshots/bug-step-1.png │
164
- │ ├── 📸 screenshots/bug-step-2.png │
165
- │ ├── 📸 screenshots/bug-step-3.png │
166
- │ ├── 📸 screenshots/bug-step-4-FAIL.png │
167
- │ ├── 🎥 videos/bug-reproduction.webm │
168
- │ └── 📋 logs/console-errors.txt │
169
- │ │
170
- │ Console Errors Found: │
171
- │ └── TypeError: Cannot read property 'user' of undefined │
172
- │ at Dashboard.tsx:42 │
173
- │ │
174
- └─────────────────────────────────────────────────────────────────┘
175
- ```
176
-
177
- ## Output
178
-
179
- ```
180
- ┌─────────────────────────────────────────────────────────────────┐
181
- │ 🎭 E2E TEST RESULTS │
182
- ├─────────────────────────────────────────────────────────────────┤
183
- │ │
184
- │ Test Suite: Login Flow │
185
- │ Duration: 12.3s │
186
- │ Browser: Chromium 120 │
187
- │ │
188
- │ Results: │
189
- │ ├── ✅ Passed: 8 │
190
- │ ├── ❌ Failed: 1 │
191
- │ └── ⏭️ Skipped: 0 │
192
- │ │
193
- │ Failed Tests: │
194
- │ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ │
195
- │ ❌ "should show error for invalid password" │
196
- │ Expected: "Invalid password" message │
197
- │ Actual: No error message displayed │
198
- │ 📸 Screenshot: .claude/vibe/e2e/failures/invalid-password.png │
199
- │ │
200
- │ Console Errors: 2 │
201
- │ ├── TypeError at Dashboard.tsx:42 │
202
- │ └── 404 at /api/user/preferences │
203
- │ │
204
- │ Accessibility Issues: 3 │
205
- │ ├── [serious] Form input missing label │
206
- │ ├── [moderate] Color contrast insufficient │
207
- │ └── [minor] Missing skip link │
208
- │ │
209
- │ Artifacts: │
210
- │ ├── 📸 Screenshots: .claude/vibe/e2e/screenshots/ │
211
- │ ├── 🎥 Video: .claude/vibe/e2e/videos/ │
212
- │ └── 📋 Report: .claude/vibe/e2e/report.html │
213
- │ │
214
- └─────────────────────────────────────────────────────────────────┘
215
- ```
216
-
217
- ## Configuration
218
-
219
- `.claude/vibe/e2e/config.json`:
220
-
221
- ```json
222
- {
223
- "baseURL": "http://localhost:3000",
224
- "browsers": ["chromium"],
225
- "viewport": { "width": 1280, "height": 720 },
226
- "video": "retain-on-failure",
227
- "screenshot": "only-on-failure",
228
- "trace": "retain-on-failure",
229
- "visualRegression": {
230
- "enabled": true,
231
- "threshold": 0.01
232
- },
233
- "accessibility": {
234
- "enabled": true,
235
- "rules": ["wcag2aa"]
236
- }
237
- }
238
- ```
239
-
240
- ## Integration with Review
241
-
242
- Auto-suggest after `/vibe.review`:
243
-
244
- ```
245
- ┌─────────────────────────────────────────────────────────────────┐
246
- │ 💡 E2E Test Recommended │
247
- ├─────────────────────────────────────────────────────────────────┤
248
- │ │
249
- │ UI changes detected in this PR: │
250
- │ - src/components/LoginForm.tsx │
251
- │ - src/pages/Dashboard.tsx │
252
- │ │
253
- │ Run E2E tests? /vibe.e2e "login flow" │
254
- │ │
255
- └─────────────────────────────────────────────────────────────────┘
256
- ```
257
-
258
- ## Related Commands
259
-
260
- - `/vibe.review` - Code review
261
- - `/vibe.verify` - SPEC verification
262
- - `/vibe.compound` - Document test results
263
-
264
- ---
265
-
266
- ARGUMENTS: $ARGUMENTS
1
+ ---
2
+ description: End-to-end testing with Playwright automation
3
+ argument-hint: "test scenario or URL"
4
+ ---
5
+
6
+ # /vibe.e2e
7
+
8
+ **E2E Test Automation** - Playwright-based browser testing
9
+
10
+ ## Usage
11
+
12
+ ```
13
+ /vibe.e2e # Run all E2E tests
14
+ /vibe.e2e "login flow" # Test specific scenario
15
+ /vibe.e2e http://localhost:3000/login # Test specific URL
16
+ /vibe.e2e --visual # Visual regression testing
17
+ /vibe.e2e --record # Record test video
18
+ ```
19
+
20
+ ## Core Features
21
+
22
+ ```
23
+ ┌─────────────────────────────────────────────────────────────────┐
24
+ │ 🎭 Playwright E2E Testing │
25
+ ├─────────────────────────────────────────────────────────────────┤
26
+ │ │
27
+ │ ✅ Screenshot Capture - Record UI state │
28
+ │ ✅ Console Error Collection - Detect JS errors │
29
+ │ ✅ Network Monitoring - Detect API failures │
30
+ │ ✅ Visual Regression - Compare screenshots │
31
+ │ ✅ Video Recording - Bug reproduction evidence │
32
+ │ ✅ Accessibility Check - Detect a11y violations │
33
+ │ │
34
+ └─────────────────────────────────────────────────────────────────┘
35
+ ```
36
+
37
+ ## Process
38
+
39
+ ### Phase 1: Environment Setup
40
+
41
+ ```bash
42
+ # Check Playwright installation
43
+ npx playwright --version
44
+
45
+ # Install browsers if needed
46
+ npx playwright install chromium
47
+ ```
48
+
49
+ ### Phase 2: Test Scenario Analysis
50
+
51
+ ```
52
+ 📋 Scenario Detection
53
+ ├── .claude/vibe/features/{feature}.feature → Extract BDD scenarios
54
+ ├── .claude/vibe/specs/{feature}.md → Check acceptance criteria
55
+ └── Analyze existing e2e/*.spec.ts
56
+ ```
57
+
58
+ ### Phase 3: Test Execution
59
+
60
+ **Single Page Test:**
61
+ ```typescript
62
+ // Auto-generated test
63
+ import { test, expect } from '@playwright/test';
64
+
65
+ test('login flow', async ({ page }) => {
66
+ // Navigate
67
+ await page.goto('http://localhost:3000/login');
68
+
69
+ // Screenshot: initial state
70
+ await page.screenshot({ path: 'screenshots/login-initial.png' });
71
+
72
+ // Fill form
73
+ await page.fill('[data-testid="email"]', 'test@example.com');
74
+ await page.fill('[data-testid="password"]', 'password123');
75
+
76
+ // Submit
77
+ await page.click('[data-testid="submit"]');
78
+
79
+ // Wait for navigation
80
+ await page.waitForURL('**/dashboard');
81
+
82
+ // Screenshot: success state
83
+ await page.screenshot({ path: 'screenshots/login-success.png' });
84
+
85
+ // Assertions
86
+ await expect(page.locator('h1')).toContainText('Dashboard');
87
+ });
88
+ ```
89
+
90
+ **Console Error Collection:**
91
+ ```typescript
92
+ test.beforeEach(async ({ page }) => {
93
+ // Collect console errors
94
+ page.on('console', msg => {
95
+ if (msg.type() === 'error') {
96
+ console.log(`Console Error: ${msg.text()}`);
97
+ }
98
+ });
99
+
100
+ // Collect network failures
101
+ page.on('requestfailed', request => {
102
+ console.log(`Request failed: ${request.url()}`);
103
+ });
104
+ });
105
+ ```
106
+
107
+ ### Phase 4: Visual Regression (--visual)
108
+
109
+ ```
110
+ ┌─────────────────────────────────────────────────────────────────┐
111
+ │ 👁️ Visual Regression Test │
112
+ ├─────────────────────────────────────────────────────────────────┤
113
+ │ │
114
+ │ Comparing screenshots: │
115
+ │ │
116
+ │ ├── login-page.png │
117
+ │ │ ├── Baseline: .claude/vibe/e2e/baseline/login-page.png │
118
+ │ │ ├── Current: .claude/vibe/e2e/current/login-page.png │
119
+ │ │ └── Diff: ✅ 0.02% (threshold: 1%) │
120
+ │ │ │
121
+ │ ├── dashboard.png │
122
+ │ │ ├── Baseline: .claude/vibe/e2e/baseline/dashboard.png │
123
+ │ │ ├── Current: .claude/vibe/e2e/current/dashboard.png │
124
+ │ │ └── Diff: ❌ 5.3% (threshold: 1%) │
125
+ │ │ └── .claude/vibe/e2e/diff/dashboard-diff.png │
126
+ │ │ │
127
+ └─────────────────────────────────────────────────────────────────┘
128
+ ```
129
+
130
+ ### Phase 5: Accessibility Check
131
+
132
+ ```typescript
133
+ import { injectAxe, checkA11y } from 'axe-playwright';
134
+
135
+ test('accessibility check', async ({ page }) => {
136
+ await page.goto('/login');
137
+ await injectAxe(page);
138
+ await checkA11y(page, null, {
139
+ detailedReport: true,
140
+ detailedReportOptions: { html: true }
141
+ });
142
+ });
143
+ ```
144
+
145
+ ### Phase 6: Bug Reproduction (Optional)
146
+
147
+ Link with bug reports:
148
+
149
+ ```
150
+ /vibe.e2e --reproduce "User sees blank page after login"
151
+
152
+ ┌─────────────────────────────────────────────────────────────────┐
153
+ │ 🐛 Bug Reproduction Mode │
154
+ ├─────────────────────────────────────────────────────────────────┤
155
+ │ │
156
+ │ Steps executed: │
157
+ │ 1. ✅ Navigate to /login │
158
+ │ 2. ✅ Enter credentials │
159
+ │ 3. ✅ Click login button │
160
+ │ 4. ❌ Dashboard shows blank │
161
+ │ │
162
+ │ Evidence collected: │
163
+ │ ├── 📸 screenshots/bug-step-1.png │
164
+ │ ├── 📸 screenshots/bug-step-2.png │
165
+ │ ├── 📸 screenshots/bug-step-3.png │
166
+ │ ├── 📸 screenshots/bug-step-4-FAIL.png │
167
+ │ ├── 🎥 videos/bug-reproduction.webm │
168
+ │ └── 📋 logs/console-errors.txt │
169
+ │ │
170
+ │ Console Errors Found: │
171
+ │ └── TypeError: Cannot read property 'user' of undefined │
172
+ │ at Dashboard.tsx:42 │
173
+ │ │
174
+ └─────────────────────────────────────────────────────────────────┘
175
+ ```
176
+
177
+ ## Output
178
+
179
+ ```
180
+ ┌─────────────────────────────────────────────────────────────────┐
181
+ │ 🎭 E2E TEST RESULTS │
182
+ ├─────────────────────────────────────────────────────────────────┤
183
+ │ │
184
+ │ Test Suite: Login Flow │
185
+ │ Duration: 12.3s │
186
+ │ Browser: Chromium 120 │
187
+ │ │
188
+ │ Results: │
189
+ │ ├── ✅ Passed: 8 │
190
+ │ ├── ❌ Failed: 1 │
191
+ │ └── ⏭️ Skipped: 0 │
192
+ │ │
193
+ │ Failed Tests: │
194
+ │ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ │
195
+ │ ❌ "should show error for invalid password" │
196
+ │ Expected: "Invalid password" message │
197
+ │ Actual: No error message displayed │
198
+ │ 📸 Screenshot: .claude/vibe/e2e/failures/invalid-password.png │
199
+ │ │
200
+ │ Console Errors: 2 │
201
+ │ ├── TypeError at Dashboard.tsx:42 │
202
+ │ └── 404 at /api/user/preferences │
203
+ │ │
204
+ │ Accessibility Issues: 3 │
205
+ │ ├── [serious] Form input missing label │
206
+ │ ├── [moderate] Color contrast insufficient │
207
+ │ └── [minor] Missing skip link │
208
+ │ │
209
+ │ Artifacts: │
210
+ │ ├── 📸 Screenshots: .claude/vibe/e2e/screenshots/ │
211
+ │ ├── 🎥 Video: .claude/vibe/e2e/videos/ │
212
+ │ └── 📋 Report: .claude/vibe/e2e/report.html │
213
+ │ │
214
+ └─────────────────────────────────────────────────────────────────┘
215
+ ```
216
+
217
+ ## Configuration
218
+
219
+ `.claude/vibe/e2e/config.json`:
220
+
221
+ ```json
222
+ {
223
+ "baseURL": "http://localhost:3000",
224
+ "browsers": ["chromium"],
225
+ "viewport": { "width": 1280, "height": 720 },
226
+ "video": "retain-on-failure",
227
+ "screenshot": "only-on-failure",
228
+ "trace": "retain-on-failure",
229
+ "visualRegression": {
230
+ "enabled": true,
231
+ "threshold": 0.01
232
+ },
233
+ "accessibility": {
234
+ "enabled": true,
235
+ "rules": ["wcag2aa"]
236
+ }
237
+ }
238
+ ```
239
+
240
+ ## Integration with Review
241
+
242
+ Auto-suggest after `/vibe.review`:
243
+
244
+ ```
245
+ ┌─────────────────────────────────────────────────────────────────┐
246
+ │ 💡 E2E Test Recommended │
247
+ ├─────────────────────────────────────────────────────────────────┤
248
+ │ │
249
+ │ UI changes detected in this PR: │
250
+ │ - src/components/LoginForm.tsx │
251
+ │ - src/pages/Dashboard.tsx │
252
+ │ │
253
+ │ Run E2E tests? /vibe.e2e "login flow" │
254
+ │ │
255
+ └─────────────────────────────────────────────────────────────────┘
256
+ ```
257
+
258
+ ## Related Commands
259
+
260
+ - `/vibe.review` - Code review
261
+ - `/vibe.verify` - SPEC verification
262
+ - `/vibe.compound` - Document test results
263
+
264
+ ---
265
+
266
+ ARGUMENTS: $ARGUMENTS
@@ -0,0 +1,42 @@
1
+ # Explorer Agent - Low Tier (Haiku)
2
+
3
+ Fast codebase exploration for simple searches.
4
+
5
+ ## Role
6
+
7
+ - Quick file/pattern search
8
+ - Basic structure analysis
9
+ - Simple dependency checking
10
+
11
+ ## Model
12
+
13
+ **Haiku** - Optimized for fast, simple searches
14
+
15
+ ## When to Use
16
+
17
+ - Single file lookups
18
+ - Simple pattern matching
19
+ - Quick structure overview
20
+ - Cost-sensitive operations
21
+
22
+ ## Usage
23
+
24
+ ```
25
+ Task(model: "haiku", subagent_type: "Explore", prompt: "Find files matching *.ts in src/")
26
+ ```
27
+
28
+ ## Process
29
+
30
+ 1. Quick pattern match (Glob)
31
+ 2. Basic content scan (Grep)
32
+ 3. Return file list
33
+
34
+ ## Output
35
+
36
+ ```markdown
37
+ ## Quick Search Results
38
+
39
+ ### Files Found
40
+ - src/index.ts
41
+ - src/utils/helper.ts
42
+ ```
@@ -0,0 +1,59 @@
1
+ # Explorer Agent - Medium Tier (Sonnet)
2
+
3
+ Balanced codebase exploration with analysis.
4
+
5
+ ## Role
6
+
7
+ - Thorough file/pattern search
8
+ - Code structure analysis
9
+ - Dependency graph understanding
10
+ - Pattern identification
11
+
12
+ ## Model
13
+
14
+ **Sonnet** - Balanced speed and depth
15
+
16
+ ## When to Use
17
+
18
+ - Multi-file searches
19
+ - Understanding code relationships
20
+ - Pattern discovery
21
+ - Standard exploration tasks
22
+
23
+ ## Usage
24
+
25
+ ```
26
+ Task(model: "sonnet", subagent_type: "Explore", prompt: "Analyze the authentication flow")
27
+ ```
28
+
29
+ ## Process
30
+
31
+ 1. Understand project structure
32
+ 2. Search related files (Glob, Grep)
33
+ 3. Read and analyze key files
34
+ 4. Identify patterns/conventions
35
+ 5. Map dependencies
36
+ 6. Return detailed summary
37
+
38
+ ## Output
39
+
40
+ ```markdown
41
+ ## Exploration Results
42
+
43
+ ### Related Files
44
+ - src/auth/login.ts (entry point)
45
+ - src/auth/service.ts (business logic)
46
+ - src/auth/types.ts (type definitions)
47
+
48
+ ### Discovered Patterns
49
+ - Auth uses JWT tokens
50
+ - Session stored in Redis
51
+ - Refresh token rotation enabled
52
+
53
+ ### Dependencies
54
+ - jsonwebtoken: ^9.0.0
55
+ - redis: ^4.0.0
56
+
57
+ ### Code Flow
58
+ login.ts → service.ts → database.ts → redis cache
59
+ ```