opencodekit 0.10.0 → 0.11.1

package/dist/template/.opencode/command/generate-pattern.md

@@ -1,6 +1,6 @@
 ---
 description: Generate seamless patterns and textures
-argument-hint: "<description> [type: geometric|organic|abstract|texture] [colors: <palette>]"
+argument-hint: "<description> [--type=<type>] [--style=<style>] [--colors=<palette>] [--density=<level>] [--size=<px>]"
 agent: vision
 model: proxypal/gemini-3-pro-image-preview
 ---
@@ -9,33 +9,247 @@ model: proxypal/gemini-3-pro-image-preview
 
 Generate seamless, tileable patterns and textures.
 
-## Instructions
+## Parse Arguments
 
-Parse from `$ARGUMENTS`:
+| Argument        | Default   | Options                               |
+| --------------- | --------- | ------------------------------------- |
+| Description     | required  | What the pattern depicts              |
+| `--type`        | geometric | geometric, organic, abstract, texture |
+| `--style`       | none      | See style presets below               |
+| `--colors`      | auto      | Hex colors or preset name             |
+| `--density`     | medium    | sparse, medium, dense                 |
+| `--size`        | 512       | 256, 512, 1024, 2048                  |
+| `--repeat`      | tile      | tile, mirror, half-drop, brick        |
+| `--format`      | png       | png, svg, both                        |
+| `--transparent` | false     | Transparent background                |
 
-- Pattern description
-- Type (default: geometric)
-- Color palette (optional)
+---
 
-## Types
+## Pattern Types
 
-- **geometric**: Shapes, grids, lines
-- **organic**: Nature-inspired, flowing
-- **abstract**: Artistic, experimental
-- **texture**: Material surfaces (wood, marble, fabric)
+| Type        | Description                                     | Best For                      |
+| ----------- | ----------------------------------------------- | ----------------------------- |
+| `geometric` | Shapes, grids, lines, polygons                  | Modern UI, tech, corporate    |
+| `organic`   | Nature-inspired, flowing, irregular             | Wellness, eco, natural brands |
+| `abstract`  | Artistic, experimental, non-representational    | Creative, bold designs        |
+| `texture`   | Material surfaces (wood, marble, fabric, paper) | Backgrounds, realism          |
 
