cue-ai 0.9.2 → 0.9.3

package/resources/skills/skills/design/banana/references/gemini-models.md

@@ -0,0 +1,236 @@
+# Gemini Image Generation Models
+
+> Last updated: 2026-03-19
+> Aligned with Google's March 2026 API state
+
+## Available Models
+
+### gemini-3.1-flash-image-preview -- Nano Banana 2 (DEFAULT)
+| Property | Value |
+|----------|-------|
+| **Model ID** | `gemini-3.1-flash-image-preview` |
+| **Tier** | Nano Banana 2 (Flash) |
+| **Status** | Preview -- **Active, recommended default** |
+| **Speed** | Fast -- optimized for high-volume use |
+| **Aspect Ratios** | All 14 ratios including extreme: 1:4, 4:1, 1:8, 8:1 (see table below) |
+| **Max Resolution** | Up to 4096×4096 (4K tier) |
+| **Input Tokens** | 131,072 |
+| **Features** | Google Search grounding (web + image), thinking levels, image-only output, extreme aspect ratios |
+| **Rate Limits (Free)** | ~5-15 RPM / ~20-500 RPD (per project, resets midnight Pacific. Cut ~92% Dec 2025) |
+| **Output Tokens** | ~1,290 output tokens per image |
+| **Best For** | All standard production generation and editing -- most use cases |
+
+### gemini-2.5-flash-image -- Nano Banana (Original)
+| Property | Value |
+|----------|-------|
+| **Model ID** | `gemini-2.5-flash-image` |
+| **Tier** | Nano Banana (Flash, original generation) |
+| **Status** | GA -- **Active** |
+| **Speed** | Fast |
+| **Aspect Ratios** | 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2, 4:5, 5:4, 21:9 (10 ratios) |
+| **Max Resolution** | Up to 1024×1024 (1K tier) |
+| **Input Tokens** | 32,768 |
+| **Rate Limits (Free)** | ~5-15 RPM / ~20-500 RPD |
+| **Best For** | Free-tier users, budget-conscious high-volume workflows, 1K-resolution use cases |
+| **Cost** | ~$0.039/image at 1K |
+
+## ⛔ DEPRECATED -- Nano Banana Pro (gemini-3-pro-image-preview)
+
+<!-- REMOVED 2026-03-19: gemini-3-pro-image-preview shut down by Google March 9, 2026 -->
+
+**Shut down by Google on March 9, 2026.** API calls to this model ID will fail
+with a hard error. Do not use. The replacement is Nano Banana 2
+(`gemini-3.1-flash-image-preview`).
+
+**Was:** Nano Banana Pro tier -- professional asset production, 4K output, 14 reference images, 94% text accuracy.
+
+**Migration:** Replace all references to `gemini-3-pro-image-preview` with `gemini-3.1-flash-image-preview`.
+
+## Deprecated Models (DO NOT USE)
+
+### gemini-2.0-flash-exp
+- **Status:** Deprecated, replaced by gemini-2.5-flash-image
+
+## Domain-to-Model Routing
+
+| Domain Mode | Recommended Model | Reason |
+|---|---|---|
+| Cinema, Landscape, Abstract | Nano Banana 2 | Thinking mode improves complex compositions |
+| Product, Portrait | Nano Banana 2 | 2K/4K resolution for fidelity |
+| UI, Infographic | Nano Banana 2 | Search grounding for factual diagrams |
+| Logo | Nano Banana 2 | Text rendering improvements in 3.1 |
+| Editorial | Nano Banana 2 | Default |
+| Free tier / budget | Nano Banana (original) | $0.039/image, still excellent |
+
+## Resolution Defaults by Domain
+
+| Domain | Default `imageSize` | Rationale |
+|--------|-------------------|-----------|
+| Portrait, Product, Logo | `2K` | Fine detail and text fidelity |
+| Cinema, Landscape | `2K` + widescreen ratio | Atmospheric depth at larger canvas |
+| UI, Infographic | `1K` | Structured output doesn't benefit from 4K |
+| Quick draft / preview | `512` (Nano Banana 2 only) | Rapid iteration |
+| Print / high fidelity | `4K` | Maximum resolution for physical output |
+
+## Aspect Ratios
+
+All 14 supported ratios. Availability varies by model:
+
+| Ratio | Orientation | Use Cases | NB2 (3.1 Flash) | NB (2.5 Flash) |
+|-------|-------------|-----------|:----------------:|:--------------:|
+| `1:1` | Square | Social posts, avatars, thumbnails | ✅ | ✅ |
+| `16:9` | Landscape | Blog headers, YouTube thumbnails, presentations | ✅ | ✅ |
+| `9:16` | Portrait | Stories, Reels, TikTok, mobile | ✅ | ✅ |
+| `4:3` | Landscape | Product shots, classic display | ✅ | ✅ |
+| `3:4` | Portrait | Book covers, portrait framing | ✅ | ✅ |
+| `2:3` | Portrait | Pinterest pins, posters | ✅ | ✅ |
+| `3:2` | Landscape | DSLR standard, photo prints | ✅ | ✅ |
+| `4:5` | Portrait | Instagram portrait, social | ✅ | ✅ |
+| `5:4` | Landscape | Large format photography | ✅ | ✅ |
+| `21:9` | Ultra-wide | Cinematic, film-grade, ultra-wide monitors | ✅ | ✅ |
+| `1:4` | Tall strip | Vertical banners, side panels | ✅ | ❌ |
+| `4:1` | Wide strip | Website banners, headers | ✅ | ❌ |
+| `1:8` | Extreme tall | Narrow vertical strips | ✅ | ❌ |
+| `8:1` | Extreme wide | Ultra-wide banners | ✅ | ❌ |
+
+## Resolution Tiers
+
+Control output resolution with the `imageSize` parameter. Note the **UPPERCASE** requirement -- lowercase values are silently rejected.
+
+| `imageSize` Value | Pixel Range | Model Availability | Use Case |
+|-------------------|-------------|-------------------|----------|
+| `512` | Up to 512×512 | Nano Banana 2 only | Drafts, quick iteration, low bandwidth |
+| `1K` | Up to 1024×1024 | All models | Standard web use, social media |
+| `2K` | Up to 2048×2048 | Nano Banana 2 only | Quality assets, detailed work |
+| `4K` | Up to 4096×4096 | Nano Banana 2 only | Print production, hero images, final assets |
+
+**Notes:**
+- Actual pixel dimensions depend on aspect ratio (e.g., 4K at 16:9 = 4096×2304)
+- Higher resolutions consume more tokens and cost more
+- The API default is `1K` if `imageSize` is omitted. The banana skill defaults to `2K` -- always pass `imageSize` explicitly
+- `imageSize` value MUST be uppercase -- `"2k"` will be silently ignored
+
+## API Configuration
+
+### Endpoint
+```
+https://generativelanguage.googleapis.com/v1beta/models/{model-id}:generateContent
+```
+
+### Required Parameters
+```json
+{
+  "contents": [{"parts": [{"text": "your prompt here"}]}],
+  "generationConfig": {
+    "responseModalities": ["TEXT", "IMAGE"],
+    "imageConfig": {
+      "aspectRatio": "16:9",
+      "imageSize": "2K"
+    }
+  }
+}
+```
+
+### Image-Only Output Mode
+Force the model to return only an image (no text response):
+```json
+{
+  "generationConfig": {
+    "responseModalities": ["IMAGE"]
+  }
+}
+```
+
+### Thinking Level
+Control how much the model "thinks" before generating. Higher levels improve complex compositions but increase latency:
+```json
+{
+  "generationConfig": {
+    "thinkingConfig": {
+      "thinkingLevel": "medium"
+    }
+  }
+}
+```
+Levels: `minimal`, `low`, `medium`, `high`
+
+### Google Search Grounding
+Ground generation in real-world visual references. Supports web and image search (Nano Banana 2):
+```json
+{
+  "tools": [{"googleSearch": {}}]
+}
+```
+**Prompt pattern:** `[Search/source request] + [Analytical task] + [Visual translation]`
+
+Example: "Search for the latest SpaceX Starship design, analyze its proportions and markings, then generate a photorealistic image of it at sunset on the launch pad."
+
+### Multi-Image Input
+Up to 14 reference images can be provided:
+- **10 object references** -- for style, composition, or visual matching
+- **4 character references** -- assign distinct names to preserve features across generations
+
+Useful for character consistency, style transfer, and brand-aligned generation.
+
+## Rate Limits by Tier
+
+| Tier | RPM | RPD | Notes |
+|------|-----|-----|-------|
+| Free | ~5-15 | ~20-500 | Per project, resets midnight Pacific. Cut ~92% Dec 2025. |
+| Tier 1 (billing enabled) | 150-300 | 1,500-10,000 | Production workloads |
+| Tier 2 ($250+ spend) | 1,000+ | Unlimited | High-volume |
+| Enterprise | Custom | Custom | Contact Google |
+
+## Pricing
+
+| Model | Resolution | Cost per Image | Notes |
+|-------|-----------|---------------|-------|
+| NB2 (3.1 Flash) | 1K | ~$0.067 | Standard |
+| NB2 (3.1 Flash) | 2K | ~$0.134 | 2x standard |
+| NB2 (3.1 Flash) | 4K | ~$0.268 | 4x standard |
+| NB (2.5 Flash) | 1K | ~$0.039 | Previous gen, budget option |
+| Batch API | Any | 50% discount | Asynchronous, higher latency |
+
+Pricing is approximate and based on ~1,290 output tokens per image.
+
+## Image Output Specs
+
+| Property | Value |
+|----------|-------|
+| **Format** | PNG |
+| **Max Resolution** | Up to 4096×4096 (4K tier, Nano Banana 2) |
+| **Color Space** | sRGB |
+| **Text Rendering** | Supported -- excellent under 25 characters |
+| **Style Control** | Via prompt engineering |
+
+## Safety Filters
+
+Gemini uses a two-layer safety architecture:
+
+1. **Input filters** -- block prompts containing prohibited content before generation
+2. **Output filters** -- analyze generated images and block unsafe results
+
+| `finishReason` | Meaning | Retryable? |
+|----------------|---------|:----------:|
+| `STOP` | Successful generation | N/A |
+| `IMAGE_SAFETY` | Output blocked by safety filter | Rephrase prompt |
+| `PROHIBITED_CONTENT` | Content policy violation | No -- topic is blocked |
+| `SAFETY` | General safety block | Rephrase prompt |
+| `RECITATION` | Detected copyrighted content | Rephrase prompt |
+
+**Known issue:** Filters are known to be overly cautious -- benign prompts may be blocked. Iterate with rephrased wording if this happens.
+
+## Content Credentials
+
+- **SynthID watermarks** are always embedded in generated images (invisible, machine-readable)
+- **C2PA metadata** is included on paid outputs (verifiable provenance chain)
+
+## Key Limitations
+- No video generation (image only)
+- No transparent backgrounds (PNG but always with background -- use green screen workaround)
+- Text rendering quality varies -- keep text under 25 characters for best results
+- Safety filters may block some prompts (violence, NSFW, public figures) -- known to be overly cautious
+- Session context resets between Claude Code conversations
+- `imageSize` values MUST be uppercase -- lowercase fails silently
+- Gemini generates ONE image per API call -- no batch parameter exists
+- No negative prompt parameter -- use semantic reframing instead

