@su-record/vibe 2.5.7 → 2.5.9

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 (190) hide show
  1. package/CLAUDE.md +348 -338
  2. package/LICENSE +21 -21
  3. package/README.md +262 -262
  4. package/agents/build-error-resolver.md +115 -0
  5. package/agents/compounder.md +261 -261
  6. package/agents/diagrammer.md +178 -178
  7. package/agents/e2e-tester.md +266 -266
  8. package/agents/explorer.md +48 -48
  9. package/agents/implementer.md +54 -54
  10. package/agents/refactor-cleaner.md +143 -0
  11. package/agents/research/best-practices-agent.md +189 -189
  12. package/agents/research/codebase-patterns-agent.md +147 -147
  13. package/agents/research/framework-docs-agent.md +178 -178
  14. package/agents/research/security-advisory-agent.md +203 -203
  15. package/agents/review/architecture-reviewer.md +107 -107
  16. package/agents/review/complexity-reviewer.md +116 -116
  17. package/agents/review/data-integrity-reviewer.md +88 -88
  18. package/agents/review/git-history-reviewer.md +103 -103
  19. package/agents/review/performance-reviewer.md +86 -86
  20. package/agents/review/python-reviewer.md +150 -150
  21. package/agents/review/rails-reviewer.md +139 -139
  22. package/agents/review/react-reviewer.md +144 -144
  23. package/agents/review/security-reviewer.md +80 -80
  24. package/agents/review/simplicity-reviewer.md +140 -140
  25. package/agents/review/test-coverage-reviewer.md +116 -116
  26. package/agents/review/typescript-reviewer.md +127 -127
  27. package/agents/searcher.md +54 -54
  28. package/agents/simplifier.md +120 -120
  29. package/agents/tester.md +49 -49
  30. package/agents/ui-previewer.md +129 -129
  31. package/commands/vibe.analyze.md +356 -356
  32. package/commands/vibe.reason.md +329 -329
  33. package/commands/vibe.review.md +326 -326
  34. package/commands/vibe.run.md +1031 -1031
  35. package/commands/vibe.spec.md +1022 -1022
  36. package/commands/vibe.utils.md +296 -202
  37. package/commands/vibe.verify.md +375 -375
  38. package/dist/cli/collaborator.js +52 -52
  39. package/dist/cli/detect.js +32 -32
  40. package/dist/cli/index.d.ts.map +1 -1
  41. package/dist/cli/index.js +102 -112
  42. package/dist/cli/index.js.map +1 -1
  43. package/dist/cli/llm.js +144 -144
  44. package/dist/cli/mcp.d.ts +49 -0
  45. package/dist/cli/mcp.d.ts.map +1 -0
  46. package/dist/cli/mcp.js +169 -0
  47. package/dist/cli/mcp.js.map +1 -0
  48. package/dist/lib/PythonParser.js +108 -108
  49. package/dist/lib/gemini-mcp.d.ts +10 -0
  50. package/dist/lib/gemini-mcp.d.ts.map +1 -0
  51. package/dist/lib/gemini-mcp.js +353 -0
  52. package/dist/lib/gemini-mcp.js.map +1 -0
  53. package/dist/lib/gpt-api.js +4 -4
  54. package/dist/lib/gpt-mcp.d.ts +10 -0
  55. package/dist/lib/gpt-mcp.d.ts.map +1 -0
  56. package/dist/lib/gpt-mcp.js +352 -0
  57. package/dist/lib/gpt-mcp.js.map +1 -0
  58. package/dist/lib/memory/KnowledgeGraph.js +4 -4
  59. package/dist/lib/memory/MemorySearch.js +20 -20
  60. package/dist/lib/memory/MemoryStorage.js +64 -64
  61. package/dist/tools/analytics/getUsageAnalytics.d.ts +10 -0
  62. package/dist/tools/analytics/getUsageAnalytics.d.ts.map +1 -0
  63. package/dist/tools/analytics/getUsageAnalytics.js +246 -0
  64. package/dist/tools/analytics/getUsageAnalytics.js.map +1 -0
  65. package/dist/tools/analytics/index.d.ts +5 -0
  66. package/dist/tools/analytics/index.d.ts.map +1 -0
  67. package/dist/tools/analytics/index.js +5 -0
  68. package/dist/tools/analytics/index.js.map +1 -0
  69. package/dist/tools/convention/analyzeComplexity.test.js +115 -115
  70. package/dist/tools/convention/getCodingGuide.d.ts +7 -0
  71. package/dist/tools/convention/getCodingGuide.d.ts.map +1 -0
  72. package/dist/tools/convention/getCodingGuide.js +69 -0
  73. package/dist/tools/convention/getCodingGuide.js.map +1 -0
  74. package/dist/tools/convention/validateCodeQuality.test.js +104 -104
  75. package/dist/tools/planning/analyzeRequirements.d.ts +9 -0
  76. package/dist/tools/planning/analyzeRequirements.d.ts.map +1 -0
  77. package/dist/tools/planning/analyzeRequirements.js +171 -0
  78. package/dist/tools/planning/analyzeRequirements.js.map +1 -0
  79. package/dist/tools/planning/createUserStories.d.ts +9 -0
  80. package/dist/tools/planning/createUserStories.d.ts.map +1 -0
  81. package/dist/tools/planning/createUserStories.js +124 -0
  82. package/dist/tools/planning/createUserStories.js.map +1 -0
  83. package/dist/tools/planning/featureRoadmap.d.ts +10 -0
  84. package/dist/tools/planning/featureRoadmap.d.ts.map +1 -0
  85. package/dist/tools/planning/featureRoadmap.js +207 -0
  86. package/dist/tools/planning/featureRoadmap.js.map +1 -0
  87. package/dist/tools/planning/generatePrd.d.ts +11 -0
  88. package/dist/tools/planning/generatePrd.d.ts.map +1 -0
  89. package/dist/tools/planning/generatePrd.js +161 -0
  90. package/dist/tools/planning/generatePrd.js.map +1 -0
  91. package/dist/tools/planning/index.d.ts +8 -0
  92. package/dist/tools/planning/index.d.ts.map +1 -0
  93. package/dist/tools/planning/index.js +8 -0
  94. package/dist/tools/planning/index.js.map +1 -0
  95. package/dist/tools/prompt/analyzePrompt.d.ts +7 -0
  96. package/dist/tools/prompt/analyzePrompt.d.ts.map +1 -0
  97. package/dist/tools/prompt/analyzePrompt.js +150 -0
  98. package/dist/tools/prompt/analyzePrompt.js.map +1 -0
  99. package/dist/tools/prompt/enhancePrompt.d.ts +8 -0
  100. package/dist/tools/prompt/enhancePrompt.d.ts.map +1 -0
  101. package/dist/tools/prompt/enhancePrompt.js +110 -0
  102. package/dist/tools/prompt/enhancePrompt.js.map +1 -0
  103. package/dist/tools/prompt/enhancePromptGemini.d.ts +8 -0
  104. package/dist/tools/prompt/enhancePromptGemini.d.ts.map +1 -0
  105. package/dist/tools/prompt/enhancePromptGemini.js +332 -0
  106. package/dist/tools/prompt/enhancePromptGemini.js.map +1 -0
  107. package/dist/tools/prompt/index.d.ts +7 -0
  108. package/dist/tools/prompt/index.d.ts.map +1 -0
  109. package/dist/tools/prompt/index.js +7 -0
  110. package/dist/tools/prompt/index.js.map +1 -0
  111. package/dist/tools/reasoning/applyReasoningFramework.d.ts +8 -0
  112. package/dist/tools/reasoning/applyReasoningFramework.d.ts.map +1 -0
  113. package/dist/tools/reasoning/applyReasoningFramework.js +266 -0
  114. package/dist/tools/reasoning/applyReasoningFramework.js.map +1 -0
  115. package/dist/tools/reasoning/index.d.ts +5 -0
  116. package/dist/tools/reasoning/index.d.ts.map +1 -0
  117. package/dist/tools/reasoning/index.js +5 -0
  118. package/dist/tools/reasoning/index.js.map +1 -0
  119. package/dist/tools/thinking/analyzeProblem.d.ts +7 -0
  120. package/dist/tools/thinking/analyzeProblem.d.ts.map +1 -0
  121. package/dist/tools/thinking/analyzeProblem.js +55 -0
  122. package/dist/tools/thinking/analyzeProblem.js.map +1 -0
  123. package/dist/tools/thinking/breakDownProblem.d.ts +8 -0
  124. package/dist/tools/thinking/breakDownProblem.d.ts.map +1 -0
  125. package/dist/tools/thinking/breakDownProblem.js +145 -0
  126. package/dist/tools/thinking/breakDownProblem.js.map +1 -0
  127. package/dist/tools/thinking/createThinkingChain.d.ts +7 -0
  128. package/dist/tools/thinking/createThinkingChain.d.ts.map +1 -0
  129. package/dist/tools/thinking/createThinkingChain.js +44 -0
  130. package/dist/tools/thinking/createThinkingChain.js.map +1 -0
  131. package/dist/tools/thinking/formatAsPlan.d.ts +9 -0
  132. package/dist/tools/thinking/formatAsPlan.d.ts.map +1 -0
  133. package/dist/tools/thinking/formatAsPlan.js +78 -0
  134. package/dist/tools/thinking/formatAsPlan.js.map +1 -0
  135. package/dist/tools/thinking/index.d.ts +10 -0
  136. package/dist/tools/thinking/index.d.ts.map +1 -0
  137. package/dist/tools/thinking/index.js +10 -0
  138. package/dist/tools/thinking/index.js.map +1 -0
  139. package/dist/tools/thinking/stepByStepAnalysis.d.ts +8 -0
  140. package/dist/tools/thinking/stepByStepAnalysis.d.ts.map +1 -0
  141. package/dist/tools/thinking/stepByStepAnalysis.js +63 -0
  142. package/dist/tools/thinking/stepByStepAnalysis.js.map +1 -0
  143. package/dist/tools/thinking/thinkAloudProcess.d.ts +8 -0
  144. package/dist/tools/thinking/thinkAloudProcess.d.ts.map +1 -0
  145. package/dist/tools/thinking/thinkAloudProcess.js +80 -0
  146. package/dist/tools/thinking/thinkAloudProcess.js.map +1 -0
  147. package/hooks/hooks.json +204 -195
  148. package/hooks/scripts/code-check.js +22 -22
  149. package/hooks/scripts/code-review.js +22 -22
  150. package/hooks/scripts/complexity.js +22 -22
  151. package/hooks/scripts/compound.js +23 -23
  152. package/hooks/scripts/context-save.js +33 -33
  153. package/hooks/scripts/llm-orchestrate.js +171 -171
  154. package/hooks/scripts/post-edit.js +97 -0
  155. package/hooks/scripts/recall.js +22 -22
  156. package/hooks/scripts/session-start.js +30 -30
  157. package/hooks/scripts/utils.js +97 -65
  158. package/languages/csharp-unity.md +515 -515
  159. package/languages/gdscript-godot.md +470 -470
  160. package/languages/ruby-rails.md +489 -489
  161. package/languages/typescript-angular.md +433 -433
  162. package/languages/typescript-astro.md +416 -416
  163. package/languages/typescript-electron.md +406 -406
  164. package/languages/typescript-nestjs.md +524 -524
  165. package/languages/typescript-svelte.md +407 -407
  166. package/languages/typescript-tauri.md +365 -365
  167. package/package.json +83 -83
  168. package/skills/context7-usage.md +102 -102
  169. package/skills/git-worktree.md +181 -181
  170. package/skills/parallel-research.md +77 -77
  171. package/skills/priority-todos.md +239 -239
  172. package/skills/tool-fallback.md +190 -190
  173. package/skills/vibe-capabilities.md +161 -161
  174. package/vibe/constitution.md +227 -227
  175. package/vibe/rules/core/communication-guide.md +98 -98
  176. package/vibe/rules/core/development-philosophy.md +52 -52
  177. package/vibe/rules/core/quick-start.md +102 -102
  178. package/vibe/rules/quality/bdd-contract-testing.md +393 -393
  179. package/vibe/rules/quality/checklist.md +276 -276
  180. package/vibe/rules/quality/testing-strategy.md +440 -440
  181. package/vibe/rules/standards/anti-patterns.md +541 -369
  182. package/vibe/rules/standards/code-structure.md +291 -291
  183. package/vibe/rules/standards/complexity-metrics.md +313 -313
  184. package/vibe/rules/standards/naming-conventions.md +198 -198
  185. package/vibe/setup.sh +31 -31
  186. package/vibe/templates/constitution-template.md +252 -252
  187. package/vibe/templates/contract-backend-template.md +526 -526
  188. package/vibe/templates/contract-frontend-template.md +599 -599
  189. package/vibe/templates/feature-template.md +96 -96
  190. package/vibe/templates/spec-template.md +221 -221