-## Requirements
+---
+
+## Style Presets
+
+| Style          | Description                    | Characteristics                     |
+| -------------- | ------------------------------ | ----------------------------------- |
+| `art-deco`     | 1920s geometric elegance       | Gold, black, symmetry, fan shapes   |
+| `memphis`      | 1980s bold & playful           | Bright colors, squiggles, dots      |
+| `scandinavian` | Nordic minimalism              | Muted colors, simple shapes, nature |
+| `japanese`     | Traditional Japanese motifs    | Waves, clouds, cherry blossoms      |
+| `moroccan`     | Islamic geometric patterns     | Intricate tiles, symmetry           |
+| `terrazzo`     | Speckled stone aggregate       | Colorful chips on neutral base      |
+| `botanical`    | Plant and floral elements      | Leaves, flowers, vines              |
+| `retro`        | Mid-century modern             | Atomic age, boomerangs, starbursts  |
+| `tribal`       | Ethnic and indigenous patterns | Bold lines, earth tones             |
+| `digital`      | Tech/circuit inspired          | Lines, nodes, grid patterns         |
+| `watercolor`   | Soft, painterly texture        | Bleeding edges, wash effects        |
+| `noise`        | Grain and static textures      | Film grain, static, subtle texture  |
+
+---
+
+## Color Palette Presets
+
+Use `--colors=<preset>` or specify hex values:
+
+| Preset    | Colors                    | Mood                  |
+| --------- | ------------------------- | --------------------- |
+| `mono`    | Single color + variations | Clean, minimal        |
+| `duotone` | Two contrasting colors    | Bold, striking        |
+| `earth`   | Browns, greens, tans      | Natural, organic      |
+| `ocean`   | Blues, teals, white       | Calm, professional    |
+| `sunset`  | Orange, pink, purple      | Warm, vibrant         |
+| `forest`  | Greens, browns, gold      | Earthy, grounded      |
+| `pastel`  | Soft, muted colors        | Gentle, friendly      |
+| `neon`    | Bright, saturated colors  | Energetic, bold       |
+| `neutral` | Grays, beige, white       | Sophisticated, subtle |
+| `jewel`   | Deep, rich colors         | Luxurious, premium    |
+
+**Custom colors:**
+
+```bash
+--colors=#FF5722,#4CAF50,#2196F3
+```
+
+---
+
+## Density Levels
+
+| Density  | Description                 | Use Case                     |
+| -------- | --------------------------- | ---------------------------- |
+| `sparse` | Few elements, lots of space | Subtle backgrounds, overlays |
+| `medium` | Balanced coverage           | General purpose              |
+| `dense`  | Tightly packed elements     | Bold statements, textures    |
+
+---
+
+## Repeat Modes
+
+| Mode        | Description               | Visual           |
+| ----------- | ------------------------- | ---------------- |
+| `tile`      | Direct repeat in grid     | ▢▢▢ / ▢▢▢ / ▢▢▢  |
+| `mirror`    | Flip alternating tiles    | ▢◻▢ / ◻▢◻ / ▢◻▢  |
+| `half-drop` | Offset by half vertically | ▢▢▢ / ·▢▢ / ▢▢▢  |
+| `brick`     | Offset like brickwork     | ▢▢▢ / ·▢▢▢ / ▢▢▢ |
+
+---
+
+## Use Cases
+
+### UI Backgrounds
+
+```bash
+# Subtle hero background
+/generate-pattern soft gradient noise --type=texture --density=sparse --colors=neutral --transparent
+
+# Card pattern overlay
+/generate-pattern geometric grid --style=digital --density=sparse --colors=#0066CC --transparent
+```
+
+### Print & Packaging
+
+```bash
+# Gift wrap
+/generate-pattern festive geometric shapes --style=memphis --colors=pastel --size=2048
+
+# Fabric print
+/generate-pattern botanical leaves --style=scandinavian --colors=forest --repeat=half-drop
+```
+
+### Branding
+
+```bash
+# Corporate pattern
+/generate-pattern subtle diagonal lines --type=geometric --colors=#1a1a1a --density=sparse
+
+# Playful brand pattern
+/generate-pattern abstract shapes and dots --style=memphis --colors=neon
+```
+
+### Textures
 
-- Must tile seamlessly in all directions
-- Generate at 512x512 minimum
-- Include both light and dark variants if useful
+```bash
+# Paper texture
+/generate-pattern subtle paper grain --type=texture --colors=#FAFAFA --density=medium
+
+# Marble surface
+/generate-pattern marble veins --type=texture --colors=#FFFFFF,#CCCCCC,#999999 --size=1024
+
+# Wood grain
+/generate-pattern oak wood grain --type=texture --colors=earth
+```
+
+---
+
+## Examples by Style
+
+```bash
+# Art Deco
+/generate-pattern fan shapes and gold lines --style=art-deco --colors=#1a1a1a,#D4AF37
+
+# Japanese
+/generate-pattern waves and clouds --style=japanese --colors=ocean
+
+# Terrazzo
+/generate-pattern colorful stone chips --style=terrazzo --colors=pastel --size=1024
+
+# Moroccan
+/generate-pattern intricate tile pattern --style=moroccan --colors=jewel
+
+# Scandinavian
+/generate-pattern simple leaf shapes --style=scandinavian --colors=#2D4739,#F5F5DC
+```
+
+---
 
 ## Output
 
