# Prompt Improvement Guide — Home Solutions TT

**Purpose:** a checklist every image prompt should pass before reaching image
generation. Used manually today; will be read automatically by
`prompt-improvement-filter` once that skill exists — this file doesn't change when
that happens.

**Canonical tokens:** palette and typography come from `HomeSolutionsTT_brand_guide.md`
(the declared SOURCE). Note: `04_hl_subaccount_config/` still carries legacy tokens
(`#0a9444` green; Fraunces + Manrope) that do **not** match the brand guide — treat the
brand guide as authoritative and regenerate any content built on the legacy values.

## Brand voice in prompts

**Direct, Warm, Proven, Confident, Trustworthy**

- **Direct** — single clear focal point per slide; one message per frame; no busy or cluttered compositions
- **Warm** — natural, golden-hour or soft daylight lighting; family-friendly scenes; approachable, genuine expressions (never stiff or overly formal)
- **Proven** — data visualized cleanly; numbers prominent; charts, timelines, and stats feel authoritative and grounded
- **Confident** — bold Manrope 800-weight typography; strong color contrast (green text/accents on charcoal background); no tentative or weak framing
- **Trustworthy** — photorealistic over stylized/illustrated; real skin texture; genuine candid moments; architecture shown as-built, not as a rendering fantasy

## What to verify in EVERY image prompt

1. **Language / context:** English, and Trinidad & Tobago throughout — scenes, people, architecture, vehicles, and signage must read as T&T. No foreign flags, currency, snow, or non-T&T architecture.
2. **Palette:** exact hex only — Green `#217A3C`, Green Dark `#1A5E2E`, Green Light `#2EA052`, Charcoal `#3A3A3C`, White `#FFFFFF`, Black `#000000`. Never vague "brand colors".
3. **Typography in image:** Manrope only (weights 300–800). No long text blocks. No em dashes (—) or en dashes (–).
4. **Composition / framing:** specify it ("lower-third text block on charcoal overlay at 60% opacity"), not just the subject matter.
5. **Remove AI Slop preamble:** included, unless explicitly excluded.
6. **Overlay color by slide role:** green `#217a3c` for Hook/CTA slides, charcoal `#3a3a3c` for Info/Conversion slides. Tints: Green/12% `rgba(33,122,60,0.12)` for tinted backgrounds, Green/28% `rgba(33,122,60,0.28)` for borders.
7. **Text layout sub-areas:** break into headline, supporting text, price block, CTA — without forcing the ones that don't apply.
8. **Visual continuity:** within a carousel, keep the same location, same subject, and same overlay treatment across all slides.
9. **Model recommendation:** appropriate to the slide type (Flux for lifestyle/architecture, DALL·E for text-heavy/infographic).
10. **Persona alignment:** match the message to the buyer profile — no luxury language ("luxury living", "dream home", "world-class amenities") on mass-market projects, and no mass-market framing on the luxury tier (Eighteen Moka).
11. **Real-estate compliance:**
    - Prices always "starting from" or "approximately" — never a hard promise
    - Never guarantee financing approval (say "we can help you explore options")
    - TTMF 2% fixed applies only to mortgages under TT$1.5M — don't state it without that framing
    - Never disparage competitors — anchor on the Home Solutions track record instead
    - Keep the "1,700 homes. 16 communities. 0 abandoned." claim accurate and consistent
12. **Design sheets:** if design sheets exist, cite their tokens explicitly (`design_sheets/01_client_profiles/`). The `00_MAIN` identity sheet is still pending.

## Typical transformations (before → after)

- "modern house with a happy family" → "candid photo of a T&T family at the gate of a Home Solutions community, charcoal overlay #3a3a3c, Manrope 800 headline 'Own yours. Stop renting theirs.'"
- "brand green accents" → "green #217A3C accents on a charcoal #3a3a3c overlay"
- "guaranteed financing available" → "we can help you explore financing options"
- "special price, act now" → "starting from $… — Phase 2 pricing"
- "luxury villas" (on a mass-market project) → (rewrite to the project-appropriate register and remove "luxury")

## Brand-specific prompt patterns that work well

[Populate this over time as good prompts get identified — empty at creation, this is the section most worth revisiting after a few real cycles]

## Known weak patterns to avoid for this brand

[Empty at creation — same maintenance pattern as `HomeSolutionsTT_negative_prompt_block.md`'s "Observed-problem exclusions." Add with a date/cycle reference when discovered.]

## Pending gaps

- `02_brand_kit/design_sheets/00_MAIN/` — MAIN identity sheet not created yet
- `01_knowledge_base/rules/HomeSolutionsTT_design_sheet_lookup.md` — pending (needs `SOP_Brand_Diagnostic`)