@hienlh/ppm 0.9.80 → 0.9.81

package/.opencode/skills/ai-artist/references/image-prompting.md

@@ -0,0 +1,141 @@
+# Image Generation Prompting
+
+## Universal Structure
+```
+[Subject + Details] [Action/Pose] [Setting/Environment]
+[Style/Medium] [Artist/Movement Reference]
+[Lighting] [Camera/Lens] [Composition]
+[Quality Modifiers] [Aspect Ratio]
+```
+
+## Platform Reference
+
+### Midjourney v6.1
+```
+[prompt] --ar 16:9 --style raw --v 6.1
+```
+
+| Parameter | Values | Effect |
+|-----------|--------|--------|
+| `--ar` | 1:1, 16:9, 9:16, 4:3, 3:2, 21:9 | Aspect ratio |
+| `--style` | raw, default | raw=photorealistic |
+| `--stylize` | 0-1000 | Artistic interpretation (0=literal) |
+| `--chaos` | 0-100 | Variation between outputs |
+| `--weird` | 0-3000 | Unusual/experimental elements |
+| `--quality` | .25, .5, 1, 2 | Detail level (cost) |
+| `--seed` | number | Reproducibility |
+| `--no` | [term] | Negative prompt inline |
+| `--tile` | - | Seamless patterns |
+
+**Multi-prompt weighting**: `cat::2 dog::1` (cat 2x stronger)
+**Describe**: Upload image → get prompt suggestions
+**Blend**: `/blend` to merge 2-5 images
+
+### DALL-E 3
+- Natural language only, no parameters
+- Be descriptive, not keyword-heavy
+- Specify: "HD quality" or "vivid style" in prompt
+- Text rendering: Describe font, placement, content explicitly
+- Avoid: Lists of keywords, technical jargon
+
+### Stable Diffusion / SDXL / Flux
+```
+(important term:1.3), normal term, (less important:0.8)
+Negative prompt: ugly, blurry, deformed, watermark
+```
+
+| Feature | Syntax |
+|---------|--------|
+| Weight up | `(word:1.2)` to `(word:1.5)` |
+| Weight down | `(word:0.5)` to `(word:0.8)` |
+| LoRA | `<lora:model_name:0.8>` |
+| Embedding | `embedding:name` |
+| Blend | `[cat|dog]` alternating |
+
+**CFG Scale**: 7-12 typical (higher=more prompt adherence)
+**Samplers**: DPM++ 2M Karras (quality), Euler a (speed)
+
+### Nano Banana (Gemini)
+```
+[Narrative description, not keywords]
+Captured with 85mm lens, soft bokeh, natural lighting
+```
+
+**Key features**:
+- 32K token context (complex prompts OK)
+- Narrative paragraphs > keyword lists
+- Hex colors for precision: `#9F2B68`
+- Text rendering: Describe font, placement explicitly
+- Multi-image: Up to 14 reference images
+- Search grounding: Real-time data (weather, events)
+- Thinking mode: Complex composition reasoning
+
+**Aspect ratios**: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
+**Resolution**: 1K, 2K, 4K (use uppercase K)
+
+**Best practices**:
+- ALL CAPS for critical requirements
+- Markdown lists for multiple rules
+- "NEVER include..." for negative constraints
+- Photography terms anchor quality
+
+### Imagen 4 / Veo 3.1
+- Natural language, descriptive
+- Aspect ratio in text: "16:9 landscape format"
+- Veo: Cinematography keywords most powerful
+- Camera movements: pan, tilt, dolly, crane, tracking
+- Scene transitions: cut, fade, dissolve
+
+## Style Keywords
+
+### Art Movements
+photorealistic, hyperrealistic, impressionist, expressionist,
+surrealist, art nouveau, art deco, pop art, cyberpunk, steampunk,
+solarpunk, vaporwave, synthwave, brutalist, minimalist
+
+### Media Types
+oil painting, watercolor, digital art, 3D render, vector art,
+pencil sketch, ink drawing, pastel, charcoal, gouache, fresco
+
+### Photography Styles
+portrait, landscape, macro, street, documentary, fashion,
+editorial, product, architectural, aerial, underwater
+
+## Lighting Vocabulary
+
+| Term | Effect |
+|------|--------|
+| Golden hour | Warm, soft, directional |
+| Blue hour | Cool, moody, twilight |
+| Rembrandt | Triangle on cheek, dramatic |
+| Butterfly | Shadow under nose, glamorous |
+| Split | Half face lit, mysterious |
+| Rim/back | Edge highlight, separation |
+| Volumetric | Light rays visible |
+| Neon glow | Colorful, cyberpunk |
+
+## Camera/Lens Terms
+- 50mm (standard), 85mm (portrait), 35mm (wide)
+- Telephoto (compressed), Macro (close-up), Fisheye (distorted)
+- Shallow DOF, Deep DOF, Bokeh
+- Low angle, High angle, Dutch angle, Bird's eye, Worm's eye
+
+## Composition Keywords
+rule of thirds, golden ratio, centered, symmetrical,
+leading lines, framing, negative space, filling frame,
+foreground interest, layered depth
+
+## Negative Prompts (SD/Flux)
+```
+ugly, deformed, blurry, low quality, bad anatomy,
+extra limbs, missing limbs, disfigured, watermark,
+text, signature, cropped, out of frame, duplicate,
+poorly drawn, bad proportions, gross proportions
+```
+
+## Iterative Workflow
+1. Start: Subject + style + quality modifier
+2. Add: Lighting + composition + camera
+3. Test: Generate 4 variations
+4. Refine: Adjust weights, add negatives
+5. Upscale: Select winner, increase resolution