-Save to `.opencode/memory/design/patterns/`:
+### File Structure
+
+```
+.opencode/memory/design/patterns/[name]/
+├── pattern-512.png           # Main pattern tile
+├── pattern-512.svg           # Vector version (if --format=svg)
+├── pattern-preview.png       # 3x3 tiled preview
+├── pattern-dark.png          # Dark variant (if applicable)
+└── usage.css                 # CSS snippet
+```
+
+### CSS Snippet
+
+```css
+/* Generated pattern usage */
+.pattern-background {
+  background-image: url("pattern-512.png");
+  background-repeat: repeat;
+  background-size: 128px 128px; /* Adjust for desired scale */
+}
+
+/* With overlay for text readability */
+.pattern-overlay {
+  background:
+    linear-gradient(rgba(255, 255, 255, 0.9), rgba(255, 255, 255, 0.9)),
+    url("pattern-512.png");
+  background-repeat: repeat;
+}
+
+/* CSS-only alternative (if simple enough) */
+.pattern-css {
+  background: repeating-linear-gradient(
+    45deg,
+    #f0f0f0,
+    #f0f0f0 10px,
+    #ffffff 10px,
+    #ffffff 20px
+  );
+}
+```
+
+---
+
+## Requirements
+
+- **Seamless tiling**: Must repeat perfectly in all directions
+- **Edge matching**: No visible seams when tiled
+- **Consistent density**: Even distribution across tile
+- **Color accuracy**: Match specified palette exactly
+
+---
+
+## Tips for Better Patterns
+
+1. **Be specific**: "Geometric triangles" > "shapes"
+2. **Reference styles**: "Like William Morris wallpaper"
+3. **Specify scale**: "Large-scale floral" vs "micro pattern"
+4. **Consider use**: "For dark text overlay" guides contrast
+5. **Test at scale**: Preview at intended display size
+
+---
+
+## Limitations
+
+| Limitation              | Workaround                                  |
+| ----------------------- | ------------------------------------------- |
+| Complex illustrations   | Use simpler, repeated motifs                |
+| Photorealistic textures | Use `--type=texture` with specific material |
+| Exact brand assets      | Provide reference, use as base              |
+| Perfect symmetry        | May need manual adjustment                  |
+| Text in patterns        | Add text in post-processing                 |
+
+---
 
-- Main pattern file
-- Tiled preview showing seamless repeat
-- CSS snippet for background usage
+## Related Commands
 
-Report generated files and usage example.
+| Need           | Command           |
+| -------------- | ----------------- |
+| Generate image | `/generate-image` |
+| Edit pattern   | `/edit-image`     |
+| Create icon    | `/generate-icon`  |
+| Analyze design | `/analyze-mockup` |

package/dist/template/.opencode/command/generate-storyboard.md

@@ -1,41 +1,251 @@
 ---
 description: Generate sequential images for visual storytelling
-argument-hint: "<story-description> [frames: N] [style: comic|realistic|sketch]"
+argument-hint: "<story-description> [--frames=<N>] [--style=<style>] [--aspect=<ratio>] [--layout=<layout>]"
 agent: vision
 model: proxypal/gemini-3-pro-image-preview
 ---
 
 # Generate Storyboard: $ARGUMENTS
 
-Generate a sequence of images telling a visual story.
+Generate a sequence of images telling a visual story with consistent characters and settings.
 
-## Instructions
+## Parse Arguments
 
-Parse from `$ARGUMENTS`:
+| Argument          | Default  | Options                          |
+| ----------------- | -------- | -------------------------------- |
+| Story description | required | Narrative or script to visualize |
+| `--frames`        | 4        | 3-12 frames                      |
+| `--style`         | sketch   | See style presets below          |
+| `--aspect`        | 16:9     | 16:9, 4:3, 1:1, 9:16             |
+| `--layout`        | grid     | grid, strip, single              |
+| `--captions`      | true     | Include scene descriptions       |
+| `--timing`        | false    | Add duration annotations         |
 
