ad-creative-variations

Ad Creative Variations System

Turns one proven-winning ad into a batch of Higgsfield-ready creative variations, using a strict, gated pipeline so every variation preserves what actually makes the ad win instead of guessing from scratch.

Full source spec (Seyed's canonical doc, Version 2): references/ad-creative-system-source.md. Read it once for the complete rationale; this file is the operating summary.

When to use

• The user shares a winning ad (image) and asks for variations, new angles, or scaled creative.
• The user asks to generate Higgsfield prompts from a proven ad.
• The user asks to fix a weak ad angle or generate new hooks for an existing winner.

Hard gate — Step 0

Only proceed if the ad meets the winner bar the user has set (minimum spend AND a ROAS/CPA threshold). Ask for these numbers if not given — do not run the system on unproven ads. If the ad doesn't qualify, say so and stop.

The pipeline

Winning ad
    |
Prompt 1 (analyze) -> ad-creative-analyze-winner
    |                  recommendation: PROMPT 2 / PROMPT 3 / BOTH
    |                  text angle: STRONG or WEAK
    |
WEAK? -> ad-creative-fix-weak-angle -> take the Top Pick
    |
optional -> ad-creative-generate-hooks (Prompt 2 only, max 5 of 15 hooks)
    |
ad-creative-new-angles (Prompt 2)  and/or  ad-creative-new-backgrounds (Prompt 3)
    |
Generate each resulting prompt in Higgsfield (Nano Banana 2)
    |
QC checklist (below) on every image
    |
Save with the naming convention (below) and hand off for review/go-live

Always run in this order. Never skip Prompt 1 — every later step depends on its brief.

Step-by-step

1. Analyze — use skill ad-creative-analyze-winner on the winning ad image. Get RECOMMENDATION (PROMPT 2 / PROMPT 3 / BOTH) and TEXT ANGLE SCORE (STRONG/WEAK). Keep the full brief output — every later step needs it verbatim.
2. Route:
   • TEXT ANGLE is WEAK → run ad-creative-fix-weak-angle first. Prompt 3 is not allowed on a weak text angle (never copy a weak text 5 times). Take the Top Pick forward into step 4.
   • RECOMMENDATION is PROMPT 3 or BOTH, and text angle is STRONG → Prompt 3 is in play.
   • RECOMMENDATION is PROMPT 2 or BOTH → Prompt 2 is in play.
3. Optional hooks — if the user wants fresh headline hooks (Prompt 2 route only), run ad-creative-generate-hooks, then pick at most 5 of the 15 to feed into Prompt 2.
4. Generate variations:
   • Prompt 2 in play → run ad-creative-new-angles (5 new angles, same visual DNA, format from the brief; use the Top Pick or hooks if produced in steps 2-3).
   • Prompt 3 in play → run ad-creative-new-backgrounds (5 new backgrounds, text 100% identical to the brief).
   • Both in play → run both; treat the result as 10 creatives that go live simultaneously with equal budget per creative.
5. Render each resulting Higgsfield prompt via the Higgsfield skill/CLI (Nano Banana 2 model). One image per prompt.
6. QC every image against the checklist below before approving. One NO = regenerate or adjust the prompt; never ship an unchecked image.
7. Save + hand off using the naming convention below, and tell the user what to review before it goes live.