@su-record/vibe 2.6.26 → 2.6.28

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 (287) hide show
  1. package/CLAUDE.md +202 -153
  2. package/LICENSE +21 -21
  3. package/README.md +267 -236
  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 +1313 -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/mcp.d.ts +49 -0
  59. package/dist/cli/mcp.d.ts.map +1 -0
  60. package/dist/cli/mcp.js +169 -0
  61. package/dist/cli/mcp.js.map +1 -0
  62. package/dist/cli/postinstall.d.ts.map +1 -1
  63. package/dist/cli/postinstall.js +886 -858
  64. package/dist/cli/postinstall.js.map +1 -1
  65. package/dist/cli/setup/GlobalInstaller.d.ts +6 -0
  66. package/dist/cli/setup/GlobalInstaller.d.ts.map +1 -1
  67. package/dist/cli/setup/GlobalInstaller.js +26 -0
  68. package/dist/cli/setup/GlobalInstaller.js.map +1 -1
  69. package/dist/lib/DeepInit.js +24 -24
  70. package/dist/lib/IterationTracker.js +11 -11
  71. package/dist/lib/MemoryManager.d.ts +30 -0
  72. package/dist/lib/MemoryManager.d.ts.map +1 -1
  73. package/dist/lib/MemoryManager.js +74 -0
  74. package/dist/lib/MemoryManager.js.map +1 -1
  75. package/dist/lib/PythonParser.js +108 -108
  76. package/dist/lib/ReviewRace.js +96 -96
  77. package/dist/lib/SkillFrontmatter.js +28 -28
  78. package/dist/lib/SkillQualityGate.js +9 -9
  79. package/dist/lib/SkillRepository.js +159 -159
  80. package/dist/lib/UltraQA.js +77 -77
  81. package/dist/lib/gemini-api.js +5 -5
  82. package/dist/lib/gemini-mcp.d.ts +10 -0
  83. package/dist/lib/gemini-mcp.d.ts.map +1 -0
  84. package/dist/lib/gemini-mcp.js +353 -0
  85. package/dist/lib/gemini-mcp.js.map +1 -0
  86. package/dist/lib/gpt-api.js +4 -4
  87. package/dist/lib/gpt-mcp.d.ts +10 -0
  88. package/dist/lib/gpt-mcp.d.ts.map +1 -0
  89. package/dist/lib/gpt-mcp.js +352 -0
  90. package/dist/lib/gpt-mcp.js.map +1 -0
  91. package/dist/lib/memory/KnowledgeGraph.js +4 -4
  92. package/dist/lib/memory/MemorySearch.js +43 -43
  93. package/dist/lib/memory/MemoryStorage.js +130 -130
  94. package/dist/lib/memory/ObservationStore.js +28 -28
  95. package/dist/lib/memory/SessionRAGRetriever.d.ts +66 -0
  96. package/dist/lib/memory/SessionRAGRetriever.d.ts.map +1 -0
  97. package/dist/lib/memory/SessionRAGRetriever.js +196 -0
  98. package/dist/lib/memory/SessionRAGRetriever.js.map +1 -0
  99. package/dist/lib/memory/SessionRAGRetriever.test.d.ts +2 -0
  100. package/dist/lib/memory/SessionRAGRetriever.test.d.ts.map +1 -0
  101. package/dist/lib/memory/SessionRAGRetriever.test.js +180 -0
  102. package/dist/lib/memory/SessionRAGRetriever.test.js.map +1 -0
  103. package/dist/lib/memory/SessionRAGStore.d.ts +153 -0
  104. package/dist/lib/memory/SessionRAGStore.d.ts.map +1 -0
  105. package/dist/lib/memory/SessionRAGStore.js +673 -0
  106. package/dist/lib/memory/SessionRAGStore.js.map +1 -0
  107. package/dist/lib/memory/SessionRAGStore.test.d.ts +2 -0
  108. package/dist/lib/memory/SessionRAGStore.test.d.ts.map +1 -0
  109. package/dist/lib/memory/SessionRAGStore.test.js +326 -0
  110. package/dist/lib/memory/SessionRAGStore.test.js.map +1 -0
  111. package/dist/lib/memory/SessionSummarizer.js +9 -9
  112. package/dist/orchestrator/AgentManager.js +12 -12
  113. package/dist/orchestrator/MultiLlmResearch.js +8 -8
  114. package/dist/orchestrator/SmartRouter.js +11 -11
  115. package/dist/orchestrator/SwarmOrchestrator.test.js +16 -16
  116. package/dist/orchestrator/parallelResearch.js +24 -24
  117. package/dist/tools/analytics/getUsageAnalytics.d.ts +10 -0
  118. package/dist/tools/analytics/getUsageAnalytics.d.ts.map +1 -0
  119. package/dist/tools/analytics/getUsageAnalytics.js +246 -0
  120. package/dist/tools/analytics/getUsageAnalytics.js.map +1 -0
  121. package/dist/tools/analytics/index.d.ts +5 -0
  122. package/dist/tools/analytics/index.d.ts.map +1 -0
  123. package/dist/tools/analytics/index.js +5 -0
  124. package/dist/tools/analytics/index.js.map +1 -0
  125. package/dist/tools/convention/analyzeComplexity.test.js +115 -115
  126. package/dist/tools/convention/getCodingGuide.d.ts +7 -0
  127. package/dist/tools/convention/getCodingGuide.d.ts.map +1 -0
  128. package/dist/tools/convention/getCodingGuide.js +69 -0
  129. package/dist/tools/convention/getCodingGuide.js.map +1 -0
  130. package/dist/tools/convention/validateCodeQuality.test.js +104 -104
  131. package/dist/tools/index.d.ts +5 -0
  132. package/dist/tools/index.d.ts.map +1 -1
  133. package/dist/tools/index.js +4 -0
  134. package/dist/tools/index.js.map +1 -1
  135. package/dist/tools/memory/index.d.ts +3 -0
  136. package/dist/tools/memory/index.d.ts.map +1 -1
  137. package/dist/tools/memory/index.js +4 -0
  138. package/dist/tools/memory/index.js.map +1 -1
  139. package/dist/tools/memory/manageGoals.d.ts +11 -0
  140. package/dist/tools/memory/manageGoals.d.ts.map +1 -0
  141. package/dist/tools/memory/manageGoals.js +152 -0
  142. package/dist/tools/memory/manageGoals.js.map +1 -0
  143. package/dist/tools/memory/retrieveSessionContext.d.ts +9 -0
  144. package/dist/tools/memory/retrieveSessionContext.d.ts.map +1 -0
  145. package/dist/tools/memory/retrieveSessionContext.js +140 -0
  146. package/dist/tools/memory/retrieveSessionContext.js.map +1 -0
  147. package/dist/tools/memory/saveSessionItem.d.ts +26 -0
  148. package/dist/tools/memory/saveSessionItem.d.ts.map +1 -0
  149. package/dist/tools/memory/saveSessionItem.js +218 -0
  150. package/dist/tools/memory/saveSessionItem.js.map +1 -0
  151. package/dist/tools/memory/startSession.d.ts.map +1 -1
  152. package/dist/tools/memory/startSession.js +29 -0
  153. package/dist/tools/memory/startSession.js.map +1 -1
  154. package/dist/tools/planning/analyzeRequirements.d.ts +9 -0
  155. package/dist/tools/planning/analyzeRequirements.d.ts.map +1 -0
  156. package/dist/tools/planning/analyzeRequirements.js +171 -0
  157. package/dist/tools/planning/analyzeRequirements.js.map +1 -0
  158. package/dist/tools/planning/createUserStories.d.ts +9 -0
  159. package/dist/tools/planning/createUserStories.d.ts.map +1 -0
  160. package/dist/tools/planning/createUserStories.js +124 -0
  161. package/dist/tools/planning/createUserStories.js.map +1 -0
  162. package/dist/tools/planning/featureRoadmap.d.ts +10 -0
  163. package/dist/tools/planning/featureRoadmap.d.ts.map +1 -0
  164. package/dist/tools/planning/featureRoadmap.js +207 -0
  165. package/dist/tools/planning/featureRoadmap.js.map +1 -0
  166. package/dist/tools/planning/generatePrd.d.ts +11 -0
  167. package/dist/tools/planning/generatePrd.d.ts.map +1 -0
  168. package/dist/tools/planning/generatePrd.js +161 -0
  169. package/dist/tools/planning/generatePrd.js.map +1 -0
  170. package/dist/tools/planning/index.d.ts +8 -0
  171. package/dist/tools/planning/index.d.ts.map +1 -0
  172. package/dist/tools/planning/index.js +8 -0
  173. package/dist/tools/planning/index.js.map +1 -0
  174. package/dist/tools/prompt/analyzePrompt.d.ts +7 -0
  175. package/dist/tools/prompt/analyzePrompt.d.ts.map +1 -0
  176. package/dist/tools/prompt/analyzePrompt.js +150 -0
  177. package/dist/tools/prompt/analyzePrompt.js.map +1 -0
  178. package/dist/tools/prompt/enhancePrompt.d.ts +8 -0
  179. package/dist/tools/prompt/enhancePrompt.d.ts.map +1 -0
  180. package/dist/tools/prompt/enhancePrompt.js +110 -0
  181. package/dist/tools/prompt/enhancePrompt.js.map +1 -0
  182. package/dist/tools/prompt/enhancePromptGemini.d.ts +8 -0
  183. package/dist/tools/prompt/enhancePromptGemini.d.ts.map +1 -0
  184. package/dist/tools/prompt/enhancePromptGemini.js +332 -0
  185. package/dist/tools/prompt/enhancePromptGemini.js.map +1 -0
  186. package/dist/tools/prompt/index.d.ts +7 -0
  187. package/dist/tools/prompt/index.d.ts.map +1 -0
  188. package/dist/tools/prompt/index.js +7 -0
  189. package/dist/tools/prompt/index.js.map +1 -0
  190. package/dist/tools/reasoning/applyReasoningFramework.d.ts +8 -0
  191. package/dist/tools/reasoning/applyReasoningFramework.d.ts.map +1 -0
  192. package/dist/tools/reasoning/applyReasoningFramework.js +266 -0
  193. package/dist/tools/reasoning/applyReasoningFramework.js.map +1 -0
  194. package/dist/tools/reasoning/index.d.ts +5 -0
  195. package/dist/tools/reasoning/index.d.ts.map +1 -0
  196. package/dist/tools/reasoning/index.js +5 -0
  197. package/dist/tools/reasoning/index.js.map +1 -0
  198. package/dist/tools/spec/prdParser.test.js +171 -171
  199. package/dist/tools/spec/specGenerator.js +169 -169
  200. package/dist/tools/spec/traceabilityMatrix.js +64 -64
  201. package/dist/tools/spec/traceabilityMatrix.test.js +28 -28
  202. package/dist/tools/thinking/analyzeProblem.d.ts +7 -0
  203. package/dist/tools/thinking/analyzeProblem.d.ts.map +1 -0
  204. package/dist/tools/thinking/analyzeProblem.js +55 -0
  205. package/dist/tools/thinking/analyzeProblem.js.map +1 -0
  206. package/dist/tools/thinking/breakDownProblem.d.ts +8 -0
  207. package/dist/tools/thinking/breakDownProblem.d.ts.map +1 -0
  208. package/dist/tools/thinking/breakDownProblem.js +145 -0
  209. package/dist/tools/thinking/breakDownProblem.js.map +1 -0
  210. package/dist/tools/thinking/createThinkingChain.d.ts +7 -0
  211. package/dist/tools/thinking/createThinkingChain.d.ts.map +1 -0
  212. package/dist/tools/thinking/createThinkingChain.js +44 -0
  213. package/dist/tools/thinking/createThinkingChain.js.map +1 -0
  214. package/dist/tools/thinking/formatAsPlan.d.ts +9 -0
  215. package/dist/tools/thinking/formatAsPlan.d.ts.map +1 -0
  216. package/dist/tools/thinking/formatAsPlan.js +78 -0
  217. package/dist/tools/thinking/formatAsPlan.js.map +1 -0
  218. package/dist/tools/thinking/index.d.ts +10 -0
  219. package/dist/tools/thinking/index.d.ts.map +1 -0
  220. package/dist/tools/thinking/index.js +10 -0
  221. package/dist/tools/thinking/index.js.map +1 -0
  222. package/dist/tools/thinking/stepByStepAnalysis.d.ts +8 -0
  223. package/dist/tools/thinking/stepByStepAnalysis.d.ts.map +1 -0
  224. package/dist/tools/thinking/stepByStepAnalysis.js +63 -0
  225. package/dist/tools/thinking/stepByStepAnalysis.js.map +1 -0
  226. package/dist/tools/thinking/thinkAloudProcess.d.ts +8 -0
  227. package/dist/tools/thinking/thinkAloudProcess.d.ts.map +1 -0
  228. package/dist/tools/thinking/thinkAloudProcess.js +80 -0
  229. package/dist/tools/thinking/thinkAloudProcess.js.map +1 -0
  230. package/hooks/hooks.json +115 -115
  231. package/hooks/scripts/code-check.js +70 -70
  232. package/hooks/scripts/code-review.js +22 -22
  233. package/hooks/scripts/complexity.js +22 -22
  234. package/hooks/scripts/compound.js +23 -23
  235. package/hooks/scripts/context-save.js +53 -53
  236. package/hooks/scripts/gemini-ui-gen.js +281 -281
  237. package/hooks/scripts/generate-brand-assets.js +474 -474
  238. package/hooks/scripts/hud-multiline.js +262 -262
  239. package/hooks/scripts/hud-status.js +291 -291
  240. package/hooks/scripts/keyword-detector.js +214 -214
  241. package/hooks/scripts/llm-orchestrate.js +171 -171
  242. package/hooks/scripts/post-edit.js +97 -97
  243. package/hooks/scripts/post-tool-verify.js +210 -210
  244. package/hooks/scripts/pre-tool-guard.js +125 -125
  245. package/hooks/scripts/prompt-dispatcher.js +161 -161
  246. package/hooks/scripts/recall.js +22 -22
  247. package/hooks/scripts/session-start.js +30 -30
  248. package/hooks/scripts/skill-injector.js +191 -191
  249. package/hooks/scripts/utils.js +97 -97
  250. package/languages/csharp-unity.md +515 -515
  251. package/languages/gdscript-godot.md +470 -470
  252. package/languages/ruby-rails.md +489 -489
  253. package/languages/typescript-angular.md +433 -433
  254. package/languages/typescript-astro.md +416 -416
  255. package/languages/typescript-electron.md +406 -406
  256. package/languages/typescript-nestjs.md +524 -524
  257. package/languages/typescript-svelte.md +407 -407
  258. package/languages/typescript-tauri.md +365 -365
  259. package/package.json +84 -84
  260. package/skills/brand-assets.md +141 -141
  261. package/skills/commerce-patterns.md +361 -361
  262. package/skills/context7-usage.md +102 -102
  263. package/skills/e2e-commerce.md +304 -304
  264. package/skills/frontend-design.md +92 -92
  265. package/skills/git-worktree.md +181 -181
  266. package/skills/parallel-research.md +77 -77
  267. package/skills/priority-todos.md +239 -239
  268. package/skills/seo-checklist.md +244 -244
  269. package/skills/tool-fallback.md +190 -190
  270. package/skills/vibe-capabilities.md +161 -161
  271. package/vibe/constitution.md +227 -227
  272. package/vibe/rules/core/communication-guide.md +98 -98
  273. package/vibe/rules/core/development-philosophy.md +52 -52
  274. package/vibe/rules/core/quick-start.md +102 -102
  275. package/vibe/rules/quality/bdd-contract-testing.md +393 -393
  276. package/vibe/rules/quality/checklist.md +276 -276
  277. package/vibe/rules/quality/testing-strategy.md +440 -440
  278. package/vibe/rules/standards/anti-patterns.md +541 -541
  279. package/vibe/rules/standards/code-structure.md +291 -291
  280. package/vibe/rules/standards/complexity-metrics.md +313 -313
  281. package/vibe/rules/standards/naming-conventions.md +198 -198
  282. package/vibe/setup.sh +31 -31
  283. package/vibe/templates/constitution-template.md +252 -252
  284. package/vibe/templates/contract-backend-template.md +526 -526
  285. package/vibe/templates/contract-frontend-template.md +599 -599
  286. package/vibe/templates/feature-template.md +96 -96
  287. package/vibe/templates/spec-template.md +221 -221
