Build a Brand Guide That Powers Every AI Image

Reverse-engineer this client’s brand into a single note titled exactly “Brand Guide”. This note is read on every future AI image generation for this client (ads, social graphics, anything), so precision compounds — a tight note yields consistent images across dozens of runs, a loose one yields drift. Keep it efficient though: capture signal, evaluate briefly, write. Hard budget: 3 site browses, max 2 competitors, max 8 images in the final catalog. For the image catalog specifically, evaluate the candidates and pick the 8 best brand references — not the first 8 that pass the filter.

Competitor URLs (optional — paste up to 2 full URLs, or leave the line blank): [COMPETITOR URLS HERE]

Step 1: Pull what we already know. Read the client profile for the machine-extracted brand config: primary, secondary, and accent color hex values, heading and body fonts, the primary logo URL, and the overview description field. The overview sometimes contains competitors or positioning. Do not re-browse the site for colors or fonts — they are already in the profile.

Step 2: Browse three pages on the client’s site. Exactly three browses, in this order. Use type page_content with detail full on each (that returns markdown plus the full image list with src/alt/width/height in one call):

1. Homepage
2. About page (skip only if there is no About page — do not substitute)
3. One product or services page (pick the most prominent from the homepage nav)

Do not browse a fourth page. Do not re-browse a page. Do not use page_seo_audit — we do not need SEO metadata.

From these three pages, capture:

• Voice: five adjectives describing how they write. Pull from hero copy and product descriptions, not generic marketing words.

• Photography style: one sentence on lighting, one on color grading, one on composition, one on subject matter.

• Typography in use: headline weight, body weight, letter-spacing, distinctive treatments (e.g. all-caps nav, italic taglines).

• Color application: how primary is used vs accent. Background color. CTA button style.

• Product details: physical description, materials and finishes (matte, gloss, translucent, embossed), label and logo placement, distinctive packaging features.

• Ad creative style hints: formats, text overlay style, photo vs illustration bias, UGC presence.

• Image catalog: across all three pages, evaluate the candidate images and pick the 8 best for brand reference. Best = most likely to be useful as a style anchor for future ads: real people, products, lifestyle scenes, environments, or brand-styled compositions. Skip logos, nav icons, social icons, decorative flourishes, thumbnails under 400px wide, and anything obviously stock.

  Critical: you cannot see the actual pixels. All you have is the URL, the alt text, and the surrounding page context (heading above the image, nearby copy). Infer the description from those three signals only. Do not invent details you cannot verify.

  • Strong signal (descriptive URL and/or descriptive alt): quote what you can infer. E.g. “shows: head roaster Mark (alt: ‘Our head roaster Mark’), homepage hero slot”
  • Mid signal (generic URL, weak alt, but clear page context): describe the placement. E.g. “shows: image on the About page under the ‘Our Story’ heading — likely a team or founder photo”
  • Weak signal (generic URL like /img_4837.jpg, missing or non-descriptive alt, no context): use a generic label. E.g. “shows: homepage image, subject unclear — reviewer to confirm visually”

  One short line per image, no paragraphs. Stop once you have the 8 strongest candidates.

Step 3: Browse up to 2 competitors. Get competitor URLs from the [COMPETITOR URLS HERE] line first. If blank, check the client profile overview. Do not guess competitors from general industry knowledge.

If you have URLs, browse each with type page_content (no detail: full — we don’t need their image list). One browse per competitor, max 2. For each, write one sentence only: “Competitor X uses {color} and {photography style}; differentiation: {one phrase}.” Stop.

If no URLs are available, write “Competitors not confirmed — agency to add during review” in the Competitive differentiation field and move on. No competitor browses in that case.

Step 4: Capture the client’s own ad creative history (only if integrations are connected). If meta_ads_report is available, one call: view ads, last 90 days, limit 5 (not 10), sorted by spend. Capture just the top ad names and their copy angles. Do not deep-dive into performance metrics; the Ad Creative Style section needs direction not data.

If google_ads_report is available, one call with the same parameters.

Skip both silently if not connected.

Step 5: Check for an existing Brand Guide note. Call list_client_notes filtered by title “Brand Guide” for this client. If one exists, you will update it. If not, you will create a new one with this exact title.

Step 6: Assemble the note. The note body must follow this exact markdown structure so downstream playbooks can parse it:

# Brand Guide — {Client Name}

## Brand Overview
- **Tagline**: …
- **Voice adjectives (5)**: …, …, …, …, …
- **Positioning**: one sentence on what the brand stands for
- **Competitive differentiation**: name 2-3 direct competitors and what visually differentiates this client from them

## Visual System
- **Primary font**: …
- **Secondary font**: …
- **Primary color**: #RRGGBB
- **Secondary color**: #RRGGBB
- **Accent color**: #RRGGBB
- **Background colors**: …
- **CTA color and style**: …

## Photography Direction
- **Lighting**: …
- **Color grading**: …
- **Composition**: …
- **Subject matter**: …
- **Props and surfaces**: …
- **Mood**: …

## Product Details
- **Physical description**: …
- **Materials and finishes**: … (matte, gloss, translucent, embossed, textured)
- **Label and logo placement**: …
- **Distinctive packaging features**: …

## Ad Creative Style
- **Typical formats**: …
- **Text overlay style**: …
- **Photo vs illustration**: …
- **UGC usage**: …
- **Offer presentation**: …
- **Top-spending past ads (if available)**: …

## Image Dos and Don'ts
<!-- Free-form bullet list. Capture rules grounded in what you actually observed on the site, the packaging, or past ads. If you cannot observe it, do not invent it. -->

- **Do**: …
- **Do**: …
- **Don't**: …
- **Don't**: …

## Image Generation Prompt Modifier
<!-- 50-75 word paragraph. This is the single most important field in this note. It is prepended to every image the AI generates for this client. Include exact colors with hex values, font descriptions, photography direction (lighting, color grading, composition), and mood. Be concrete, not generic. Example of a strong modifier: "Brand aesthetic: minimalist editorial photography. Soft diffuse daylight, low contrast, warm neutral color grade. Primary accent #2563EB deep blue used sparingly against off-white #FAFAF7 backgrounds. Typography is Playfair Display for headlines, Inter for body, tight tracking. Composition favors generous negative space with the subject slightly off-center. Mood: confident, quiet, premium. Avoid stock imagery cliches, avoid busy compositions." -->


{Write the modifier here as a single paragraph of prose, not bullet points. Do not include the comment block in your output.}

## Reference Images
<!-- Max 8 images total, grouped by source page. Each entry is one line. Descriptions are inferred from URL, alt text, and page context — the AI cannot see the pixels, so weak-signal entries use a generic "subject unclear" label that the human reviewer confirms visually. -->


### From the homepage
- ![{alt or short label}]({url}) — shows: {inferred description, or "homepage image, subject unclear"}

### From the About page
- ![{alt or short label}]({url}) — shows: {inferred description, or "About page image, subject unclear"}

### From the product / services page
- ![{alt or short label}]({url}) — shows: {inferred description, or "product page image, subject unclear"}

Fill every field using what you pulled in Steps 1-4. If a field does not apply (e.g., no packaging for a services business), write Not applicable. Do not leave placeholders. In Reference Images, omit any sub-heading with no images rather than leaving an empty one.

Step 7: Save the note. If a Brand Guide note already existed, call update_client_note with its id and the full new body. If no note existed, call create_client_note with title “Brand Guide” and the body above.

When done, create a task from the “Review Brand Guide (2/2)” template assigned to me, due tomorrow.