Suede Image

Suede Marketing Image Production

Suede produces marketing imagery as a rights-aware, placement-specific system: choose the right production method, protect canonical brand assets, preserve real product truth, and verify the exported result. Use generation models and design tools to create efficient hero, social, mockup, banner, and preview workflows without fabricating interfaces or provenance.

Before Starting

Check for product marketing context first: If .agents/product-marketing.md exists (or .claude/product-marketing.md, or the legacy product-marketing-context.md filename, in older setups), read it before asking questions. Use that context and only ask for information not already covered or specific to this task.

Gather this context (ask if not provided):

1. Image Goal

• What type of image? (Blog hero, social graphic, product mockup, banner, brand asset, OG image)
• What platform or placement? (Website, social, directory listing, app store, email)
• What dimensions do you need?

2. Production Approach

• Do you have existing brand assets? (Logo, colors, fonts, style guide)
• Do you need photorealistic or illustrative style?
• Is this a one-off or a template for repeated use?

3. Technical Context

• Which image, browser, design, or local conversion tools are currently callable?
• What is the approved maximum cost and data-handling boundary?
• Do you need the image optimized for web performance?

Do not ask the user to paste API keys or secrets into the conversation.

Choosing Your Approach

First discover the current production surface. Inspect callable tools and connected accounts; do not assume a named model, provider, API, plugin, or design app is available. Then choose among these methods:

AI Image Generation

Use generation only after the current tool and authority gates pass.

Capability and authority gate

1. Confirm a generation or editing tool is callable in the current session.
2. Check its current official documentation for model availability, accepted inputs, output sizes, editing/reference support, safety restrictions, retention, commercial-use terms, and pricing. Record the source and check date.
3. Confirm rights to every uploaded logo, screenshot, photo, font, and reference image. Do not upload confidential or personal material outside its approved boundary.
4. Calculate the maximum cost for the requested attempts and get explicit approval before using a paid account or exceeding an already approved budget.
5. Confirm whether the user's request authorizes generation only, editing of supplied files, overwriting a source, or publication. These are separate gates.

Provider names and model versions are volatile. Examples such as OpenAI, Google, Black Forest Labs, Ideogram, Midjourney, Recraft, and self-hosted diffusion are research candidates, not routing instructions or capability claims.

Selection criteria

• For text-heavy assets, prefer a deterministic overlay or design template; test any verified in-image text capability before committing to it.
• For repeated brand work, prefer locked templates and approved assets over a claimed consistency feature.
• For edits, use a tool whose current documentation and callable schema confirm image input and the required edit mode.
• For vectors, require a real vector export and inspect its paths; a raster image labeled as vector is not sufficient.
• For product UI, capture the live authorized interface rather than generating it.
• For volume, compare verified cost, rate limits, review time, and output quality on a small test batch.

If no suitable renderer or editor is callable, deliver a production-ready prompt, layout spec, asset manifest, rights checklist, and export checklist. State clearly that no image was generated; do not route the user to an unavailable tool as though execution occurred. Use these exact headings:

## Prompt
<Subject + Setting + Style + Lighting + Composition + Technical, one block,
ready to paste; note any text that must be a deterministic overlay instead>

## Layout Spec
Canvas WxH + ratio | safe margins | focal point | text zones with max character
counts | logo placement and clear space | color values

## Asset Manifest
Asset | origin (owned / licensed / captured / to be generated) | rights basis
and holder | attribution or expiry | file path or "to source"

## Rights Checklist
- [ ] Every uploaded or referenced asset has a confirmed rights basis
- [ ] No real person, endorsement, or product interface is fabricated
- [ ] Brand mark is the approved file, unmodified, or omitted
- [ ] Paid-tool cost approved, or no paid tool used

## Export Checklist
Destination | dimensions | format | quality target | file-size budget | alt text
Then apply the Optimization Checklist in "Image Optimization" before delivery.

## Not Done
No image was generated. What would unblock production: <tool, authority, asset>

Prompting Basics

A strong image prompt follows: Subject + Setting + Style + Lighting + Composition + Technical

A laptop on a minimal white desk with an abstract analytics motif,
soft directional lighting from the left, shallow depth of field,
clean commercial photography style, 16:9 aspect ratio, 4K

Common mistakes:

• Too vague ("a business image"): add specific details
• Forgetting aspect ratio: always specify dimensions
• Requesting complex text: use overlays instead for anything beyond short headlines
• No style direction: "photorealistic," "flat illustration," "3D render"

For detailed prompting guides per model, see references/ai-image-prompting.md.

Design Tools

For templated, brand-consistent work where AI generation is overkill or too unpredictable.

Canva

Can be a candidate for template-driven social graphics, presentations, email headers, and banners. Verify the connected account, current features, export rights, plan limits, API availability, and callable integration before routing work to it. Keep a human review gate for brand output.

Figma

Can be a candidate when an authorized design file or component system exists. Verify current account access and whether the available integration can read, edit, export, or only inspect. Do not claim write access or create files merely because a connector exists.

When to Use Design Tools vs. AI Generation

Marketing Image Workflows

Blog & Article Hero Images

The image at the top of every post. Sets tone, improves shareability, required for OG/social previews.

1. Define the concept: what visual metaphor represents the topic?
2. Choose the verified method: callable generator, approved media, or a deterministic local/design template
3. Confirm dimensions from the actual site component and current social preview requirements
4. Optimize to a measured quality and performance budget

Prompt pattern:

[Visual metaphor for topic], clean modern style,
bright natural lighting, shallow depth of field,
professional blog header aesthetic, [verified width]x[verified height]

Social Media Graphics

Platform-specific images for organic posts.

The values below are planning defaults, not current platform guarantees. Check the platform's official specification on the work date and use its current safe zones, file limits, and format rules.

Workflow:

1. Create the hero concept at highest resolution needed
2. Use a verified resize/export feature or manual crop for platform variants
3. Add text overlays deterministically when accurate text is required
4. Export at platform-specific dimensions

Product Mockups & Screenshots

Showcase your product UI in context. AI models hallucinate UI: don't use them for this.

1. Capture real screenshots of your product at 2x resolution
2. Frame in device mockups: use browser frame, laptop, or phone templates
3. Add context: callout arrows, verified feature labels, before/after comparisons
4. Annotate deterministically: use a callable local layout workflow or an authorized design tool

Possible capture surfaces include browser tooling or an installed OS capture utility. Discover what is currently callable, confirm authorization for the live surface, and omit tools that are not available.