@su-record/vibe 2.6.28 → 2.6.30

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 (240) hide show
  1. package/CLAUDE.md +235 -202
  2. package/LICENSE +21 -21
  3. package/README.md +276 -267
  4. package/agents/architect-low.md +41 -41
  5. package/agents/architect-medium.md +59 -59
  6. package/agents/architect.md +80 -80
  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/docs/api-documenter.md +99 -99
  11. package/agents/docs/changelog-writer.md +93 -93
  12. package/agents/e2e-tester.md +266 -266
  13. package/agents/explorer-low.md +42 -42
  14. package/agents/explorer-medium.md +59 -59
  15. package/agents/explorer.md +48 -48
  16. package/agents/implementer-low.md +43 -43
  17. package/agents/implementer-medium.md +52 -52
  18. package/agents/implementer.md +54 -54
  19. package/agents/planning/requirements-analyst.md +84 -84
  20. package/agents/planning/ux-advisor.md +83 -83
  21. package/agents/qa/acceptance-tester.md +86 -86
  22. package/agents/qa/edge-case-finder.md +93 -93
  23. package/agents/refactor-cleaner.md +143 -143
  24. package/agents/research/best-practices-agent.md +199 -199
  25. package/agents/research/codebase-patterns-agent.md +157 -157
  26. package/agents/research/framework-docs-agent.md +188 -188
  27. package/agents/research/security-advisory-agent.md +213 -213
  28. package/agents/review/architecture-reviewer.md +107 -107
  29. package/agents/review/complexity-reviewer.md +116 -116
  30. package/agents/review/data-integrity-reviewer.md +88 -88
  31. package/agents/review/git-history-reviewer.md +103 -103
  32. package/agents/review/performance-reviewer.md +86 -86
  33. package/agents/review/python-reviewer.md +150 -150
  34. package/agents/review/rails-reviewer.md +139 -139
  35. package/agents/review/react-reviewer.md +144 -144
  36. package/agents/review/security-reviewer.md +80 -80
  37. package/agents/review/simplicity-reviewer.md +140 -140
  38. package/agents/review/test-coverage-reviewer.md +116 -116
  39. package/agents/review/typescript-reviewer.md +127 -127
  40. package/agents/searcher.md +54 -54
  41. package/agents/simplifier.md +120 -120
  42. package/agents/tester.md +49 -49
  43. package/agents/ui-previewer.md +268 -268
  44. package/commands/vibe.analyze.md +356 -356
  45. package/commands/vibe.reason.md +329 -329
  46. package/commands/vibe.review.md +423 -423
  47. package/commands/vibe.run.md +1423 -1313
  48. package/commands/vibe.spec.md +1054 -1054
  49. package/commands/vibe.spec.review.md +412 -412
  50. package/commands/vibe.trace.md +161 -161
  51. package/commands/vibe.utils.md +376 -376
  52. package/commands/vibe.verify.md +375 -375
  53. package/dist/cli/collaborator.js +52 -52
  54. package/dist/cli/detect.js +32 -32
  55. package/dist/cli/hud.js +20 -20
  56. package/dist/cli/index.js +112 -112
  57. package/dist/cli/llm.js +144 -144
  58. package/dist/cli/postinstall.js +858 -858
  59. package/dist/lib/DeepInit.js +24 -24
  60. package/dist/lib/IterationTracker.js +11 -11
  61. package/dist/lib/PythonParser.js +108 -108
  62. package/dist/lib/ReviewRace.js +96 -96
  63. package/dist/lib/SkillFrontmatter.js +28 -28
  64. package/dist/lib/SkillQualityGate.js +9 -9
  65. package/dist/lib/SkillRepository.js +159 -159
  66. package/dist/lib/UltraQA.js +77 -77
  67. package/dist/lib/gemini-api.js +5 -5
  68. package/dist/lib/gpt-api.js +4 -4
  69. package/dist/lib/memory/KnowledgeGraph.js +4 -4
  70. package/dist/lib/memory/MemorySearch.js +43 -43
  71. package/dist/lib/memory/MemoryStorage.js +130 -130
  72. package/dist/lib/memory/ObservationStore.js +28 -28
  73. package/dist/lib/memory/SessionRAGRetriever.js +7 -7
  74. package/dist/lib/memory/SessionRAGStore.js +216 -216
  75. package/dist/lib/memory/SessionSummarizer.js +9 -9
  76. package/dist/orchestrator/AgentManager.js +12 -12
  77. package/dist/orchestrator/MultiLlmResearch.js +8 -8
  78. package/dist/orchestrator/SmartRouter.js +11 -11
  79. package/dist/orchestrator/SwarmOrchestrator.test.js +16 -16
  80. package/dist/orchestrator/parallelResearch.js +24 -24
  81. package/dist/tools/convention/analyzeComplexity.test.js +115 -115
  82. package/dist/tools/convention/validateCodeQuality.test.js +104 -104
  83. package/dist/tools/spec/prdParser.test.js +171 -171
  84. package/dist/tools/spec/specGenerator.js +169 -169
  85. package/dist/tools/spec/traceabilityMatrix.js +64 -64
  86. package/dist/tools/spec/traceabilityMatrix.test.js +28 -28
  87. package/hooks/hooks.json +115 -115
  88. package/hooks/scripts/code-check.js +70 -70
  89. package/hooks/scripts/code-review.js +22 -22
  90. package/hooks/scripts/complexity.js +22 -22
  91. package/hooks/scripts/compound.js +23 -23
  92. package/hooks/scripts/context-save.js +53 -53
  93. package/hooks/scripts/gemini-ui-gen.js +281 -281
  94. package/hooks/scripts/generate-brand-assets.js +474 -474
  95. package/hooks/scripts/hud-multiline.js +262 -262
  96. package/hooks/scripts/hud-status.js +291 -291
  97. package/hooks/scripts/keyword-detector.js +214 -214
  98. package/hooks/scripts/llm-orchestrate.js +328 -171
  99. package/hooks/scripts/post-edit.js +97 -97
  100. package/hooks/scripts/post-tool-verify.js +210 -210
  101. package/hooks/scripts/pre-tool-guard.js +125 -125
  102. package/hooks/scripts/prompt-dispatcher.js +161 -161
  103. package/hooks/scripts/recall.js +22 -22
  104. package/hooks/scripts/session-start.js +30 -30
  105. package/hooks/scripts/skill-injector.js +191 -191
  106. package/hooks/scripts/utils.js +97 -97
  107. package/languages/csharp-unity.md +515 -515
  108. package/languages/gdscript-godot.md +470 -470
  109. package/languages/ruby-rails.md +489 -489
  110. package/languages/typescript-angular.md +433 -433
  111. package/languages/typescript-astro.md +416 -416
  112. package/languages/typescript-electron.md +406 -406
  113. package/languages/typescript-nestjs.md +524 -524
  114. package/languages/typescript-svelte.md +407 -407
  115. package/languages/typescript-tauri.md +365 -365
  116. package/package.json +84 -84
  117. package/skills/brand-assets.md +141 -141
  118. package/skills/commerce-patterns.md +361 -361
  119. package/skills/context7-usage.md +102 -102
  120. package/skills/e2e-commerce.md +304 -304
  121. package/skills/frontend-design.md +92 -92
  122. package/skills/git-worktree.md +181 -181
  123. package/skills/parallel-research.md +77 -77
  124. package/skills/priority-todos.md +239 -239
  125. package/skills/seo-checklist.md +244 -244
  126. package/skills/tool-fallback.md +190 -190
  127. package/skills/vibe-capabilities.md +161 -161
  128. package/vibe/constitution.md +227 -227
  129. package/vibe/rules/core/communication-guide.md +98 -98
  130. package/vibe/rules/core/development-philosophy.md +52 -52
  131. package/vibe/rules/core/quick-start.md +102 -102
  132. package/vibe/rules/quality/bdd-contract-testing.md +393 -393
  133. package/vibe/rules/quality/checklist.md +276 -276
  134. package/vibe/rules/quality/testing-strategy.md +440 -440
  135. package/vibe/rules/standards/anti-patterns.md +541 -541
  136. package/vibe/rules/standards/code-structure.md +291 -291
  137. package/vibe/rules/standards/complexity-metrics.md +313 -313
  138. package/vibe/rules/standards/naming-conventions.md +198 -198
  139. package/vibe/setup.sh +31 -31
  140. package/vibe/templates/constitution-template.md +252 -252
  141. package/vibe/templates/contract-backend-template.md +526 -526
  142. package/vibe/templates/contract-frontend-template.md +599 -599
  143. package/vibe/templates/feature-template.md +96 -96
  144. package/vibe/templates/spec-template.md +221 -221
  145. package/dist/cli/mcp.d.ts +0 -49
  146. package/dist/cli/mcp.d.ts.map +0 -1
  147. package/dist/cli/mcp.js +0 -169
  148. package/dist/cli/mcp.js.map +0 -1
  149. package/dist/lib/gemini-mcp.d.ts +0 -10
  150. package/dist/lib/gemini-mcp.d.ts.map +0 -1
  151. package/dist/lib/gemini-mcp.js +0 -353
  152. package/dist/lib/gemini-mcp.js.map +0 -1
  153. package/dist/lib/gpt-mcp.d.ts +0 -10
  154. package/dist/lib/gpt-mcp.d.ts.map +0 -1
  155. package/dist/lib/gpt-mcp.js +0 -352
  156. package/dist/lib/gpt-mcp.js.map +0 -1
  157. package/dist/tools/analytics/getUsageAnalytics.d.ts +0 -10
  158. package/dist/tools/analytics/getUsageAnalytics.d.ts.map +0 -1
  159. package/dist/tools/analytics/getUsageAnalytics.js +0 -246
  160. package/dist/tools/analytics/getUsageAnalytics.js.map +0 -1
  161. package/dist/tools/analytics/index.d.ts +0 -5
  162. package/dist/tools/analytics/index.d.ts.map +0 -1
  163. package/dist/tools/analytics/index.js +0 -5
  164. package/dist/tools/analytics/index.js.map +0 -1
  165. package/dist/tools/convention/getCodingGuide.d.ts +0 -7
  166. package/dist/tools/convention/getCodingGuide.d.ts.map +0 -1
  167. package/dist/tools/convention/getCodingGuide.js +0 -69
  168. package/dist/tools/convention/getCodingGuide.js.map +0 -1
  169. package/dist/tools/planning/analyzeRequirements.d.ts +0 -9
  170. package/dist/tools/planning/analyzeRequirements.d.ts.map +0 -1
  171. package/dist/tools/planning/analyzeRequirements.js +0 -171
  172. package/dist/tools/planning/analyzeRequirements.js.map +0 -1
  173. package/dist/tools/planning/createUserStories.d.ts +0 -9
  174. package/dist/tools/planning/createUserStories.d.ts.map +0 -1
  175. package/dist/tools/planning/createUserStories.js +0 -124
  176. package/dist/tools/planning/createUserStories.js.map +0 -1
  177. package/dist/tools/planning/featureRoadmap.d.ts +0 -10
  178. package/dist/tools/planning/featureRoadmap.d.ts.map +0 -1
  179. package/dist/tools/planning/featureRoadmap.js +0 -207
  180. package/dist/tools/planning/featureRoadmap.js.map +0 -1
  181. package/dist/tools/planning/generatePrd.d.ts +0 -11
  182. package/dist/tools/planning/generatePrd.d.ts.map +0 -1
  183. package/dist/tools/planning/generatePrd.js +0 -161
  184. package/dist/tools/planning/generatePrd.js.map +0 -1
  185. package/dist/tools/planning/index.d.ts +0 -8
  186. package/dist/tools/planning/index.d.ts.map +0 -1
  187. package/dist/tools/planning/index.js +0 -8
  188. package/dist/tools/planning/index.js.map +0 -1
  189. package/dist/tools/prompt/analyzePrompt.d.ts +0 -7
  190. package/dist/tools/prompt/analyzePrompt.d.ts.map +0 -1
  191. package/dist/tools/prompt/analyzePrompt.js +0 -150
  192. package/dist/tools/prompt/analyzePrompt.js.map +0 -1
  193. package/dist/tools/prompt/enhancePrompt.d.ts +0 -8
  194. package/dist/tools/prompt/enhancePrompt.d.ts.map +0 -1
  195. package/dist/tools/prompt/enhancePrompt.js +0 -110
  196. package/dist/tools/prompt/enhancePrompt.js.map +0 -1
  197. package/dist/tools/prompt/enhancePromptGemini.d.ts +0 -8
  198. package/dist/tools/prompt/enhancePromptGemini.d.ts.map +0 -1
  199. package/dist/tools/prompt/enhancePromptGemini.js +0 -332
  200. package/dist/tools/prompt/enhancePromptGemini.js.map +0 -1
  201. package/dist/tools/prompt/index.d.ts +0 -7
  202. package/dist/tools/prompt/index.d.ts.map +0 -1
  203. package/dist/tools/prompt/index.js +0 -7
  204. package/dist/tools/prompt/index.js.map +0 -1
  205. package/dist/tools/reasoning/applyReasoningFramework.d.ts +0 -8
  206. package/dist/tools/reasoning/applyReasoningFramework.d.ts.map +0 -1
  207. package/dist/tools/reasoning/applyReasoningFramework.js +0 -266
  208. package/dist/tools/reasoning/applyReasoningFramework.js.map +0 -1
  209. package/dist/tools/reasoning/index.d.ts +0 -5
  210. package/dist/tools/reasoning/index.d.ts.map +0 -1
  211. package/dist/tools/reasoning/index.js +0 -5
  212. package/dist/tools/reasoning/index.js.map +0 -1
  213. package/dist/tools/thinking/analyzeProblem.d.ts +0 -7
  214. package/dist/tools/thinking/analyzeProblem.d.ts.map +0 -1
  215. package/dist/tools/thinking/analyzeProblem.js +0 -55
  216. package/dist/tools/thinking/analyzeProblem.js.map +0 -1
  217. package/dist/tools/thinking/breakDownProblem.d.ts +0 -8
  218. package/dist/tools/thinking/breakDownProblem.d.ts.map +0 -1
  219. package/dist/tools/thinking/breakDownProblem.js +0 -145
  220. package/dist/tools/thinking/breakDownProblem.js.map +0 -1
  221. package/dist/tools/thinking/createThinkingChain.d.ts +0 -7
  222. package/dist/tools/thinking/createThinkingChain.d.ts.map +0 -1
  223. package/dist/tools/thinking/createThinkingChain.js +0 -44
  224. package/dist/tools/thinking/createThinkingChain.js.map +0 -1
  225. package/dist/tools/thinking/formatAsPlan.d.ts +0 -9
  226. package/dist/tools/thinking/formatAsPlan.d.ts.map +0 -1
  227. package/dist/tools/thinking/formatAsPlan.js +0 -78
  228. package/dist/tools/thinking/formatAsPlan.js.map +0 -1
  229. package/dist/tools/thinking/index.d.ts +0 -10
  230. package/dist/tools/thinking/index.d.ts.map +0 -1
  231. package/dist/tools/thinking/index.js +0 -10
  232. package/dist/tools/thinking/index.js.map +0 -1
  233. package/dist/tools/thinking/stepByStepAnalysis.d.ts +0 -8
  234. package/dist/tools/thinking/stepByStepAnalysis.d.ts.map +0 -1
  235. package/dist/tools/thinking/stepByStepAnalysis.js +0 -63
  236. package/dist/tools/thinking/stepByStepAnalysis.js.map +0 -1
  237. package/dist/tools/thinking/thinkAloudProcess.d.ts +0 -8
  238. package/dist/tools/thinking/thinkAloudProcess.d.ts.map +0 -1
  239. package/dist/tools/thinking/thinkAloudProcess.js +0 -80
  240. 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
@@ -1,42 +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
- ```
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
+ ```