@@ -1,92 +1,92 @@
1
- ---
2
- name: frontend-design
3
- description: "Production-grade frontend with bold aesthetic direction for UI-focused projects"
4
- triggers: [frontend, ui design, aesthetic, beautiful ui, design system, ui quality, visual design]
5
- priority: 70
6
- ---
7
- # Frontend Design Skill
8
-
9
- Create production-grade frontend with bold aesthetic direction.
10
-
11
- ## When to Use
12
-
13
- - UI-focused projects requiring high visual quality
14
- - Design system implementation
15
- - User-facing features where aesthetics matter
16
-
17
- ## Core Principles
18
-
19
- ### 1. Typography
20
- - Choose distinctive typefaces that set the tone
21
- - Establish clear hierarchy through size, weight, and spacing
22
- - Consider custom fonts that reflect brand personality
23
-
24
- ### 2. Color & Theme
25
- - Develop unique color palettes beyond defaults
26
- - Consider dark/light mode with intentional contrast
27
- - Use color purposefully for hierarchy and emphasis
28
-
29
- ### 3. Motion & Animation
30
- - Add meaningful micro-interactions
31
- - Use motion to guide user attention
32
- - Implement smooth transitions between states
33
-
34
- ### 4. Composition & Layout
35
- - Create visual rhythm through spacing
36
- - Use asymmetry and unconventional layouts when appropriate
37
- - Balance density with breathing room
38
-
39
- ### 5. Visual Details
40
- - Custom icons and illustrations
41
- - Thoughtful shadows and depth
42
- - Refined borders, corners, and surfaces
43
-
44
- ## Anti-Patterns to Avoid
45
-
46
- - Generic Bootstrap/Tailwind defaults without customization
47
- - Overused fonts (Inter, Roboto without styling)
48
- - Predictable card-based layouts everywhere
49
- - Stock photography without curation
50
- - Safe, corporate color palettes
51
-
52
- ## Implementation Guidelines
53
-
54
- ```typescript
55
- // Design token structure
56
- const tokens = {
57
- colors: {
58
- primary: { /* custom palette */ },
59
- semantic: { /* success, error, warning */ },
60
- },
61
- typography: {
62
- fontFamily: { /* display, body, mono */ },
63
- scale: { /* modular scale */ },
64
- },
65
- spacing: { /* consistent rhythm */ },
66
- motion: { /* duration, easing */ },
67
- };
68
- ```
69
-
70
- ## Quality Checklist
71
-
72
- - [ ] Typography creates clear hierarchy
73
- - [ ] Color palette is distinctive and accessible
74
- - [ ] Animations are smooth (60fps)
75
- - [ ] Layout works across breakpoints
76
- - [ ] Empty/loading/error states are designed
77
- - [ ] Dark mode (if applicable) is intentional
78
- - [ ] Micro-interactions provide feedback
79
-
80
- ## Integration with Vibe
81
-
82
- Use with `/vibe.utils --ui` for preview:
83
-
84
- ```bash
85
- /vibe.utils --ui "login form with bold typography and custom color scheme"
86
- ```
87
-
88
- ## Resources
89
-
90
- - [Refactoring UI](https://www.refactoringui.com/) - Design principles
91
- - [Motion Design](https://motion.dev/) - Animation library
92
- - [Radix Primitives](https://www.radix-ui.com/) - Accessible components
1
+ ---
2
+ name: frontend-design
3
+ description: "Production-grade frontend with bold aesthetic direction for UI-focused projects"
4
+ triggers: [frontend, ui design, aesthetic, beautiful ui, design system, ui quality, visual design]
5
+ priority: 70
6
+ ---
7
+ # Frontend Design Skill
8
+
9
+ Create production-grade frontend with bold aesthetic direction.
10
+
11
+ ## When to Use
12
+
13
+ - UI-focused projects requiring high visual quality
14
+ - Design system implementation
15
+ - User-facing features where aesthetics matter
16
+
17
+ ## Core Principles
18
+
19
+ ### 1. Typography
20
+ - Choose distinctive typefaces that set the tone
21
+ - Establish clear hierarchy through size, weight, and spacing
22
+ - Consider custom fonts that reflect brand personality
23
+
24
+ ### 2. Color & Theme
25
+ - Develop unique color palettes beyond defaults
26
+ - Consider dark/light mode with intentional contrast
27
+ - Use color purposefully for hierarchy and emphasis
28
+
29
+ ### 3. Motion & Animation
30
+ - Add meaningful micro-interactions
31
+ - Use motion to guide user attention
32
+ - Implement smooth transitions between states
33
+
34
+ ### 4. Composition & Layout
35
+ - Create visual rhythm through spacing
36
+ - Use asymmetry and unconventional layouts when appropriate
37
+ - Balance density with breathing room
38
+
39
+ ### 5. Visual Details
40
+ - Custom icons and illustrations
41
+ - Thoughtful shadows and depth
42
+ - Refined borders, corners, and surfaces
43
+
44
+ ## Anti-Patterns to Avoid
45
+
46
+ - Generic Bootstrap/Tailwind defaults without customization
47
+ - Overused fonts (Inter, Roboto without styling)
48
+ - Predictable card-based layouts everywhere
49
+ - Stock photography without curation
50
+ - Safe, corporate color palettes
51
+
52
+ ## Implementation Guidelines
53
+
54
+ ```typescript
55
+ // Design token structure
56
+ const tokens = {
57
+ colors: {
58
+ primary: { /* custom palette */ },
59
+ semantic: { /* success, error, warning */ },
60
+ },
61
+ typography: {
62
+ fontFamily: { /* display, body, mono */ },
63
+ scale: { /* modular scale */ },
64
+ },
65
+ spacing: { /* consistent rhythm */ },
66
+ motion: { /* duration, easing */ },
67
+ };
68
+ ```
69
+
70
+ ## Quality Checklist
71
+
72
+ - [ ] Typography creates clear hierarchy
73
+ - [ ] Color palette is distinctive and accessible
74
+ - [ ] Animations are smooth (60fps)
75
+ - [ ] Layout works across breakpoints
76
+ - [ ] Empty/loading/error states are designed
77
+ - [ ] Dark mode (if applicable) is intentional
78
+ - [ ] Micro-interactions provide feedback
79
+
80
+ ## Integration with Vibe
81
+
82
+ Use with `/vibe.utils --ui` for preview:
83
+
84
+ ```bash
85
+ /vibe.utils --ui "login form with bold typography and custom color scheme"
86
+ ```
87
+
88
+ ## Resources
89
+
90
+ - [Refactoring UI](https://www.refactoringui.com/) - Design principles
91
+ - [Motion Design](https://motion.dev/) - Animation library
92
+ - [Radix Primitives](https://www.radix-ui.com/) - Accessible components
@@ -1,181 +1,181 @@
1
- ---
2
- description: Git Worktree for parallel branch work. Auto-activates for PR review, hotfix, parallel testing, or working on multiple branches simultaneously.
3
- ---
4
- # Git Worktree Skill
5
-
6
- Parallel branch work using Git Worktree
7
-
8
- ## Overview
9
-
10
- Perform reviews/tests on other branches without interrupting main work
11
-
12
- ## Usage
13
-
14
- ```bash
15
- # Create worktree
16
- git worktree add ../review-pr123 pr/123
17
-
18
- # Work in that directory
19
- cd ../review-pr123
20
- npm test
21
-
22
- # Clean up after work is done
23
- git worktree remove ../review-pr123
24
- ```
25
-
26
- ## Commands
27
-
28
- ### Create Worktree
29
-
30
- ```bash
31
- # Worktree for PR review
32
- git worktree add ../review-{pr_number} origin/pr/{pr_number}
33
-
34
- # Worktree for specific branch
35
- git worktree add ../feature-work feature/new-feature
36
-
37
- # Worktree with new branch
38
- git worktree add -b hotfix/urgent ../hotfix main
39
- ```
40
-
41
- ### List Worktrees
42
-
43
- ```bash
44
- git worktree list
45
- # /path/to/main abc1234 [main]
46
- # /path/to/review-123 def5678 [pr/123]
47
- ```
48
-
49
- ### Remove Worktree
50
-
51
- ```bash
52
- # Normal removal
53
- git worktree remove ../review-123
54
-
55
- # Force removal (ignore uncommitted changes)
56
- git worktree remove --force ../review-123
57
-
58
- # Prune stale worktrees
59
- git worktree prune
60
- ```
61
-
62
- ## Workflow Integration
63
-
64
- ### PR Review Workflow
65
-
66
- ```
67
- ┌─────────────────────────────────────────────────────────────────┐
68
- │ /vibe.review PR#123 │
69
- ├─────────────────────────────────────────────────────────────────┤
70
- │ │
71
- │ 1. git worktree add ../review-123 origin/pr/123 │
72
- │ 2. cd ../review-123 │
73
- │ 3. npm install && npm test │
74
- │ 4. Run parallel review agents │
75
- │ 5. Generate review report │
76
- │ 6. cd - && git worktree remove ../review-123 │
77
- │ │
78
- └─────────────────────────────────────────────────────────────────┘
79
- ```
80
-
81
- ### Hotfix Workflow
82
-
83
- ```
84
- ┌─────────────────────────────────────────────────────────────────┐
85
- │ Urgent hotfix while working on feature │
86
- ├─────────────────────────────────────────────────────────────────┤
87
- │ │
88
- │ # Keep feature work intact │
89
- │ git worktree add -b hotfix/critical ../hotfix main │
90
- │ cd ../hotfix │
91
- │ │
92
- │ # Fix and deploy │
93
- │ vim src/bug.py │
94
- │ git commit -am "fix: critical bug" │
95
- │ git push origin hotfix/critical │
96
- │ │
97
- │ # Return to feature │
98
- │ cd - && git worktree remove ../hotfix │
99
- │ │
100
- └─────────────────────────────────────────────────────────────────┘
101
- ```
102
-
103
- ## Benefits
104
-
105
- 1. **No Stash Needed**: Keep current work intact
106
- 2. **Full Codebase**: Each worktree is a complete codebase
107
- 3. **Parallel Work**: Work on multiple branches simultaneously
108
- 4. **Clean Testing**: Test in isolated environment
109
-
110
- ## Best Practices
111
-
112
- ### Naming Convention
113
-
114
- ```bash
115
- # PR review
116
- ../review-{pr_number}
117
-
118
- # Hotfix
119
- ../hotfix-{issue_number}
120
-
121
- # Experiment
122
- ../experiment-{feature_name}
123
- ```
124
-
125
- ### Cleanup
126
-
127
- ```bash
128
- # Regular cleanup
129
- git worktree prune
130
-
131
- # Check all worktrees
132
- git worktree list
133
-
134
- # Auto cleanup with script
135
- for wt in $(git worktree list --porcelain | grep worktree | cut -d' ' -f2); do
136
- if [[ $wt == *"review-"* ]] || [[ $wt == *"hotfix-"* ]]; then
137
- git worktree remove "$wt" 2>/dev/null || true
138
- fi
139
- done
140
- ```
141
-
142
- ### Integration with CI/CD
143
-
144
- ```yaml
145
- # GitHub Actions example
146
- - name: Setup Review Worktree
147
- run: |
148
- git fetch origin pull/${{ github.event.pull_request.number }}/head:pr-${{ github.event.pull_request.number }}
149
- git worktree add ../review pr-${{ github.event.pull_request.number }}
150
-
151
- - name: Run Tests in Worktree
152
- working-directory: ../review
153
- run: npm test
154
-
155
- - name: Cleanup
156
- run: git worktree remove ../review
157
- ```
158
-
159
- ## Troubleshooting
160
-
161
- ### "already checked out" Error
162
-
163
- ```bash
164
- # Solution: Branch is already in another worktree
165
- git worktree list # Check
166
- git worktree remove <path> # Remove
167
- ```
168
-
169
- ### Locked Worktree
170
-
171
- ```bash
172
- # Solution: Unlock the locked worktree
173
- git worktree unlock <path>
174
- ```
175
-
176
- ### Stale Worktree
177
-
178
- ```bash
179
- # Solution: Clean up deleted directories
180
- git worktree prune
181
- ```
1
+ ---
2
+ description: Git Worktree for parallel branch work. Auto-activates for PR review, hotfix, parallel testing, or working on multiple branches simultaneously.
3
+ ---
4
+ # Git Worktree Skill
5
+
6
+ Parallel branch work using Git Worktree
7
+
8
+ ## Overview
9
+
10
+ Perform reviews/tests on other branches without interrupting main work
11
+
12
+ ## Usage
13
+
14
+ ```bash
15
+ # Create worktree
16
+ git worktree add ../review-pr123 pr/123
17
+
18
+ # Work in that directory
19
+ cd ../review-pr123
20
+ npm test
21
+
22
+ # Clean up after work is done
23
+ git worktree remove ../review-pr123
24
+ ```
25
+
26
+ ## Commands
27
+
28
+ ### Create Worktree
29
+
30
+ ```bash
31
+ # Worktree for PR review
32
+ git worktree add ../review-{pr_number} origin/pr/{pr_number}
33
+
34
+ # Worktree for specific branch
35
+ git worktree add ../feature-work feature/new-feature
36
+
37
+ # Worktree with new branch
38
+ git worktree add -b hotfix/urgent ../hotfix main
39
+ ```
40
+
41
+ ### List Worktrees
42
+
43
+ ```bash
44
+ git worktree list
45
+ # /path/to/main abc1234 [main]
46
+ # /path/to/review-123 def5678 [pr/123]
47
+ ```
48
+
49
+ ### Remove Worktree
50
+
51
+ ```bash
52
+ # Normal removal
53
+ git worktree remove ../review-123
54
+
55
+ # Force removal (ignore uncommitted changes)
56
+ git worktree remove --force ../review-123
57
+
58
+ # Prune stale worktrees
59
+ git worktree prune
60
+ ```
61
+
62
+ ## Workflow Integration
63
+
64
+ ### PR Review Workflow
65
+
66
+ ```
67
+ ┌─────────────────────────────────────────────────────────────────┐
68
+ │ /vibe.review PR#123 │
69
+ ├─────────────────────────────────────────────────────────────────┤
70
+ │ │
71
+ │ 1. git worktree add ../review-123 origin/pr/123 │
72
+ │ 2. cd ../review-123 │
73
+ │ 3. npm install && npm test │
74
+ │ 4. Run parallel review agents │
75
+ │ 5. Generate review report │
76
+ │ 6. cd - && git worktree remove ../review-123 │
77
+ │ │
78
+ └─────────────────────────────────────────────────────────────────┘
79
+ ```
80
+
81
+ ### Hotfix Workflow
82
+
83
+ ```
84
+ ┌─────────────────────────────────────────────────────────────────┐
85
+ │ Urgent hotfix while working on feature │
86
+ ├─────────────────────────────────────────────────────────────────┤
87
+ │ │
88
+ │ # Keep feature work intact │
89
+ │ git worktree add -b hotfix/critical ../hotfix main │
90
+ │ cd ../hotfix │
91
+ │ │
92
+ │ # Fix and deploy │
93
+ │ vim src/bug.py │
94
+ │ git commit -am "fix: critical bug" │
95
+ │ git push origin hotfix/critical │
96
+ │ │
97
+ │ # Return to feature │
98
+ │ cd - && git worktree remove ../hotfix │
99
+ │ │
100
+ └─────────────────────────────────────────────────────────────────┘
101
+ ```
102
+
103
+ ## Benefits
104
+
105
+ 1. **No Stash Needed**: Keep current work intact
106
+ 2. **Full Codebase**: Each worktree is a complete codebase
107
+ 3. **Parallel Work**: Work on multiple branches simultaneously
108
+ 4. **Clean Testing**: Test in isolated environment
109
+
110
+ ## Best Practices
111
+
112
+ ### Naming Convention
113
+
114
+ ```bash
115
+ # PR review
116
+ ../review-{pr_number}
117
+
118
+ # Hotfix
119
+ ../hotfix-{issue_number}
120
+
121
+ # Experiment
122
+ ../experiment-{feature_name}
123
+ ```
124
+
125
+ ### Cleanup
126
+
127
+ ```bash
128
+ # Regular cleanup
129
+ git worktree prune
130
+
131
+ # Check all worktrees
132
+ git worktree list
133
+
134
+ # Auto cleanup with script
135
+ for wt in $(git worktree list --porcelain | grep worktree | cut -d' ' -f2); do
136
+ if [[ $wt == *"review-"* ]] || [[ $wt == *"hotfix-"* ]]; then
137
+ git worktree remove "$wt" 2>/dev/null || true
138
+ fi
139
+ done
140
+ ```
141
+
142
+ ### Integration with CI/CD
143
+
144
+ ```yaml
145
+ # GitHub Actions example
146
+ - name: Setup Review Worktree
147
+ run: |
148
+ git fetch origin pull/${{ github.event.pull_request.number }}/head:pr-${{ github.event.pull_request.number }}
149
+ git worktree add ../review pr-${{ github.event.pull_request.number }}
150
+
151
+ - name: Run Tests in Worktree
152
+ working-directory: ../review
153
+ run: npm test
154
+
155
+ - name: Cleanup
156
+ run: git worktree remove ../review
157
+ ```
158
+
159
+ ## Troubleshooting
160
+
161
+ ### "already checked out" Error
162
+
163
+ ```bash
164
+ # Solution: Branch is already in another worktree
165
+ git worktree list # Check
166
+ git worktree remove <path> # Remove
167
+ ```
168
+
169
+ ### Locked Worktree
170
+
171
+ ```bash
172
+ # Solution: Unlock the locked worktree
173
+ git worktree unlock <path>
174
+ ```
175
+
176
+ ### Stale Worktree
177
+
178
+ ```bash
179
+ # Solution: Clean up deleted directories
180
+ git worktree prune
181
+ ```