package/.opencode/skills/ai-artist/references/llm-prompting.md

@@ -0,0 +1,165 @@
+# LLM Prompting Reference
+
+## Prompt Architecture
+
+### System Prompt Structure
+```
+You are [ROLE] with expertise in [DOMAIN].
+
+## Context
+[Background, constraints, tone]
+
+## Instructions
+[Step-by-step task breakdown]
+
+## Output Format
+[Exact structure with example]
+
+## Constraints
+- [Hard limits]
+- [Guardrails]
+```
+
+### User Prompt Structure
+```xml
+<context>[Background information]</context>
+<task>[Specific action required]</task>
+<format>[Output structure]</format>
+<constraints>[Additional limits]</constraints>
+```
+
+## Reasoning Techniques
+
+### Chain of Thought (CoT)
+| Variant | Trigger | Best For |
+|---------|---------|----------|
+| Zero-shot | "Think step by step" | Quick reasoning tasks |
+| Few-shot | 2-3 reasoning examples | Complex multi-step |
+| Auto-CoT | "Let's approach systematically" | General reasoning |
+
+### Tree of Thoughts (ToT)
+```
+Explore 3 approaches to [problem]:
+For each: 1) Method 2) Pros/cons 3) Success probability
+Evaluate branches, select best path.
+```
+
+### Self-Consistency
+Run same prompt 3-5x with temp=0.7, take majority answer. Best for: math, logic, factual.
+
+### ReAct Pattern
+```
+Thought: [Current reasoning]
+Action: [Tool/step to take]
+Observation: [Result]
+...repeat...
+Final Answer: [Conclusion]
+```
+
+### Least-to-Most
+```
+Break [complex task] into subproblems.
+Solve easiest first, build up.
+```
+
+## Instruction Optimization
+
+### Self-Refine Pattern
+```
+1. Generate initial response
+2. Critique: "What's wrong with this?"
+3. Refine: "Fix identified issues"
+4. Repeat until satisfactory
+```
+
+### Role Optimization
+- **Expert persona**: "As a senior [role] with 20 years..."
+- **Constraint persona**: "You only respond with..."
+- **Teaching persona**: "Explain as if to a..."
+
+### Task Decomposition
+```
+<subtasks>
+1. [First step - output X]
+2. [Second step - using X, output Y]
+3. [Final step - using Y, output Z]
+</subtasks>
+```
+
+## Output Control
+
+### JSON Enforcement
+```
+Respond in valid JSON only:
+{"field": "type", "required": true}
+No markdown, no explanation, just JSON.
+```
+
+### Length Control
+| Goal | Phrase |
+|------|--------|
+| Brief | "In 2-3 sentences" |
+| Detailed | "Comprehensive analysis in 500 words" |
+| Structured | "5 bullet points, max 20 words each" |
+
+### Hallucination Reduction
+- "Only use information from provided context"
+- "If unsure, say 'I don't know'"
+- "Cite sources for each claim"
+- "Confidence: high/medium/low for each point"
+
+## Model-Specific Tips
+
+### Claude
+- XML tags: `<thinking>`, `<answer>`, `<context>`
+- Extended thinking: "Think deeply before responding"
+- Prefill: Start assistant response to guide format
+
+### GPT-4
+- JSON mode: `response_format: {"type": "json_object"}`
+- Function calling for structured output
+- System message for persistent instructions
+
+### Gemini
+- Multimodal: Image + text in same prompt
+- Grounding: Enable Google Search for facts
+- Safety settings: Adjust thresholds
+
+## Context Engineering
+
+### RAG Prompt Pattern
+```
+<retrieved_context>
+[Document chunks with sources]
+</retrieved_context>
+
+Answer based ONLY on context above.
+If not in context, say "Not found in documents."
+```
+
+### Window Optimization
+- Front-load critical info (primacy effect)
+- Repeat key constraints at end (recency effect)
+- Chunk long documents with summaries
+
+## Few-Shot Examples
+
+### Structure
+```
+Example 1:
+Input: [representative input]
+Output: [ideal output]
+
+Example 2:
+Input: [edge case]
+Output: [handling]
+
+Now apply to:
+Input: [actual task]
+```
+
+### Selection Criteria
+- Diverse examples > similar examples
+- Include edge cases
+- Match complexity of target task
+- 2-5 examples optimal (diminishing returns beyond)

