@su-record/vibe 2.5.15 → 2.5.17

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 (231) hide show
  1. package/CLAUDE.md +96 -267
  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 +1117 -1117
  42. package/commands/vibe.spec.md +1066 -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/index.d.ts.map +1 -1
  48. package/dist/cli/index.js +109 -108
  49. package/dist/cli/index.js.map +1 -1
  50. package/dist/cli/llm.js +144 -144
  51. package/dist/lib/DeepInit.js +24 -24
  52. package/dist/lib/FrameworkDetector.d.ts +56 -0
  53. package/dist/lib/FrameworkDetector.d.ts.map +1 -0
  54. package/dist/lib/FrameworkDetector.js +287 -0
  55. package/dist/lib/FrameworkDetector.js.map +1 -0
  56. package/dist/lib/IterationTracker.js +11 -11
  57. package/dist/lib/PythonParser.js +108 -108
  58. package/dist/lib/RuleBuildSystem.d.ts +117 -0
  59. package/dist/lib/RuleBuildSystem.d.ts.map +1 -0
  60. package/dist/lib/RuleBuildSystem.js +402 -0
  61. package/dist/lib/RuleBuildSystem.js.map +1 -0
  62. package/dist/lib/SkillFrontmatter.js +28 -28
  63. package/dist/lib/SkillQualityGate.js +9 -9
  64. package/dist/lib/SkillRepository.js +159 -159
  65. package/dist/lib/UltraQA.js +77 -77
  66. package/dist/lib/gpt-api.js +4 -4
  67. package/dist/lib/memory/KnowledgeGraph.js +4 -4
  68. package/dist/lib/memory/MemorySearch.js +20 -20
  69. package/dist/lib/memory/MemoryStorage.js +64 -64
  70. package/dist/orchestrator/AgentManager.js +12 -12
  71. package/dist/orchestrator/MultiLlmResearch.js +8 -8
  72. package/dist/orchestrator/SmartRouter.js +11 -11
  73. package/dist/orchestrator/parallelResearch.js +24 -24
  74. package/dist/tools/convention/analyzeComplexity.test.js +115 -115
  75. package/dist/tools/convention/validateCodeQuality.test.js +104 -104
  76. package/dist/tools/index.d.ts +4 -0
  77. package/dist/tools/index.d.ts.map +1 -1
  78. package/dist/tools/index.js +4 -0
  79. package/dist/tools/index.js.map +1 -1
  80. package/hooks/hooks.json +222 -222
  81. package/hooks/scripts/code-check.js +22 -22
  82. package/hooks/scripts/code-review.js +22 -22
  83. package/hooks/scripts/complexity.js +22 -22
  84. package/hooks/scripts/compound.js +23 -23
  85. package/hooks/scripts/context-save.js +33 -33
  86. package/hooks/scripts/generate-brand-assets.js +472 -472
  87. package/hooks/scripts/hud-multiline.js +262 -262
  88. package/hooks/scripts/hud-status.js +291 -291
  89. package/hooks/scripts/keyword-detector.js +214 -214
  90. package/hooks/scripts/llm-orchestrate.js +171 -171
  91. package/hooks/scripts/post-edit.js +97 -97
  92. package/hooks/scripts/post-tool-verify.js +210 -210
  93. package/hooks/scripts/pre-tool-guard.js +125 -125
  94. package/hooks/scripts/recall.js +22 -22
  95. package/hooks/scripts/session-start.js +30 -30
  96. package/hooks/scripts/skill-injector.js +191 -191
  97. package/hooks/scripts/utils.js +97 -97
  98. package/languages/csharp-unity.md +515 -515
  99. package/languages/gdscript-godot.md +470 -470
  100. package/languages/ruby-rails.md +489 -489
  101. package/languages/typescript-angular.md +433 -433
  102. package/languages/typescript-astro.md +416 -416
  103. package/languages/typescript-electron.md +406 -406
  104. package/languages/typescript-nestjs.md +524 -524
  105. package/languages/typescript-svelte.md +407 -407
  106. package/languages/typescript-tauri.md +365 -365
  107. package/package.json +83 -83
  108. package/skills/brand-assets.md +141 -141
  109. package/skills/commerce-patterns.md +361 -361
  110. package/skills/context7-usage.md +102 -102
  111. package/skills/e2e-commerce.md +304 -304
  112. package/skills/frontend-design.md +92 -92
  113. package/skills/git-worktree.md +181 -181
  114. package/skills/parallel-research.md +77 -77
  115. package/skills/priority-todos.md +239 -239
  116. package/skills/seo-checklist.md +244 -244
  117. package/skills/tool-fallback.md +190 -190
  118. package/skills/vibe-capabilities.md +161 -161
  119. package/vibe/constitution.md +227 -227
  120. package/vibe/rules/core/communication-guide.md +98 -98
  121. package/vibe/rules/core/development-philosophy.md +52 -52
  122. package/vibe/rules/core/quick-start.md +102 -102
  123. package/vibe/rules/quality/bdd-contract-testing.md +393 -393
  124. package/vibe/rules/quality/checklist.md +276 -276
  125. package/vibe/rules/quality/testing-strategy.md +440 -440
  126. package/vibe/rules/standards/anti-patterns.md +541 -541
  127. package/vibe/rules/standards/code-structure.md +291 -291
  128. package/vibe/rules/standards/complexity-metrics.md +313 -313
  129. package/vibe/rules/standards/naming-conventions.md +198 -198
  130. package/vibe/setup.sh +31 -31
  131. package/vibe/templates/constitution-template.md +252 -252
  132. package/vibe/templates/contract-backend-template.md +526 -526
  133. package/vibe/templates/contract-frontend-template.md +599 -599
  134. package/vibe/templates/feature-template.md +96 -96
  135. package/vibe/templates/spec-template.md +221 -221
  136. package/dist/cli/mcp.d.ts +0 -49
  137. package/dist/cli/mcp.d.ts.map +0 -1
  138. package/dist/cli/mcp.js +0 -169
  139. package/dist/cli/mcp.js.map +0 -1
  140. package/dist/lib/gemini-mcp.d.ts +0 -10
  141. package/dist/lib/gemini-mcp.d.ts.map +0 -1
  142. package/dist/lib/gemini-mcp.js +0 -353
  143. package/dist/lib/gemini-mcp.js.map +0 -1
  144. package/dist/lib/gpt-mcp.d.ts +0 -10
  145. package/dist/lib/gpt-mcp.d.ts.map +0 -1
  146. package/dist/lib/gpt-mcp.js +0 -352
  147. package/dist/lib/gpt-mcp.js.map +0 -1
  148. package/dist/tools/analytics/getUsageAnalytics.d.ts +0 -10
  149. package/dist/tools/analytics/getUsageAnalytics.d.ts.map +0 -1
  150. package/dist/tools/analytics/getUsageAnalytics.js +0 -246
  151. package/dist/tools/analytics/getUsageAnalytics.js.map +0 -1
  152. package/dist/tools/analytics/index.d.ts +0 -5
  153. package/dist/tools/analytics/index.d.ts.map +0 -1
  154. package/dist/tools/analytics/index.js +0 -5
  155. package/dist/tools/analytics/index.js.map +0 -1
  156. package/dist/tools/convention/getCodingGuide.d.ts +0 -7
  157. package/dist/tools/convention/getCodingGuide.d.ts.map +0 -1
  158. package/dist/tools/convention/getCodingGuide.js +0 -69
  159. package/dist/tools/convention/getCodingGuide.js.map +0 -1
  160. package/dist/tools/planning/analyzeRequirements.d.ts +0 -9
  161. package/dist/tools/planning/analyzeRequirements.d.ts.map +0 -1
  162. package/dist/tools/planning/analyzeRequirements.js +0 -171
  163. package/dist/tools/planning/analyzeRequirements.js.map +0 -1
  164. package/dist/tools/planning/createUserStories.d.ts +0 -9
  165. package/dist/tools/planning/createUserStories.d.ts.map +0 -1
  166. package/dist/tools/planning/createUserStories.js +0 -124
  167. package/dist/tools/planning/createUserStories.js.map +0 -1
  168. package/dist/tools/planning/featureRoadmap.d.ts +0 -10
  169. package/dist/tools/planning/featureRoadmap.d.ts.map +0 -1
  170. package/dist/tools/planning/featureRoadmap.js +0 -207
  171. package/dist/tools/planning/featureRoadmap.js.map +0 -1
  172. package/dist/tools/planning/generatePrd.d.ts +0 -11
  173. package/dist/tools/planning/generatePrd.d.ts.map +0 -1
  174. package/dist/tools/planning/generatePrd.js +0 -161
  175. package/dist/tools/planning/generatePrd.js.map +0 -1
  176. package/dist/tools/planning/index.d.ts +0 -8
  177. package/dist/tools/planning/index.d.ts.map +0 -1
  178. package/dist/tools/planning/index.js +0 -8
  179. package/dist/tools/planning/index.js.map +0 -1
  180. package/dist/tools/prompt/analyzePrompt.d.ts +0 -7
  181. package/dist/tools/prompt/analyzePrompt.d.ts.map +0 -1
  182. package/dist/tools/prompt/analyzePrompt.js +0 -150
  183. package/dist/tools/prompt/analyzePrompt.js.map +0 -1
  184. package/dist/tools/prompt/enhancePrompt.d.ts +0 -8
  185. package/dist/tools/prompt/enhancePrompt.d.ts.map +0 -1
  186. package/dist/tools/prompt/enhancePrompt.js +0 -110
  187. package/dist/tools/prompt/enhancePrompt.js.map +0 -1
  188. package/dist/tools/prompt/enhancePromptGemini.d.ts +0 -8
  189. package/dist/tools/prompt/enhancePromptGemini.d.ts.map +0 -1
  190. package/dist/tools/prompt/enhancePromptGemini.js +0 -332
  191. package/dist/tools/prompt/enhancePromptGemini.js.map +0 -1
  192. package/dist/tools/prompt/index.d.ts +0 -7
  193. package/dist/tools/prompt/index.d.ts.map +0 -1
  194. package/dist/tools/prompt/index.js +0 -7
  195. package/dist/tools/prompt/index.js.map +0 -1
  196. package/dist/tools/reasoning/applyReasoningFramework.d.ts +0 -8
  197. package/dist/tools/reasoning/applyReasoningFramework.d.ts.map +0 -1
  198. package/dist/tools/reasoning/applyReasoningFramework.js +0 -266
  199. package/dist/tools/reasoning/applyReasoningFramework.js.map +0 -1
  200. package/dist/tools/reasoning/index.d.ts +0 -5
  201. package/dist/tools/reasoning/index.d.ts.map +0 -1
  202. package/dist/tools/reasoning/index.js +0 -5
  203. package/dist/tools/reasoning/index.js.map +0 -1
  204. package/dist/tools/thinking/analyzeProblem.d.ts +0 -7
  205. package/dist/tools/thinking/analyzeProblem.d.ts.map +0 -1
  206. package/dist/tools/thinking/analyzeProblem.js +0 -55
  207. package/dist/tools/thinking/analyzeProblem.js.map +0 -1
  208. package/dist/tools/thinking/breakDownProblem.d.ts +0 -8
  209. package/dist/tools/thinking/breakDownProblem.d.ts.map +0 -1
  210. package/dist/tools/thinking/breakDownProblem.js +0 -145
  211. package/dist/tools/thinking/breakDownProblem.js.map +0 -1
  212. package/dist/tools/thinking/createThinkingChain.d.ts +0 -7
  213. package/dist/tools/thinking/createThinkingChain.d.ts.map +0 -1
  214. package/dist/tools/thinking/createThinkingChain.js +0 -44
  215. package/dist/tools/thinking/createThinkingChain.js.map +0 -1
  216. package/dist/tools/thinking/formatAsPlan.d.ts +0 -9
  217. package/dist/tools/thinking/formatAsPlan.d.ts.map +0 -1
  218. package/dist/tools/thinking/formatAsPlan.js +0 -78
  219. package/dist/tools/thinking/formatAsPlan.js.map +0 -1
  220. package/dist/tools/thinking/index.d.ts +0 -10
  221. package/dist/tools/thinking/index.d.ts.map +0 -1
  222. package/dist/tools/thinking/index.js +0 -10
  223. package/dist/tools/thinking/index.js.map +0 -1
  224. package/dist/tools/thinking/stepByStepAnalysis.d.ts +0 -8
  225. package/dist/tools/thinking/stepByStepAnalysis.d.ts.map +0 -1
  226. package/dist/tools/thinking/stepByStepAnalysis.js +0 -63
  227. package/dist/tools/thinking/stepByStepAnalysis.js.map +0 -1
  228. package/dist/tools/thinking/thinkAloudProcess.d.ts +0 -8
  229. package/dist/tools/thinking/thinkAloudProcess.d.ts.map +0 -1
  230. package/dist/tools/thinking/thinkAloudProcess.js +0 -80
  231. package/dist/tools/thinking/thinkAloudProcess.js.map +0 -1
