Affiliation Audit

Audit affiliation data for: $ARGUMENTS

$ARGUMENTS should include:

• A person slug (e.g. alan-hirsch) or full name — looks for content-library/affiliations/{slug}.json
• Optionally: --strip-max N — max logos in the strip (default: 12)
• Optionally: --strip-min N — min logos required (default: 5)
• Optionally: --groups N — max number of strip groups (default: 4)
• Optionally: --fix — auto-attempt logo quality upgrades via browser

Before Starting

1. Read content-library/affiliations/{slug}.json — the scraped affiliation data
2. If the file doesn't exist, instruct the user to run /affiliation-scrape {name} first
3. Read public/images/orgs/ to see which logos are already downloaded locally

Audit Dimensions

Dimension 1 — Strip Count & Density

Logo strips have a sweet spot. Evaluate against these benchmarks:

Dimension 2 — Logo Quality Assessment

For each include_in_strip: true org:

Quality checks:

• Logo URL resolves (HTTP 200, not 404)
• Logo is SVG or PNG ≥ 200px wide
• Logo has transparent background (critical for light/dark mode compatibility)
• Logo is readable at 48px height (the standard strip display size)
• Logo is not a favicon (< 32px)
• Logo does not contain the organization's full sentence tagline (logos only)

Grade each logo:

• A — SVG, transparent background, clearly readable at 48px
• B — PNG ≥ 200px, transparent or white background, readable at 48px
• C — PNG 100–200px, or has non-transparent background but works on expected strip background
• D — PNG < 100px, wrong background color, favicon, or partial/cropped
• F — Not found, broken URL, or unreadable at any size

If --fix flag is passed, attempt to find better logo sources for any D or F grade:

1. Try https://logo.clearbit.com/{domain} (Clearbit logo API)
2. Navigate to the org's website and look for /images/logo.svg or equivalent
3. Check Wikimedia Commons: https://commons.wikimedia.org/wiki/Special:Search?search={org+name}+logo
4. Update logo_url and logo_quality in the JSON file if a better source is found

Dimension 3 — Grouping Strategy

Logo strips are most persuasive when logos are grouped by relationship type. Evaluate the proposed grouping:

Ideal group structure for thought leaders:

Checks:

• At least 2 distinct groups (a single group is just a list)
• Each group has 2+ logos (a single logo in a group looks sparse)
• No group has > 8 logos (split if needed)
• Group labels are relationship-specific, not generic ("As featured in" beats "Media")
• Publisher logos appear first (highest credibility signal)
• Groups flow from most to least formal: Publishers → Academic → Networks → Speaking → Media

Dimension 4 — Copy & Framing

The strip needs a headline that frames the social proof correctly.

For authors: "Published by the world's leading Christian publishers" For speakers: "Trusted on the world's most important stages" For thought leaders: "A voice that bridges the academy and the movement" Generic fallback: "Trusted by organizations worldwide"

Evaluate:

• A headline is defined (or can be drafted)
• The headline is specific to the type of credibility being claimed
• The headline is not just "Trusted by" with no qualifier — too generic
• Consider: does this person's affiliations speak to quality, breadth, or longevity? The headline should name that.

Optional: sub-headline for context (especially useful for less-known audiences):

• e.g., "Alan's work has been published, taught, and recognized across the global church movement"

Dimension 5 — Prominence Ordering

Within each group, logos should be ordered by prominence (prominence_score desc). Check:

• Within each group, orgs are sorted by prominence_score (highest first)
• Publisher group: major publishers (Baker, Zondervan, IVP = score 9–10) appear before smaller ones
• Media group: national/international outlets precede regional or niche outlets
• Conference group: marquee events (Lausanne, TGC, Catalyst) precede smaller ones
• No group puts a low-prominence org first

Dimension 6 — Dark/Light Mode Compatibility

Logo strips must work in both light and dark backgrounds:

• All logos are SVG (adapts to CSS color-scheme) OR
• PNG logos have transparent backgrounds (shows correctly on any background) OR
• Both light and dark variants are available
• No logos have white-on-white or dark-on-dark issues
• Plan exists for logos that don't have transparent backgrounds (CSS mix-blend-mode, inversion, or dark-bg alternative)

Recommended approach:

• Default: show logos in monochrome/grayscale via CSS filter: grayscale(1) with hover → full color
• On dark backgrounds: filter: grayscale(1) brightness(2) to lighten dark logos
• If logo quality is consistently poor: consider monochrome SVG recreation for top-tier orgs

Dimension 7 — Mobile Responsiveness Plan

• Strip design handles mobile (< 768px) gracefully
• Options: horizontal scroll (snap), 2-column grid, or condensed to top 6
• Logo height: 40px mobile, 48px tablet, 56px desktop
• Touch targets: logos should link to the org's website
• If groups are used: groups collapse to a single flat list on mobile

Gap Analysis

Identify what the strip is missing:

Common gaps for thought leaders:

• No speaking bureau listed — weakens speaker credibility
• Only books from one publisher — suggests limited reach
• No media appearances — makes it look like they speak only to insiders
• No academic affiliation — misses scholarly credibility if they have it
• No international orgs — looks US-centric for global thinkers

For each gap, recommend a targeted search:

• "missing speaking bureau" → suggest running /affiliation-scrape {name} --category speaking-bureau
• "no media" → suggest searching "{name}" interview OR podcast OR article specifically

Output Format

## Affiliation Audit: [Person Name]

### Overall Strip Readiness
Status: READY / NEEDS WORK / BLOCKED
Strip-ready logos: N (target: 5–12)
Recommended strip layout: [single-row / two-row / grouped / scrolling]

### Logo Quality Grades
| Organization | Group | Grade | Issue |
|-------------|-------|-------|-------|
| Baker Books | publishers | A | SVG, transparent |
| Forge International | networks | B | PNG 300px, white bg |
| Example Conference | conference | D | Favicon only — needs upgrade |

### Grouping Assessment
Status: GOOD / ADJUST / REWORK
Proposed groups:
1. publishers (3 logos) — "Published by" ✅
2. networks (4 logos) — "Part of" ✅
3. media (5 logos) — "As featured in" ✅ (trim to 4)
4. speaking (2 logos) — "Speaking with" ✅

Issues:
- [ ] "conference" group has only 1 logo — merge into media or speaking
- [ ] academic group empty — no academic affiliations found

### Copy Assessment
Recommended headline: "A voice trusted by the global church"
Recommended sub-headline: "Alan's work spans the world's leading publishers, networks, and stages"

### Prominence Order (recommended)
**publishers:** Baker Books (10) → IVP (9) → Fortress (7)
**networks:** Forge International (9) → 5Q Collective (8) → Communitas (7) → Exponential (6)
**media:** Christianity Today (9) → Relevant Magazine (7) → Leadership Journal (6) → The Gospel Coalition (8)
**speaking:** Premier Speakers Bureau (8) → Chartwell (7)

### Dark/Light Mode Status
✅ 8 logos: SVG or transparent PNG
⚠️ 4 logos: white background (needs CSS handling or dark alternative)
❌ 1 logo: dark background (will disappear on dark strip backgrounds)

### Mobile Plan
Recommended: Horizontal scroll with snap at 40px height, grouped by category with category label as section header

### Gaps & Recommendations
| Gap | Impact | Suggested Action |
|-----|--------|-----------------|
| No speaking bureau listed | MEDIUM | Search "{name} speaking" — check personal site /speaking page |
| Academic affiliation unverified | LOW | Check if there are seminary ties in bio |

### Actions Before Authoring
1. ❌ Fix logo grade D for [org name] — try Clearbit or official site (run with --fix)
2. ⚠️ Merge "conference" into "media" group (only 1 logo)
3. ✅ Re-sort networks group by prominence_score
4. ✅ All else ready — run `/logo-strip-author alan-hirsch` to generate the section

### Next Step
Run: `/logo-strip-author {slug}` to generate the full social proof section

Rules

• Audit only — don't rewrite the JSON unless --fix is passed (then only update logo_url/logo_quality)
• Be specific about D/F grade logos — name exactly what's wrong and how to fix it
• Never recommend including LOW confidence orgs in the strip without user confirmation
• 5 is the floor — a strip with < 5 logos is not credible; say so plainly
• Grayscale is the default — remind the user this is the visual standard unless they explicitly want full-color
• Prominence ordering is non-negotiable — a minor org appearing before a major publisher undermines credibility