package/.opencode/skills/ai-artist/references/nano-banana-pro-examples.md

@@ -0,0 +1,132 @@
+# Nano Banana Pro Prompt Examples
+
+6,000+ curated prompts searchable via `--domain examples`. Source: [YouMind Gallery](https://youmind.com/en-US/nano-banana-pro-prompts)
+
+## Categories
+
+### Use Cases
+| Category | Search Keywords |
+|----------|----------------|
+| Profile/Avatar | avatar, profile pic, headshot, linkedin |
+| Social Media Post | instagram, twitter, social post |
+| Infographic | infographic, edu visual, diagram, chart |
+| YouTube Thumbnail | thumbnail, youtube, cover image |
+| Comic/Storyboard | comic, storyboard, panel, manga |
+| Product Marketing | product shot, marketing, hero image |
+| E-commerce | product main image, listing, catalog |
+| Game Asset | game asset, sprite, icon, character |
+| Poster/Flyer | poster, flyer, event, announcement |
+| App/Web Design | ui mockup, app screen, web design |
+
+### Styles
+| Style | Search Keywords |
+|-------|----------------|
+| Photography | photo, realistic, camera, lens |
+| Cinematic | film still, movie, cinematic |
+| Anime/Manga | anime, manga, japanese style |
+| Illustration | illustration, digital art, hand-drawn |
+| 3D Render | 3d, render, blender, c4d |
+| Chibi/Q-Style | chibi, cute, q-style, kawaii |
+| Isometric | isometric, 3d flat, diorama |
+| Pixel Art | pixel, 8-bit, retro game |
+| Oil Painting | oil painting, classical, brush |
+| Watercolor | watercolor, aquarelle, soft edges |
+| Ink/Chinese | ink wash, chinese painting, sumi-e |
+| Retro/Vintage | vintage, retro, 80s, 90s |
+| Cyberpunk | cyberpunk, neon, sci-fi |
+| Minimalism | minimal, clean, simple |
+
+### Subjects
+| Subject | Search Keywords |
+|---------|----------------|
+| Portrait/Selfie | portrait, selfie, face, headshot |
+| Character | character, hero, protagonist |
+| Product | product, item, object |
+| Food/Drink | food, drink, cuisine, beverage |
+| Animal | animal, pet, creature, wildlife |
+| Architecture | building, interior, architecture |
+| Landscape | landscape, nature, scenery |
+| Text/Typography | text, typography, lettering, font |
+
+## Search Examples
+
+```bash
+# Find quote card examples
+python3 .opencode/skills/ai-artist/scripts/search.py "quote card" --domain examples
+
+# Find avatar/profile prompts
+python3 .opencode/skills/ai-artist/scripts/search.py "avatar profile" --domain examples
+
+# Find infographic templates
+python3 .opencode/skills/ai-artist/scripts/search.py "bento grid infographic" --domain examples
+
+# Find YouTube thumbnail ideas
+python3 .opencode/skills/ai-artist/scripts/search.py "youtube thumbnail" --domain examples
+
+# Find product photography prompts
+python3 .opencode/skills/ai-artist/scripts/search.py "product marketing" --domain examples
+```
+
+## Featured Prompt Patterns
+
+### Quote Card Pattern
+```
+A [wide/square] quote card featuring [subject], with [background color] background
+and [font color] [font style] font for the quote: "[QUOTE]" and smaller text:
+"—[AUTHOR]." [Layout description]. [Visual effects].
+```
+
+### Bento Grid Infographic Pattern
+```
+Create a premium [style] Bento grid product infographic with [N] modules.
+Product: [name]. Language: [lang].
+M1 — Hero: Product displayed as [style]
+M2 — Core Benefits: [N] benefits + icons
+M3 — How to Use: [N] methods + icons
+M4 — Key Metrics: [exact data points]
+[Additional modules...]
+Output: 1 image, 16:9 landscape.
+```
+
+### Mirror Selfie Scene Pattern
+```
+### Scene
+[Environment description]
+### Subject
+* Gender/Age/Ethnicity
+* Body type/Skin tone
+* Hairstyle details
+* Pose description
+* Clothing details
+### Environment
+* Furnishings list
+* Color palette
+### Lighting
+* Source, quality, white balance
+### Camera
+* Mode, focal length, aperture
+```
+
+### Professional Headshot Pattern
+```
+Turn this [source] into a professional [platform] headshot.
+Background: [description]. Style: [clean/realistic/retouched].
+Lighting: [type]. Constraints: [preservation requirements].
+```
+
+## Raycast Snippet Syntax
+
+Dynamic arguments for reusable prompts:
+```
+{argument name="quote" default="Stay hungry, stay foolish"}
+{argument name="author" default="Steve Jobs"}
+{argument name="product" default="INVENTION"}
+```
+
+## Tips from Community
+
+1. **Specificity wins** — Describe exact layouts, colors, positions
+2. **Use modules** — Break complex scenes into numbered sections
+3. **Reference real styles** — "Apple/Braun aesthetic", "Pixar-style"
+4. **Camera settings** — Include lens, aperture, lighting for realism
+5. **Constraint lists** — Use bullet points for multiple requirements

package/.opencode/skills/ai-artist/references/nano-banana.md

@@ -0,0 +1,59 @@
+# Nano Banana (Gemini Image)
+
+## Models
+
+| Model ID | Type | Best For |
+|----------|------|----------|
+| `gemini-2.5-flash-image` | Flash | Speed, high-volume |
+| `gemini-3-pro-image-preview` | Pro | Text rendering, complex prompts |
+
+## Core Principle
+
+**Narrative paragraphs > keyword lists** (32K context). Write like briefing a photographer.
+
+## Parameters
+
+```python
+responseModalities=['TEXT', 'IMAGE']
+aspect_ratio="16:9"  # 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
+image_size="2K"      # 1K, 2K, 4K - MUST be uppercase K
+```
+
+## Prompt Templates
+
+**Photorealistic**: `A [subject] in [location], [lens] lens. [Lighting] creates [mood]. [Details]. [Camera angle]. Professional photography, natural lighting.`
+
+**Illustration**: `[Art style] illustration of [subject]. [Color palette]. [Line style]. [Background]. [Mood].`
+
+**Text in Image**: `Image with text "[EXACT]" in [font]. Font: [style]. Color: [hex/#FF5733]. Position: [top/center/bottom]. Background: [desc]. Context: [poster/sign].`
+
+**Product**: `[Product] on [surface]. Materials: [finish]. Lighting: [setup]. Camera: [angle]. Background: [type]. Style: [commercial/lifestyle].`
+
+## Techniques
+
+| Technique | Example |
+|-----------|---------|
+| Emphasis | `ALL CAPS` for critical requirements |
+| Precision colors | `#9F2B68` instead of "dark magenta" |
+| Negative constraints | `NEVER include text/watermarks. DO NOT add labels.` |
+| Realism trigger | `Natural lighting, DOF. Captured with Canon EOS 90D DSLR.` |
+| Structured edits | `Make ALL edits: - [1] - [2] - [3]` |
+| Complex logic | `Kittens MUST have heterochromatic eyes matching fur colors` |
+
+## Advanced Features
+
+**Multi-Image Input** (up to 14): 6 object + 5 human refs. Tip: collage refs into single image.
+
+**Search Grounding**: `tools=[{"google_search": {}}]` — real-time data (weather, charts, events).
+
+**Thinking Mode** (Pro only): `part.thought` in response for complex reasoning.
+
+## Workflow
+
+1. Narrative description → 2. Photography terms → 3. ALL CAPS emphasis → 4. Multi-turn refine → 5. Negative constraints → 6. Set ratio/resolution
+
+## Avoid
+
+- Keyword spam ("4k, trending, masterpiece")
+- Vague text ("add some text" → specify exact text, font, position)
+- Lowercase resolution ("4k" rejected, use "4K")

package/.opencode/skills/ai-artist/references/reasoning-techniques.md

@@ -0,0 +1,201 @@
+# Reasoning Techniques Deep Dive
+
+## Chain of Thought (CoT) Variants
+
+### Zero-Shot CoT
+```
+[Task description]
+
+Think step by step before answering.
+```
+**Use when**: Quick reasoning, no examples available
+**Effectiveness**: +40-60% on reasoning tasks
+
+### Few-Shot CoT
+```
+Example 1:
+Q: [Question]
+A: Let me think through this...
+   Step 1: [Reasoning]
+   Step 2: [Reasoning]
+   Therefore: [Answer]
+
+Example 2:
+Q: [Question]
+A: Breaking this down...
+   First: [Reasoning]
+   Next: [Reasoning]
+   So: [Answer]
+
+Now solve:
+Q: [Your question]
+```
+**Use when**: Complex reasoning, pattern demonstration needed
+**Effectiveness**: +50-80% on complex tasks
+
+### Auto-CoT
+```
+Let me approach this systematically:
+1. Identify the key elements
+2. Analyze relationships
+3. Apply relevant principles
+4. Draw conclusions
+5. Verify my reasoning
+```
+**Use when**: General problem-solving, exploratory reasoning
+
+## Tree of Thoughts (ToT)
+
+### Implementation Pattern
+```
+Problem: [Complex problem]
+
+Generate 3 different approaches:
+
+Approach A:
+- Method: [Description]
+- Reasoning: [Why this might work]
+- Potential issues: [Risks]
+- Confidence: [1-10]
+
+Approach B:
+- Method: [Description]
+- Reasoning: [Why this might work]
+- Potential issues: [Risks]
+- Confidence: [1-10]
+
+Approach C:
+- Method: [Description]
+- Reasoning: [Why this might work]
+- Potential issues: [Risks]
+- Confidence: [1-10]
+
+Evaluate branches:
+- Which has highest success probability?
+- Which has fewest risks?
+- Which is most feasible?
+
+Selected approach: [Best option with justification]
+Execution: [Step-by-step implementation]
+```
+
+**Use when**: Strategic decisions, multiple valid paths, high-stakes problems
+
+## Self-Consistency
+
+### Process
+1. Generate 5 responses at temp=0.7
+2. Extract final answers from each
+3. Take majority vote
+4. Report confidence = agreement %
+
+### Implementation
+```
+Run this prompt 5 times (or use n=5 parameter):
+[Your reasoning task]
+Think step by step and provide final answer.
+
+Aggregate: If 4/5 agree = high confidence
+          If 3/5 agree = medium confidence
+          If split = low confidence, needs review
+```
+
+**Use when**: Math, logic, factual questions with verifiable answers
+
+## ReAct (Reasoning + Acting)
+
+### Full Pattern
+```
+Task: [Goal to achieve]
+
+Thought 1: I need to understand the current situation.
+Action 1: [Observation or tool use]
+Observation 1: [Result from action]
+
+Thought 2: Based on this, I should [next logical step].
+Action 2: [Next action]
+Observation 2: [Result]
+
+Thought 3: Now I can see that [insight].
+Action 3: [Verification or next step]
+Observation 3: [Result]
+
+Thought 4: I have enough information to conclude.
+Final Answer: [Conclusion with reasoning]
+```
+
+**Use when**: Tool-augmented reasoning, research tasks, multi-step analysis
+
+## Least-to-Most Prompting
+
+### Structure
+```
+Complex problem: [Full problem statement]
+
+Step 1: Decomposition
+Break this into simpler subproblems, ordered from easiest to hardest:
+1. [Simplest subproblem]
+2. [Next subproblem, may depend on 1]
+3. [Harder subproblem, may depend on 1,2]
+4. [Final subproblem requiring all above]
+
+Step 2: Sequential Solution
+Subproblem 1: [Solution]
+Using result from 1, Subproblem 2: [Solution]
+Using results from 1,2, Subproblem 3: [Solution]
+Using all results, Subproblem 4: [Solution]
+
+Final integrated answer: [Complete solution]
+```
+
+**Use when**: Mathematical word problems, multi-step procedures, compositional tasks
+
+## Decomposed Prompting (DECOMP)
+
+### Pattern
+```
+Task: [Complex task]
+
+Required capabilities:
+- [Capability 1]: Use [specialized prompt/tool]
+- [Capability 2]: Use [specialized prompt/tool]
+- [Capability 3]: Use [specialized prompt/tool]
+
+Orchestration:
+1. Call [Capability 1] with [input] → get [output1]
+2. Call [Capability 2] with [output1] → get [output2]
+3. Call [Capability 3] with [output2] → get [final output]
+
+Integrate results: [Final response]
+```
+
+**Use when**: Tasks requiring diverse expertise, specialized sub-tasks
+
+## Constitutional AI Reasoning
+
+### Self-Critique Pattern
+```
+Initial response: [Generated content]
+
+Critique against principles:
+- Is it helpful? [Yes/No + reasoning]
+- Is it harmless? [Yes/No + reasoning]
+- Is it honest? [Yes/No + reasoning]
+
+If any No:
+Revised response that addresses [specific issues]:
+[Improved content]
+```
+
+## Choosing the Right Technique
+
+| Task Type | Best Technique |
+|-----------|---------------|
+| Simple reasoning | Zero-shot CoT |
+| Complex multi-step | Few-shot CoT |
+| Strategic decisions | Tree of Thoughts |
+| Factual verification | Self-Consistency |
+| Tool-using tasks | ReAct |
+| Word problems | Least-to-Most |
+| Specialized sub-tasks | DECOMP |
+| Safety-critical | Constitutional AI |