package/package.json CHANGED
@@ -1,83 +1,83 @@
1
- {
2
- "name": "@su-record/vibe",
3
- "version": "2.5.15",
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
- "./orchestrator": "./dist/orchestrator/index.js",
16
- "./lib/gpt": "./dist/lib/gpt-api.js",
17
- "./lib/gemini": "./dist/lib/gemini-api.js"
18
- },
19
- "bin": {
20
- "vibe": "./dist/cli/index.js"
21
- },
22
- "scripts": {
23
- "build": "tsc",
24
- "dev": "tsc --watch",
25
- "test": "vitest run",
26
- "test:watch": "vitest",
27
- "prepublishOnly": "npm run build",
28
- "postinstall": "node dist/cli/postinstall.js"
29
- },
30
- "keywords": [
31
- "ai",
32
- "vibe",
33
- "coding",
34
- "spec-driven",
35
- "claude",
36
- "mcp",
37
- "framework",
38
- "requirements",
39
- "user-story",
40
- "ultrawork",
41
- "parallel-agents",
42
- "memory-management",
43
- "knowledge-graph",
44
- "code-analysis",
45
- "code-quality"
46
- ],
47
- "author": "Su",
48
- "license": "MIT",
49
- "repository": {
50
- "type": "git",
51
- "url": "https://github.com/su-record/vibe.git"
52
- },
53
- "homepage": "https://github.com/su-record/vibe#readme",
54
- "engines": {
55
- "node": ">=18.0.0"
56
- },
57
- "dependencies": {
58
- "@anthropic-ai/claude-agent-sdk": "^0.2.6",
59
- "better-sqlite3": "^12.4.1",
60
- "chalk": "^5.3.0",
61
- "glob": "^11.0.3",
62
- "ts-morph": "^26.0.0"
63
- },
64
- "devDependencies": {
65
- "@types/better-sqlite3": "^7.6.13",
66
- "@types/glob": "^8.1.0",
67
- "@types/node": "^22.0.0",
68
- "typescript": "^5.5.4",
69
- "vitest": "^4.0.9"
70
- },
71
- "files": [
72
- "dist/",
73
- "vibe/",
74
- "languages/",
75
- "commands/",
76
- "agents/",
77
- "skills/",
78
- "hooks/",
79
- "CLAUDE.md",
80
- "README.md",
81
- "LICENSE"
82
- ]
83
- }
1
+ {
2
+ "name": "@su-record/vibe",
3
+ "version": "2.5.17",
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
+ "./orchestrator": "./dist/orchestrator/index.js",
16
+ "./lib/gpt": "./dist/lib/gpt-api.js",
17
+ "./lib/gemini": "./dist/lib/gemini-api.js"
18
+ },
19
+ "bin": {
20
+ "vibe": "./dist/cli/index.js"
21
+ },
22
+ "scripts": {
23
+ "build": "tsc",
24
+ "dev": "tsc --watch",
25
+ "test": "vitest run",
26
+ "test:watch": "vitest",
27
+ "prepublishOnly": "npm run build",
28
+ "postinstall": "node dist/cli/postinstall.js"
29
+ },
30
+ "keywords": [
31
+ "ai",
32
+ "vibe",
33
+ "coding",
34
+ "spec-driven",
35
+ "claude",
36
+ "mcp",
37
+ "framework",
38
+ "requirements",
39
+ "user-story",
40
+ "ultrawork",
41
+ "parallel-agents",
42
+ "memory-management",
43
+ "knowledge-graph",
44
+ "code-analysis",
45
+ "code-quality"
46
+ ],
47
+ "author": "Su",
48
+ "license": "MIT",
49
+ "repository": {
50
+ "type": "git",
51
+ "url": "https://github.com/su-record/vibe.git"
52
+ },
53
+ "homepage": "https://github.com/su-record/vibe#readme",
54
+ "engines": {
55
+ "node": ">=18.0.0"
56
+ },
57
+ "dependencies": {
58
+ "@anthropic-ai/claude-agent-sdk": "^0.2.6",
59
+ "better-sqlite3": "^12.4.1",
60
+ "chalk": "^5.3.0",
61
+ "glob": "^11.0.3",
62
+ "ts-morph": "^26.0.0"
63
+ },
64
+ "devDependencies": {
65
+ "@types/better-sqlite3": "^7.6.13",
66
+ "@types/glob": "^8.1.0",
67
+ "@types/node": "^22.0.0",
68
+ "typescript": "^5.5.4",
69
+ "vitest": "^4.0.9"
70
+ },
71
+ "files": [
72
+ "dist/",
73
+ "vibe/",
74
+ "languages/",
75
+ "commands/",
76
+ "agents/",
77
+ "skills/",
78
+ "hooks/",
79
+ "CLAUDE.md",
80
+ "README.md",
81
+ "LICENSE"
82
+ ]
83
+ }
@@ -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
+ ```