@su-record/vibe 2.5.15 → 2.5.18

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