opencodekit 0.15.21 → 0.16.1

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 (144) hide show
  1. package/dist/index.js +5 -7
  2. package/dist/template/.opencode/AGENTS.md +85 -23
  3. package/dist/template/.opencode/agent/build.md +88 -7
  4. package/dist/template/.opencode/agent/explore.md +1 -1
  5. package/dist/template/.opencode/agent/general.md +54 -4
  6. package/dist/template/.opencode/agent/looker.md +1 -1
  7. package/dist/template/.opencode/agent/painter.md +1 -1
  8. package/dist/template/.opencode/agent/plan.md +52 -0
  9. package/dist/template/.opencode/agent/review.md +1 -1
  10. package/dist/template/.opencode/agent/scout.md +3 -3
  11. package/dist/template/.opencode/agent/vision.md +1 -1
  12. package/dist/template/.opencode/command/create.md +231 -91
  13. package/dist/template/.opencode/command/design.md +40 -7
  14. package/dist/template/.opencode/command/handoff.md +22 -0
  15. package/dist/template/.opencode/command/init.md +49 -78
  16. package/dist/template/.opencode/command/plan.md +36 -16
  17. package/dist/template/.opencode/command/pr.md +15 -0
  18. package/dist/template/.opencode/command/research.md +3 -0
  19. package/dist/template/.opencode/command/resume.md +8 -18
  20. package/dist/template/.opencode/command/review-codebase.md +30 -0
  21. package/dist/template/.opencode/command/ship.md +199 -0
  22. package/dist/template/.opencode/command/start.md +316 -28
  23. package/dist/template/.opencode/command/status.md +24 -1
  24. package/dist/template/.opencode/command/ui-review.md +36 -7
  25. package/dist/template/.opencode/command/verify.md +307 -0
  26. package/dist/template/.opencode/memory/_templates/prd.md +29 -0
  27. package/dist/template/.opencode/memory/_templates/proposal.md +38 -0
  28. package/dist/template/.opencode/memory/_templates/spec.md +66 -0
  29. package/dist/template/.opencode/memory/_templates/tasks.md +198 -0
  30. package/dist/template/.opencode/memory/_templates/tech-stack.md +50 -0
  31. package/dist/template/.opencode/memory/project/tech-stack.md +53 -0
  32. package/dist/template/.opencode/memory/research/ccpm-analysis.md +334 -0
  33. package/dist/template/.opencode/memory/research/openspec-analysis.md +226 -0
  34. package/dist/template/.opencode/memory.db +0 -0
  35. package/dist/template/.opencode/memory.db-shm +0 -0
  36. package/dist/template/.opencode/memory.db-wal +0 -0
  37. package/dist/template/.opencode/opencode.json +18 -4
  38. package/dist/template/.opencode/package.json +1 -0
  39. package/dist/template/.opencode/plans/1770006237537-mighty-otter.md +418 -0
  40. package/dist/template/.opencode/plans/1770006913647-glowing-forest.md +170 -0
  41. package/dist/template/.opencode/plans/1770013678126-witty-planet.md +278 -0
  42. package/dist/template/.opencode/plugin/lib/memory-db.ts +828 -0
  43. package/dist/template/.opencode/plugin/memory.ts +38 -1
  44. package/dist/template/.opencode/skill/index-knowledge/SKILL.md +76 -31
  45. package/dist/template/.opencode/skill/memory-system/SKILL.md +110 -55
  46. package/dist/template/.opencode/skill/tool-priority/SKILL.md +2 -2
  47. package/dist/template/.opencode/tool/memory-get.ts +143 -0
  48. package/dist/template/.opencode/tool/memory-maintain.ts +167 -0
  49. package/dist/template/.opencode/tool/memory-migrate.ts +319 -0
  50. package/dist/template/.opencode/tool/memory-read.ts +17 -46
  51. package/dist/template/.opencode/tool/memory-search.ts +131 -28
  52. package/dist/template/.opencode/tool/memory-timeline.ts +105 -0
  53. package/dist/template/.opencode/tool/memory-update.ts +21 -26
  54. package/dist/template/.opencode/tool/observation.ts +112 -100
  55. package/dist/template/.opencode/tsconfig.json +19 -19
  56. package/package.json +1 -1
  57. package/dist/template/.opencode/command/accessibility-check.md +0 -331
  58. package/dist/template/.opencode/command/agent-browser.md +0 -21
  59. package/dist/template/.opencode/command/analyze-mockup.md +0 -423
  60. package/dist/template/.opencode/command/analyze-project.md +0 -295
  61. package/dist/template/.opencode/command/brainstorm.md +0 -373
  62. package/dist/template/.opencode/command/cloudflare.md +0 -70
  63. package/dist/template/.opencode/command/commit.md +0 -245
  64. package/dist/template/.opencode/command/complete-next-task.md +0 -77
  65. package/dist/template/.opencode/command/design-audit.md +0 -480
  66. package/dist/template/.opencode/command/edit-image.md +0 -242
  67. package/dist/template/.opencode/command/finish.md +0 -255
  68. package/dist/template/.opencode/command/fix-ci.md +0 -109
  69. package/dist/template/.opencode/command/fix-types.md +0 -104
  70. package/dist/template/.opencode/command/fix-ui.md +0 -117
  71. package/dist/template/.opencode/command/fix.md +0 -168
  72. package/dist/template/.opencode/command/frontend-design.md +0 -21
  73. package/dist/template/.opencode/command/generate-diagram.md +0 -349
  74. package/dist/template/.opencode/command/generate-icon.md +0 -283
  75. package/dist/template/.opencode/command/generate-image.md +0 -246
  76. package/dist/template/.opencode/command/generate-pattern.md +0 -247
  77. package/dist/template/.opencode/command/generate-storyboard.md +0 -250
  78. package/dist/template/.opencode/command/implement.md +0 -609
  79. package/dist/template/.opencode/command/import-plan.md +0 -406
  80. package/dist/template/.opencode/command/index-knowledge.md +0 -25
  81. package/dist/template/.opencode/command/integration-test.md +0 -424
  82. package/dist/template/.opencode/command/issue.md +0 -102
  83. package/dist/template/.opencode/command/new-feature.md +0 -651
  84. package/dist/template/.opencode/command/opensrc.md +0 -58
  85. package/dist/template/.opencode/command/quick-build.md +0 -238
  86. package/dist/template/.opencode/command/ralph.md +0 -41
  87. package/dist/template/.opencode/command/research-and-implement.md +0 -148
  88. package/dist/template/.opencode/command/research-ui.md +0 -466
  89. package/dist/template/.opencode/command/restore-image.md +0 -424
  90. package/dist/template/.opencode/command/revert-feature.md +0 -386
  91. package/dist/template/.opencode/command/skill-create.md +0 -517
  92. package/dist/template/.opencode/command/skill-optimize.md +0 -556
  93. package/dist/template/.opencode/command/summarize.md +0 -412
  94. package/dist/template/.opencode/command/triage.md +0 -398
  95. package/dist/template/.opencode/memory/_templates/README.md +0 -35
  96. package/dist/template/.opencode/memory/_templates/observation.md +0 -39
  97. package/dist/template/.opencode/memory/_templates/project/architecture.md +0 -60
  98. package/dist/template/.opencode/memory/_templates/project/commands.md +0 -72
  99. package/dist/template/.opencode/memory/_templates/project/conventions.md +0 -68
  100. package/dist/template/.opencode/memory/_templates/project/gotchas.md +0 -41
  101. package/dist/template/.opencode/memory/_templates/prompt-engineering.md +0 -333
  102. package/dist/template/.opencode/memory/observations/2026-01-22-decision-agents-md-prompt-engineering-improvement.md +0 -29
  103. package/dist/template/.opencode/memory/observations/2026-01-25-decision-agent-roles-build-orchestrates-general-e.md +0 -14
  104. package/dist/template/.opencode/memory/observations/2026-01-25-decision-simplified-swarm-helper-tool-to-fix-type.md +0 -20
  105. package/dist/template/.opencode/memory/observations/2026-01-25-decision-use-beads-as-swarm-board-source-of-truth.md +0 -14
  106. package/dist/template/.opencode/memory/observations/2026-01-25-learning-user-wants-real-swarm-coordination-guida.md +0 -15
  107. package/dist/template/.opencode/memory/observations/2026-01-28-decision-created-deep-research-skill-for-thorough.md +0 -29
  108. package/dist/template/.opencode/memory/observations/2026-01-28-decision-gh-grep-mcp-wrapper-vs-native-grep-searc.md +0 -21
  109. package/dist/template/.opencode/memory/observations/2026-01-28-decision-oracle-tool-optimal-usage-patterns.md +0 -32
  110. package/dist/template/.opencode/memory/observations/2026-01-28-learning-ampcode-deep-mode-research-integration-w.md +0 -42
  111. package/dist/template/.opencode/memory/observations/2026-01-28-pattern-research-delegation-pattern-explore-for-.md +0 -32
  112. package/dist/template/.opencode/memory/observations/2026-01-29-decision-copilot-auth-plugin-rate-limit-handling.md +0 -27
  113. package/dist/template/.opencode/memory/observations/2026-01-29-decision-spec-driven-approach-for-opencodekit.md +0 -21
  114. package/dist/template/.opencode/memory/observations/2026-01-29-learning-karpathy-llm-coding-insights-dec-2025.md +0 -44
  115. package/dist/template/.opencode/memory/observations/2026-01-30-decision-github-copilot-claude-routing-keep-disab.md +0 -32
  116. package/dist/template/.opencode/memory/observations/2026-01-30-discovery-context-management-research-critical-gap.md +0 -14
  117. package/dist/template/.opencode/memory/observations/2026-01-30-discovery-kimi-k2-5-agent-swarm-architecture-patte.md +0 -45
  118. package/dist/template/.opencode/memory/observations/2026-01-30-pattern-swarm-tools-architecture.md +0 -28
  119. package/dist/template/.opencode/memory/observations/2026-01-31-decision-copilot-auth-plugin-updated-with-baseurl.md +0 -63
  120. package/dist/template/.opencode/memory/observations/2026-01-31-decision-created-dedicated-worker-agent-for-swarm.md +0 -20
  121. package/dist/template/.opencode/memory/observations/2026-01-31-decision-rollback-to-v1-1-47-for-copilot-claude-r.md +0 -21
  122. package/dist/template/.opencode/memory/observations/2026-01-31-decision-simplified-swarm-to-task-tool-pattern.md +0 -44
  123. package/dist/template/.opencode/memory/observations/2026-01-31-decision-swarm-architecture-task-tool-over-tmux.md +0 -33
  124. package/dist/template/.opencode/memory/observations/2026-01-31-decision-worker-skills-defined-for-swarm-delegati.md +0 -30
  125. package/dist/template/.opencode/memory/observations/2026-01-31-learning-gpt-reasoning-config-for-github-copilot.md +0 -51
  126. package/dist/template/.opencode/memory/observations/2026-01-31-learning-opencode-copilot-auth-comparison-finding.md +0 -61
  127. package/dist/template/.opencode/memory/observations/2026-01-31-learning-opencode-copilot-reasoning-architecture-.md +0 -66
  128. package/dist/template/.opencode/memory/observations/2026-01-31-learning-opencode-custom-tools-api.md +0 -48
  129. package/dist/template/.opencode/memory/observations/2026-01-31-learning-opencode-v1-1-48-skills-as-slash-command.md +0 -21
  130. package/dist/template/.opencode/memory/observations/2026-01-31-learning-swarm-system-simplified-removed-mailbox-.md +0 -30
  131. package/dist/template/.opencode/memory/observations/2026-01-31-learning-v1-1-48-native-copilot-reasoning-via-pr-.md +0 -45
  132. package/dist/template/.opencode/memory/observations/2026-01-31-warning-cannot-add-custom-config-to-opencode-jso.md +0 -18
  133. package/dist/template/.opencode/memory/observations/2026-01-31-warning-copilot-claude-v1-endpoint-returns-404-c.md +0 -48
  134. package/dist/template/.opencode/memory/observations/2026-01-31-warning-opencode-v1-1-48-claude-thinking-block-s.md +0 -51
  135. package/dist/template/.opencode/memory/project/architecture.md +0 -60
  136. package/dist/template/.opencode/memory/project/commands.md +0 -72
  137. package/dist/template/.opencode/memory/project/conventions.md +0 -68
  138. package/dist/template/.opencode/memory/project/gotchas.md +0 -41
  139. package/dist/template/.opencode/skill/notebooklm/SKILL.md +0 -272
  140. package/dist/template/.opencode/skill/notebooklm/references/setup.md +0 -353
  141. package/dist/template/.opencode/tool/notebooklm.ts +0 -488
  142. package/dist/template/.opencode/tool/oracle.ts +0 -240
  143. /package/dist/template/.opencode/memory/{user.example.md → _templates/user.md} +0 -0
  144. /package/dist/template/.opencode/memory/{user.md → project/user.md} +0 -0