package/resources/skills/skills/design/banana/references/mcp-tools.md

@@ -0,0 +1,145 @@
+# MCP Tools Reference -- @ycse/nanobanana-mcp
+
+> Package: `@ycse/nanobanana-mcp`
+> GitHub: https://github.com/YCSE/nanobanana-mcp
+
+## Tools
+
+### gemini_generate_image
+Generate an image from a text prompt.
+
+**Parameters:**
+| Param | Type | Required | Description |
+|-------|------|----------|-------------|
+| `prompt` | string | Yes | Text description of the image to generate |
+
+**Returns:** Image data + file path (saved to `~/Documents/nanobanana_generated/`)
+
+**Example usage in Claude Code:**
+```
+User: "Generate a sunset over mountains in watercolor style"
+→ Claude calls gemini_generate_image with prompt
+→ Returns image path and description
+```
+
+### gemini_edit_image
+Edit an existing image with text instructions.
+
+**Parameters:**
+| Param | Type | Required | Description |
+|-------|------|----------|-------------|
+| `imagePath` | string | Yes | Path to the image file to edit |
+| `prompt` | string | Yes | Edit instructions |
+
+**Returns:** Modified image data + file path
+
+**Example:**
+```
+User: "Remove the background from ~/Documents/photo.png"
+→ Claude calls gemini_edit_image with path and instruction
+```
+
+### gemini_chat
+Multi-turn visual conversation maintaining session context.
+
+**Parameters:**
+| Param | Type | Required | Description |
+|-------|------|----------|-------------|
+| `message` | string | Yes | Chat message (can reference previous images) |
+
+**Returns:** Text response + optional image
+
+**Key feature:** Session consistency -- maintains style, characters, and context across turns. Great for iterative refinement.
+
+### set_aspect_ratio
+Configure the aspect ratio for subsequent image generations.
+
+**Parameters:**
+| Param | Type | Required | Description |
+|-------|------|----------|-------------|
+| `ratio` | string | Yes | Aspect ratio (e.g., "16:9", "1:1", "9:16") |
+
+**Supported ratios:** 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2, 4:5, 5:4, 1:4, 4:1, 1:8, 8:1, 21:9
+
+### set_model
+Switch the active Gemini model.
+
+**Parameters:**
+| Param | Type | Required | Description |
+|-------|------|----------|-------------|
+| `model` | string | Yes | Model identifier |
+
+**Available models:**
+- `gemini-3.1-flash-image-preview` (default, recommended -- Nano Banana 2)
+- `gemini-2.5-flash-image` (stable fallback -- Nano Banana original)
+<!-- REMOVED 2026-03-19: gemini-3-pro-image-preview shut down by Google March 9, 2026. Do not use. -->
+
+### get_image_history
+Retrieve list of images generated in the current session.
+
+**Parameters:** None
+
+**Returns:** Array of image entries with paths and prompts
+
+### clear_conversation
+Reset session context and conversation history.
+
+**Parameters:** None
+
+**Returns:** Confirmation of reset
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `GOOGLE_AI_API_KEY` | Yes | API key from https://aistudio.google.com/apikey |
+| `NANOBANANA_MODEL` | No | Override default model (default: `gemini-3.1-flash-image-preview`) |
+
+## Output Directory
+All generated images are saved to: `~/Documents/nanobanana_generated/`
+
+Images are named with timestamps for easy identification.
+
+## Feature Availability via MCP
+
+Some newer Gemini API features depend on the MCP package version of `@ycse/nanobanana-mcp`. Check the package version to confirm support:
+
+| Feature | API Status | MCP Support |
+|---------|-----------|-------------|
+| `imageSize` (resolution control) | Available | Depends on package version |
+| Thinking level (`thinkingConfig`) | Available | Depends on package version |
+| Search grounding (`googleSearch`) | Available | Depends on package version |
+| Image-only output (`responseModalities: ["IMAGE"]`) | Available | Depends on package version |
+| Multi-image input (up to 14 refs) | Available | Via `gemini_chat` with image paths |
+| All 14 aspect ratios | Available | Via `set_aspect_ratio` |
+
+If a feature is not yet supported by the MCP package, you can still use it via direct API calls with the fallback scripts (`scripts/generate.py` and `scripts/edit.py`).
+
+## ImageConfig Parameter Reference
+
+| Parameter | Type | Valid values | Default | Critical notes |
+|---|---|---|---|---|
+| `aspect_ratio` | string | "1:1", "2:3", "3:2", "3:4", "4:3", "4:5", "5:4", "9:16", "16:9", "21:9", "1:4"*, "4:1"*, "1:8"*, "8:1"* | "1:1" | * = Nano Banana 2 only |
+| `image_size` | string | "512"*, "1K", "2K"*, "4K"* | "1K" | MUST be uppercase. "2k" silently fails. * = Nano Banana 2 only |
+| `person_generation` | string | "ALLOW_ALL", "ALLOW_ADULT", "ALLOW_NONE" | Varies | ALLOW_ALL restricted in EU/UK |
+
+## ❌ Parameters That Do NOT Exist for Gemini Image Models
+
+These are common copy-paste errors from Imagen or other model documentation.
+Passing them will not cause errors -- they will be silently ignored.
+
+- `numberOfImages` / `n` / `sampleCount` -- Gemini generates ONE image per call. These are Imagen-only. There is no batch parameter.
+- `negativePrompt` -- See prompt-engineering.md for the correct approach (semantic reframing).
+- `output_mime_type` -- Vertex AI only, not available in Gemini API.
+- `candidate_count` -- Only 1 supported for image models.
+- `seed` -- Not supported for reproducible generation.
+
+## Error Response Taxonomy
+
+| Error type | Cause | Correct response |
+|---|---|---|
+| HTTP 429 | Rate limit | Exponential backoff. Free tier: ~5-15 RPM. |
+| HTTP 400 FAILED_PRECONDITION | Billing not enabled | User must enable billing in Google AI Studio |
+| `finishReason: "IMAGE_SAFETY"` | Content policy block | Apply safety rephrase from prompt-engineering.md, retry once |
+| Empty `parts` in response | Wrong `response_modalities` | Must include "IMAGE" in responseModalities |
+| `thought_signature` missing | Multi-turn editing on Gemini 3 | Preserve this field from previous response for edit continuity |

