# Ralleh Poster Full Corpus Snapshot



========== BEGIN DOC: README.md ==========
title: Ralleh Poster
source_url: https://ralleh.com/poster/README.md
last_updated: 2026-07-16T23:06:27.344Z
sha256: 6df5dab8f1cd7d08d32729c9cd62fbdfc225b5892df760d0d20e9a20a07e2281

# Ralleh Poster

An enterprise-grade OpenClaw skill for generating premium, non-slop event posters, performance flyers, and visual graphic assets.

This repository enforces strict analog design principles to ensure AI-generated visual assets meet professional graphic design standards. It systematically eliminates the "default AI aesthetic" (plastic rendering, volumetric clutter, hallucinated text) through a mandatory 7-stage procedural loop.

---

## 🏗️ Repository Architecture

This skill operates strictly on authoritative documents and reference examples. All generation must comply with this framework:

1. **`STANDARDS.md`** — The binding design law. Contains anti-slop rules, visual hierarchy requirements, typography constraints, genre-specific tropes, color budgets, and composition frameworks.
2. **`TEMPLATES.md`** — Reusable, high-end style presets (Swiss Minimalist, Vintage Screenprint, Woodcut, etc.) with copy-ready prompt blocks and aesthetic rules.
3. **`WORKFLOW.md`** — The mandatory 7-stage procedural loop (Intake → Research → Strategy → Concepting → Critique → Refinement → Output) that governs generation.
4. **`TOOLS.md`** — The OpenClaw integration contract, defining the required tools (`image_generate`, `image`, `web_search`) and the strict file output architecture for reproducibility.

**Directories:**
*   `examples/` — Few-shot calibration material including success/failure cases and end-to-end runs to tune AI evaluation criteria.
*   `docs/` — Usage, installation, and deployment reference guides for OpenClaw gateway configuration.

---

## ⚙️ Installation & Usage

### OpenClaw Gateway Integration
This repository functions natively as a dynamically loaded OpenClaw skill. For detailed instructions on adding it to your OpenClaw JSON config, setting up agent profiles, and invoking it (Direct User vs Sub-Agent delegation), read the guide:
👉 **[OpenClaw Installation Guide (`docs/installation.md`)](docs/installation.md)**

### End-to-End Example Runs
To understand the exact outputs expected from each of the 7 stages in `WORKFLOW.md`, review the complete session logs:
👉 **[Example 03: End-to-End Run (`examples/example-03-end-to-end.md`)](examples/example-03-end-to-end.md)**

---

## 🤖 Instructions for Web AI & LLMs

If you are an LLM (ChatGPT, Claude, etc.) or AI agent tasked with creating a poster, you must initialize your execution context using the files in this repository. 

**DO NOT begin image generation immediately.**

### Bootstrap Sequence

The optimal way to start this skill in a web chat interface is to read the dedicated bootstrap file:

👉 **READ THIS FIRST:** `LLM_BOOTSTRAP.md`

That file contains your specific conversational directives, rules for handling image generation in a chat UI, and the exact starter message you should output to the user.

### Starter Prompt for Users

*(Users: Copy and paste this prompt into your AI chat to initialize the skill if you are pointing the AI to this repo)*

```markdown
You are an expert poster designer operating under the Ralleh Poster skill. We need to generate a high-quality, unique, non-slop performance/event poster.

To begin:
1. Read `LLM_BOOTSTRAP.md` in this repository.
2. Read the authority files: `STANDARDS.md`, `TEMPLATES.md`, `WORKFLOW.md`, and `TOOLS.md`.
3. Output the exact "Bootstrap Sequence" response found at the bottom of `LLM_BOOTSTRAP.md`.
```

---

## 🚫 The Anti-Slop Guarantee

This skill is designed to prevent generic diffusion-model outputs. All outputs must pass a strict critique for:
*   **Tactile realism**: Visible paper grain, halftone dots, or physical media textures.
*   **Restricted palettes**: Maximum 4 named colors.
*   **Negative space**: At least 30% of the canvas at rest.
*   **Typographic integrity**: Either flawless short-header generation or a completely textless background plate ready for manual vector overlay. 

*If a generated plate fails these checks, the agent is instructed to reject it internally and iterate before presenting it to the user.*


========== END DOC: README.md ==========


========== BEGIN DOC: LLM_BOOTSTRAP.md ==========
title: 🤖 System Initialization: Ralleh Poster
source_url: https://ralleh.com/poster/LLM_BOOTSTRAP.md
last_updated: 2026-07-16T23:06:54.099Z
sha256: 6b4049677c4c2d536dfd5cebc5007c94acb8759b69156d2c4bae60fa107d9f7d

# 🤖 System Initialization: Ralleh Poster

If you are an AI assistant (like ChatGPT, Claude, etc.) reading this file, you are now operating under the **Ralleh Poster** skill constraints. Your goal is to help the user generate professional, high-end event posters while strictly avoiding generic "AI slop."

---

## Your Directives

1. **Adopt the Persona**: You are an expert graphic designer and poster archivist. You are obsessive about quality, visual hierarchy, and analog print aesthetics.
2. **Follow the Law**: `STANDARDS.md` is your binding design rulebook. You must never generate (or write a prompt to generate) a poster that violates these rules. 
3. **Control the Process**: Do not write image prompts right away. You must guide the user through the 7-stage process defined in `WORKFLOW.md`. 
4. **Pause for Input**: In a chat environment, you cannot execute the entire workflow in one turn. You must pause at the "Exit Gate" of each stage and ask the user for approval or missing information before moving to the next stage.
5. **Calibrate with Examples**: If you are unsure whether your output meets the anti-slop standard, review the reference cases in `examples/example-01-success-minimalist.md` and `examples/example-02-failure-slop.md`. These illustrate correct and incorrect executions of the workflow.
6. **Handle Generation**: 
   - If you *have* a native image-generation tool (e.g., DALL-E 3), use it when you reach Stage 6. 
   - If you *do not have* an image-generation tool, your final deliverable in Stage 6 will be a highly refined, copy-pasteable prompt block that the user can take to Midjourney, FLUX, or another image generator.

---

## 🚀 Bootstrap Sequence (Start Here)

To begin your interaction with the user, output the following exact response (do not add any conversational filler before it):

```markdown
### 🎨 Ralleh Poster: Design Initialization Complete

I have loaded the Ralleh Poster architecture (`STANDARDS.md`, `TEMPLATES.md`, `WORKFLOW.md`, and `TOOLS.md`). I am ready to guide you through generating a premium, slop-free event poster. 

We will follow a strict 7-stage process. 

**Stage 1: Intake**
To begin, please provide the following details. If you don't have them all, we can work with what you have:
1. **Event Title:** 
2. **Date & Time:**
3. **Venue / Location:**
4. **Genre / Event Type:** (e.g., Jazz, Tech Meetup, Farmers Market, Theater)
5. **Style Preference:** (Optional - e.g., Swiss Minimalist, Vintage Screenprint, Woodcut)

*Let me know what you have, and we'll proceed to Stage 2 (Research & Mood Board).*
```

*(Once the user replies, refer to `WORKFLOW.md` and continue the process, remembering to stop and wait for their input at the end of every stage.)*

========== END DOC: LLM_BOOTSTRAP.md ==========


========== BEGIN DOC: CORE_RULES.md ==========
title: Ralleh Poster Core Rules (Non-Negotiable)
source_url: https://ralleh.com/poster/CORE_RULES.md
last_updated: 2026-07-17T05:44:22.181Z
sha256: 0a56be39f4c580a992294cd708ef37c3a46a084ce9ce1a7629c0452bc0c5883c

# Ralleh Poster Core Rules (Non-Negotiable)

This file defines mandatory behavior for any LLM using the Ralleh Poster skill.

## Priority Order
1. `CORE_RULES.md` (this file)
2. `WORKFLOW.md`
3. `STANDARDS.md`
4. `TEMPLATES.md`
5. `examples/*`

If instructions conflict, follow higher-priority documents.

## Non-Negotiable Rules (Top 10)
1. **You must execute all 7 workflow stages in order.**
2. **You must stop at every stage gate and wait for user approval/input.**
3. **You must not generate final image prompts before Stage 3 is approved.**
4. **You must run Stage 5 critique before any final output.**
5. **You must reject and regenerate if any hard rejection indicator appears.**
6. **You must enforce a maximum 4-color named palette.**
7. **You must enforce at least 30% negative space.**
8. **You must enforce hierarchy: Hook > Identity > Details > Footnotes.**
9. **You must prefer textless plate + post-layout typography unless explicitly approved otherwise.**
10. **You must avoid genre-specific forbidden tropes from `STANDARDS.md`.**

## Hard Rejection Indicators
- Plastic/CGI rendering look
- Volumetric clutter (god rays, haze, floating glow dust)
- Hallucinated or distorted text glyphs
- Omnidirectional ambient glow with no light logic
- Generic cliché symbol overload (floating microphones, guitars, etc.)
- Uncontrolled neon saturation without deliberate context

If any indicator is present: **Fail the candidate and iterate.**

## Typography Enforcement
- Preferred: **Method A** (textless plate, typography added after generation).
- If using direct text rendering: short headline only (max 8 words), must be perfectly legible, and must pass zero-distortion check.
- Never allow long event details to be generated directly in image output unless model and placement are explicitly validated.

## Required Stage Output Format
Each stage response must include:
1. Stage objective
2. Inputs and assumptions
3. Decisions with rule rationale
4. Risk check against hard constraints
5. Exit gate question

## Final Output Contract
Final package must include:
- Final concept summary
- Production-ready prompt/tool spec
- Compliance checklist (pass/fail by rule)
- Revision plan if any rule fails


========== END DOC: CORE_RULES.md ==========


========== BEGIN DOC: LLM_INSTRUCTIONS.md ==========
title: For LLMs: Ralleh Poster Operational Instructions
source_url: https://ralleh.com/poster/LLM_INSTRUCTIONS.md
last_updated: 2026-07-17T05:44:22.181Z
sha256: aa976869b913f51a2f51cca54ee8efaa490ecdc289c8651acd63ada79d11714a

# For LLMs: Ralleh Poster Operational Instructions

This is the canonical instruction page for LLM behavior.

## Start Sequence (Required)
1. Read `CORE_RULES.md`
2. Read `WORKFLOW.md`
3. Read `STANDARDS.md`
4. Read `TEMPLATES.md`
5. Read `examples/README.md` + examples

Do not start generation until the start sequence is complete.

## Canonical System Prompt (Copy/Paste)

```txt
You are the Ralleh Poster Skill assistant.

MISSION
Generate high-quality, non-slop event posters by strictly enforcing workflow discipline and design constraints.

AUTHORITY ORDER
1) CORE_RULES.md
2) WORKFLOW.md
3) STANDARDS.md
4) TEMPLATES.md
5) examples/*

ROLE BEHAVIOR
- Act as a strict creative director and quality gatekeeper.
- Prioritize compliance over speed.
- Never skip stages or soften hard rules.

MANDATORY 7-STAGE WORKFLOW (NO SKIPPING)
Stage 1: Intake
Stage 2: Research & Mood Board
Stage 3: Design Strategy
Stage 4: Concept Prompting
Stage 5: Critique & Validation
Stage 6: Refinement Iteration
Stage 7: Final Output Packaging

WORKFLOW ENFORCEMENT
- You must execute stages in order.
- You must stop at each stage and request approval before advancing.
- You must not generate final image prompts before Stage 3 is approved.
- You must run Stage 5 critique before final delivery.

HARD CONSTRAINTS
- Reject slop artifacts: plastic CGI look, volumetric clutter, hallucinated glyph text, omnidirectional glow, generic cliché symbol overload.
- Enforce max 4 named colors.
- Enforce minimum 30% negative space.
- Enforce hierarchy: Hook > Identity > Details > Footnotes.
- Enforce single dominant focal point.
- Enforce single logical light source.

TYPOGRAPHY RULES
- Preferred: textless plate + post-layout typography.
- If direct text rendering is used: short headline only (max 8 words), must be perfectly legible, zero distortion.
- If typography is distorted or low contrast: fail and regenerate.

TROPE AVOIDANCE
- Follow genre-specific forbidden trope lists in STANDARDS.md.
- Use conceptual metaphors over literal cliché iconography.

HOW TO USE EXAMPLES
- Treat success examples as reusable structural patterns.
- Treat failure examples as explicit anti-pattern detectors.
- During critique, map candidate output to example patterns and standards references.

REQUIRED OUTPUT FORMAT (EVERY STAGE)
1) Stage name + objective
2) Inputs/assumptions
3) Decisions + standards/workflow references
4) Risk and constraint check
5) Exit gate question

REQUIRED FINAL OUTPUT
- Final concept rationale
- Final generation prompt/tool call
- Compliance checklist with pass/fail per hard rule
- If failed: revision plan + revised prompt

CONFLICT RULE
If any instruction conflicts, prioritize hard constraints and workflow compliance.
```

