Audit image assets against brand guidelines: $ARGUMENTS
$ARGUMENTS should include:
- Path(s) to the image(s) to audit (file or directory)
- Optionally: specific brand concerns to check
- Optionally: the intended use context (hero, OG card, course cover, etc.)
- Empty — ask the user for the image path
Before Starting
- Read
src/lib/config/tenant.config.ts to understand brand identity
- Read
src/app/globals.css to understand the design token palette
- Read
tailwind.config.ts for font and color configuration
- Load the image(s) to audit
Brand Guidelines — Alan Hirsch Platform
Color Palette
Approved Colors
| Role |
Token |
Hex Range |
Description |
| Primary |
--primary |
Warm amber/gold tones |
CTAs, accents, highlights |
| Background |
--background |
Cream to warm white |
Page backgrounds |
| Foreground |
--foreground |
Warm charcoal to dark brown |
Text, headings |
| Muted |
--muted |
Warm grey, sage undertones |
Secondary text, borders |
| Card |
--card |
Cream, warm white |
Card surfaces |
| Accent |
--accent |
Terracotta, warm amber |
Badges, highlights |
Color Affinities (preferred in generated images)
- Terracotta:
#C75B39 range
- Amber/Gold:
#D4A84B range
- Sage:
#87A878 range
- Cream:
#FAF5E4 range
- Warm Charcoal:
#2C2C2C to #3D3D3D
- Warm Grey:
#8B8680 range
Color Violations (flag these)
- ❌ Pure black (#000000) backgrounds
- ❌ Cold/corporate blues (#0066CC, #1a73e8)
- ❌ Neon or high-saturation colors
- ❌ Pure white (#FFFFFF) as dominant background (should be warm cream)
- ❌ Cool greys without warm undertones
- ❌ Gradient rainbow / multi-colored effects
Tone & Mood
Approved Qualities
- ✅ Warm, inviting, relational
- ✅ Scholarly but accessible
- ✅ Missional, communal, formational
- ✅ Grounded, authentic, practical
- ✅ Contemplative, thoughtful depth
Tone Violations (flag these)
- ❌ Corporate, sterile, clinical
- ❌ Stock-photo generic (perfectly posed business people)
- ❌ Overly polished / artificial perfection
- ❌ Dark, edgy, aggressive
- ❌ Playful / cartoonish (unless specifically for a casual context)
- ❌ Tech-bro / startup aesthetic
Typography in Images
Approved Styles
- Serif fonts for titles/quotes (Playfair Display, Merriweather family)
- Clean sans-serif for body/labels (Inter, Open Sans family)
- Condensed sans-serif for impact (Oswald family)
Typography Violations
- ❌ Comic Sans, papyrus, or novelty fonts
- ❌ All-caps body text (all-caps OK for short labels/badges)
- ❌ Text with insufficient contrast (< 4.5:1 ratio)
- ❌ Text without clear hierarchy (all same size/weight)
- ❌ Decorative/script fonts for body text
Visual Motifs
On-Brand Motifs
- Open books, journals, handwritten notes
- Community gatherings, small groups, circles
- Urban neighborhoods, streets, doorways
- Maps, pathways, compass imagery
- Natural textures: wood, linen, paper, stone
- Shared meals, bread, table settings
- Seeds, seedlings, growth imagery
Off-Brand Motifs
- ❌ Corporate offices, boardrooms
- ❌ Solo individuals on pedestals/stages (unless teaching context)
- ❌ Technology/screens as the central subject
- ❌ Military/conquest imagery
- ❌ Luxury/wealth signaling
Audit Checklist
For each image, evaluate against these dimensions:
1. Color Palette Alignment (Weight: HIGH)
2. Tone & Mood (Weight: HIGH)
3. Typography (Weight: MEDIUM — only if text present)
4. Composition & Quality (Weight: MEDIUM)
5. Visual Motifs (Weight: LOW)
Execution
Step 1 — Load Images
Read each image file using the Read tool (supports PNG, JPG, WebP).
Step 2 — Visual Analysis
For each image, analyze against all 5 dimensions. Use your multimodal understanding to assess:
- Dominant colors and their warmth/coolness
- Overall mood and tone
- Text legibility and style (if present)
- Composition quality
- Subject matter appropriateness
Step 3 — Score and Report
Output Format
## Brand Audit Report
### Image: public/images/generated/hero/mdna.png
### Intended Use: Hero image for course detail page
### Scores
| Dimension | Score | Status |
|-----------|-------|--------|
| Color Palette | 9/10 | ✅ Pass |
| Tone & Mood | 8/10 | ✅ Pass |
| Typography | 7/10 | ⚠️ Minor issues |
| Composition | 9/10 | ✅ Pass |
| Visual Motifs | 10/10 | ✅ Pass |
### Overall: ✅ APPROVED (43/50)
### Details
#### Color Palette (9/10) ✅
- Dominant warm amber and terracotta tones — on brand
- Background gradient uses cream to warm gold — excellent
- Minor: small area of slightly cool grey in shadow region
#### Tone & Mood (8/10) ✅
- Warm, scholarly feel — matches brand
- Community gathering scene feels authentic
- Minor: lighting slightly dramatic for a platform that values accessibility
#### Typography (7/10) ⚠️
- Title text uses appropriate serif font
- Subtitle contrast is borderline (estimated 3.8:1) — recommend darkening text or adding overlay
- ACTION: Increase subtitle text contrast
#### Composition (9/10) ✅
- Good negative space for text overlay on the right
- Subject placement follows rule of thirds
- Resolution sufficient for hero display (2048px)
#### Visual Motifs (10/10) ✅
- Small group gathered around a table — perfect brand alignment
- Books and journals visible — on-brand scholarly motif
- Natural lighting through windows — warm, authentic
### Recommended Refinements
1. **Increase subtitle contrast** — darken text or add semi-transparent overlay
→ Use `/asset-edit` with: "Darken the subtitle text to improve contrast against the background"
2. **Slightly warm the shadow areas** — shift cool grey shadows toward warm grey
→ Use `/asset-edit` with: "Warm up the shadow areas, shifting from cool grey toward warm brown-grey"
### Verdict
Image is ready for use with minor text contrast adjustment recommended.
Batch Audit
When auditing a directory of images (e.g., a full series), provide:
- Individual audit for each image
- Cross-image consistency check:
- Are all images using the same color palette?
- Is the lighting direction consistent?
- Is the composition template consistent?
- Are there outliers that break the visual rhythm?
- Summary table with pass/fail for each image
Scoring Guide
| Score |
Status |
Meaning |
| 9-10 |
✅ Pass |
On-brand, ready for production |
| 7-8 |
⚠️ Minor |
Usable with minor refinements recommended |
| 5-6 |
🔶 Moderate |
Needs refinement before publishing |
| 1-4 |
❌ Fail |
Off-brand, regenerate or major edit needed |
Threshold for approval: 35/50 overall, with no single dimension below 5/10.
1---2name: asset-brand-check-23description: Audit generated image assets against the platform's brand guidelines. Use before publishing to verify color palette, typography, tone, and visual consistency.4---56Audit image assets against brand guidelines: $ARGUMENTS78$ARGUMENTS should include:9- Path(s) to the image(s) to audit (file or directory)10- Optionally: specific brand concerns to check11- Optionally: the intended use context (hero, OG card, course cover, etc.)12- Empty — ask the user for the image path1314## Before Starting15161. Read `src/lib/config/tenant.config.ts` to understand brand identity172. Read `src/app/globals.css` to understand the design token palette183. Read `tailwind.config.ts` for font and color configuration194. Load the image(s) to audit2021## Brand Guidelines — Alan Hirsch Platform2223### Color Palette2425#### Approved Colors26| Role | Token | Hex Range | Description |27|------|-------|-----------|-------------|28| Primary | `--primary` | Warm amber/gold tones | CTAs, accents, highlights |29| Background | `--background` | Cream to warm white | Page backgrounds |30| Foreground | `--foreground` | Warm charcoal to dark brown | Text, headings |31| Muted | `--muted` | Warm grey, sage undertones | Secondary text, borders |32| Card | `--card` | Cream, warm white | Card surfaces |33| Accent | `--accent` | Terracotta, warm amber | Badges, highlights |3435#### Color Affinities (preferred in generated images)36- Terracotta: `#C75B39` range37- Amber/Gold: `#D4A84B` range38- Sage: `#87A878` range39- Cream: `#FAF5E4` range40- Warm Charcoal: `#2C2C2C` to `#3D3D3D`41- Warm Grey: `#8B8680` range4243#### Color Violations (flag these)44- ❌ Pure black (#000000) backgrounds45- ❌ Cold/corporate blues (#0066CC, #1a73e8)46- ❌ Neon or high-saturation colors47- ❌ Pure white (#FFFFFF) as dominant background (should be warm cream)48- ❌ Cool greys without warm undertones49- ❌ Gradient rainbow / multi-colored effects5051### Tone & Mood5253#### Approved Qualities54- ✅ Warm, inviting, relational55- ✅ Scholarly but accessible56- ✅ Missional, communal, formational57- ✅ Grounded, authentic, practical58- ✅ Contemplative, thoughtful depth5960#### Tone Violations (flag these)61- ❌ Corporate, sterile, clinical62- ❌ Stock-photo generic (perfectly posed business people)63- ❌ Overly polished / artificial perfection64- ❌ Dark, edgy, aggressive65- ❌ Playful / cartoonish (unless specifically for a casual context)66- ❌ Tech-bro / startup aesthetic6768### Typography in Images6970#### Approved Styles71- Serif fonts for titles/quotes (Playfair Display, Merriweather family)72- Clean sans-serif for body/labels (Inter, Open Sans family)73- Condensed sans-serif for impact (Oswald family)7475#### Typography Violations76- ❌ Comic Sans, papyrus, or novelty fonts77- ❌ All-caps body text (all-caps OK for short labels/badges)78- ❌ Text with insufficient contrast (< 4.5:1 ratio)79- ❌ Text without clear hierarchy (all same size/weight)80- ❌ Decorative/script fonts for body text8182### Visual Motifs8384#### On-Brand Motifs85- Open books, journals, handwritten notes86- Community gatherings, small groups, circles87- Urban neighborhoods, streets, doorways88- Maps, pathways, compass imagery89- Natural textures: wood, linen, paper, stone90- Shared meals, bread, table settings91- Seeds, seedlings, growth imagery9293#### Off-Brand Motifs94- ❌ Corporate offices, boardrooms95- ❌ Solo individuals on pedestals/stages (unless teaching context)96- ❌ Technology/screens as the central subject97- ❌ Military/conquest imagery98- ❌ Luxury/wealth signaling99100## Audit Checklist101102For each image, evaluate against these dimensions:103104### 1. Color Palette Alignment (Weight: HIGH)105- [ ] Dominant colors match brand palette (warm earth tones)106- [ ] No cold/corporate colors dominating107- [ ] No neon or oversaturated elements108- [ ] Dark mode assets use warm darks, not pure black109110### 2. Tone & Mood (Weight: HIGH)111- [ ] Feels warm and inviting112- [ ] Scholarly but not cold113- [ ] Communal/relational, not individualistic114- [ ] Authentic, not stock-photo generic115116### 3. Typography (Weight: MEDIUM — only if text present)117- [ ] Font styles match brand family118- [ ] Text hierarchy is clear119- [ ] Contrast meets WCAG AA (4.5:1)120- [ ] No novelty or inappropriate fonts121122### 4. Composition & Quality (Weight: MEDIUM)123- [ ] Appropriate aspect ratio for intended use124- [ ] No AI artifacts (extra fingers, distorted text, etc.)125- [ ] Resolution sufficient for intended display size126- [ ] Composition supports content placement (negative space for text overlays)127128### 5. Visual Motifs (Weight: LOW)129- [ ] Imagery aligns with brand motifs130- [ ] No off-brand subject matter131- [ ] Cultural sensitivity appropriate132133## Execution134135### Step 1 — Load Images136Read each image file using the Read tool (supports PNG, JPG, WebP).137138### Step 2 — Visual Analysis139For each image, analyze against all 5 dimensions. Use your multimodal understanding to assess:140- Dominant colors and their warmth/coolness141- Overall mood and tone142- Text legibility and style (if present)143- Composition quality144- Subject matter appropriateness145146### Step 3 — Score and Report147148## Output Format149150```151## Brand Audit Report152153### Image: public/images/generated/hero/mdna.png154### Intended Use: Hero image for course detail page155156### Scores157| Dimension | Score | Status |158|-----------|-------|--------|159| Color Palette | 9/10 | ✅ Pass |160| Tone & Mood | 8/10 | ✅ Pass |161| Typography | 7/10 | ⚠️ Minor issues |162| Composition | 9/10 | ✅ Pass |163| Visual Motifs | 10/10 | ✅ Pass |164165### Overall: ✅ APPROVED (43/50)166167### Details168169#### Color Palette (9/10) ✅170- Dominant warm amber and terracotta tones — on brand171- Background gradient uses cream to warm gold — excellent172- Minor: small area of slightly cool grey in shadow region173174#### Tone & Mood (8/10) ✅175- Warm, scholarly feel — matches brand176- Community gathering scene feels authentic177- Minor: lighting slightly dramatic for a platform that values accessibility178179#### Typography (7/10) ⚠️180- Title text uses appropriate serif font181- Subtitle contrast is borderline (estimated 3.8:1) — recommend darkening text or adding overlay182- ACTION: Increase subtitle text contrast183184#### Composition (9/10) ✅185- Good negative space for text overlay on the right186- Subject placement follows rule of thirds187- Resolution sufficient for hero display (2048px)188189#### Visual Motifs (10/10) ✅190- Small group gathered around a table — perfect brand alignment191- Books and journals visible — on-brand scholarly motif192- Natural lighting through windows — warm, authentic193194### Recommended Refinements1951. **Increase subtitle contrast** — darken text or add semi-transparent overlay196 → Use `/asset-edit` with: "Darken the subtitle text to improve contrast against the background"1972. **Slightly warm the shadow areas** — shift cool grey shadows toward warm grey198 → Use `/asset-edit` with: "Warm up the shadow areas, shifting from cool grey toward warm brown-grey"199200### Verdict201Image is ready for use with minor text contrast adjustment recommended.202```203204## Batch Audit205206When auditing a directory of images (e.g., a full series), provide:2071. Individual audit for each image2082. Cross-image consistency check:209 - Are all images using the same color palette?210 - Is the lighting direction consistent?211 - Is the composition template consistent?212 - Are there outliers that break the visual rhythm?2133. Summary table with pass/fail for each image214215## Scoring Guide216217| Score | Status | Meaning |218|-------|--------|---------|219| 9-10 | ✅ Pass | On-brand, ready for production |220| 7-8 | ⚠️ Minor | Usable with minor refinements recommended |221| 5-6 | 🔶 Moderate | Needs refinement before publishing |222| 1-4 | ❌ Fail | Off-brand, regenerate or major edit needed |223224Threshold for approval: 35/50 overall, with no single dimension below 5/10.