package/resources/skills/skills/design/banana/references/post-processing.md

@@ -0,0 +1,192 @@
+# Post-Processing Pipeline Reference
+
+> Load this on-demand when the user needs image manipulation after generation.
+
+## Prerequisites
+
+Check availability before using:
+```bash
+which magick    # ImageMagick 7 (preferred)
+which convert   # ImageMagick 6 (fallback)
+which ffmpeg    # For video/animation
+```
+
+Install ImageMagick if not present: `sudo apt install imagemagick` (Debian/Ubuntu) or `brew install imagemagick` (macOS).
+
+## Common Operations
+
+### Resize for Platforms
+
+```bash
+# Instagram post (1080x1080)
+magick input.png -resize 1080x1080^ -gravity center -extent 1080x1080 instagram.png
+
+# Twitter/X header (1500x500)
+magick input.png -resize 1500x500^ -gravity center -extent 1500x500 twitter-header.png
+
+# YouTube thumbnail (1280x720)
+magick input.png -resize 1280x720^ -gravity center -extent 1280x720 youtube-thumb.png
+
+# LinkedIn banner (1584x396)
+magick input.png -resize 1584x396^ -gravity center -extent 1584x396 linkedin-banner.png
+
+# Favicon (multi-size ICO)
+magick input.png -resize 32x32 favicon.ico
+```
+
+### Background Removal (Transparency)
+
+```bash
+# Remove solid white background
+magick input.png -fuzz 10% -transparent white output.png
+
+# Remove solid color background (specify color)
+magick input.png -fuzz 15% -transparent "#F0F0F0" output.png
+
+# Clean edges after transparency (anti-alias)
+magick input.png -fuzz 10% -transparent white -channel A -blur 0x1 -level 50%,100% output.png
+
+# Auto-crop transparent padding
+magick input.png -trim +repage output.png
+```
+
+### Format Conversion
+
+```bash
+# PNG to WebP (web-optimized, smaller file)
+magick input.png -quality 85 output.webp
+
+# PNG to JPEG (with white background for transparency)
+magick input.png -background white -flatten -quality 90 output.jpg
+
+# PNG to AVIF (modern, smallest size)
+magick input.png -quality 80 output.avif
+
+# SVG trace (for logos -- requires potrace)
+potrace input.pbm -s -o output.svg
+```
+
+### Color Adjustments
+
+```bash
+# Increase contrast
+magick input.png -contrast-stretch 2%x1% output.png
+
+# Warm color temperature
+magick input.png -modulate 100,110,105 output.png
+
+# Cool color temperature
+magick input.png -modulate 100,90,95 output.png
+
+# Desaturate (muted colors)
+magick input.png -modulate 100,70,100 output.png
+
+# Convert to grayscale
+magick input.png -colorspace Gray output.png
+
+# Sepia tone
+magick input.png -sepia-tone 80% output.png
+```
+
+### Compositing
+
+```bash
+# Overlay watermark (bottom-right, 20% opacity)
+magick base.png watermark.png -gravity southeast -geometry +20+20 \
+  -compose dissolve -define compose:args=20 -composite output.png
+
+# Side-by-side comparison
+magick input1.png input2.png +append comparison.png
+
+# Vertical stack
+magick input1.png input2.png -append stack.png
+
+# Add padding/border
+magick input.png -bordercolor white -border 40 output.png
+
+# Add rounded corners
+magick input.png \( +clone -alpha extract -draw \
+  "roundrectangle 0,0,%[fx:w-1],%[fx:h-1],20,20" \) \
+  -alpha off -compose CopyOpacity -composite rounded.png
+```
+
+### Batch Processing
+
+```bash
+# Resize all PNGs in directory
+for f in ~/Documents/nanobanana_generated/*.png; do
+  magick "$f" -resize 800x800 "${f%.png}_thumb.png"
+done
+
+# Convert all to WebP
+for f in ~/Documents/nanobanana_generated/*.png; do
+  magick "$f" -quality 85 "${f%.png}.webp"
+done
+```
+
+## Animation (GIF/Video from Multiple Frames)
+
+```bash
+# Create GIF from multiple images
+magick -delay 100 frame1.png frame2.png frame3.png animation.gif
+
+# Create MP4 from image sequence
+ffmpeg -framerate 1 -pattern_type glob -i '*.png' \
+  -c:v libx264 -pix_fmt yuv420p slideshow.mp4
+```
+
+## Note on 4K Output
+
+With Gemini 3.1 Flash's `imageSize: "4K"` option (up to 4096×4096), many traditional
+upscaling post-processing steps are no longer necessary. If your target platform accepts
+images at or below 4K resolution, generate at native 4K instead of generating at 1K
+and upscaling. This produces better detail and avoids upscaling artifacts.
+
+## Green Screen Transparency Pipeline
+
+Gemini cannot generate transparent backgrounds. Use this workaround:
+
+### 1. Generate with green screen prompt
+
+Append to any prompt:
+```
+on a solid bright green (#00FF00) chroma key background
+with a thin white outline separating the subject from the background
+```
+
+### 2. Remove green screen (ImageMagick)
+
+```bash
+magick input.png -fuzz 20% -transparent "#00FF00" output.png
+```
+
+### 3. Clean edges + trim (ImageMagick)
+
+```bash
+magick output.png -channel A -blur 0x1 -level 50%,100% -trim +repage final.png
+```
+
+### 4. Alternative (FFmpeg, better for batch)
+
+```bash
+ffmpeg -i input.png -vf "colorkey=0x00FF00:0.3:0.1,despill=type=green" -pix_fmt rgba output.png
+```
+
+### Tips
+- `-fuzz 20%` handles slight color variations at edges; increase to 25% for softer edges
+- The white outline in the prompt helps prevent color spill on subject edges
+- For batch processing, the FFmpeg approach is faster and handles despill automatically
+- Always verify edges after conversion -- may need manual touchup for hair/fur
+
+## Quality Assessment
+
+```bash
+# Get image dimensions and info
+magick identify -verbose input.png | head -20
+
+# Check file size
+ls -lh input.png
+
+# Get exact pixel dimensions
+magick identify -format "%wx%h" input.png
+```