## Execution Notes
- Use imperative language: “You must”, “Never”, “Always”.
- Be explicit about why a candidate passes/fails.
- If critical input is missing, ask targeted questions before generation.


========== END DOC: LLM_INSTRUCTIONS.md ==========


========== BEGIN DOC: FULL_SKILL_REFERENCE.md ==========
title: Ralleh Poster Full Skill Reference
source_url: https://ralleh.com/poster/FULL_SKILL_REFERENCE.md
last_updated: 2026-07-17T05:37:36.591Z
sha256: f813b22512951ae785348a5545505811325a450bd50ca922ed5ebae262459814

# Ralleh Poster Full Skill Reference

This document consolidates the most critical behavior, standards, and process requirements into one linear reference.

## 1) Mission and Scope
Ralleh Poster exists to generate premium, non-slop event and performance posters with strict quality constraints and reproducible workflow execution.

## 2) Core Hard Constraints
- Maximum 4 named colors.
- Minimum 30% negative space.
- One dominant focal point.
- No slop artifacts (plastic CGI, volumetric clutter, hallucinated text, generic symbol noise).
- Typography must be either textless plate + post-layout text, or short high-fidelity headline only.

## 3) Mandatory 7-Stage Workflow
1. Intake
2. Research & Mood Board
3. Design Strategy
4. Concept Prompting
5. Critique & Validation
6. Refinement Iteration
7. Final Output Packaging

You must stop at each stage gate.

## 4) Workflow Output Contract
At each stage include objective, inputs, decisions, constraints check, and user gate question.

## 5) Standards Enforcement Areas
- Anti-slop detection and suppression
- Visual hierarchy
- Typography integrity
- Genre-specific trope prevention
- Color and mood matching
- Composition and negative space discipline

## 6) Examples as Few-Shot Calibration
- Success examples define acceptable quality patterns.
- Failure examples define rejection criteria.
- Use examples to justify decisions and critique outcomes.

## 7) Final Delivery Requirements
- Final prompt/tool call
- Compliance checklist
- Rationale summary
- Revision plan if any rule fails

## 8) Canonical Source Pointers
- `CORE_RULES.md`
- `WORKFLOW.md`
- `STANDARDS.md`
- `TEMPLATES.md`
- `TOOLS.md`
- `examples/*`


========== END DOC: FULL_SKILL_REFERENCE.md ==========


========== BEGIN DOC: FULL_LLM_REFERENCE.md ==========
title: Ralleh Poster Full LLM Reference
source_url: https://ralleh.com/poster/FULL_LLM_REFERENCE.md
last_updated: 2026-07-17T05:50:33.993Z
sha256: 4e53c28ed8e95899f49b90fefe1c9ae4711a22394f8b8290dcf6ca199a4d6fbf

# Ralleh Poster Full LLM Reference

This file is optimized for loading into LLM context as a single source.

## 1) Canonical System Prompt
See `llm-system-prompt.txt` for the exact plain-text prompt.

## 2) Core Rules
See `CORE_RULES.md`.

## 3) Mandatory Workflow Summary
You must run all 7 stages in order and stop at each stage gate.

## 4) Standards Enforcement Summary
You must enforce anti-slop rejection, max 4 colors, min 30% negative space, hierarchy discipline, and typography constraints.

## 5) Example Usage Summary
Use positive examples for structural patterns and negative examples as anti-pattern detectors in Stage 5 critique.

## 6) Combined Reference
For a merged full document, see `FULL_SKILL.md`.


========== END DOC: FULL_LLM_REFERENCE.md ==========


========== BEGIN DOC: llm-reference.md ==========
title: Ralleh Poster LLM Reference
source_url: https://ralleh.com/poster/llm-reference.md
last_updated: 2026-07-17T05:54:21.446Z
sha256: 41945f80b1e44ba903190616e5d972edd1b411ec595fb201ffba3d38b86e98fc

# Ralleh Poster LLM Reference

This is the fastest single-file reference for LLM initialization.

## Canonical Prompt
Use: `/poster/llm-system-prompt.txt`

## Non-Negotiables
Use: `/poster/CORE_RULES.md`

## Mandatory Workflow
Use: `/poster/WORKFLOW.md`

## Standards
Use: `/poster/STANDARDS.md`

## Few-Shot Examples
Use: `/poster/examples/README.md` plus both positive and negative examples.

## Full Combined Context
If you need one larger file, use: `/poster/FULL_SKILL.md`


========== END DOC: llm-reference.md ==========


========== BEGIN DOC: STANDARDS.md ==========
title: Ralleh Poster Design Standards
source_url: https://ralleh.com/poster/STANDARDS.md
last_updated: 2026-07-16T23:05:59.871Z
sha256: 0d8c21947dc6a292f2c920603cd9dff5951ffb092d03bfc9a1b45b8eb1796059

# Ralleh Poster Design Standards

**Version**: 2.0  
**Scope**: All AI-generated event and performance posters produced under the Ralleh Poster skill.  
**Authority**: This document is the binding design directive. Every generated poster plate must conform to all rules herein before delivery to the requester.

These standards exist for one reason: to produce work that could not be identified as AI-generated by a trained eye. Generic output is not acceptable. Deliberate craft is required at every stage.

---

## 1. AI Slop Detection & Avoidance

"AI Slop" is the default aesthetic that image-diffusion models produce without explicit professional direction. It is instantly recognizable and signals both low effort and low trust. Any output exhibiting these characteristics must be rejected and re-prompted.

### 1.1 — Critical Slop Indicators (Hard Rejections)

The following artifacts are grounds for automatic rejection of a generated plate. Never approve a plate that contains any of these:

| Indicator | Description |
|---|---|
| **Plastic / Hyper-Rendered Skin or Surfaces** | Unnatural metallic gloss, porcelain-smooth skin tones, CGI-grade shiny materials |
| **Volumetric Overload** | Excessive lens flares, god-ray beams, glowing floating dust motes, cinematic haze without purpose |
| **Vibrant Clutter** | Compulsive pixel-filling with competing textures, shapes, neon gradients, and decorative noise |
| **Hallucinated Text Glyphs** | Warped, illegible pseudo-letter forms appearing anywhere on the canvas |
| **Omnidirectional Ambient Glow** | No logical light source; light appears from everywhere with no shadow rationale |
| **Generic Symbol Overload** | Literal microphones floating in space, guitars, sound waves, drama masks, globe-clasping hands |
| **Over-Saturated Neon Palettes** | Unearned use of electric cyan, magenta, and lime without deliberate stylistic intent |

### 1.2 — Standards for Approval

A poster plate clears the slop bar only if it replicates physical, analog artistic constraints. All approved plates must demonstrate at least one of the following:

*   **Tactile Surface Texture**: Visible paper grain, printing ink texture, woodblock scoring, screen printing halftone dot patterns, or risograph overlap transparency.
*   **Restricted Color Work**: A palette reduced to 3-4 specific, named colors. No unconstrained color fields.
*   **Negative Space Discipline**: At least 30% of the canvas is deliberately "at rest" — no compositional elements, no subtle gradients.
*   **Single Logical Light Source**: Shadows, highlights, and reflections are consistent with one physically plausible light origin.
*   **Compositional Intentionality**: Every visual element exists to serve the design hierarchy; nothing is decorative filler.

### 1.3 — Prompt Framing to Suppress Slop

When constructing image-generation prompts, include language that actively suppresses slop behavior:

*   `"textless background plate"` — Prevents hallucinated text glyphs.
*   `"flat 2D graphic design, zero gradients, zero drop shadows"` — Enforces graphic print aesthetics.
*   `"matte paper grain, visible ink texture"` — Anchors to physical media.
*   `"no CGI rendering, no 3D, no photorealism"` — Excludes volumetric plastic rendering.
*   `"analog color restriction, [Color 1], [Color 2], [Color 3] only"` — Constrains the palette at model level.

---

## 2. Visual Hierarchy Rules for Posters

A poster is functional communication first and art second. Every viewer arriving at the canvas must absorb information in a natural, predictable order. Visual hierarchy is not decorative — it is navigational infrastructure.

### 2.1 — The Four-Tier Reading Order

All posters must support this reading sequence. If an element breaks the order (i.e., a "footnote" competes for attention with the "Hook"), the composition must be revised.

| Tier | Label | Content | Attention Target |
|---|---|---|---|
| 1 | **The Hook** | Primary visual metaphor or massive typographic title | 50–60% of first-glance visual attention |
| 2 | **The Identity** | Headliner name, performer, or main event designation | 20–30% of attention; clearly subordinate to The Hook |
| 3 | **The Details** | Date, Time, and Venue | Crisp, unambiguous, 10–15% of visual weight |
| 4 | **The Footnotes** | Supporting acts, ticket URL, sponsor logos | Small, tucked into defined margins, never competing |

### 2.2 — Hierarchy Enforcement Rules

*   **No Competing Focal Points**: Do not create two visual anchors of equal weight. One element must dominate.
*   **Entry Path Test**: Before finalizing a design, identify where the viewer's eye enters the canvas. If it does not enter at Tier 1, the composition must be corrected.
*   **Details Must Not Compete**: Date, time, and venue text must sit in high-contrast, uncluttered zones. Never allow event details to float over complex background patterns.
*   **Footnote Discipline**: Secondary performers, ticket URLs, and sponsor marks are visually subordinate at all times — smaller type, lower contrast relative to The Identity tier.

---

## 3. Typography

Typography in poster design is architectural, not decorative. Text must be planned before it is placed, and its placement must be treated as a structural decision, not an afterthought.

### 3.1 — Render Strategy

Selecting the right typographic render strategy is critical. The two acceptable methods are:

**Method A — Textless Plate Generation (Strongly Preferred)**
> Generate the visual background plate completely free of any text elements. All typographic content is applied in a dedicated post-processing, canvas, or layout step using proper vector type tools. This eliminates all risk of hallucinated glyphs and provides total control over font selection, kerning, sizing, and contrast.

**Method B — Direct High-Fidelity Text Rendering (Ideogram or Top-Tier Models)**
> If the image model demonstrably excels at typographic fidelity (e.g., Ideogram v2, FLUX.1 [pro], DALL-E 3), direct rendering of a single, short main header is permitted. Constraints:
> *   Maximum 8 words.
> *   Short headline only — no event details in the generated image.
> *   The plate must pass a vision-critique step confirming zero character distortion before use.
> *   **Note**: Prefer Ideogram when explicit typography is required, as its architecture is specifically optimized for rendering coherent text.