-- Story description or script
-- Number of frames (default: 4)
-- Visual style (default: sketch)
+---
+
+## Style Presets
+
+| Style        | Description                               | Best For                           |
+| ------------ | ----------------------------------------- | ---------------------------------- |
+| `sketch`     | Hand-drawn, rough lines, quick            | Pre-production, drafts             |
+| `comic`      | Bold lines, panels, dynamic               | Marketing, entertainment           |
+| `realistic`  | Photo-realistic rendering                 | Film pre-viz, client presentations |
+| `animation`  | Clean lines, flat colors                  | Animated content planning          |
+| `noir`       | High contrast, shadows, dramatic          | Thriller, drama                    |
+| `watercolor` | Soft, artistic, painterly                 | Emotional narratives               |
+| `minimalist` | Simple shapes, icons                      | UX flows, explainers               |
+| `cinematic`  | Widescreen, film grain, dramatic lighting | Video production                   |
+| `children`   | Bright colors, friendly, rounded          | Kids content                       |
+| `technical`  | Clean, annotated, precise                 | Product demos, tutorials           |
+
+---
+
+## Aspect Ratios
+
+| Ratio    | Dimensions  | Use Case                         |
+| -------- | ----------- | -------------------------------- |
+| `16:9`   | Widescreen  | Video, YouTube, presentations    |
+| `4:3`    | Traditional | Classic film, some presentations |
+| `1:1`    | Square      | Social media, Instagram          |
+| `9:16`   | Vertical    | TikTok, Stories, Reels           |
+| `2.35:1` | Anamorphic  | Cinematic widescreen             |
+
+---
+
+## Shot Types
+
+Specify shot types in your description for precise framing:
+
+| Shot                | Description                          | Emotional Effect            |
+| ------------------- | ------------------------------------ | --------------------------- |
+| `wide/establishing` | Full environment, tiny figures       | Context, scale, isolation   |
+| `medium`            | Waist up, some environment           | Conversation, action        |
+| `close-up`          | Face or object fills frame           | Emotion, detail, importance |
+| `extreme close-up`  | Eyes, hands, small detail            | Intensity, intimacy         |
+| `over-shoulder`     | Behind one character, facing another | Dialogue, connection        |
+| `bird's eye`        | Directly above                       | Overview, vulnerability     |
+| `low angle`         | Looking up at subject                | Power, dominance            |
+| `high angle`        | Looking down at subject              | Weakness, submission        |
+| `POV`               | Character's viewpoint                | Immersion, subjectivity     |
+
+**Example prompt with shots:**
+
+```
+Frame 1: Wide shot - City skyline at sunset, small figure on rooftop
+Frame 2: Medium shot - Character turns, looking worried
+Frame 3: Close-up - Phone screen showing message
+Frame 4: Over-shoulder - Character reading, city blurred behind
+```
+
+---
+
+## Panel Layouts
+
+| Layout     | Description                | Frames              |
+| ---------- | -------------------------- | ------------------- |
+| `grid`     | Even grid arrangement      | Any (auto-arranges) |
+| `strip`    | Single horizontal row      | 3-6 frames          |
+| `vertical` | Single vertical column     | 3-6 frames          |
+| `featured` | One large + smaller panels | 4-6 frames          |
+| `single`   | Individual images only     | Any                 |
+
+---
+
+## Use Cases
+
+### Video Production
+
+```bash
+# Commercial storyboard
+/generate-storyboard Product unboxing: hands open box, reveal product, show features, happy customer using it --frames=6 --style=cinematic --aspect=16:9
+
+# Music video
+/generate-storyboard Singer in empty warehouse, dancing, memories flash, reunites with loved one --frames=8 --style=noir --timing
+```
+
+### UX/Product Flows
+
+```bash
+# User journey
+/generate-storyboard User discovers app, signs up, completes first task, shares achievement --frames=4 --style=minimalist --aspect=1:1
+
+# Feature explainer
+/generate-storyboard Problem: messy desk. Solution: our app. Result: organized life --frames=3 --style=technical
+```
+
+### Marketing/Social
+
+```bash
+# Social campaign
+/generate-storyboard Day in the life with our coffee: morning routine, commute, work meeting, evening relaxation --frames=4 --style=watercolor --aspect=9:16
+
+# Brand story
+/generate-storyboard Founder's journey: garage startup, first customer, team growth, today's success --frames=6 --style=sketch
+```
+
+### Animation Planning
+
+```bash
+# Character animation
+/generate-storyboard Character walks in, sees something surprising, reacts with joy, celebrates --frames=4 --style=animation
 
-## Styles
+# Explainer video
+/generate-storyboard Complex data enters system, gets processed, outputs simple insights --frames=5 --style=minimalist
+```
 
