Oliver/ai_qc
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
ai_qc/CLAUDE_AMAZON.md
nickviljoen 6f3528b54f Add Boots client QC profile with 5 compliance checks and split CLAUDE.md client docs 
New boots_static profile (5 checks, 2.0 weight each) for retail promotional
artwork compliance: caveat rules, brand name accuracy (~170 names), offer
mechanics, T&C wording, and currency/locale. Strict grading override (any
check <6 = Fail). Guidelines embedded from 7 thematic guidance documents.

Also splits client-specific documentation out of CLAUDE.md into separate
CLAUDE_LOREAL.md, CLAUDE_AMAZON.md, CLAUDE_BOOTS.md, and CLAUDE_DOW_JONES.md
files to reduce main file size.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-13 09:25:58 +02:00

4.1 KiB
Raw Permalink Blame History

Amazon Client Documentation

Referenced from main CLAUDE.md. This file contains detailed Amazon QC check descriptions, prompt tuning history, test file locations, and known gaps.

Amazon QC Tools

Six specialized checks for Amazon marketing asset compliance. Originally based on ASD 2025 guidelines, prompts have been refined through testing with Amazon Prime Day OOH assets (2026-03-30). All checks use equal weight (1.67 each).

Tool What it checks
amazon_required_elements Critical: Headline + Box. Important: Date + Legal line. Subhead is optional (especially for OOH formats)
amazon_logo_country Primary: Country/URL must match content language (mismatch = instant low score). Secondary: correct logo type (smile vs URL) for locale
amazon_typography Ember Modern Standard Display font, size ratios, leading/tracking, ligatures, headline-to-date spacing (cramped = fail)
amazon_headline_layout Left-aligned, largest element, natural line splits. Prepositions at line end ("di", "of") are acceptable. One word per line OK in tall formats
amazon_margins Visual margin assessment (not pixel-level). Headline breathing room from edges. Left alignment consistency between headline, date, and logo/branding
amazon_element_placement Element placement (box, bag, logo). Box position (right for landscape, centre OK for portrait). Tape/flaps = branded coloured strips on box edges -- must not be cropped by asset edge

Prompt Tuning History (2026-03-30)

Prompts were refined based on testing with 9 assets (5 correct, 4 incorrect with known single defects):

Test files location: /Users/nickviljoen/Desktop/AI_QC_Bitbucket/Amazon/Test Files/ (Correct/ and Incorrect/ subfolders) Reports location: /Users/nickviljoen/Desktop/AI_QC_Bitbucket/Amazon/Latest Reports/ (Google and OpenAI subfolders)

What each incorrect file tests (client changed only 1-2 things per file):

Incorrect File What was wrong Correct version fix
DE_Stroer_1080x1920 copy Bad headline line breaks ("Tag. Neue" on same line) + box cropped/tape cut off Line breaks fixed + box scaled down so tape visible
IT_GSRetail_1920x720 copy Box cropped with tape cut off + date too close to headline Box scaled so tape visible + date spacing increased
IT_Pylon_648x432 copy Wrong country logo ("amazon.ie" on Italian content) Changed to correct logo (no wrong country domain)
IE_BrightSide_576x1152 copy Headline too large/close to left edge, not aligned with logo Headline scaled down for proper margins and left-alignment

Key prompt refinements made:

  1. Element Placement: Tape described as branded coloured strips (not plain packing tape). Format-aware positioning (centre OK for portrait). Only fail tape if cropped by asset edge.
  2. Required Elements: Subhead demoted to optional. OOH/DOOH formats don't need separate subhead.
  3. Logo Country: Country/language match is the primary scoring factor. Logo colour is secondary.
  4. Margins: Visual assessment approach (not pixel calculations). Added left-alignment consistency check between headline and logo.
  5. Headline Layout: Prepositions at line end acceptable in display typography. One word per line OK in tall formats. Only fail for sentence endings mid-line.
  6. Typography: Added headline-to-date element spacing check. Only flags genuinely cramped spacing.

Detection accuracy (latest round):

  • Correct files average ~94% (3 files get 100%)
  • DE incorrect: detected (headline + box issues) -- scores ~75%
  • IT wide incorrect: detected by Gemini (box), missed by OpenAI -- Gemini scores ~87%, OpenAI scores 100%
  • IT pylon incorrect: detected (wrong country) -- both score ~85% (logo 1/10)
  • IE incorrect: NOT detected by either LLM -- both score 100% (subtle margin/alignment difference)

Known gaps to address:

  • Subtle margin/alignment differences (IE pair) not reliably detected
  • Headline line break rules may need further tuning based on client feedback
  • OpenAI is more lenient on box placement than Gemini
  • No incorrect file receives an overall "Fail" grade -- pass threshold may need adjustment