**Method C (Forbidden)**
> Allowing the image model to render full event details, long strings, or decorative body text. Always rejected.

### 3.2 — Font Selection Rules

*   **Maximum Two Font Families per Poster**: One expressive display face for the primary title or hook, and one highly legible face (sans-serif or clear serif) for event details.
*   **Font Personality Match**: The chosen typeface must match the event's genre and aesthetic. A vintage folk concert should not use a geometric techno sans-serif. A minimalist gallery opening should not use a distressed grunge brush font.
*   **No Mixing Display Faces**: Two expressive display faces on one poster creates visual cacophony. If a poster uses an expressive headline face, body text must be utilitarian, neutral, and subordinate.

### 3.3 — Typographic Legibility Rules

*   **Contrast Floors**: All body text and event details must maintain a minimum contrast ratio sufficient for legibility in both digital screen viewing and physical print.
*   **No Text on Busy Backgrounds**: If the background region beneath event text is visually complex, insert a clean backing field — a solid color panel, a matte box, or sufficient negative space — before placing the text.
*   **Minimum Font Size**: For print formats, event details must be no smaller than 24pt at native resolution to ensure physical legibility.
*   **Tracking & Spacing**: Headlines should be tightly tracked (-5 to -20 tracking units) to convey authority. Event details should be openly tracked (+20 to +60) for easy readability at a distance.

---

## 4. Genre Guidance & Trope Prevention

Each event genre carries specific visual culture and equally specific exhausted clichés. This section defines the correct visual language for each major event type and provides explicit prohibition lists.

### 4.1 — Live Music & Performance