-- **comic**: Bold lines, panels, speech bubbles
-- **realistic**: Photo-realistic scenes
-- **sketch**: Hand-drawn, rough storyboard style
+---
+
+## Maintaining Consistency
+
+### Character Consistency
+
+Include character details in your prompt:
+
+```
+Main character: Young woman, short black hair, red jacket, determined expression
+Setting: Rainy city at night, neon signs, wet streets
+```
+
+### Consistency Tips
+
+1. **Define characters first**: Age, hair, clothing, distinguishing features
+2. **Establish setting**: Time of day, weather, key environmental elements
+3. **Maintain color palette**: Specify dominant colors to carry through
+4. **Reference previous frames**: "Same character from frame 1..."
+5. **Use consistent lighting**: Define light source direction
+
+---
+
+## Transitions & Timing
+
+Use `--timing` to add duration annotations:
+
+| Transition | Symbol | Description          |
+| ---------- | ------ | -------------------- | --------------- |
+| Cut        | `→`    | Instant switch       |
+| Fade       | `~>`   | Gradual transition   |
+| Dissolve   | `<~>`  | Blend between frames |
+| Wipe       | `      | >`                   | Edge transition |
+
+**Example output with timing:**
+
+```
+Frame 1 (3s) → Frame 2 (2s) ~> Frame 3 (4s) → Frame 4 (2s)
+```
+
+---
 
-## Process
+## Captions & Dialogue
 
-1. Break story into key moments
-2. Maintain visual consistency (characters, settings)
-3. Generate each frame with clear narrative progression
-4. Number frames sequentially
+Include dialogue or narration:
+
+```bash
+/generate-storyboard Scene: coffee shop meeting
+Frame 1: "Two old friends spot each other" - wide shot, recognition
+Frame 2: "They haven't seen each other in years" - medium, approaching
+Frame 3: "Warm embrace" - close-up, emotional hug
+Frame 4: "Just like old times" - sitting, laughing, coffee cups
+```
+
+---
 
 ## Output
 
-Save to `.opencode/memory/design/storyboards/<story-name>/`:
+### File Structure
+
+```
+.opencode/memory/design/storyboards/[story-name]/
+├── frames/
+│   ├── 01-establishing.png
+│   ├── 02-introduction.png
+│   ├── 03-conflict.png
+│   └── 04-resolution.png
+├── storyboard-sheet.png      # Combined layout
+├── storyboard-sheet.pdf      # Print-ready
+└── script.md                 # Scene descriptions + timing
+```
+
+### Script Output
+
+```markdown
+# Storyboard: [Story Name]
+
+## Frame 1 - Establishing Shot
+
+**Duration:** 3 seconds
+**Shot:** Wide
+**Description:** City skyline at sunset, small figure visible on rooftop
+**Audio:** Ambient city sounds, distant traffic
+**Transition:** Cut to →
+
+## Frame 2 - Introduction
+
+**Duration:** 2 seconds
+**Shot:** Medium
+**Description:** Character turns, worried expression
+**Dialogue:** (thinking) "Where is she?"
+**Transition:** Fade to ~>
+```
+
+---
+
+## Limitations
+
+| Limitation                    | Workaround                                                 |
+| ----------------------------- | ---------------------------------------------------------- |
+| Perfect character consistency | Include detailed character description; may need touch-ups |
+| Exact pose matching           | Describe poses clearly; use reference terms                |
+| Complex action sequences      | Break into more frames                                     |
+| Text/dialogue in image        | Add text in post-processing                                |
+| Specific brand elements       | Describe style, add logos later                            |
+
+---
 
-- Individual frame images (01.png, 02.png, etc.)
-- Combined storyboard sheet
-- Scene descriptions text file
+## Related Commands
 
-Report generated sequence.
+| Need                  | Command             |
+| --------------------- | ------------------- |
+| Generate single image | `/generate-image`   |
+| Edit a frame          | `/edit-image`       |
+| Create diagram        | `/generate-diagram` |
+| Analyze reference     | `/analyze-mockup`   |