nickviljoen 59a0b2408c Restructure CLAUDE.md docs: slim project-wide root, complete per-client coverage

Splits the monolithic CLAUDE.md (962 lines) into a slim project-wide root (211 lines)
plus per-client files. Auto-loaded context drops ~88% per session.

Changes:
- CLAUDE.md slimmed to project-wide essentials (architecture, auth, deployment, branch
  strategy, deploy scripts, prod troubleshooting, pre-session checklist). Adds explicit
  session-start convention pointing to CLAUDE_<CLIENT>.md for client-specific work.
  Updates client roster table to all 10 clients with profile counts.
- New CLAUDE_AXA.md: document-mode pipeline + axa_policy_document profiles
- New CLAUDE_DIAGEO.md: key_visual + packaging profiles, check inventories
- New CLAUDE_UNILEVER.md: profiles + zero-score logic for face/new visibility
- New CLAUDE_HONDA.md, CLAUDE_RANK.md, CLAUDE_GENERAL.md: stubs (clients use generic
  profiles only — kept for completeness and future expansion)
- backend/CLAUDE.md: stale 932-line duplicate replaced with 18-line redirect to root
  + backend-specific quick pointers

Per-client files (CLAUDE_LOREAL.md, CLAUDE_AMAZON.md, CLAUDE_BOOTS.md,
CLAUDE_DOW_JONES.md) unchanged — already had the right content.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-06 12:29:16 +02:00

2.7 KiB

Raw Permalink Blame History

Diageo Client Documentation

Referenced from main CLAUDE.md. Detailed Diageo QC profile descriptions and check inventories.

Overview

Diageo has two specialised profiles for its core asset types: Key Visual (campaign creative) and Packaging (label/pack design). Both run against generic visual checks shared with other CPG-style brand profiles (Unilever uses an overlapping check set).

Diageo Profiles

`diageo_key_visual` — 11 checks

Campaign key-visual QC. Uses generic shared visual checks at brand-tuned weights.

Check	What it does	Weight
`background_contrast`	Product/text contrast against background	0.115
`brand_assets_visibility`	Brand assets clearly visible	0.077
`call_to_action`	CTA presence and clarity	0.115
`face_gaze_direction`	If a face is present, gaze direction guides toward product/CTA	0.038
`face_visibility`	Face presence and visibility	0.077
`imperative_verb`	Headline uses imperative verb	0.077
`logo_visibility`	Brand logo clearly visible	0.115
`text_readability`	Text legibility	0.115
`visual_elements_count`	Element count not overwhelming	0.077
`visual_hierarchy`	Clear visual hierarchy	0.115
`word_count`	Headline word count appropriate	0.077

`diageo_packaging` — 13 checks

Packaging design QC. Adds packaging-specific checks (curved edges, color format) to a similar base.

Check	What it does	Weight
`background_contrast`	Visibility of design elements	0.087
`brand_assets_visibility`	Brand assets visible on pack	0.13
`call_to_action`	CTA on pack (if applicable)	0.043
`color_format`	Color mode appropriate for print	0.043
`curved_edges`	Pack curve treatment	0.087
`face_gaze_direction`	Gaze direction (if face)	0.043
`face_visibility`	Face visibility	0.043
`logo_visibility`	Brand logo on pack	0.13
`lowercase_text`	Lowercase usage rules	0.043
`new_visibility`	"NEW" tag visibility (if present)	0.087
`product_visibility`	Product clearly visible	0.13
`text_readability`	Text legibility	0.087
`visual_elements_count`	Element count appropriate	0.043

Status

No formal prompt-tuning rounds have been run on Diageo profiles in this repo's history. Profiles use generic shared checks, so tuning is captured in the underlying visual_qc_apps/<check>/app.py prompts rather than client-specific check modules.

If Diageo-specific tuning is required (specific brand families, region rules, etc.), introduce dedicated diageo_* checks in visual_qc_apps/ following the Boots / Amazon pattern.

2.7 KiB Raw Permalink Blame History