package/resources/skills/skills/design/banana/references/presets.md

@@ -0,0 +1,69 @@
+# Brand/Style Presets Reference
+
+> Load this on-demand when the user asks about presets or brand consistency.
+
+## Preset Schema
+
+Each preset is stored as `~/.banana/presets/NAME.json`:
+
+```json
+{
+  "name": "tech-saas",
+  "description": "Clean tech SaaS brand",
+  "colors": ["#2563EB", "#1E40AF", "#F8FAFC"],
+  "style": "clean minimal tech illustration, flat vectors, soft shadows",
+  "typography": "bold geometric sans-serif",
+  "lighting": "bright diffused studio, no harsh shadows",
+  "mood": "professional, trustworthy, modern",
+  "default_ratio": "16:9",
+  "default_resolution": "2K"
+}
+```
+
+## Example Presets
+
+### tech-saas
+- **Colors:** #2563EB, #1E40AF, #F8FAFC (blue + white)
+- **Style:** Clean minimal tech illustration, flat vectors, soft shadows
+- **Typography:** Bold geometric sans-serif
+- **Mood:** Professional, trustworthy, modern
+
+### luxury-brand
+- **Colors:** #1A1A1A, #C9A96E, #FAFAF5 (black + gold + cream)
+- **Style:** Elegant high-end photography, rich textures, deep contrast
+- **Typography:** Thin elegant serif, generous letter-spacing
+- **Mood:** Exclusive, sophisticated, aspirational
+
+### editorial-magazine
+- **Colors:** #000000, #FFFFFF, #FF3B30 (black + white + accent red)
+- **Style:** Bold editorial photography, strong geometric composition
+- **Typography:** Condensed all-caps sans-serif headlines
+- **Mood:** Bold, provocative, contemporary
+
+## How Presets Merge into Reasoning Brief
+
+When a preset is active, Claude uses its values as defaults for the Reasoning Brief:
+1. **Colors** → inform palette descriptions in Context and Style components
+2. **Style** → becomes the base for the Style component
+3. **Typography** → used for any text rendering
+4. **Lighting** → becomes the base for the Lighting component
+5. **Mood** → influences Action and Context components
+
+User instructions always override preset values. If a user says "make it dark"
+but the preset has bright lighting, follow the user's instruction.
+
+## Managing Presets
+
+```bash
+# List presets
+presets.py list
+
+# Show details
+presets.py show tech-saas
+
+# Create interactively (Claude fills in details from conversation)
+presets.py create NAME --colors "#hex,#hex" --style "..." --mood "..."
+
+# Delete
+presets.py delete NAME --confirm
+```