@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
package/package.json CHANGED
@@ -1,84 +1,84 @@
1
- {
2
- "name": "@su-record/vibe",
3
- "version": "2.6.14",
4
- "description": "Vibe - Claude Code exclusive SPEC-driven AI coding framework with 35+ integrated tools",
5
- "type": "module",
6
- "main": "dist/cli/index.js",
7
- "exports": {
8
- ".": "./dist/cli/index.js",
9
- "./tools": "./dist/tools/index.js",
10
- "./tools/memory": "./dist/tools/memory/index.js",
11
- "./tools/convention": "./dist/tools/convention/index.js",
12
- "./tools/semantic": "./dist/tools/semantic/index.js",
13
- "./tools/ui": "./dist/tools/ui/index.js",
14
- "./tools/time": "./dist/tools/time/index.js",
15
- "./tools/interaction": "./dist/tools/interaction/index.js",
16
- "./orchestrator": "./dist/orchestrator/index.js",
17
- "./lib/gpt": "./dist/lib/gpt-api.js",
18
- "./lib/gemini": "./dist/lib/gemini-api.js"
19
- },
20
- "bin": {
21
- "vibe": "./dist/cli/index.js"
22
- },
23
- "scripts": {
24
- "build": "tsc",
25
- "dev": "tsc --watch",
26
- "test": "vitest run",
27
- "test:watch": "vitest",
28
- "prepublishOnly": "npm run build",
29
- "postinstall": "node dist/cli/postinstall.js"
30
- },
31
- "keywords": [
32
- "ai",
33
- "vibe",
34
- "coding",
35
- "spec-driven",
36
- "claude",
37
- "mcp",
38
- "framework",
39
- "requirements",
40
- "user-story",
41
- "ultrawork",
42
- "parallel-agents",
43
- "memory-management",
44
- "knowledge-graph",
45
- "code-analysis",
46
- "code-quality"
47
- ],
48
- "author": "Su",
49
- "license": "MIT",
50
- "repository": {
51
- "type": "git",
52
- "url": "https://github.com/su-record/vibe.git"
53
- },
54
- "homepage": "https://github.com/su-record/vibe#readme",
55
- "engines": {
56
- "node": ">=18.0.0"
57
- },
58
- "dependencies": {
59
- "@anthropic-ai/claude-agent-sdk": "^0.2.6",
60
- "better-sqlite3": "^12.4.1",
61
- "chalk": "^5.3.0",
62
- "glob": "^11.0.3",
63
- "ts-morph": "^26.0.0"
64
- },
65
- "devDependencies": {
66
- "@types/better-sqlite3": "^7.6.13",
67
- "@types/glob": "^8.1.0",
68
- "@types/node": "^22.0.0",
69
- "typescript": "^5.5.4",
70
- "vitest": "^4.0.9"
71
- },
72
- "files": [
73
- "dist/",
74
- "vibe/",
75
- "languages/",
76
- "commands/",
77
- "agents/",
78
- "skills/",
79
- "hooks/",
80
- "CLAUDE.md",
81
- "README.md",
82
- "LICENSE"
83
- ]
84
- }
1
+ {
2
+ "name": "@su-record/vibe",
3
+ "version": "2.6.16",
4
+ "description": "Vibe - Claude Code exclusive SPEC-driven AI coding framework with 35+ integrated tools",
5
+ "type": "module",
6
+ "main": "dist/cli/index.js",
7
+ "exports": {
8
+ ".": "./dist/cli/index.js",
9
+ "./tools": "./dist/tools/index.js",
10
+ "./tools/memory": "./dist/tools/memory/index.js",
11
+ "./tools/convention": "./dist/tools/convention/index.js",
12
+ "./tools/semantic": "./dist/tools/semantic/index.js",
13
+ "./tools/ui": "./dist/tools/ui/index.js",
14
+ "./tools/time": "./dist/tools/time/index.js",
15
+ "./tools/interaction": "./dist/tools/interaction/index.js",
16
+ "./orchestrator": "./dist/orchestrator/index.js",
17
+ "./lib/gpt": "./dist/lib/gpt-api.js",
18
+ "./lib/gemini": "./dist/lib/gemini-api.js"
19
+ },
20
+ "bin": {
21
+ "vibe": "./dist/cli/index.js"
22
+ },
23
+ "scripts": {
24
+ "build": "tsc",
25
+ "dev": "tsc --watch",
26
+ "test": "vitest run",
27
+ "test:watch": "vitest",
28
+ "prepublishOnly": "npm run build",
29
+ "postinstall": "node dist/cli/postinstall.js"
30
+ },
31
+ "keywords": [
32
+ "ai",
33
+ "vibe",
34
+ "coding",
35
+ "spec-driven",
36
+ "claude",
37
+ "mcp",
38
+ "framework",
39
+ "requirements",
40
+ "user-story",
41
+ "ultrawork",
42
+ "parallel-agents",
43
+ "memory-management",
44
+ "knowledge-graph",
45
+ "code-analysis",
46
+ "code-quality"
47
+ ],
48
+ "author": "Su",
49
+ "license": "MIT",
50
+ "repository": {
51
+ "type": "git",
52
+ "url": "https://github.com/su-record/vibe.git"
53
+ },
54
+ "homepage": "https://github.com/su-record/vibe#readme",
55
+ "engines": {
56
+ "node": ">=18.0.0"
57
+ },
58
+ "dependencies": {
59
+ "@anthropic-ai/claude-agent-sdk": "^0.2.6",
60
+ "better-sqlite3": "^12.4.1",
61
+ "chalk": "^5.3.0",
62
+ "glob": "^11.0.3",
63
+ "ts-morph": "^26.0.0"
64
+ },
65
+ "devDependencies": {
66
+ "@types/better-sqlite3": "^7.6.13",
67
+ "@types/glob": "^8.1.0",
68
+ "@types/node": "^22.0.0",
69
+ "typescript": "^5.5.4",
70
+ "vitest": "^4.0.9"
71
+ },
72
+ "files": [
73
+ "dist/",
74
+ "vibe/",
75
+ "languages/",
76
+ "commands/",
77
+ "agents/",
78
+ "skills/",
79
+ "hooks/",
80
+ "CLAUDE.md",
81
+ "README.md",
82
+ "LICENSE"
83
+ ]
84
+ }
@@ -1,141 +1,141 @@
1
- ---
2
- name: brand-assets
3
- description: "Auto-generate app icons and favicons from SPEC brand information using Gemini Image API"
4
- triggers: [icon, favicon, brand, logo, app icon, branding, assets]
5
- priority: 65
6
- ---
7
- # Brand Assets Generation Skill
8
-
9
- Auto-generate app icons and favicons based on SPEC brand information.
10
-
11
- ## When to Use
12
-
13
- - First-time project setup with `/vibe.run`
14
- - When SPEC contains brand/design information
15
- - When Gemini API key is configured
16
-
17
- ## Prerequisites
18
-
19
- - Gemini API key configured (`vibe gemini auth`)
20
- - SPEC with brand context (app name, colors, style)
21
-
22
- ## Generated Assets
23
-
24
- ### Web
25
- - `favicon.ico` (16x16, 32x32, 48x48)
26
- - `favicon-16x16.png`
27
- - `favicon-32x32.png`
28
- - `apple-touch-icon.png` (180x180)
29
- - `android-chrome-192x192.png`
30
- - `android-chrome-512x512.png`
31
-
32
- ### Mobile (if applicable)
33
- - iOS: `AppIcon.appiconset/` with all sizes
34
- - Android: `mipmap-*/` adaptive icons
35
-
36
- ## SPEC Brand Section
37
-
38
- For best results, include brand info in your SPEC:
39
-
40
- ```yaml
41
- <context>
42
- Brand:
43
- - App Name: MyApp
44
- - Primary Color: #2F6BFF
45
- - Style: Modern, minimal, flat design
46
- - Icon Concept: Abstract geometric shape representing connectivity
47
- </context>
48
- ```
49
-
50
- ## Generation Flow
51
-
52
- ```
53
- SPEC Brand Info
54
- |
55
- v
56
- Extract: name, colors, style keywords
57
- |
58
- v
59
- Generate Prompt: "App icon for [name], [style], [colors]..."
60
- |
61
- v
62
- Gemini Image API (imagen-3)
63
- |
64
- v
65
- Resize & Convert: All platform sizes
66
- |
67
- v
68
- Save to: public/ or assets/
69
- ```
70
-
71
- ## Auto-Trigger Conditions
72
-
73
- 1. First `/vibe.run` execution (no existing icons)
74
- 2. SPEC contains brand/design context
75
- 3. Gemini API key is available
76
- 4. `--generate-icons` flag passed
77
-
78
- ## Skip Conditions
79
-
80
- - Icons already exist (unless `--regenerate-icons`)
81
- - No brand info in SPEC
82
- - Gemini API not configured
83
-
84
- ## Prompt Template
85
-
86
- ```
87
- Create a modern app icon for "[APP_NAME]".
88
-
89
- Style: [STYLE_KEYWORDS]
90
- Primary color: [PRIMARY_COLOR]
91
- Design: Minimalist, professional, suitable for mobile app
92
- Format: Square, clean edges, simple recognizable shape
93
- Background: Solid color or subtle gradient
94
-
95
- Requirements:
96
- - Works at small sizes (16x16 to 512x512)
97
- - No text or letters
98
- - Single focal element
99
- - High contrast for visibility
100
- ```
101
-
102
- ## Manual Usage
103
-
104
- ```bash
105
- # Generate via hook script (when Gemini configured)
106
- node hooks/scripts/generate-brand-assets.js \
107
- --name "MyApp" \
108
- --color "#2F6BFF" \
109
- --style "modern minimal" \
110
- --output "./public"
111
- ```
112
-
113
- ## Integration with /vibe.run
114
-
115
- During Phase 1 (Setup), if brand assets don't exist:
116
-
117
- 1. Parse SPEC for brand context
118
- 2. Generate icon via Gemini Image API
119
- 3. Create all size variants
120
- 4. Place in appropriate directories
121
- 5. Update manifest files if needed
122
-
123
- ## Fallback Strategy
124
-
125
- If Gemini Image fails:
126
- 1. Generate text-based monogram icon (first letter)
127
- 2. Use project primary color as background
128
- 3. Create simple geometric placeholder
129
-
130
- ## Output Structure
131
-
132
- ```
133
- public/
134
- favicon.ico
135
- favicon-16x16.png
136
- favicon-32x32.png
137
- apple-touch-icon.png
138
- android-chrome-192x192.png
139
- android-chrome-512x512.png
140
- site.webmanifest
141
- ```
1
+ ---
2
+ name: brand-assets
3
+ description: "Auto-generate app icons and favicons from SPEC brand information using Gemini Image API"
4
+ triggers: [icon, favicon, brand, logo, app icon, branding, assets]
5
+ priority: 65
6
+ ---
7
+ # Brand Assets Generation Skill
8
+
9
+ Auto-generate app icons and favicons based on SPEC brand information.
10
+
11
+ ## When to Use
12
+
13
+ - First-time project setup with `/vibe.run`
14
+ - When SPEC contains brand/design information
15
+ - When Gemini API key is configured
16
+
17
+ ## Prerequisites
18
+
19
+ - Gemini API key configured (`vibe gemini auth`)
20
+ - SPEC with brand context (app name, colors, style)
21
+
22
+ ## Generated Assets
23
+
24
+ ### Web
25
+ - `favicon.ico` (16x16, 32x32, 48x48)
26
+ - `favicon-16x16.png`
27
+ - `favicon-32x32.png`
28
+ - `apple-touch-icon.png` (180x180)
29
+ - `android-chrome-192x192.png`
30
+ - `android-chrome-512x512.png`
31
+
32
+ ### Mobile (if applicable)
33
+ - iOS: `AppIcon.appiconset/` with all sizes
34
+ - Android: `mipmap-*/` adaptive icons
35
+
36
+ ## SPEC Brand Section
37
+
38
+ For best results, include brand info in your SPEC:
39
+
40
+ ```yaml
41
+ <context>
42
+ Brand:
43
+ - App Name: MyApp
44
+ - Primary Color: #2F6BFF
45
+ - Style: Modern, minimal, flat design
46
+ - Icon Concept: Abstract geometric shape representing connectivity
47
+ </context>
48
+ ```
49
+
50
+ ## Generation Flow
51
+
52
+ ```
53
+ SPEC Brand Info
54
+ |
55
+ v
56
+ Extract: name, colors, style keywords
57
+ |
58
+ v
59
+ Generate Prompt: "App icon for [name], [style], [colors]..."
60
+ |
61
+ v
62
+ Gemini Image API (imagen-3)
63
+ |
64
+ v
65
+ Resize & Convert: All platform sizes
66
+ |
67
+ v
68
+ Save to: public/ or assets/
69
+ ```
70
+
71
+ ## Auto-Trigger Conditions
72
+
73
+ 1. First `/vibe.run` execution (no existing icons)
74
+ 2. SPEC contains brand/design context
75
+ 3. Gemini API key is available
76
+ 4. `--generate-icons` flag passed
77
+
78
+ ## Skip Conditions
79
+
80
+ - Icons already exist (unless `--regenerate-icons`)
81
+ - No brand info in SPEC
82
+ - Gemini API not configured
83
+
84
+ ## Prompt Template
85
+
86
+ ```
87
+ Create a modern app icon for "[APP_NAME]".
88
+
89
+ Style: [STYLE_KEYWORDS]
90
+ Primary color: [PRIMARY_COLOR]
91
+ Design: Minimalist, professional, suitable for mobile app
92
+ Format: Square, clean edges, simple recognizable shape
93
+ Background: Solid color or subtle gradient
94
+
95
+ Requirements:
96
+ - Works at small sizes (16x16 to 512x512)
97
+ - No text or letters
98
+ - Single focal element
99
+ - High contrast for visibility
100
+ ```
101
+
102
+ ## Manual Usage
103
+
104
+ ```bash
105
+ # Generate via hook script (when Gemini configured)
106
+ node hooks/scripts/generate-brand-assets.js \
107
+ --name "MyApp" \
108
+ --color "#2F6BFF" \
109
+ --style "modern minimal" \
110
+ --output "./public"
111
+ ```
112
+
113
+ ## Integration with /vibe.run
114
+
115
+ During Phase 1 (Setup), if brand assets don't exist:
116
+
117
+ 1. Parse SPEC for brand context
118
+ 2. Generate icon via Gemini Image API
119
+ 3. Create all size variants
120
+ 4. Place in appropriate directories
121
+ 5. Update manifest files if needed
122
+
123
+ ## Fallback Strategy
124
+
125
+ If Gemini Image fails:
126
+ 1. Generate text-based monogram icon (first letter)
127
+ 2. Use project primary color as background
128
+ 3. Create simple geometric placeholder
129
+
130
+ ## Output Structure
131
+
132
+ ```
133
+ public/
134
+ favicon.ico
135
+ favicon-16x16.png
136
+ favicon-32x32.png
137
+ apple-touch-icon.png
138
+ android-chrome-192x192.png
139
+ android-chrome-512x512.png
140
+ site.webmanifest
141
+ ```