@@ -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
@@ -1,48 +1,48 @@
1
- # Explorer Agent (Haiku 4.5)
2
-
3
- Codebase exploration specialist sub-agent.
4
-
5
- ## Role
6
-
7
- - Codebase analysis
8
- - File/pattern search
9
- - Dependency checking
10
- - Related code collection
11
-
12
- ## Model
13
-
14
- **Haiku 4.5** - Optimized for fast exploration
15
-
16
- ## Usage
17
-
18
- Call via Task tool:
19
- ```
20
- Task(model: "haiku", subagent_type: "Explore")
21
- ```
22
-
23
- ## Process
24
-
25
- 1. Understand project structure
26
- 2. Search related files (Glob, Grep)
27
- 3. Read and analyze code
28
- 4. Identify patterns/conventions
29
- 5. Return summary
30
-
31
- ## Output
32
-
33
- ```markdown
34
- ## Exploration Results
35
-
36
- ### Related Files
37
- - src/components/Button.tsx (UI component)
38
- - src/hooks/useAuth.ts (auth hook)
39
-
40
- ### Discovered Patterns
41
- - Components: Functional + TypeScript
42
- - State management: Zustand
43
- - Styling: Tailwind CSS
44
-
45
- ### Dependencies
46
- - react: ^18.2.0
47
- - zustand: ^4.4.0
48
- ```
1
+ # Explorer Agent (Haiku 4.5)
2
+
3
+ Codebase exploration specialist sub-agent.
4
+
5
+ ## Role
6
+
7
+ - Codebase analysis
8
+ - File/pattern search
9
+ - Dependency checking
10
+ - Related code collection
11
+
12
+ ## Model
13
+
14
+ **Haiku 4.5** - Optimized for fast exploration
15
+
16
+ ## Usage
17
+
18
+ Call via Task tool:
19
+ ```
20
+ Task(model: "haiku", subagent_type: "Explore")
21
+ ```
22
+
23
+ ## Process
24
+
25
+ 1. Understand project structure
26
+ 2. Search related files (Glob, Grep)
27
+ 3. Read and analyze code
28
+ 4. Identify patterns/conventions
29
+ 5. Return summary
30
+
31
+ ## Output
32
+
33
+ ```markdown
34
+ ## Exploration Results
35
+
36
+ ### Related Files
37
+ - src/components/Button.tsx (UI component)
38
+ - src/hooks/useAuth.ts (auth hook)
39
+
40
+ ### Discovered Patterns
41
+ - Components: Functional + TypeScript
42
+ - State management: Zustand
43
+ - Styling: Tailwind CSS
44
+
45
+ ### Dependencies
46
+ - react: ^18.2.0
47
+ - zustand: ^4.4.0
48
+ ```