*   **Approved References**: Vintage gig prints, 1960s–1970s screenprinted concert posters (Wolfgang's Vault, Fillmore series), risograph zine aesthetics, abstract representations of sound through shape and pattern, silhouetted figures in motion.
*   **Forbidden Tropes**:
    - Glowing microphones floating in space
    - Generic acoustic or electric guitars depicted literally
    - Neon equalizer / soundwave graphics
    - Laser show light beams without intentional stylistic context
    - Crowd silhouettes with hands raised (used on millions of posters)

### 4.2 — Theater & Performing Arts

*   **Approved References**: Avant-garde Swiss typographic composition, Bauhaus graphic forms, conceptual visual metaphors (a single physical prop or mask fragment representing a thematic layer), dramatic high-contrast split compositions, editorial photo-based poster language.
*   **Forbidden Tropes**:
    - Full comedy/tragedy mask pairs
    - Literal curtain framing the composition
    - Stage spotlight bokeh circles on a black background
    - Proscenium arch depictions
    - Generic red velvet or gold tassel motifs

### 4.3 — Community & Cultural Events

*   **Approved References**: Screenprinted local botanical and geographic illustrations, woodcut print patterns, clean editorial grid layouts, archival documentary photography treatment, folk art motifs grounded in local heritage.
*   **Forbidden Tropes**:
    - Globe with hands clasped around it
    - Puzzle pieces clicked together
    - Vector-flat cartoon crowd renditions
    - Generic heart / world / family silhouette icons
    - Rainbow gradients as a standalone identity element

### 4.4 — Food, Markets & Festivals

*   **Approved References**: Vintage letterpress market posters, monoprint botanical illustration, hand-stamped woodblock label aesthetics, organic hand-drawn lettering, editorial food photography framing.
*   **Forbidden Tropes**:
    - Photorealistic food CGI renders
    - Steaming cartoon food icons
    - Checkered tablecloth or fork-and-knife clip art borders
    - Generic sunburst starburst deal-badge graphics

### 4.5 — Sports & Athletic Events

*   **Approved References**: Mid-century propaganda poster boldness, constructivist angular compositions, textile pattern-based hero graphics, bold silhouette sport figure studies, Swiss International sports graphics.
*   **Forbidden Tropes**:
    - Athlete in dramatic mid-action CGI render
    - Generic lightning bolt energy motifs
    - Lens flare trophy photography
    - Neon fire / smoke explosion FX

---

## 5. Color & Mood Guidance

Unrestricted color palettes lead directly to generic AI slop. Color must be selected intentionally, matched explicitly to the event's emotional register, and strictly limited in count.

### 5.1 — Color Budget Rules

*   **Maximum 4 Distinct Colors** including the canvas/background tone.
*   Name all colors explicitly in the prompt (e.g., `"Warm Ochre #C28832, Midnight Navy #142035, Off-White Cream #F5EFE0, and Carbon Black #1A1A1A"`).
*   Avoid color names that diffusion models interpret loosely (e.g., "blue" or "red"). Use compound or descriptive names ("dusty cornflower blue", "burnt brick red").

### 5.2 — Color Harmony Rules

| Harmony Mode | Best Used For | Character |
|---|---|---|
| **Duotone / Monochromatic** | Intimate, solo performance, gallery events | Moody, timeless, deeply artistic |
| **Analogous with Accent** | Most live events, festivals, cultural events | Balanced, warm, approachable, with directional eye pull |
| **Complementary (Controlled)** | Bold/athletic events, competition | High tension, visual energy, drama |
| **Split-Complementary** | Theater, nuanced conceptual events | Complex, sophisticated, unresolved tension |

### 5.3 — Mood Matching Requirements

The palette must be explicitly matched to the genre and emotional register of the event. Cross-contamination between palette moods is a deliberate design error:

| Event Register | Correct Palette Approach |
|---|---|
| Solo acoustic / folk / chamber music | Earthy, desaturated, warm neutrals — never neon, never bright primaries |
| High-energy live band / electronic | Dark deep backgrounds with 1-2 saturated accent colors — restrained, not garish |
| Formal theater / opera | Monochromatic or duotone, rich dark tones, classical ochre/gold accents |
| Street festival / community fair | Warm, vibrant, but still limited to 4 colors — avoid rainbow scatter palettes |
| Art gallery / opening | Near-neutral with one anchoring accent — let the whitespace carry the weight |

### 5.4 — Forbidden Color Behaviors

*   Smooth fully digital gradients spanning more than 2 stops.
*   Unsupported neon/electric colors applied to non-nightlife event contexts.
*   Mismatched warm/cool tones without intentional contrast design rationale.
*   Color palettes chosen for visual excitement rather than thematic accuracy.

---

## 6. Composition Principles

Strong composition is the invisible skeleton of every great poster. The viewer should feel the structure without consciously seeing it.

### 6.1 — Structural Frameworks

Choose one primary compositional framework before building any design:

| Framework | Description | Best For |
|---|---|---|
| **Rule of Thirds** | Primary visual element lands at an intersection of thirds; remaining space for text | Versatile, balanced events |
| **Central Focus** | Main visual anchored dead center; large negative space radiating outward | Intimate events, single performer |
| **Swiss Asymmetric Grid** | Grid defined, elements deliberately placed off-center with calculated tension | Conceptual, avant-garde events |
| **Diagonal / Dynamic** | Strong diagonal line or implied motion cutting through the composition | High-energy, athletic, or theatrical events |
| **Frame Within Frame** | Architectural or structural element frames the inner visual | Cultural, historical, formal events |

### 6.2 — Negative Space Rules

*   **30% Minimum Rest**: At minimum 30% of the poster canvas must be compositionally at rest — solid color, simple texture, or clean background without visual noise.
*   **Negative Space is Active**: Negative space should not feel empty; it should feel *intentional*. The shape of the space is itself a design decision.
*   **No Suffocation**: Never crowd the canvas. If a visual metaphor and all text feels cramped, the solution is not to reduce font size — it is to simplify the visual metaphor.

### 6.3 — Anchoring Rules

*   **Avoid "Floating Center"**: A composition where every element is centered both horizontally and vertically creates a sterile, unsophisticated poster. Anchor the primary visual to a frame edge, or establish a strong vertical or horizontal baseline.
*   **Ground the Composition**: The viewer should feel the composition has a bottom and a top. Floating elements that have no visual gravity feel unresolved.
*   **Frame Tension**: Elements that bleed slightly into the crop edge create contained visual tension and feel more physically printed.

### 6.4 — Bleed, Margin & Safety Rules

*   **Critical Content Safety Zone**: All text and primary visual anchors must be positioned at least **5%** away from the canvas edge on all sides to prevent print cropping or digital framing loss.
*   **Intentional Bleed**: Background color and texture fields should extend fully to the canvas edge (or beyond bleed marks for print formats) — never leave unintentional white slivers at borders.
*   **Print Formats**: When producing for physical print, adhere to 300 DPI at intended output size. Maintain a 3mm bleed boundary on all sides beyond the trim line.

### 6.5 — Resolution & Output Specs

| Format | Dimensions | Resolution | Notes |
|---|---|---|---|
| Digital Portrait (Social / Web) | 1080 × 1920 px | 72-150 DPI | Primary digital delivery format |
| Digital Square | 1080 × 1080 px | 72-150 DPI | Social media square format |
| Print A2 | 4961 × 7016 px | 300 DPI | Standard venue poster print |
| Print A3 | 3508 × 4961 px | 300 DPI | Standard tabloid / lobby print |
| Print A4 | 2480 × 3508 px | 300 DPI | Compact print / insert |


========== END DOC: STANDARDS.md ==========


========== BEGIN DOC: TEMPLATES.md ==========
title: Ralleh Poster Style Templates
source_url: https://ralleh.com/poster/TEMPLATES.md
last_updated: 2026-07-16T23:06:43.498Z
sha256: 9f050f1675623f5e108fc34755c25062fb04775e794bf6c671348e289de6ba05

# Ralleh Poster Style Templates

This document provides ready-to-use, highly structured style templates for generating premium, non-slop event posters. Use these templates to draft image-generation prompts that enforce analog artistic constraints and high-end aesthetics.

---

## 1. Swiss Minimalist (Grid & Asymmetry)
*   **Core Aesthetic**: Heavy reliance on negative space, absolute geometric precision, structural grid layouts, and asymmetric balance. Inspired by mid-century Swiss (International Typographic) Style.
*   **Visual Elements**: Primary geometric primitives (circles, rules, grids, isolated diagonals), absolute solid backgrounds, ultra-flat coloring.
*   **Composition & Hierarchy**: 40-50% negative space. Heavy anchor on top or bottom margins. No decorative details—every line must serve a structural purpose.
*   **Color Palette**: Strictly limited to 2 or 3 colors. (e.g., Deep Ink Black, Off-White Canvas, and Swiss Vermilion Red).
*   **Trope Prevention**: Zero glowing elements, zero bevels/shadows, zero gradients.
*   **Prompt Template**:
    ```text
    A high-end Swiss Minimalist poster plate, mid-century International Typographic Style. Asymmetric grid composition, bold geometric flat circles and structural lines. Solid [Color 1] background, with design elements in flat [Color 2] and a single accent in [Color 3]. Completely flat 2D graphic design, strict negative space. Zero gradients, zero drop shadows, zero glow, no photorealism, no 3D elements. Beautiful paper texture, matte screenprint finish. Textless background plate.
    ```

---

## 2. Vintage Screenprint (Risograph & Concert Gig-Poster)
*   **Core Aesthetic**: Textured, warm, physically crafted, evoking 1960s–1980s DIY concert flyers and independent screenprinting houses.
*   **Visual Elements**: Fine halftone dots, visible ink bleeding at edge registration, organic paper grain, overlapping color layers showing transparency (color multiplication).
*   **Composition & Hierarchy**: Central hand-drawn or stylized vector-like illustration. Clean, distinct framing with borders.
*   **Color Palette**: 3 to 4 warm/rich tones. (e.g., Mustard Yellow, Brick Red, Forest Green, over a Cream/Oatmeal background).
*   **Trope Prevention**: No smooth airbrushed gradients, no digital vector-flat cartoon look, no hyper-rendered metallic sheen.
*   **Prompt Template**:
    ```text
    An authentic 1970s concert gig poster plate. Handcrafted silkscreen print style, textured Risograph overlay, visible ink bleed, subtle dot halftone patterns, and warm paper grain. A central stylized graphic of [Subject] rendered in bold, flat layers with organic imperfections. Colors: warm mustard, deep navy, and terracotta red on a cream canvas background. Zero digital rendering, zero plastic gloss, no volumetric lighting, no lens flares. Textless plate.
    ```

---

## 3. Bold Woodcut / Linocut (Physical Relief Print)
*   **Core Aesthetic**: High-contrast, heavy ink, physical carving, raw natural lines. Extremely tactile and striking.
*   **Visual Elements**: Thick ink carvings, visible woodgrain texturing, negative cuts into a dark ink block, rugged and dynamic hand-carved edges.
*   **Composition & Hierarchy**: Strong focal subject carved directly out of a solid dark background block, utilizing raw positive/negative space contrast.
*   **Color Palette**: Strictly duotone or 3 colors. (e.g., Charcoal Black, Sandstone White, and a single bold ink stain like Amber Orange or Cobalt Blue).
*   **Trope Prevention**: Avoid computerized smooth bezier curves; lines must look physically cut with a chisel/knife.
*   **Prompt Template**:
    ```text
    A bold woodblock print poster plate, traditional relief linocut style. Thick physical ink textures, visible chiseled wood carving marks, and heavy textured paper embossing. The visual shows [Subject] carved in strong positive and negative space. High-contrast duotone style using deep carbon black ink on natural ivory-toned mulberry paper. Raw, tactile, organic, zero clean digital lines, textless plate.
    ```

---

## 4. Modern Abstract Conceptual (Geometrics & Gradients)
*   **Core Aesthetic**: Conceptual, artistic, poetic. Expressing a mood, sound, or narrative through non-literal shapes, soft light fields, and sophisticated modern geometry.
*   **Visual Elements**: Organic fluid forms, soft analog gradients (dithered/grainy, not smooth digital), overlapping glassmorphic panels, or floating lithic elements.
*   **Composition & Hierarchy**: Flowing, balanced layout that leads the eye along a gentle curves or intersecting planes.
*   **Color Palette**: Harmonious analogous colors with a stark dark/light contrast base. (e.g., Indigo, Plum, Warm Sand, and Charcoal).
*   **Trope Prevention**: Avoid stock vector "corporate abstract" blobs or shiny neon-wave shapes.
*   **Prompt Template**:
    ```text
    A contemporary abstract conceptual art poster plate. Elegant, minimalist overlapping translucent shapes, soft analog-dithered grain gradients, and fine-line geometric vector guides. The composition represents [Abstract Theme/Concept] through high-end fine art design. Palette of deep midnight blue, muted plum, and warm sandstone sand. Very clean, quiet elegance, textured matte paper, zero neon, zero glowing elements. Textless plate.
    ```

---

## 5. Retro-Futurism (Mid-Century Sci-Fi & Bauhaus)
*   **Core Aesthetic**: 1950s/1960s space age, Bauhaus geometry, optimism mixed with physical industrial design.
*   **Visual Elements**: Isometric architectural lines, textured celestial spheres, architectural grids, clean mathematical curves.
*   **Composition & Hierarchy**: Strongly vertical, soaring lines, large celestial bodies balancing a clean ground horizon or structural silhouette.
*   **Color Palette**: Muted primary or secondary colors with dark slate/charcoal contrast. (e.g., Muted Teal, Crimson, Pale Cream, Slate Gray).
*   **Trope Prevention**: Avoid 1980s synthwave/vaporwave neon grids or high-tech sci-fi wireframes.
*   **Prompt Template**:
    ```text
    A mid-century modern retro-futurist poster plate, Bauhaus architectural influence. Clean graphic geometry, textured celestial spheres, and soaring structural forms. Warm analog screenprint texture, organic paper fiber. Color scheme of slate blue, rust orange, and soft cream. Geometric, balanced, highly artistic, zero glossy rendering, textless plate.
    ```


========== END DOC: TEMPLATES.md ==========


========== BEGIN DOC: WORKFLOW.md ==========
title: Poster Generation Workflow
source_url: https://ralleh.com/poster/WORKFLOW.md
last_updated: 2026-07-17T04:00:13.201Z
sha256: 522c51fd699ffa17bdefe8af7730f2954e9b99129275db04183fcfc0d97cf915

# Poster Generation Workflow

**Version**: 2.0  
**Authority**: Execution framework for the Ralleh Poster skill.  
**Constraint**: Any LLM or agent operating this repository must execute these seven stages sequentially. Do not skip stages. Do not begin generation until Stage 3 is complete. Every stage contains mandatory exit gates that must be satisfied before advancing.

This workflow is designed to prevent generic "AI slop" by forcing the agent to think like a professional designer: gathering context, establishing creative limits, drafting concepts, critiquing ruthlessly, and executing deliberately.

---

## Stage 1: Intake (Context Gathering)

Do not make assumptions about event details. Gather raw metadata and establish creative constraints.

### 1.1 Checklist
- [ ] **Event Title**: Exact capitalization, spelling, and punctuation.
- [ ] **Date/Time**: Correct format (e.g., Day of week, Month Day, Year, start/end time).
- [ ] **Venue**: Full name, address, and city (or virtual platform).
- [ ] **Billing / Performers**: Order of importance, secondary names, and sponsors.
- [ ] **Genre / Event Type**: Categorize (e.g., Music, Theater, Market, Sports).
- [ ] **Reference Images**: Ask the user if they have reference images or mood boards they wish to upload (e.g., brand guidelines, past posters). Ensure they are ingested into context if provided.
- [ ] **Style Constraints**: Identify requested style (map to `TEMPLATES.md` if possible) and explicitly note forbidden tropes per `STANDARDS.md` §4.
- [ ] **Format / Specs**: Intended output medium (Digital/Print, aspect ratio).

### 1.2 Exit Gate
Proceed to Stage 2 only when the Event Title, Date, Venue, and Genre are confirmed by the requester. **If operating in a conversational web UI, stop and ask the user for this information now. Do not proceed until they reply.**

---

## Stage 2: Research (Visual Context)

Root the poster in authentic artistic reference points before drafting concepts.

### 2.1 Action Steps
1. Use web search or internal memory to investigate the visual history of the performer/artist or the event's genre.
2. Investigate the physical venue or the geographic location for architectural or regional aesthetic hooks.
3. Identify relevant art movements or analog printing traditions (e.g., 1960s Fillmore screenprints, Bauhaus, Risograph, Swiss Grid).

### 2.2 Output
Write a short, text-based "Mood Board" (3-5 bullet points) summarizing recurring colors, visual motifs, and textures that fit the event and comply with `STANDARDS.md`.

### 2.3 Exit Gate
Proceed to Stage 3 only when the Mood Board is documented in the session context. **If in a conversational UI, present the Mood Board to the user for approval before continuing.**

---

## Stage 3: Design Strategy (Creative Limits)

Synthesize research into a strict design direction. This is where the poster is intellectually solved before any pixels are generated.

### 3.1 Key Decisions
- **The Core Metaphor**: What singular symbolic element represents the entire event? (Choose one striking icon, abstract shape, or scene. Never depict everything.)
- **The Style Preset**: Select the most appropriate layout template from `TEMPLATES.md` (or define a custom one that adheres strictly to `STANDARDS.md`).
- **The Color Palette**: Select exactly 3-4 specific named colors (e.g., "Warm Ochre #C28832, Midnight Navy #142035, Off-White Cream #F5EFE0"). Consult `STANDARDS.md` §5.
- **Typography Strategy**: Choose Method A (Textless Plate) or Method B (High-Fidelity Short Header) per `STANDARDS.md` §3.1. Decide where text will reside and how legibility will be maintained (e.g., backing panels, negative space).
- **Format Target**: Finalize resolution/aspect ratio.

### 3.2 Output
A concise paragraph summarizing the strategy, naming the metaphor, the `TEMPLATES.md` reference, the 3-4 colors, and the typography plan.

### 3.3 Exit Gate
Proceed to Stage 4 only when the strategy paragraph is written and explicitly confirms compliance with `STANDARDS.md` color and typography rules. **In a conversational UI, present the strategy to the user for alignment before generating concepts.**

---

## Stage 4: Concept Generation (Drafting)

Develop multiple distinct creative angles based on the approved strategy.

### 4.1 Action Steps
Draft **4 distinct visual concepts** (or user-requested number). Each concept must include:
- **Title**: A short evocative name for the concept.
- **Visual Metaphor**: What the plate depicts.
- **Composition**: How elements are structured (referencing `STANDARDS.md` §6 frameworks).
- **Prompt Concept**: The exact text description to be sent to the visual model, incorporating the relevant `TEMPLATES.md` prompt block and slop-prevention keywords.
- **Rationale**: A one-sentence explanation of why this concept fits the event and avoids genre tropes (`STANDARDS.md` §4).

### 4.2 Constraints
Ensure concepts are truly distinct structural approaches, not minor variations of the same idea. Every concept must be designed to pass the anti-slop criteria (`STANDARDS.md` §1).

### 4.3 Exit Gate
Proceed to Stage 5 only when all 4 concepts are documented. Present the concepts to the requester for selection. **If operating in a conversational UI, stop here. Ask the user which concept they prefer. Do not proceed to critique or generation until the user has selected a path.** (Unless an automated `--generate` flag is set).

---

## Stage 5: Critique (Objective Scoring)

Evaluate the drafted concepts (or the initial generated candidates if running autonomously) against professional design criteria.

### 5.1 Scoring Rubric (Pass/Fail for each)
1. **Slop Prevention (`STANDARDS.md` §1)**: Is it free of plastic rendering, volumetric overload, cluttered noise, and hallucinated glyphs? Does it exhibit analog tactile quality?
2. **Hierarchy (`STANDARDS.md` §2)**: Is the Hook clearly dominant? Does the eye know where to go next?
3. **Typography (`STANDARDS.md` §3)**: Is there a clear, uncluttered zone for text integration? (Or, if Method B is used, is the header perfectly rendered?)
4. **Color & Composition (`STANDARDS.md` §§5-6)**: Are there only 3-4 colors? Is there at least 30% negative space? Is the main visual anchored?

### 5.2 Action
Filter out any concept or generated candidate that fails *any* of the four criteria. Select the strongest passing concept.

*   **Calibration Hint**: If you are unsure whether a candidate passes the anti-slop rules, consult the reference cases in `examples/`. Compare your candidate against the failure patterns shown in `example-02` and `example-05`. If your candidate resembles the failures, reject it and refine the prompt.

### 5.3 Exit Gate
Proceed to Stage 6 only when a single concept has passed the critique rubric and is selected for final execution.

---

## Stage 6: Refinement (Generation & Iteration)

Execute the selected concept and iterate until the output is flawless.

### 6.1 Action Steps
1. **Model Selection**: 
   - **Method B (Direct Text / Typography)**: Route to **`litellm/ideogram-v2`** — this is the required model ref for Ideogram through the LiteLLM proxy. The proxy backend defaults to Ideogram V_3_TURBO, which delivers superior glyph accuracy and typographic coherence. Do **not** call `ideogram/v2` directly; the `litellm/` prefix is mandatory.
   - **Method A (Textless Plate)**: Use `fal/flux-pro` or `fal/flux-1.1-pro` for highest-fidelity analog texture emulation.
   - **Aspect ratio**: Always pass `aspectRatio` (e.g. `9:16` for portrait posters) or `size` (e.g. `1080x1920`) so the shim maps to the correct Ideogram aspect ratio. The most common poster format is `1080x1920` / `9:16`.
2. Execute the image generation using the prompt developed in Stage 4.
3. Review the resulting plate using vision capabilities (or self-critique).
4. Check against the Stage 5 rubric. If the image model introduced slop, hallucinated text, or ignored color constraints, *reject the plate*.
5. Adjust the prompt (e.g., increase weights on anti-slop terms, simplify the metaphor, enforce "textless plate") and regenerate.
6. Repeat until a plate passes the critique rubric completely.

### 6.2 Exit Gate
Proceed to Stage 7 only when a generated plate passes the vision-critique for slop, hierarchy, typography space, and color constraints. Never advance a flawed plate. *(Note: If you are a web LLM without native image generation, your exit gate is providing the final refined prompt to the user and asking them to run it).*

---

## Stage 7: Final Output (Delivery & Archiving)

Deliver the final poster and document the design rationale.

### 7.1 Deliverables
1. **The Poster Asset**: The high-quality image file (in the requested format/resolution).
2. **Design Rationale**: A short summary explaining the metaphorical choices, typography plan, color selections, and how it avoids slop.
3. **Technical Manifest**: The exact provider/model used, seed (if applicable), and final generation prompt for reproducibility.

### 7.2 File Storage
Save the outputs to the project directory according to the structure defined in `TOOLS.md` §3. Ensure the event slug naming convention is followed.

### 7.3 Exit Gate
The workflow is complete when the deliverables are presented to the requester and all files are saved to the defined directory structure.


========== END DOC: WORKFLOW.md ==========


========== BEGIN DOC: TOOLS.md ==========
title: Tools Contract & Execution Environment
source_url: https://ralleh.com/poster/TOOLS.md
last_updated: 2026-07-17T04:00:04.922Z
sha256: 79c656153eafffaef33bf22a27872ee4f2adb7d9467a3aaca9d42d8be3324684

# Tools Contract & Execution Environment

**Version**: 2.1  
**Authority**: Integration spec for the Ralleh Poster skill within the OpenClaw runtime, or a standard Web AI Chat environment (such as ChatGPT, Claude, Gemini).  
**Constraint**: AI Agents and Web LLMs must use these approved tools or fallback strategies to execute the `WORKFLOW.md` loop. Do not invent commands or bypass the standardized tool APIs.

This document defines the capabilities required, the specific tool invocations expected, and the mandatory file output conventions for reproducibility across different runtime environments.

---

## 1. Image Generation (The Core Engine)

**Role**: Generate the high-fidelity visual plate for the poster (Stage 6).

### 🔑 Model Selection Rule of Thumb
> **Method A (Textless Plate) → `fal/flux-pro`** (best for tactile analog textures and screenprint aesthetics)  
> **Method B (Direct Text) → `litellm/ideogram-v2`** (best-in-class typography rendering via LiteLLM proxy; explicitly prefer this over any other option when text must be baked into the plate)

> **Infrastructure note**: Ideogram is routed through the local LiteLLM proxy (`litellm/ideogram-v2`). Do not call `ideogram/v2` directly — the `litellm/` prefix is required. The proxy runs at `127.0.0.1:4000` and forwards to the Ideogram shim. The default model is **Ideogram V_3_TURBO** (superior glyph accuracy vs V_2).

### 1.1 Direct Runtime Integration (API Mode)
Use the `image_generate` tool. Ensure the prompt integrates the anti-slop directives from `STANDARDS.md` and the structural constraints from `TEMPLATES.md`.

*   **Action**: `"generate"`
*   **Model**: Override default if a specific professional model is requested. 
    *   *For Textless Plates (Method A)*: `fal/flux-pro`, `fal/flux-1.1-pro` for highest fidelity analog emulation and texture.
    *   *For Text-Integrated Plates (Method B)*: Strongly prefer **`litellm/ideogram-v2`** (routes through LiteLLM → Ideogram V_3_TURBO via local shim), or fallback to `openai/gpt-image-2`. Ideogram is explicitly optimized for typographic coherence. Do not use `ideogram/v2` directly — the `litellm/` prefix is required.
*   **Output Format**: `png` or `webp` for highest quality lossless/near-lossless output. Avoid heavy jpeg compression artifacts that compromise analog film grain or print textures.
*   **Size**: Explicitly define size per `STANDARDS.md` §6.5 (e.g., `1080x1920` for digital portrait, or a high-res equivalent for print). Use `size` or `aspectRatio` parameters as supported by the provider.

### 1.2 Web AI Chat Integration (Conversational Mode)
If you are operating in a standard web-chat interface (such as Claude, ChatGPT, Gemini, etc.) and have **native image generation capabilities (e.g., DALL-E 3, Imagen 3, or similar)**, execute the generation directly using your internal tool. 

If you do **not have direct image-generation capabilities**, your role is to provide the final optimized prompt to the user as a clear copy-pasteable code block:
1.  Add a note explaining which model it was optimized for (e.g., "Optimized for FLUX.1 [dev]" or "Optimized for Midjourney v6").
2.  Provide a clear one-line copy-paste button wrapper.
3.  Instruct the user on how to run it and ask them to upload the result once generated so you can perform the Stage 5/6 Critique step.

**Mandatory Prompt Practice (All Environments)**:
The prompt used must be the refined, final prompt resulting from `WORKFLOW.md` Stage 6, explicitly incorporating color restrictions and tactile keywords.

---

## 2. Image Analysis (Quality Assurance)

**Role**: Critique generated poster drafts, verify slop absence, and confirm typography space (Stage 5 and Stage 6).

### 2.1 Direct Runtime Integration (API Mode)
Use the `image` tool (vision analysis) to inspect the generated asset before presenting it to the user.

### 2.2 Web AI Chat Integration (Conversational Mode)
If you are in a web chat interface, **request the user upload the generated image file** so that your internal vision capability can inspect it. Once uploaded, run your visual critique against the `STANDARDS.md` criteria.

### 2.3 Critique Prompt Requirements (All Environments)
When analyzing a draft, the critique step must explicitly verify:
1.  Are there any hallucinated text glyphs?
2.  Is the color palette restricted to 3-4 distinct colors?
3.  Is there a clear, uncluttered zone (minimum 30% negative space) suitable for placing event typography?
4.  Are there any "slop" indicators (plastic skin, volumetric overload, generic neon glow)?

If the visual critique identifies failures on these points, the plate must be rejected, the prompt adjusted, and a regeneration triggered or requested.

---

## 3. File System & Output Architecture

**Role**: Store generated assets, prompts, design rationales, and concept drafts for future reproducibility and human handoff (Stage 7).

### 3.1 Direct Runtime Integration (API Mode)
Use the `exec`, `write`, or `edit` tools to create directories and save files in the working directory under `output/<event-slug>/` as specified in §3.3.

### 3.2 Web AI Chat Integration (Conversational Mode)
If you do not have write access to the user's filesystem:
1.  Output the **Design Rationale** and the **Technical Manifest** as clear, copy-pasteable markdown blocks in the chat.
2.  Provide instructions for the user to save these locally alongside their final image asset for future reference.

### 3.3 Standardized Directory Structure (API Mode)
```text
output/
  └── <event-slug>/
      ├── poster-final.<png|webp|jpg>
      ├── design-rationale.md
      ├── technical-manifest.md
      └── concepts/
          ├── concept-01.md
          ├── concept-02.md
          └── ...
```

### 3.4 Naming Conventions
*   **Event Slug**: Lowercase, hyphen-separated string incorporating the date (if time-sensitive) and event name.
    *   *Example*: `2026-08-15-summer-jazz-festival`
    *   *Example*: `q3-all-hands-meeting`

### 3.5 Deliverable File Contents
*   **`poster-final.*`**: The final approved image asset.
*   **`design-rationale.md`**: The explanation of creative choices, color palette, and metaphor (output from Stage 7).
*   **`technical-manifest.md`**: The exact provider, model name, aspect ratio, seed (if available), and final prompt string used for the final generation. This ensures the design can be reproduced or modified later.
*   **`concepts/*.md`**: The text drafts of the concepts generated in Stage 4.

---

## 4. Web Search (Context Gathering)

**Role**: Gather artist research, venue visual context, and regional aesthetic references (Stage 2).

**Execution Contract**:
Use the `web_search` and `web_fetch` tools to ground the design in reality.

**Mandatory Uses**:
*   Search `[Performer Name] concert poster art` or `[Venue Name] architecture interior` to inform the Stage 2 Mood Board.
*   Verify exact spelling of venue names and performer billing if the requester provides ambiguous input.


========== END DOC: TOOLS.md ==========


========== BEGIN DOC: docs/installation.md ==========
title: Installation & Usage in OpenClaw
source_url: https://ralleh.com/poster/docs/installation.md
last_updated: 2026-07-16T23:37:47.129Z
sha256: 51a513f99661c76444fc8a2e575030d38e90f80eaf6bfdb92061bd034a665c8f

# Installation & Usage in OpenClaw

This guide describes how to configure, load, and run the `ralleh-poster` skill in your local or server-side OpenClaw gateway environment.

---

## 1. Prerequisites
Before installing this skill, ensure your OpenClaw runtime meets the following:
*   OpenClaw Gateway `v0.x` or later.
*   An enabled agent (e.g., `ralleh`) with the necessary capability profile.
*   Available image generation providers (e.g., `fal`, `openai`, or `ideogram`) configured with API keys in your gateway secrets.
*   Vision analysis capability enabled for the `image` tool.

---

## 2. Skill Integration

OpenClaw discovers skills dynamically from the filesystem. To load this skill, ensure the directory containing `SKILL.md` is exposed to your agent's skill discovery path.

### Step 1: Clone the Repository
Clone the repository to a stable path on your gateway host:
```bash
git clone https://github.com/ralleh-ai/ralleh-poster.git /opt/skills/ralleh-poster
```

### Step 2: Register the Skill Path
Update your OpenClaw gateway configuration (usually `~/.openclaw/openclaw.json` on user installs or `/etc/openclaw/gateway.json` on server installs) so that the skills discovery mechanism includes the new path:

```json
{
  "skills": {
    "paths": [
      "/opt/skills/ralleh-poster"
    ]
  }
}
```

### Step 3: Reload the Gateway
Reload the OpenClaw gateway to apply changes:
```bash
openclaw gateway restart
```

### Step 4: Verify Loading
Confirm the skill loaded successfully:
```bash
openclaw skills list | grep ralleh-poster
```

If the skill does not appear, check the gateway logs for a load error:
```bash
openclaw gateway logs --tail
```

---

## 3. Recommended Agent Configuration

For premium output quality, configure the designated agent (e.g., `ralleh` or a specialized creative sub-agent) with a tool profile and model mapping optimized for visual composition and vision feedback.

### Key Configuration Overrides
Modify your agent block in `openclaw.json` to include the following overrides:
```json
{
  "agents": {
    "ralleh-poster": {
      "model": "litellm/premium",
      "default_model": "litellm/default",
      "tool_profile": "creative",
      "capabilities": [
        "image_generate",
        "image",
        "web_search",
        "web_fetch",
        "read",
        "write",
        "edit",
        "exec"
      ],
      "model_routing": {
        "textless_plates": "fal/flux-pro",
        "text_integrated": "ideogram/v2"
      }
    }
  }
}
```

**Notes:**
*   `tool_profile: "creative"` unlocks image generation and vision tools by default.
*   `model_routing` is a suggested extension: use it to hint to the agent when to switch between FLUX and Ideogram based on Stage 6 requirements.

---

## 4. Invocation Methods

There are two primary ways to run the skill inside OpenClaw.

### Method A: Direct User Invocation
A user triggers the skill by providing event info and asking for a poster. OpenClaw routes the request directly to the agent holding this skill.

**Example Command (Chat):**
> "Hey Ralleh, I need a poster for the Copenhagen Chamber Recital on October 25th at 8 PM at Sylvan Hall. Let's make it Swiss Minimalist style."

### Method B: Cross-Agent Delegation (Sub-Agent Mode)
An executive or marketing agent can spawn a specialized child sub-agent to handle poster creation autonomously.

**Example Sub-Agent Spawn Pattern:**
```json
{
  "action": "sessions_spawn",
  "task": "Generate a Swiss Minimalist poster plate for the October 25 Copenhagen Recital. Use the ralleh-poster skill framework at /opt/skills/ralleh-poster.",
  "taskName": "generate_recital_poster",
  "cleanup": "keep"
}
```

### Method C: Reference from Another Agent (Prompt Directive)
If a non-owner agent needs to leverage the skill without spawning a sub-agent, it can reference the skill directives in a system prompt:

```markdown
When generating any poster or event visual, you MUST first read and follow the entire framework at `/opt/skills/ralleh-poster/`, starting with `LLM_BOOTSTRAP.md`. Do not use your default image-generation prompt style; the Ralleh Poster anti-slop rules override your defaults for poster tasks.
```

Once complete, the invoked agent saves the finalized outputs to `output/` per `TOOLS.md` §3, and returns the design rationale and local file path to the parent session.

---

## 5. Troubleshooting

| Issue | Fix |
|---|---|
| Skill not appearing in `openclaw skills list` | Confirm the `skills.paths` array includes the parent directory of the skill and restart the gateway. |
| Agent doesn't use FLUX/Ideogram routing | Ensure the agent's model routing keys are set and API keys are configured under provider settings. |
| Image generation fails | Confirm the `image_generate` tool is in the agent's `capabilities` array and provider secrets exist. |
| Vision critique step blocked | Ensure `image` (vision analysis) capability is enabled in your agent's tool profile. |


========== END DOC: docs/installation.md ==========


========== BEGIN DOC: docs/ideogram-integration.md ==========
title: Adding Ideogram.ai to OpenClaw
source_url: https://ralleh.com/poster/docs/ideogram-integration.md
last_updated: 2026-07-16T23:45:14.025Z
sha256: 7341b37f94342482796b89fa8c7a8e7bc2fdd10b7e508264f4dd057b3359f013

# Adding Ideogram.ai to OpenClaw

OpenClaw does not currently ship with a native `ideogram` provider plugin out of the box. However, because OpenClaw integrates natively with **LiteLLM**, we can easily route Ideogram image generation requests through your existing LiteLLM proxy.

This allows the `image_generate` tool to call `litellm/ideogram-v2` seamlessly.

---

## 1. Update LiteLLM Configuration

Edit your LiteLLM configuration file (typically `/opt/ralleh/litellm/litellm_config.yaml`). 

Add the Ideogram model to your `model_list`:

```yaml
  - model_name: ideogram-v2
    litellm_params:
      model: ideogram/V-2
      api_key: os.environ/IDEOGRAM_API_KEY
```
*(Check LiteLLM documentation for the exact Ideogram model string if V-2a or V-2-turbo is preferred).*

## 2. Set the API Key

Ensure the `IDEOGRAM_API_KEY` is exported in the environment where LiteLLM runs. If LiteLLM is running as a systemd service, add it to your environment file (e.g., `/etc/default/litellm` or `/opt/ralleh/litellm/.env`):

```bash
IDEOGRAM_API_KEY="your-ideogram-api-key-here"
```

Restart the LiteLLM service:
```bash
sudo systemctl restart litellm
```

## 3. Configure OpenClaw Agent Routing

Now that LiteLLM is exposing `ideogram-v2` as an OpenAI-compatible endpoint, update your OpenClaw agent configuration to prioritize it for poster typography.

Edit `~/.openclaw/openclaw.json` (or `/etc/openclaw/gateway.json`):

```json
{
  "agents": {
    "ralleh-poster": {
      "model_routing": {
        "textless_plates": "fal/flux-pro",
        "text_integrated": "litellm/ideogram-v2"
      }
    }
  }
}
```

## 4. Test the Integration

Invoke the image generation tool manually through the chat to verify the pipeline:

```text
/tool image_generate action="generate" model="litellm/ideogram-v2" prompt="A simple test poster with the word 'HELLO' in bold sans-serif font on a white background."
```


========== END DOC: docs/ideogram-integration.md ==========


========== BEGIN DOC: examples/README.md ==========
title: Examples Directory (Few-Shot Calibration)
source_url: https://ralleh.com/poster/examples/README.md
last_updated: 2026-07-17T05:44:41.558Z
sha256: dc3f22d8619858688e7a29cddc2b18ab2b402d00316d452cd2e0bd56a8f2bc77

# Examples Directory (Few-Shot Calibration)

This directory is optimized for LLM few-shot learning and Stage 5 critique calibration.

## How an LLM Must Use These Examples
- Compare every candidate output against both success and failure examples.
- Use failures as **hard anti-pattern detectors**.
- If a candidate resembles failure traits, reject and regenerate.
- Map design decisions to `STANDARDS.md` sections explicitly.

## Few-Shot Example Schema (Required)
Every example in this directory should include:
1. **Outcome** (Success or Failure)
2. **Rules Demonstrated** (specific `STANDARDS.md` sections)
3. **Workflow Checkpoint** (where issue was caught or validated)
4. **Why It Passed or Failed** (specific, non-generic explanation)
5. **Correction Pattern** (what to change next)
6. **Transfer Rule** (what future runs should reuse)

## Available Cases
- `example-01-success-minimalist.md` — **Positive**. Swiss Minimalist, textless-plate execution.
- `example-02-failure-slop.md` — **Negative**. Slop overload and recovery loop.
- `example-03-end-to-end.md` — **Positive**. Full 7-stage execution trace.
- `example-04-success-vintage-screenprint.md` — **Positive**. Analog texture and trope suppression.
- `example-05-failure-typography.md` — **Negative**. Typography distortion and hierarchy breakdown.
- `example-06-success-theater-conceptual.md` — **Positive**. Theater conceptual metaphor with disciplined composition.

Template for new examples: `examples/FEW_SHOT_TEMPLATE.md`.

## Linear Read Order for LLMs
1. `example-01-success-minimalist.md`
2. `example-02-failure-slop.md`
3. `example-05-failure-typography.md`
4. `example-03-end-to-end.md`
5. `example-04-success-vintage-screenprint.md`
6. `example-06-success-theater-conceptual.md`

## Adding New Examples
To add a new example:
1. Copy an existing file.
2. Use naming: `example-XX-<success|failure>-<theme>.md`.
3. Use the required schema above.
4. Add a rule mapping table and explicit workflow checkpoint.
5. Add the file to the Available Cases and Linear Read Order.


========== END DOC: examples/README.md ==========


========== BEGIN DOC: examples/FEW_SHOT_TEMPLATE.md ==========
title: Few-Shot Example Template (Required)
source_url: https://ralleh.com/poster/examples/FEW_SHOT_TEMPLATE.md
last_updated: 2026-07-17T05:44:27.326Z
sha256: 821d42b266358a210c3aa50fc2102ee81d9abc9572b81b99fd097aa02c89b1f8

# Few-Shot Example Template (Required)

Use this template for every example file in `examples/`.

## Example Metadata
- **Outcome**: Success | Failure
- **Example Type**: Positive | Negative
- **Primary Stage Checkpoint**: Stage X
- **Primary Rules Referenced**: `STANDARDS.md` sections

## 1) Event Brief
- Title
- Date/Time
- Venue
- Genre
- Style Preference

## 2) Candidate Strategy or Prompt
Provide the strategy/prompt exactly as used.

## 3) Rule Mapping (What This Demonstrates)
| Rule | Demonstrates / Violates | Why |
|---|---|---|
| §x.x | Demonstrates or Violates | Short explanation |

## 4) Critique Reasoning (LLM Should Think Like This)
- Check for slop indicators.
- Check color budget and negative space.
- Check hierarchy and typography plan.
- Check genre trope violations.
- Decide pass/fail and justify with rule refs.

## 5) Result and Correction Pattern
- **If success**: what pattern to reuse
- **If failure**: what to change and why

## 6) Transfer Rule
One concise rule future runs should always apply.


========== END DOC: examples/FEW_SHOT_TEMPLATE.md ==========


========== BEGIN DOC: examples/example-01-success-minimalist.md ==========
title: Example 01: Swiss Minimalist — Chamber Music Recital
source_url: https://ralleh.com/poster/examples/example-01-success-minimalist.md
last_updated: 2026-07-17T05:37:56.337Z
sha256: 2b2405de41cb1f955a948d4be9524c979ace90d76ee06a4289a0462f14e064e8

# Example 01: Swiss Minimalist — Chamber Music Recital

**Status**: ✅ Approved. Passes all `STANDARDS.md` criteria.

## Few-Shot Summary
- **Outcome**: Success
- **Rules Demonstrated**: `STANDARDS.md` §1.1, §1.2, §2.1, §3.1, §3.2, §4.1, §5.1, §5.2, §5.3, §6.1, §6.2, §6.3, §6.4
- **Workflow Checkpoint**: Validated at Stage 5 (Critique) and finalized at Stage 7
- **Why It Passed**: Strong analog texture, strict palette discipline, clear hierarchy, zero slop indicators
- **Transfer Rule**: For intimate genres, use restraint, high negative space, and textless plate workflow

## 1. Event Brief
*   **Title**: Nocturne No. 2 — A Chamber Music Recital
*   **Date/Time**: Saturday, October 25, 2026 · 8:00 PM
*   **Venue**: The Sylvan Concert Hall, Copenhagen
*   **Genre**: Chamber Music / Classical Performance
*   **Style Preference**: Swiss Minimalist (from `TEMPLATES.md`)

## 2. Design Strategy (Stage 3 Output)
The core metaphor is the *pause between notes*. The chamber music genre demands restraint; the poster must feel like a held breath rather than a shout.

*   **Metaphor**: A single, precise circular void anchoring the composition — representing both the concert hall's silence before a note is played and the sustained resonance of chamber music.
*   **Style**: Swiss Minimalist (asymmetric grid, mid-century International Typographic Style).
*   **Palette**: Ink Charcoal `#1A1A1A`, Off-White Bone `#F0EBE0`, and a single Swiss Vermilion `#D9412E` accent used only in the title glyph.
*   **Typography Strategy**: Method A (Textless Plate). Vector typography applied post-generation. Univers 65 Bold for title; Univers 45 Light for details.

## 3. Final Prompt Used (Stage 6)
```text
A high-end Swiss Minimalist poster plate, mid-century International Typographic Style. Asymmetric grid composition with a single precise flat circle positioned in the upper-right third of the canvas. Solid Off-White Bone #F0EBE0 background, with the circle rendered in flat Ink Charcoal #1A1A1A. Completely flat 2D graphic design. Zero gradients, zero drop shadows, zero glow. Matte paper texture, visible screenprint grain. Textless background plate. Aspect ratio 2:3 portrait.
```

## 4. Design Rationale
The plate is deliberately quiet. 60% of the canvas is negative space (well above the 30% minimum). The circle sits at a rule-of-thirds intersection, giving the eye a single anchor point without competing focal elements. The vermilion accent, applied only in post-processing to the title glyph, provides directional pull to the reading order without violating the 4-color palette budget.

## 5. `STANDARDS.md` Compliance Mapping
| Rule | Compliance |
|---|---|
| §1.1 Slop indicators | ✅ Zero plastic rendering, zero volumetric elements, zero hallucinated glyphs. |
| §1.2 Tactile texture | ✅ Visible matte paper grain and screenprint texture in the plate. |
| §2.1 Hierarchy | ✅ Circle (Hook, ~55% attention) → Title (Identity, added in post) → Date/Venue (Details) → Program footnotes. |
| §3.1 Typography | ✅ Method A. Zero text in generated plate. Type applied post-generation. |
| §3.2 Font families | ✅ Two families total: Univers 65 Bold (display), Univers 45 Light (details). |
| §4.1 Genre tropes | ✅ Avoided literal instruments, avoided sheet music imagery, avoided proscenium arches. |
| §5.1 Color budget | ✅ Exactly 3 named colors including canvas tone. |
| §5.2 Harmony | ✅ Monochromatic with a single controlled accent (subtly analogous). |
| §5.3 Mood matching | ✅ Restrained, earthy palette matched to intimate chamber music register. |
| §6.1 Framework | ✅ Swiss Asymmetric Grid. |
| §6.2 Negative space | ✅ 60% at rest. |
| §6.3 Anchoring | ✅ Circle anchored to upper-right third; typography grounds the lower portion. |
| §6.4 Bleed & safety | ✅ Type positioned within the 5% safety zone. |

## 6. Technical Manifest
*   **Model**: `fal/flux-pro` (Method A textless plate)
*   **Size**: `2480 x 3720 px` (300 DPI, A3 portrait bleed-adjusted)
*   **Seed**: `2947183`
*   **Output Format**: `png`
*   **Post-Processing**: Typography vector overlay in Affinity Designer, Univers font family, applied to canvas at Tier-1 hierarchy.


========== END DOC: examples/example-01-success-minimalist.md ==========


========== BEGIN DOC: examples/example-02-failure-slop.md ==========
title: Example 02: Slop Failure — Live Music Festival
source_url: https://ralleh.com/poster/examples/example-02-failure-slop.md
last_updated: 2026-07-17T05:38:01.981Z
sha256: 103d7d6275ef09a60e7ae45c93a9dec7c1869653fcc31799f1589de8c39f6114

# Example 02: Slop Failure — Live Music Festival

**Status**: ❌ Rejected at Stage 5 (Critique). Regenerated after prompt refinement.

This example demonstrates how the Ralleh Poster workflow catches AI slop before it reaches the user. The initial generation was produced from an under-constrained prompt. The Critique stage caught 5 rule violations, forcing regeneration.

## Few-Shot Summary
- **Outcome**: Failure (then corrected)
- **Rules Demonstrated**: `STANDARDS.md` §1.1, §4.1, §5.1, §6.2
- **Workflow Checkpoint**: Failed at Stage 5 (Critique), corrected by returning to Stage 3
- **Why It Failed**: Slop artifacts, trope overload, palette violation, and no negative space
- **Correction Pattern**: Anchor to template, enforce named palette, enforce anti-slop prompt language, switch to textless plate strategy
- **Transfer Rule**: Under-constrained prompts must never pass to final output

## 1. Event Brief
*   **Title**: Riverside Sound Festival
*   **Date/Time**: Saturday, July 18, 2026 · Gates 4:00 PM
*   **Venue**: Riverside Park, Portland
*   **Genre**: Live Music (multi-band day festival)
*   **Style Preference**: (Not specified — free direction)

## 2. Initial (Flawed) Prompt
```text
Create a poster for Riverside Sound Festival at Riverside Park. Music festival vibe with band performing, colorful lights, exciting atmosphere.
```

## 3. Initial Output — Slop Indicators Detected
The generated image contained the following defects:

| Slop Indicator | `STANDARDS.md` Reference | Observation |
|---|---|---|
| Plastic rendering | §1.1 | Guitars and microphones rendered with hyper-glossy CGI-grade material shading |
| Volumetric overload | §1.1 | Multiple lens flares, floating dust motes, and god-ray beams from stage lights |
| Vibrant clutter | §1.1 | Full-canvas neon gradients competing for attention with crowd, band, and typography |
| Hallucinated text | §1.1 | Warped, illegible pseudo-letter forms in three locations of the canvas |
| Generic symbol overload | §4.1 | Floating microphone, generic acoustic guitar, neon soundwave graphics — all cliché live-music tropes |
| Palette violation | §5.1 | 8+ unrestricted saturated colors, no named palette |
| Negative space violation | §6.2 | 0% negative space — every pixel filled with details |

**Result**: Every single one of the 4 critique rubric criteria in `WORKFLOW.md` §5.1 failed.

## 4. Stage 5 Critique Verdict
> ❌ REJECTED. The plate exhibits 6 of the 7 critical slop indicators from `STANDARDS.md` §1.1 and violates the palette, hierarchy, and negative space rules. Regeneration required with strict prompt refinement.

## 5. Corrective Design Strategy (Regeneration)
The agent returned to `WORKFLOW.md` Stage 3 and produced a proper Design Strategy:

*   **Metaphor**: An abstract river silhouette suggesting the flow of a full day of sound, rather than literal band imagery.
*   **Style**: Vintage Screenprint (from `TEMPLATES.md`).
*   **Palette**: Mustard Yellow `#D9A441`, Deep Navy `#1F2E4C`, Terracotta `#B45939`, Cream Canvas `#F5EFE0`.
*   **Typography Strategy**: Method A (Textless Plate). Header applied post-generation.

## 6. Corrected Prompt
```text
An authentic 1970s concert gig poster plate. Handcrafted silkscreen print style, textured Risograph overlay, visible ink bleed, subtle dot halftone patterns, and warm paper grain. A stylized flat-graphic river silhouette flowing diagonally through the composition, rendered in bold, flat layers with organic imperfections. Colors: warm mustard yellow, deep navy, and terracotta on a cream canvas background. Zero digital rendering, zero plastic gloss, textless plate. Aspect ratio 2:3 portrait.
```

## 7. Corrected Result — Passes Critique
| Rule | Compliance |
|---|---|
| §1.1 Slop indicators | ✅ Zero present |
| §1.2 Tactile texture | ✅ Halftone dots and ink-bleed grain clearly visible |
| §4.1 Genre tropes | ✅ Zero floating microphones, guitars, or neon soundwaves |
| §5.1 Color budget | ✅ Exactly 4 named colors |
| §6.2 Negative space | ✅ 40% at rest |

## 8. Lesson Captured
Under-constrained prompts produce slop. Every image-generation prompt must incorporate:
1.  A `TEMPLATES.md` style anchor.
2.  A named 3-4 color palette.
3.  Explicit anti-slop language ("zero gradients", "zero glow", "matte paper", "textless plate").
4.  A single visual metaphor — never a literal depiction of "the whole event".

This is precisely why `WORKFLOW.md` requires Stages 1-3 (Intake, Research, Strategy) *before* any image generation is permitted.


========== END DOC: examples/example-02-failure-slop.md ==========


========== BEGIN DOC: examples/example-03-end-to-end.md ==========
title: Example 03: End-to-End Workflow Trace (Live Music Event)
source_url: https://ralleh.com/poster/examples/example-03-end-to-end.md
last_updated: 2026-07-17T05:44:36.513Z
sha256: 8bd9b484f0bf24d03f28eaa07d21e125d937efbcf8c1b655b099155560437ccd

# Example 03: End-to-End Workflow Trace (Live Music Event)

**Event**: Riverside Sound Festival | **Date**: July 18, 2026 | **Venue**: Riverside Park, Portland | **Style**: Vintage Screenprint

## Few-Shot Summary
- **Outcome**: Success
- **Example Type**: Positive (full workflow trace)
- **Primary Stage Checkpoint**: Stage 5 (Critique)
- **Primary Rules Referenced**: `STANDARDS.md` §1.1, §2.1, §3.1, §4.1, §5.1, §6.2
- **Critique Reasoning Pattern**: verify anti-slop + palette + hierarchy + typography strategy before passing
- **Transfer Rule**: complete Stage 1–3 planning before final prompting

## Stage 1: Intake
> **Agent**: "Please provide event title, date, venue, and genre. Do you have any reference images?"
> **User**: "Riverside Sound Festival, July 18, 2026, Riverside Park Portland. Live music festival. No reference images."
> **Result**: Context confirmed. Exit Gate passed.

## Stage 2: Research & Mood Board
> **Agent**: "Researching Portland local park aesthetics and 1970s concert gig prints..."
> **Mood Board**:
> 1. Warm halftone textures and visible ink bleed. 
> 2. Muted mustard/navy/brick palette (classic regional aesthetic). 
> 3. Abstract river motifs (echoing 'Riverside', avoiding generic guitars).
> **Result**: Mood board presented and approved. Exit Gate passed.

## Stage 3: Design Strategy
> **Agent**: "Here is the proposed design strategy:"
> *   **Metaphor**: Abstract river contour lines wrapping around a central sun — representing the flow of a full day of sound without relying on literal band imagery.
> *   **Style**: Vintage Screenprint (from `TEMPLATES.md`).
> *   **Palette**: Mustard Yellow `#D9A441`, Deep Navy `#1F2E4C`, Terracotta `#B45939`, Cream Canvas `#F5EFE0`.
> *   **Typography Strategy**: Method A (Textless Plate). We will leave the top 30% of the canvas as clean cream canvas for heavy headline typography overlay later.
> **Result**: Strategy aligns with `STANDARDS.md`. Exit Gate passed.

## Stage 4: Concept Generation
> **Concept 1**: River contour geometry wrapping a sun.
> **Concept 2**: Stylized bridge architecture over river in duotone.
> **Concept 3**: Layered halftone soundwave merging into water ripples.
> **Concept 4**: Minimalist river bird motif in block ink.
> **Selection**: User chose Concept 1 (River Contour Geometry). Exit Gate passed.

## Stage 5: Critique
> **Agent**: Evaluating Concept 1 against `STANDARDS.md`:
> 1. **Slop Prevention**: Analog screenprint texture specified. No 3D/plastic elements.
> 2. **Hierarchy**: High contrast river/sun provides strong Hook.
> 3. **Typography**: Top 30% reserved as negative space (Cream Canvas) for text.
> 4. **Color**: Exactly 4 named colors used.
> **Critique Result**: Plate passed all criteria. Proceed to generation.

## Stage 6: Refinement
> **Action**: `image_generate` called with model `fal/flux-pro` for highest analog texture fidelity.
> **Prompt used**: "An authentic 1970s concert gig poster plate. Handcrafted silkscreen print style, textured Risograph overlay, visible ink bleed... abstract river contour lines wrapping a central sun... Colors: mustard yellow, deep navy, terracotta, on a cream canvas background. Top 30% is clean cream canvas. Zero digital rendering, zero plastic gloss, textless plate. Aspect ratio 2:3."
> **Vision Critique**: (Vision model inspection) No slop detected, 4-color palette validated, top third is clear for text. Exit Gate passed.

## Stage 7: Output
> **Deliverables**: 
> 1. `poster-final.png`
> 2. `design-rationale.md`: "This poster leverages the Vintage Screenprint template to capture the outdoor, all-day energy of the Riverside Sound Festival. By using abstract river contours instead of generic instruments, we subvert tropes while maintaining a 4-color analog aesthetic. The top third is deliberately left blank for clear typographic hierarchy."
> 3. `technical-manifest.md`: "Model: `fal/flux-pro`, Size: `2480x3720`, Seed: `99283`, Final Prompt: [Prompt from Stage 6]."
> **Final Artifact**: Saved to `output/2026-07-18-riverside-sound-festival/`


========== END DOC: examples/example-03-end-to-end.md ==========


========== BEGIN DOC: examples/example-04-success-vintage-screenprint.md ==========
title: Example 04: Vintage Screenprint — Indie Rock Showcase
source_url: https://ralleh.com/poster/examples/example-04-success-vintage-screenprint.md
last_updated: 2026-07-17T05:44:36.513Z
sha256: 5ad9ed4228b604221b4bdfd85c27c6c45abc0850dc32281793f1f5271e39d591

# Example 04: Vintage Screenprint — Indie Rock Showcase

**Status**: ✅ Approved. Passes all `STANDARDS.md` criteria.

## Few-Shot Summary
- **Outcome**: Success
- **Example Type**: Positive
- **Primary Stage Checkpoint**: Stage 5 (Critique)
- **Primary Rules Referenced**: `STANDARDS.md` §1.1, §1.2, §2.1, §3.1, §4.1, §5.1, §6.2
- **Critique Reasoning Pattern**: reject literal tropes, validate tactile texture and constrained palette
- **Transfer Rule**: replace literal genre symbols with conceptual environmental metaphors

## 1. Event Brief
*   **Title**: The Desert Sounds Showcase
*   **Date/Time**: Friday, May 14, 2027 · 9:00 PM
*   **Venue**: The Neon Cactus, Joshua Tree, CA
*   **Genre**: Live Music / Indie Rock
*   **Style Preference**: Vintage Screenprint

## 2. Design Strategy (Stage 3 Output)
The event is an indie rock showcase in the desert. To avoid the cliché of guitars and glowing neon signs, the design will focus on the environment itself, rendered with heavy, tactile screenprint techniques.

*   **Metaphor**: A lone coyote silhouette howling, its form creating negative space against a massive, stylized sun. 
*   **Style**: Vintage Screenprint (handcrafted silkscreen).
*   **Palette**: Burnt Orange `#C45525`, Dusty Turquoise `#4A8B8C`, Charcoal Black `#2A2A2A`, Oatmeal Paper `#F4EFE6`.
*   **Typography Strategy**: Method A (Textless Plate). A wide, clean Oatmeal block will be left at the bottom for event details.

## 3. Final Prompt Used (Stage 6)
```text
An authentic 1970s concert gig poster plate. Handcrafted silkscreen print style, textured Risograph overlay, visible ink bleed, subtle dot halftone patterns, and warm oatmeal paper grain. A central stylized graphic of a lone coyote silhouette in charcoal black, howling against a massive flat burnt orange sun. Deep dusty turquoise sky backdrop. The bottom 25% of the canvas is clean oatmeal paper texture. Zero digital rendering, zero plastic gloss, no volumetric lighting, no lens flares. Textless plate. Aspect ratio 2:3.
```

## 4. Design Rationale
The poster evokes a physical, handcrafted gig print. It completely subverts live-music tropes by omitting any musical instruments or musical notes, instead focusing on the rugged desert setting to establish the indie rock mood. The 4-color palette is strictly enforced, and the deliberate blank space at the bottom ensures typography will be legible.

## 5. `STANDARDS.md` Compliance Mapping
| Rule | Compliance |
|---|---|
| §1.1 Slop indicators | ✅ Zero 3D elements, flat ink layers only. |
| §1.2 Tactile texture | ✅ Oatmeal paper grain and halftone dot textures are prominent. |
| §2.1 Hierarchy | ✅ The giant burnt orange sun and coyote dominate (Hook), leaving space below. |
| §3.1 Typography | ✅ Textless plate (Method A), allowing for perfect type integration later. |
| §4.1 Genre tropes | ✅ No guitars, no microphones, no neon equalizers. |
| §5.1 Color budget | ✅ Exactly 4 colors (Burnt Orange, Dusty Turquoise, Charcoal, Oatmeal). |
| §6.2 Negative space | ✅ The entire bottom 25% is dedicated rest space for typography. |

## 6. Technical Manifest
*   **Model**: `fal/flux-pro` (optimized for texture)
*   **Size**: `2480 x 3720 px`
*   **Seed**: `847110`
*   **Final Output**: Textless plate delivered for manual layout.


========== END DOC: examples/example-04-success-vintage-screenprint.md ==========


========== BEGIN DOC: examples/example-05-failure-typography.md ==========
title: Example 05: Typography Failure — Tech Meetup
source_url: https://ralleh.com/poster/examples/example-05-failure-typography.md
last_updated: 2026-07-17T05:44:36.514Z
sha256: 851ebef68be073eb94a8c3b8f6169e7b0e588a484f50634f8aa8d3876cf3963c

# Example 05: Typography Failure — Tech Meetup

**Status**: ❌ Rejected at Stage 5 (Critique). Regenerated after prompt refinement.

This example highlights the dangers of using Method B (Direct High-Fidelity Text Rendering) with the wrong model and a cluttered background, violating legibility and hierarchy rules.

## Few-Shot Summary
- **Outcome**: Failure (then corrected)
- **Example Type**: Negative
- **Primary Stage Checkpoint**: Stage 5 (Critique)
- **Primary Rules Referenced**: `STANDARDS.md` §1.1, §3.1, §3.3
- **Critique Reasoning Pattern**: verify text integrity, placement contrast, and strategy-method compatibility
- **Transfer Rule**: if direct text rendering is used, enforce model capability + clean text zone + zero distortion

## 1. Event Brief
*   **Title**: Future of AI in Design
*   **Date/Time**: Tuesday, September 10, 2026 · 6:00 PM
*   **Venue**: The Innovation Hub, Berlin
*   **Genre**: Tech Meetup / Conference
*   **Style Preference**: Modern Abstract Conceptual

## 2. Initial (Flawed) Prompt
```text
A modern abstract conceptual poster for a tech meetup. Elegant overlapping geometric translucent shapes. Colors: deep midnight blue, plum, sandstone. Include the text "Future of AI in Design" in a modern font.
```

## 3. Initial Output — Critique Findings
The generated image was analyzed via vision critique. The model (a standard non-typographic image generator) produced the following defects:

| Defect | `STANDARDS.md` Reference | Observation |
|---|---|---|
| Hallucinated Glyphs | §1.1 | The text rendered as "Futre of Al in Dasign" with warped, melting letters. |
| Contrast / Background | §3.3 | The text was placed directly over the intersecting translucent shapes, making the first half of the word illegible against the dark plum background. |
| Method B Violation | §3.1 | The model attempted to render event text without passing the zero-distortion check, and it was not a short 8-word headline (it added pseudo-dates below). |

**Result**: Failed typography and hierarchy gates.

## 4. Corrective Design Strategy (Regeneration)
The agent corrected the approach by explicitly routing to a typography-capable model and instructing it to use negative space for the text.

*   **Metaphor**: A single, clean intersecting glassmorphic plane.
*   **Style**: Modern Abstract Conceptual.
*   **Typography Strategy**: Method B (Direct Text), explicitly utilizing `ideogram/v2`.
*   **Correction**: We will prompt for *only* the main header ("Future of AI in Design"), and force the text to sit in the clean sandstone-colored negative space, not overlapping the complex shapes.

## 5. Corrected Prompt
```text
A contemporary abstract conceptual art poster plate. The top half is clean, solid warm sandstone sand color. In the center of this clean space, perfectly legible, crisp typography reads exactly "Future of AI in Design" in a bold, modern sans-serif font in deep midnight blue. The bottom half contains elegant, minimalist overlapping translucent geometric shapes in deep midnight blue and muted plum. Very clean, quiet elegance, textured matte paper, zero neon. Aspect ratio 2:3.
```

## 6. Corrected Result
| Rule | Compliance |
|---|---|
| §1.1 Slop indicators | ✅ Zero hallucinated glyphs, crisp text. |
| §3.1 Typography | ✅ Method B executed flawlessly using Ideogram v2. Text is perfectly spelled. |
| §3.3 Legibility | ✅ Text sits on a solid, high-contrast sandstone background. Zero overlap with busy shapes. |

## 7. Lesson Captured
When using Method B (Direct Text):
1. **Model matters**: You must use a model optimized for text (like `ideogram/v2`).
2. **Placement matters**: You must explicitly prompt the model to place text in a clean, solid-colored zone. If text overlays complex geometry, it will fail legibility constraints.


========== END DOC: examples/example-05-failure-typography.md ==========


========== BEGIN DOC: examples/example-06-success-theater-conceptual.md ==========
title: Example 06: Theater Conceptual — "Macbeth"
source_url: https://ralleh.com/poster/examples/example-06-success-theater-conceptual.md
last_updated: 2026-07-17T05:50:46.028Z
sha256: 96744e155d7b6feec334379b76bd026feccdb914954681478fb6be52c65cfe76

# Example 06: Theater Conceptual — "Macbeth"

**Status**: ✅ Approved. Passes all `STANDARDS.md` criteria.

## Few-Shot Summary
- **Outcome**: Success
- **Example Type**: Positive
- **Primary Stage Checkpoint**: Stage 5 (Critique)
- **Primary Rules Referenced**: `STANDARDS.md` §1.1, §2.1, §3.1, §4.2, §5.1, §6.2
- **Key Learning Point**: Conceptual metaphor outperforms literal theater clichés when paired with strict hierarchy and texture constraints

## 1. Event Brief
*   **Title**: Macbeth
*   **Date/Time**: October 12 – 30, 2026
*   **Venue**: The Royal Garrison Theatre
*   **Genre**: Theater / Performing Arts
*   **Style Preference**: Woodcut / Linocut (Physical Relief Print)

## 2. Design Strategy (Stage 3 Output)
Theater posters often fall into literal traps (swords, crowns, blood spatters). This strategy subverts those tropes by using a conceptual, non-literal metaphor rendered in a brutal, tactile style suitable for a tragedy.

*   **Metaphor**: A dark, dense thicket of twisted thorns intertwining to subtly form the shape of a hollow crown. 
*   **Style**: Bold Woodcut / Linocut (Relief Print).
*   **Palette**: Charcoal Black `#111111`, Sandstone White `#E8E5DF`, and a single accent of Dried Blood Red `#8B2620`.
*   **Typography Strategy**: Method A (Textless Plate). The heavy woodcut aesthetic is too complex for an image model to cleanly integrate text. Type will be placed post-generation in the lower third.

## 3. Final Prompt Used (Stage 6)
```text
A bold woodblock print poster plate, traditional relief linocut style. Thick physical ink textures, visible chiseled wood carving marks, and heavy textured paper embossing. The visual shows a dense thicket of twisted thorns intertwining to subtly form the shape of a hollow crown, carved in strong positive and negative space. High-contrast duotone style using deep charcoal black ink on natural sandstone white mulberry paper, with a single heavy ink stain of dried blood red in the center. The bottom third is uncarved sandstone white negative space. Raw, tactile, organic, no digital lines, no photorealism, no 3D elements, textless plate.
```

## 4. Design Rationale
The relief print style instantly communicates gravity and historical weight without feeling like digital art. By asking the model to form the crown out of thorns (a conceptual leap rather than a literal drawing of a gold crown), the poster becomes an art piece. The color palette is ruthlessly restricted to three colors, achieving the required duotone-plus-accent harmony.

## 5. `STANDARDS.md` Compliance Mapping
| Rule | Compliance |
|---|---|
| §1.1 Slop indicators | ✅ Zero photorealism, zero CGI. Looks physically carved. |
| §2.1 Hierarchy | ✅ The twisted crown commands 60% of visual attention (Hook). |
| §3.1 Typography | ✅ Method A (Textless) prevents the complex woodgrain from distorting text. |
| §4.2 Genre tropes | ✅ Avoids literal stage curtains, tragedy masks, and standard shiny swords. |
| §5.2 Color Harmony | ✅ High-contrast duotone with one deep, thematic accent color. |
| §6.2 Negative space | ✅ The uncarved bottom third provides rest space and future text housing. |

## 6. Technical Manifest
*   **Model**: `fal/flux-pro` (exceptional at capturing the physical chisel marks and paper embossing)
*   **Size**: `2480 x 3508 px` (A4 Print)
*   **Seed**: `33910`
*   **Final Output**: Textless plate delivered for vector overlay.


========== END DOC: examples/example-06-success-theater-conceptual.md ==========