@su-record/vibe 2.6.14 → 2.6.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (233) hide show
  1. package/CLAUDE.md +1 -394
  2. package/LICENSE +21 -21
  3. package/README.md +203 -497
  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 -199
  19. package/agents/research/codebase-patterns-agent.md +157 -157
  20. package/agents/research/framework-docs-agent.md +188 -188
  21. package/agents/research/security-advisory-agent.md +213 -213
  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 +268 -268
  38. package/commands/vibe.analyze.md +356 -356
  39. package/commands/vibe.reason.md +329 -329
  40. package/commands/vibe.review.md +412 -412
  41. package/commands/vibe.run.md +1266 -1266
  42. package/commands/vibe.spec.md +1054 -1054
  43. package/commands/vibe.spec.review.md +319 -319
  44. package/commands/vibe.trace.md +161 -161
  45. package/commands/vibe.utils.md +376 -376
  46. package/commands/vibe.verify.md +375 -375
  47. package/dist/cli/collaborator.js +52 -52
  48. package/dist/cli/detect.js +32 -32
  49. package/dist/cli/hud.js +20 -20
  50. package/dist/cli/index.js +118 -118
  51. package/dist/cli/index.js.map +1 -1
  52. package/dist/cli/llm.js +144 -144
  53. package/dist/cli/mcp.d.ts +49 -0
  54. package/dist/cli/mcp.d.ts.map +1 -0
  55. package/dist/cli/mcp.js +169 -0
  56. package/dist/cli/mcp.js.map +1 -0
  57. package/dist/cli/postinstall.js +858 -858
  58. package/dist/cli/setup/ProjectSetup.d.ts +3 -3
  59. package/dist/cli/setup/ProjectSetup.d.ts.map +1 -1
  60. package/dist/cli/setup/ProjectSetup.js +76 -30
  61. package/dist/cli/setup/ProjectSetup.js.map +1 -1
  62. package/dist/lib/DeepInit.js +24 -24
  63. package/dist/lib/IterationTracker.js +11 -11
  64. package/dist/lib/PythonParser.js +108 -108
  65. package/dist/lib/ReviewRace.js +96 -96
  66. package/dist/lib/SkillFrontmatter.js +28 -28
  67. package/dist/lib/SkillQualityGate.js +9 -9
  68. package/dist/lib/SkillRepository.js +159 -159
  69. package/dist/lib/UltraQA.js +77 -77
  70. package/dist/lib/gemini-api.js +5 -5
  71. package/dist/lib/gemini-mcp.d.ts +10 -0
  72. package/dist/lib/gemini-mcp.d.ts.map +1 -0
  73. package/dist/lib/gemini-mcp.js +353 -0
  74. package/dist/lib/gemini-mcp.js.map +1 -0
  75. package/dist/lib/gpt-api.js +4 -4
  76. package/dist/lib/gpt-mcp.d.ts +10 -0
  77. package/dist/lib/gpt-mcp.d.ts.map +1 -0
  78. package/dist/lib/gpt-mcp.js +352 -0
  79. package/dist/lib/gpt-mcp.js.map +1 -0
  80. package/dist/lib/memory/KnowledgeGraph.js +4 -4
  81. package/dist/lib/memory/MemorySearch.js +20 -20
  82. package/dist/lib/memory/MemoryStorage.js +64 -64
  83. package/dist/orchestrator/AgentManager.js +12 -12
  84. package/dist/orchestrator/MultiLlmResearch.js +8 -8
  85. package/dist/orchestrator/SmartRouter.js +11 -11
  86. package/dist/orchestrator/parallelResearch.js +24 -24
  87. package/dist/tools/analytics/getUsageAnalytics.d.ts +10 -0
  88. package/dist/tools/analytics/getUsageAnalytics.d.ts.map +1 -0
  89. package/dist/tools/analytics/getUsageAnalytics.js +246 -0
  90. package/dist/tools/analytics/getUsageAnalytics.js.map +1 -0
  91. package/dist/tools/analytics/index.d.ts +5 -0
  92. package/dist/tools/analytics/index.d.ts.map +1 -0
  93. package/dist/tools/analytics/index.js +5 -0
  94. package/dist/tools/analytics/index.js.map +1 -0
  95. package/dist/tools/convention/analyzeComplexity.test.js +115 -115
  96. package/dist/tools/convention/getCodingGuide.d.ts +7 -0
  97. package/dist/tools/convention/getCodingGuide.d.ts.map +1 -0
  98. package/dist/tools/convention/getCodingGuide.js +69 -0
  99. package/dist/tools/convention/getCodingGuide.js.map +1 -0
  100. package/dist/tools/convention/validateCodeQuality.test.js +104 -104
  101. package/dist/tools/planning/analyzeRequirements.d.ts +9 -0
  102. package/dist/tools/planning/analyzeRequirements.d.ts.map +1 -0
  103. package/dist/tools/planning/analyzeRequirements.js +171 -0
  104. package/dist/tools/planning/analyzeRequirements.js.map +1 -0
  105. package/dist/tools/planning/createUserStories.d.ts +9 -0
  106. package/dist/tools/planning/createUserStories.d.ts.map +1 -0
  107. package/dist/tools/planning/createUserStories.js +124 -0
  108. package/dist/tools/planning/createUserStories.js.map +1 -0
  109. package/dist/tools/planning/featureRoadmap.d.ts +10 -0
  110. package/dist/tools/planning/featureRoadmap.d.ts.map +1 -0
  111. package/dist/tools/planning/featureRoadmap.js +207 -0
  112. package/dist/tools/planning/featureRoadmap.js.map +1 -0
  113. package/dist/tools/planning/generatePrd.d.ts +11 -0
  114. package/dist/tools/planning/generatePrd.d.ts.map +1 -0
  115. package/dist/tools/planning/generatePrd.js +161 -0
  116. package/dist/tools/planning/generatePrd.js.map +1 -0
  117. package/dist/tools/planning/index.d.ts +8 -0
  118. package/dist/tools/planning/index.d.ts.map +1 -0
  119. package/dist/tools/planning/index.js +8 -0
  120. package/dist/tools/planning/index.js.map +1 -0
  121. package/dist/tools/prompt/analyzePrompt.d.ts +7 -0
  122. package/dist/tools/prompt/analyzePrompt.d.ts.map +1 -0
  123. package/dist/tools/prompt/analyzePrompt.js +150 -0
  124. package/dist/tools/prompt/analyzePrompt.js.map +1 -0
  125. package/dist/tools/prompt/enhancePrompt.d.ts +8 -0
  126. package/dist/tools/prompt/enhancePrompt.d.ts.map +1 -0
  127. package/dist/tools/prompt/enhancePrompt.js +110 -0
  128. package/dist/tools/prompt/enhancePrompt.js.map +1 -0
  129. package/dist/tools/prompt/enhancePromptGemini.d.ts +8 -0
  130. package/dist/tools/prompt/enhancePromptGemini.d.ts.map +1 -0
  131. package/dist/tools/prompt/enhancePromptGemini.js +332 -0
  132. package/dist/tools/prompt/enhancePromptGemini.js.map +1 -0
  133. package/dist/tools/prompt/index.d.ts +7 -0
  134. package/dist/tools/prompt/index.d.ts.map +1 -0
  135. package/dist/tools/prompt/index.js +7 -0
  136. package/dist/tools/prompt/index.js.map +1 -0
  137. package/dist/tools/reasoning/applyReasoningFramework.d.ts +8 -0
  138. package/dist/tools/reasoning/applyReasoningFramework.d.ts.map +1 -0
  139. package/dist/tools/reasoning/applyReasoningFramework.js +266 -0
  140. package/dist/tools/reasoning/applyReasoningFramework.js.map +1 -0
  141. package/dist/tools/reasoning/index.d.ts +5 -0
  142. package/dist/tools/reasoning/index.d.ts.map +1 -0
  143. package/dist/tools/reasoning/index.js +5 -0
  144. package/dist/tools/reasoning/index.js.map +1 -0
  145. package/dist/tools/spec/prdParser.test.js +171 -171
  146. package/dist/tools/spec/specGenerator.js +169 -169
  147. package/dist/tools/spec/traceabilityMatrix.js +64 -64
  148. package/dist/tools/spec/traceabilityMatrix.test.js +28 -28
  149. package/dist/tools/thinking/analyzeProblem.d.ts +7 -0
  150. package/dist/tools/thinking/analyzeProblem.d.ts.map +1 -0
  151. package/dist/tools/thinking/analyzeProblem.js +55 -0
  152. package/dist/tools/thinking/analyzeProblem.js.map +1 -0
  153. package/dist/tools/thinking/breakDownProblem.d.ts +8 -0
  154. package/dist/tools/thinking/breakDownProblem.d.ts.map +1 -0
  155. package/dist/tools/thinking/breakDownProblem.js +145 -0
  156. package/dist/tools/thinking/breakDownProblem.js.map +1 -0
  157. package/dist/tools/thinking/createThinkingChain.d.ts +7 -0
  158. package/dist/tools/thinking/createThinkingChain.d.ts.map +1 -0
  159. package/dist/tools/thinking/createThinkingChain.js +44 -0
  160. package/dist/tools/thinking/createThinkingChain.js.map +1 -0
  161. package/dist/tools/thinking/formatAsPlan.d.ts +9 -0
  162. package/dist/tools/thinking/formatAsPlan.d.ts.map +1 -0
  163. package/dist/tools/thinking/formatAsPlan.js +78 -0
  164. package/dist/tools/thinking/formatAsPlan.js.map +1 -0
  165. package/dist/tools/thinking/index.d.ts +10 -0
  166. package/dist/tools/thinking/index.d.ts.map +1 -0
  167. package/dist/tools/thinking/index.js +10 -0
  168. package/dist/tools/thinking/index.js.map +1 -0
  169. package/dist/tools/thinking/stepByStepAnalysis.d.ts +8 -0
  170. package/dist/tools/thinking/stepByStepAnalysis.d.ts.map +1 -0
  171. package/dist/tools/thinking/stepByStepAnalysis.js +63 -0
  172. package/dist/tools/thinking/stepByStepAnalysis.js.map +1 -0
  173. package/dist/tools/thinking/thinkAloudProcess.d.ts +8 -0
  174. package/dist/tools/thinking/thinkAloudProcess.d.ts.map +1 -0
  175. package/dist/tools/thinking/thinkAloudProcess.js +80 -0
  176. package/dist/tools/thinking/thinkAloudProcess.js.map +1 -0
  177. package/hooks/hooks.json +222 -222
  178. package/hooks/scripts/code-check.js +22 -22
  179. package/hooks/scripts/code-review.js +22 -22
  180. package/hooks/scripts/complexity.js +22 -22
  181. package/hooks/scripts/compound.js +23 -23
  182. package/hooks/scripts/context-save.js +33 -33
  183. package/hooks/scripts/gemini-ui-gen.js +281 -281
  184. package/hooks/scripts/generate-brand-assets.js +474 -474
  185. package/hooks/scripts/hud-multiline.js +262 -262
  186. package/hooks/scripts/hud-status.js +291 -291
  187. package/hooks/scripts/keyword-detector.js +214 -214
  188. package/hooks/scripts/llm-orchestrate.js +171 -171
  189. package/hooks/scripts/post-edit.js +97 -97
  190. package/hooks/scripts/post-tool-verify.js +210 -210
  191. package/hooks/scripts/pre-tool-guard.js +125 -125
  192. package/hooks/scripts/recall.js +22 -22
  193. package/hooks/scripts/session-start.js +30 -30
  194. package/hooks/scripts/skill-injector.js +191 -191
  195. package/hooks/scripts/utils.js +97 -97
  196. package/languages/csharp-unity.md +515 -515
  197. package/languages/gdscript-godot.md +470 -470
  198. package/languages/ruby-rails.md +489 -489
  199. package/languages/typescript-angular.md +433 -433
  200. package/languages/typescript-astro.md +416 -416
  201. package/languages/typescript-electron.md +406 -406
  202. package/languages/typescript-nestjs.md +524 -524
  203. package/languages/typescript-svelte.md +407 -407
  204. package/languages/typescript-tauri.md +365 -365
  205. package/package.json +84 -84
  206. package/skills/brand-assets.md +141 -141
  207. package/skills/commerce-patterns.md +361 -361
  208. package/skills/context7-usage.md +102 -102
  209. package/skills/e2e-commerce.md +304 -304
  210. package/skills/frontend-design.md +92 -92
  211. package/skills/git-worktree.md +181 -181
  212. package/skills/parallel-research.md +77 -77
  213. package/skills/priority-todos.md +239 -239
  214. package/skills/seo-checklist.md +244 -244
  215. package/skills/tool-fallback.md +190 -190
  216. package/skills/vibe-capabilities.md +161 -161
  217. package/vibe/constitution.md +227 -227
  218. package/vibe/rules/core/communication-guide.md +98 -98
  219. package/vibe/rules/core/development-philosophy.md +52 -52
  220. package/vibe/rules/core/quick-start.md +102 -102
  221. package/vibe/rules/quality/bdd-contract-testing.md +393 -393
  222. package/vibe/rules/quality/checklist.md +276 -276
  223. package/vibe/rules/quality/testing-strategy.md +440 -440
  224. package/vibe/rules/standards/anti-patterns.md +541 -541
  225. package/vibe/rules/standards/code-structure.md +291 -291
  226. package/vibe/rules/standards/complexity-metrics.md +313 -313
  227. package/vibe/rules/standards/naming-conventions.md +198 -198
  228. package/vibe/setup.sh +31 -31
  229. package/vibe/templates/constitution-template.md +252 -252
  230. package/vibe/templates/contract-backend-template.md +526 -526
  231. package/vibe/templates/contract-frontend-template.md +599 -599
  232. package/vibe/templates/feature-template.md +96 -96
  233. 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
+ ```