@@ -1,283 +0,0 @@
1
- ---
2
- description: Generate app icons in multiple sizes with platform optimization
3
- argument-hint: "<description> [--platform=<ios|android|web|all>] [--style=<style>] [--shape=<shape>] [--color=<hex>] [--dark]"
4
- agent: painter
5
- ---
6
-
7
- # Generate Icon: $ARGUMENTS
8
-
9
- Generate app icons optimized for different platforms and sizes.
10
-
11
- ## Parse Arguments
12
-
13
- | Argument | Default | Options |
14
- | ------------ | -------- | --------------------------------- |
15
- | Description | required | What the icon should depict |
16
- | `--platform` | all | ios, android, web, all |
17
- | `--style` | minimal | See style presets below |
18
- | `--shape` | squircle | square, rounded, squircle, circle |
19
- | `--color` | none | Brand color hex (e.g., `#0066CC`) |
20
- | `--bg` | solid | solid, gradient, transparent |
21
- | `--dark` | false | Generate dark mode variant |
22
-
23
- ---
24
-
25
- ## Style Presets
26
-
27
- | Style | Description | Best For |
28
- | --------------- | -------------------------------------- | -------------------------- |
29
- | `minimal` | Simple shapes, 1-2 colors, clean lines | Professional, utility apps |
30
- | `flat` | Solid colors, no shadows, 2D | Modern, clean aesthetic |
31
- | `3d` | Depth, gradients, subtle shadows | Games, premium apps |
32
- | `glassmorphism` | Frosted glass effect, transparency | Modern iOS, premium |
33
- | `neumorphism` | Soft shadows, raised/pressed effect | Unique, tactile feel |
34
- | `gradient` | Bold color gradients | Social, creative apps |
35
- | `outlined` | Line art, stroke-based | Technical, developer tools |
36
- | `duotone` | Two-color design | Bold, striking |
37
- | `isometric` | 3D isometric view | Productivity, games |
38
- | `cartoon` | Playful, illustrated style | Kids, casual games |
39
-
40
- ---
41
-
42
- ## Shape Options
43
-
44
- | Shape | Platform Default | Description |
45
- | ---------- | ---------------- | ------------------------------------- |
46
- | `squircle` | iOS | Superellipse (Apple's rounded square) |
47
- | `circle` | Android (some) | Perfect circle |
48
- | `rounded` | Android | Rounded corners (customizable radius) |
49
- | `square` | Web favicon | Sharp corners |
50
-
51
- **Note:** Generate at highest resolution; platforms apply their own masks.
52
-
53
- ---
54
-
55
- ## Platform Sizes
56
-
57
- ### iOS
58
-
59
- | Size | Usage |
60
- | --------- | ---------- |
61
- | 1024x1024 | App Store |
62
- | 180x180 | iPhone @3x |
63
- | 120x120 | iPhone @2x |
64
- | 167x167 | iPad Pro |
65
- | 152x152 | iPad @2x |
66
- | 76x76 | iPad @1x |
67
-
68
- **Output:** `AppIcon.appiconset/` with `Contents.json`
69
-
70
- ### Android
71
-
72
- | Size | Density | Usage |
73
- | ------- | ---------- | ------------- |
74
- | 512x512 | Play Store | Store listing |
75
- | 192x192 | xxxhdpi | Launcher |
76
- | 144x144 | xxhdpi | Launcher |
77
- | 96x96 | xhdpi | Launcher |
78
- | 72x72 | hdpi | Launcher |
79
- | 48x48 | mdpi | Launcher |
80
-
81
- **Adaptive Icons (Android 8+):**
82
-
83
- ```
84
- res/
85
- ├── mipmap-anydpi-v26/
86
- │ └── ic_launcher.xml # References layers
87
- ├── drawable/
88
- │ ├── ic_launcher_foreground.xml # 108dp, icon centered in 72dp
89
- │ └── ic_launcher_background.xml # Solid color or gradient
90
- ```
91
-
92
- ### Web
93
-
94
- | File | Size | Usage |
95
- | -------------------------- | ------------------- | ------------------ |
96
- | favicon.ico | 16x16, 32x32, 48x48 | Browser tab |
97
- | favicon-16x16.png | 16x16 | Small favicon |
98
- | favicon-32x32.png | 32x32 | Standard favicon |
99
- | apple-touch-icon.png | 180x180 | iOS bookmark |
100
- | android-chrome-192x192.png | 192x192 | Android PWA |
101
- | android-chrome-512x512.png | 512x512 | Android PWA splash |
102
-
103
- **Output:** `site.webmanifest` included
104
-
105
- ---
106
-
107
- ## Brand Color Integration
108
-
109
- Use `--color` to specify brand colors:
110
-
111
- ```bash
112
- /generate-icon cloud storage app --color=#0066CC --style=minimal
113
- ```
114
-
115
- The AI will:
116
-
117
- - Use specified color as primary
118
- - Generate complementary accents
119
- - Ensure contrast for visibility
120
-
121
- **Multiple colors:**
122
-
123
- ```bash
124
- /generate-icon social app --color=#FF5722,#4CAF50 --style=gradient
125
- ```
126
-
127
- ---
128
-
129
- ## Dark Mode Variants
130
-
131
- Use `--dark` to generate both light and dark variants:
132
-
133
- ```bash
134
- /generate-icon productivity app --dark
135
- ```
136
-
137
- **Output:**
138
-
139
- ```
140
- icons/
141
- ├── icon-light.png # Light mode (default)
142
- ├── icon-dark.png # Dark mode variant
143
- └── icon-tinted.png # iOS tinted icon (optional)
144
- ```
145
-
146
- **iOS Tinted Icons (iOS 18+):**
147
-
148
- - Monochrome version for tinted appearance
149
- - Automatically adapts to user's chosen tint color
150
-
151
- ---
152
-
153
- ## Icon Design Principles
154
-
155
- ### Do
156
-
157
- - **Simple shape**: Recognizable at 16x16
158
- - **Single focal point**: One main element
159
- - **Bold colors**: Stand out on any wallpaper
160
- - **Unique silhouette**: Distinguishable from other apps
161
- - **Consistent style**: Match your app's aesthetic
162
-
163
- ### Don't
164
-
165
- - **Text**: Illegible at small sizes (except single letter logos)
166
- - **Photos**: Don't scale well
167
- - **Too much detail**: Lost at small sizes
168
- - **Thin lines**: Disappear at low resolution
169
- - **Similar to system icons**: Avoid confusion
170
-
171
- ### The Squint Test
172
-
173
- If you squint at your icon and can still identify it, it's good.
174
-
175
- ---
176
-
177
- ## Examples
178
-
179
- ### Utility/Productivity
180
-
181
- ```bash
182
- # Cloud storage
183
- /generate-icon cloud with upward arrow, simple --style=minimal --color=#2196F3 --platform=all
184
-
185
- # Notes app
186
- /generate-icon pencil on notepad, clean lines --style=flat --color=#FFC107
187
-
188
- # Calculator
189
- /generate-icon calculator with equals sign --style=outlined --color=#607D8B
190
- ```
191
-
192
- ### Social/Creative
193
-
194
- ```bash
195
- # Social app
196
- /generate-icon chat bubble with heart --style=gradient --color=#E91E63,#9C27B0
197
-
198
- # Photo editor
199
- /generate-icon camera lens with rainbow gradient --style=glassmorphism
200
-
201
- # Music app
202
- /generate-icon musical note, vibrant --style=3d --color=#1DB954
203
- ```
204
-
205
- ### Games
206
-
207
- ```bash
208
- # Casual game
209
- /generate-icon smiling star character --style=cartoon --color=#FFEB3B
210
-
211
- # Strategy game
212
- /generate-icon shield with sword --style=3d --color=#8B4513
213
-
214
- # Puzzle game
215
- /generate-icon interlocking puzzle pieces --style=isometric --color=#00BCD4
216
- ```
217
-
218
- ### Developer Tools
219
-
220
- ```bash
221
- # Code editor
222
- /generate-icon angle brackets with cursor --style=outlined --color=#21252B
223
-
224
- # Terminal
225
- /generate-icon command prompt symbol --style=minimal --color=#282C34 --dark
226
-
227
- # API tool
228
- /generate-icon connected nodes --style=duotone --color=#6200EE
229
- ```
230
-
231
- ---
232
-
233
- ## Output Structure
234
-
235
- ```
236
- .opencode/memory/design/icons/[app-name]/
237
- ├── ios/
238
- │ └── AppIcon.appiconset/
239
- │ ├── Contents.json
240
- │ ├── icon-1024.png
241
- │ ├── icon-180.png
242
- │ └── ...
243
- ├── android/
244
- │ ├── play-store-512.png
245
- │ ├── res/
246
- │ │ ├── mipmap-xxxhdpi/
247
- │ │ ├── mipmap-xxhdpi/
248
- │ │ └── ...
249
- │ └── adaptive/
250
- │ ├── foreground.png
251
- │ └── background.png
252
- ├── web/
253
- │ ├── favicon.ico
254
- │ ├── favicon-32x32.png
255
- │ ├── apple-touch-icon.png
256
- │ └── site.webmanifest
257
- ├── master-1024.png # Source file
258
- └── dark/ # If --dark specified
259
- ├── master-1024.png
260
- └── ...
261
- ```
262
-
263
- ---
264
-
265
- ## Limitations
266
-
267
- | Limitation | Workaround |
268
- | ---------------------- | ------------------------------------------------ |
269
- | Text rendering | Use single letter or add text in post-processing |
270
- | Exact brand logos | Provide reference image with `/edit-image` |
271
- | Complex illustrations | Generate simplified version, refine manually |
272
- | Precise color matching | Specify exact hex with `--color` |
273
-
274
- ---
275
-
276
- ## Related Commands
277
-
278
- | Need | Command |
279
- | --------------------- | ------------------- |
280
- | Edit generated icon | `/edit-image` |
281
- | Generate full image | `/generate-image` |
282
- | Create pattern | `/generate-pattern` |
283
- | Analyze existing icon | `/analyze-mockup` |
@@ -1,246 +0,0 @@
1
- ---
2
- description: Generate images using Gemini image models
3
- argument-hint: "<prompt> [--style=<style>] [--aspect=<ratio>] [--size=<size>] [--count=<n>] [--pro]"
4
- agent: painter
5
- ---
6
-
7
- # Generate Image: $ARGUMENTS
8
-
9
- Generate images based on natural language prompts.
10
-
11
- ## Parse Arguments
12
-
13
- | Argument | Default | Options |
14
- | ---------- | -------- | -------------------------------- |
15
- | Prompt | required | Natural language description |
16
- | `--style` | none | See style presets below |
17
- | `--aspect` | 1:1 | 1:1, 16:9, 9:16, 4:3, 3:4 |
18
- | `--size` | default | default, hd, 2k |
19
- | `--count` | 1 | 1-4 variations |
20
- | `--pro` | false | Use Pro model for higher quality |
21
- | `--png` | false | Output PNG instead of JPEG |
22
-
23
- ---
24
-
25
- ## Style Presets
26
-
27
- Use `--style=<name>` to apply consistent aesthetics:
28
-
29
- | Style | Description | Best For |
30
- | ---------------- | -------------------------------------- | --------------------------- |
31
- | `photorealistic` | High-detail photography | Products, portraits, scenes |
32
- | `cinematic` | Movie-quality lighting, depth of field | Drama, atmosphere |
33
- | `illustration` | Clean vector-style artwork | Icons, diagrams, UI |
34
- | `watercolor` | Soft, painterly textures | Art, backgrounds |
35
- | `anime` | Japanese animation style | Characters, scenes |
36
- | `3d-render` | CGI/Blender-style render | Products, architecture |
37
- | `sketch` | Pencil/charcoal drawing | Concepts, wireframes |
38
- | `pixel-art` | Retro 8-bit/16-bit style | Games, nostalgia |
39
- | `oil-painting` | Classical art texture | Portraits, landscapes |
40
- | `minimalist` | Simple shapes, flat colors | Logos, icons |
41
- | `isometric` | 3D isometric view | Diagrams, games |
42
- | `vintage` | Aged, retro photograph look | Nostalgia, branding |
43
-
44
- ---
45
-
46
- ## Aspect Ratios
47
-
48
- | Ratio | Dimensions | Use Case |
49
- | ------ | ------------------ | -------------------------------------- |
50
- | `1:1` | Square | Social media, avatars, icons |
51
- | `16:9` | Landscape wide | Hero images, banners, video thumbnails |
52
- | `9:16` | Portrait tall | Mobile, stories, vertical content |
53
- | `4:3` | Landscape standard | Presentations, traditional photos |
54
- | `3:4` | Portrait standard | Portraits, product photos |
55
-
56
- ---
57
-
58
- ## Prompt Engineering
59
-
60
- ### Good Prompt Structure
61
-
62
- ```
63
- [Subject] + [Action/Pose] + [Environment] + [Style] + [Lighting] + [Quality modifiers]
64
- ```
65
-
66
- **Example:**
67
-
68
- ```
69
- A golden retriever playing fetch in a sunny park,
70
- soft afternoon light, shallow depth of field,
71
- professional photography, 8k, highly detailed
72
- ```
73
-
74
- ### Quality Modifiers (add to any prompt)
75
-
76
- | Modifier | Effect |
77
- | -------------------------- | ------------------------ |
78
- | "highly detailed" | Increases fine detail |
79
- | "8k" / "4k" | Suggests high resolution |
80
- | "professional photography" | Photorealistic quality |
81
- | "sharp focus" | Crisp subject |
82
- | "soft lighting" | Gentle, flattering light |
83
- | "dramatic lighting" | High contrast, mood |
84
- | "shallow depth of field" | Blurred background |
85
- | "studio lighting" | Clean, even light |
86
-
87
- ### Negative Prompts
88
-
89
- Include what to avoid in your prompt:
90
-
91
- ```
92
- A modern logo design, clean lines, minimalist,
93
- avoid: text, watermarks, busy backgrounds, gradients
94
- ```
95
-
96
- Common exclusions:
97
-
98
- - "no text" / "avoid text"
99
- - "no watermarks"
100
- - "no people"
101
- - "avoid clutter"
102
- - "no blurry elements"
103
-
104
- ---
105
-
106
- ## Examples by Category
107
-
108
- ### Product Photography
109
-
110
- ```bash
111
- # Product shot
112
- /generate-image A sleek wireless headphone on white background, studio lighting, product photography --style=photorealistic --aspect=4:3
113
-
114
- # Lifestyle product
115
- /generate-image Coffee mug on wooden desk with morning light, cozy atmosphere, shallow depth of field --style=cinematic --aspect=16:9
116
- ```
117
-
118
- ### UI/Design Assets
119
-
120
- ```bash
121
- # Icon
122
- /generate-image A simple cloud upload icon, flat design, blue and white --style=minimalist --aspect=1:1
123
-
124
- # Illustration
125
- /generate-image Team collaboration illustration, people working together, modern flat style --style=illustration --aspect=16:9
126
-
127
- # Pattern
128
- /generate-image Seamless geometric pattern, navy and gold, art deco style --style=minimalist --aspect=1:1
129
- ```
130
-
131
- ### Marketing/Social
132
-
133
- ```bash
134
- # Hero image
135
- /generate-image Futuristic city skyline at sunset, cyberpunk aesthetic, neon lights --style=cinematic --aspect=16:9 --pro
136
-
137
- # Social media
138
- /generate-image Abstract gradient background, purple and blue, smooth waves --style=minimalist --aspect=1:1
139
-
140
- # Story format
141
- /generate-image Mountain landscape with hiker, adventure theme, dramatic sky --style=photorealistic --aspect=9:16
142
- ```
143
-
144
- ### Concept Art
145
-
146
- ```bash
147
- # Character
148
- /generate-image Fantasy warrior character, detailed armor, dynamic pose --style=illustration --aspect=3:4 --pro
149
-
150
- # Environment
151
- /generate-image Abandoned space station interior, sci-fi, atmospheric lighting --style=cinematic --aspect=16:9
152
-
153
- # Creature
154
- /generate-image Friendly dragon mascot, cute, approachable, cartoon style --style=illustration --aspect=1:1
155
- ```
156
-
157
- ---
158
-
159
- ## Batch Generation
160
-
161
- Use `--count` to generate variations:
162
-
163
- ```bash
164
- # Generate 4 variations
165
- /generate-image Modern logo concepts for a tech startup --style=minimalist --count=4
166
- ```
167
-
168
- Output:
169
-
170
- ```
171
- Generated 4 images:
172
- ├── tech-logo-v1.png
173
- ├── tech-logo-v2.png
174
- ├── tech-logo-v3.png
175
- └── tech-logo-v4.png
176
- ```
177
-
178
- ---
179
-
180
- ## Output
181
-
182
- ### Standard Output
183
-
184
- ```markdown
185
- ## Image Generated
186
-
187
- **Prompt:** "A golden retriever in a sunny park"
188
- **Style:** photorealistic
189
- **Aspect:** 16:9
190
- **Size:** HD
191
- **Output:** `.opencode/memory/design/images/golden-retriever-park-001.jpg`
192
-
193
- ### Generation Details
194
-
195
- - Model: gemini-3-pro-image-preview
196
- - Enhanced prompt: [show the full prompt used]
197
- - Generation time: 4.2s
198
-
199
- ### Refinements
200
-
201
- - "Make the dog larger in frame"
202
- - "Add more vibrant colors"
203
- - "Change to sunset lighting"
204
- ```
205
-
206
- ---
207
-
208
- ## Limitations
209
-
210
- | Limitation | Details |
211
- | ------------------ | ------------------------------------ |
212
- | **Text in images** | AI struggles to render readable text |
213
- | **Specific faces** | Cannot generate real people |
214
- | **Hands/fingers** | Often produces artifacts |
215
- | **Exact counts** | "5 birds" may show 4 or 6 |
216
- | **Brand logos** | May refuse or distort |
217
- | **Complex scenes** | Many elements = inconsistency |
218
- | **Precise layout** | Spatial positioning is approximate |
219
-
220
- ### Tips to Avoid Issues
221
-
222
- - Don't request text - add it in post-processing
223
- - Keep subject count low (1-3 main elements)
224
- - Be specific about what's important
225
- - Use style presets for consistency
226
- - Generate multiple variations, pick best
227
-
228
- ---
229
-
230
- ## Storage
231
-
232
- Images saved to: `.opencode/memory/design/images/`
233
-
234
- Filename pattern: `[subject]-[style]-[timestamp].{jpg|png}`
235
-
236
- ---
237
-
238
- ## Related Commands
239
-
240
- | Need | Command |
241
- | ------------------- | ------------------- |
242
- | Edit existing image | `/edit-image` |
243
- | Generate icon | `/generate-icon` |
244
- | Generate diagram | `/generate-diagram` |
245
- | Analyze image | `/analyze-mockup` |
246
- | Create pattern | `/generate-pattern` |