start-vibing-stacks 2.28.0 → 2.30.0

package/stacks/_shared/ads-agents/skills/ads-competitor/SKILL.md

@@ -0,0 +1,198 @@
+---
+name: ads-competitor
+version: 1.5.0
+description: "Competitor ad intelligence analysis across Google, Meta, LinkedIn, TikTok, Microsoft, and Apple Ads. Analyzes competitor ad copy, creative strategy, keyword targeting, estimated spend, and identifies competitive gaps and opportunities. Use when user says competitor ads, ad spy, competitive analysis, competitor PPC, or ad intelligence."
+user-invokable: false
+---
+
+<!-- Updated: 2026-04-13 | v1.5 -->
+
+# Competitor Ad Intelligence
+
+## Process
+
+1. Identify target competitors (from user input or industry analysis)
+2. Read `ads-agents/references/benchmarks.md` for industry CPC/CTR/CVR baselines
+3. Research competitor ad presence across platforms
+4. Analyze ad copy, creative, and messaging themes
+5. Estimate competitor spend and keyword strategy
+6. Identify gaps and opportunities
+7. Generate competitive intelligence report
+
+## Data Sources
+
+### Free Intelligence Sources
+| Source | Platform | What You Can Find |
+|--------|----------|------------------|
+| Google Ads Transparency Center | Google | Active ads, formats, geo targeting |
+| Meta Ad Library | Meta/Instagram | All active ads, creative, copy, spend range |
+| LinkedIn Ad Library | LinkedIn | Active ads from company pages |
+| TikTok Creative Center | TikTok | Top ads, trending creative, hashtags |
+| Microsoft Ads | Microsoft | Limited: use auction insights |
+| Apple Ads (App Store) | Apple | Search tab ads, Today tab ads, product page creatives |
+
+### Google Ads Auction Insights
+Available from the user's own Google Ads account:
+- Impression share vs competitors
+- Overlap rate (how often you compete)
+- Outranking share (who wins more often)
+- Top of page rate and absolute top of page rate
+- Available for Search and Shopping campaigns
+
+### Platform-Specific Research
+
+#### Google
+- Ads Transparency Center: search by advertiser name or domain
+- Search for competitor brand terms to see their ads live
+- Auction Insights for impression share comparison
+
+#### Meta
+- Ad Library: filter by advertiser, country, platform (FB/IG), date range
+- Shows creative (image/video), ad copy, active dates
+- Shows platform placement (Facebook, Instagram, Audience Network)
+
+#### LinkedIn
+- Ad Library: search by company name
+- Shows Sponsored Content, Message Ads
+- Limited data compared to Meta Ad Library
+
+#### TikTok
+- Creative Center 2.0: top-performing ads by industry, country, objective with enhanced filtering
+- Hashtag analytics: trending sounds and hashtags
+- TikTok Shop: review competitor storefronts, catalogs, reviews, and live shopping
+- No per-advertiser library; use Creative Center for industry trends
+
+#### Apple Ads
+- App Store search: search competitor brand terms to see their Search tab ads
+- Today tab ads: check competitor presence on App Store homepage
+- Custom Product Pages: analyze competitor CPP variants via App Store listings
+
+## 2025-2026 Platform Updates
+
+### Meta
+- **Andromeda creative clustering** (launched October 2025): ads with >60% similarity are suppressed. Competitor creative analysis must assess genuine conceptual diversity, not just volume
+- **Advantage+ Sales** (renamed from ASC): unified shopping campaign type. Check if competitors are running Advantage+ Sales vs manual campaigns
+
+### Google
+- **Demand Gen replaced VAC** (April 2026): Video Action Campaigns fully deprecated. Analyze competitor Demand Gen adoption (multi-format video+image)
+- **AI Max for Search**: AI-powered campaign type with 14% conversion lift. Check competitor adoption via Ads Transparency Center
+- **Expanded Ads Transparency Center**: richer data on competitor ad history, formats, and targeting regions
+
+### TikTok
+- **Creative Center 2.0**: enhanced industry benchmarking, top ads filtering by objective and format
+- **Symphony AI variations** (2025): AI-generated creative at scale. Assess whether competitors use Symphony-generated vs original content
+- **TikTok Shop competitor analysis**: review competitor Shop tabs, product catalogs, reviews, and live shopping activity
+
+### LinkedIn
+- **Thought Leader Ads expansion** (March 2025): now supports non-employee creators and influencers. Check if competitors sponsor external thought leaders
+- **CRM integration** (June 2025): enhanced audience matching. Competitors with CRM integration show more precise targeting patterns
+
+### Microsoft
+- **Copilot ads in conversations**: new placement in Microsoft Copilot chat. Check if competitors appear in conversational ad placements
+- **CTV inventory**: ads on Netflix, Max, Hulu, and Roku via Microsoft Advertising. Assess competitor presence on connected TV
+
+### Apple Ads
+- **Rebranded to "Apple Ads"** (April 2025): formerly Apple Search Ads. All references updated
+- **Custom Product Page (CPP) competitive analysis**: competitors can run different product page variants per ad group. Analyze CPP strategies
+- **Maximize Conversions bidding**: AI auto-bidder (GA February 2026). Check if competitors have adopted automated bidding
+
+> **MCP Integration**: For live API access to competitor data sources, see `ads-agents/references/mcp-integration.md`.
+
+## Competitive Analysis Framework
+
+### 1. Ad Copy Analysis
+For each competitor, document:
+- **Headlines**: primary messages and value propositions
+- **CTAs**: what action they're driving (free trial, demo, buy now, learn more)
+- **Offers**: pricing, discounts, free shipping, trials
+- **Tone**: professional, casual, urgent, educational, emotional
+- **USPs**: unique selling propositions they emphasize
+- **Pain points**: customer problems they address
+
+### 2. Creative Strategy Analysis
+- **Formats used**: image, video, carousel, collection, document
+- **Visual style**: photography, illustration, UGC, stock, branded
+- **Video approach**: studio quality vs UGC vs animated
+- **Creative volume**: how many active ads (indicator of testing velocity)
+- **Refresh frequency**: how often new creatives appear
+
+### 3. Messaging Themes
+Categorize competitor messaging into themes:
+| Theme | Competitor A | Competitor B | Your Brand |
+|-------|-------------|-------------|------------|
+| Price/Value | ✅ Primary | ⚠️ Secondary | ? |
+| Quality/Premium | ❌ | ✅ Primary | ? |
+| Speed/Convenience | ⚠️ Secondary | ❌ | ? |
+| Trust/Authority | ✅ Primary | ✅ Primary | ? |
+| Innovation | ❌ | ⚠️ Secondary | ? |
+
+### 4. Keyword Intelligence (Google/Microsoft/Apple Ads)
+- Brand keyword bidding: are competitors bidding on your brand?
+- Keyword overlap: which non-brand terms do you both target?
+- Keyword gaps: terms competitors rank for that you don't target
+- Match type strategy: estimated match types from ad triggers
+
+### 5. Spend Estimation
+- Meta Ad Library shows spend ranges for political/social ads
+- Google Auction Insights + impression share = directional spend estimate
+- Third-party tools (SEMrush, SpyFu) for more precise estimates
+- Manual estimation formula:
+  ```
+  Estimated Monthly Spend = Impressions × CPM / 1000
+  or
+  Estimated Monthly Spend = Clicks × Estimated CPC
+  ```
+
+## Gap & Opportunity Identification
+
+### Platform Gaps
+- Which platforms are competitors NOT on? (opportunity to own)
+- Which platforms are they underspending on? (opportunity to outspend)
+
+### Messaging Gaps
+- What customer pain points are NO competitors addressing?
+- What value propositions are underrepresented in the market?
+- What content formats are competitors not using?
+
+### Audience Gaps
+- What demographics/segments are competitors not targeting?
+- What geographic markets are underserved?
+- What funnel stages are competitors neglecting?
+
+### Creative Gaps
+- What ad formats are competitors not using? (video, UGC, Spark Ads)
+- What creative styles are missing from the competitive landscape?
+- What platform-specific features are competitors not leveraging?
+
+## Competitive Response Strategy
+
+### When Competitors Bid on Your Brand
+- Always run brand campaigns to defend (low CPC, high CTR)
+- Dynamic keyword insertion to show your brand prominently
+- Sitelinks to key pages (pricing, features, reviews)
+- Ad copy that emphasizes unique differentiators
+- Consider bidding on competitor brand terms (know the rules)
+
+### When You're Outspent
+- Focus on efficiency over volume (better targeting, creative, landing pages)
+- Target long-tail keywords competitors ignore
+- Use Exact match for precision (less waste)
+- Double down on retargeting (lower CPA than prospecting)
+- Compete on creative quality, not budget
+
+## Output
+
+### Deliverables
+- `COMPETITOR-INTELLIGENCE-REPORT.md`: Full competitive analysis
+  - Per-competitor ad presence summary
+  - Ad copy and messaging analysis
+  - Creative strategy comparison
+  - Estimated spend levels
+  - Keyword overlap and gaps
+- `COMPETITIVE-GAPS.md`: Opportunities identified from competitor analysis
+  - Platform gaps
+  - Messaging opportunities
+  - Audience segments to target
+  - Creative format opportunities
+- Strategic recommendations for competitive positioning
+- Priority actions to gain competitive advantage

package/stacks/_shared/ads-agents/skills/ads-create/SKILL.md

@@ -0,0 +1,198 @@
+---
+name: ads-create
+version: 1.5.0
+description: "Campaign concept and copy brief generator for paid advertising. Reads brand-profile.json and optional audit results to produce structured campaign concepts, messaging pillars, and copy briefs. Outputs campaign-brief.md to the current directory. Run after /ads dna and before /ads generate. Triggers on: create campaign, campaign brief, ad concepts, write ad copy, campaign strategy, ad messaging, creative brief, generate concepts."
+user-invokable: false
+---
+
+# Ads Create: Campaign Concept & Copy Brief Generator
+
+Generates structured campaign concepts and platform-specific copy from your brand
+profile and optional audit data. Outputs `campaign-brief.md` for use by `/ads generate`.
+
+## Quick Reference
+
+| Command | What it does |
+|---------|-------------|
+| `/ads create` | Full campaign brief → `campaign-brief.md` |
+| `/ads create --platforms meta google` | Brief for specific platforms only |
+| `/ads create --objective leads` | Brief optimized for lead generation |
+
+## Process
+
+### Step 1: Check for Brand Profile
+
+Look for `brand-profile.json` in the current directory.
+
+- **Found**: Load and proceed.
+- **Not found**: Ask the user:
+  > "I don't see a brand-profile.json in this directory. Would you like to:
+  > 1. Run `/ads dna <url>` first to extract brand DNA automatically
+  > 2. Describe your brand manually (I'll create a basic profile from your description)"
+
+If the user chooses manual, collect:
+- Brand name and website
+- Primary color (or "unsure")
+- 3 words that describe the brand voice
+- Target audience (age, role, key pain point)
+- Main product/service offering
+
+### Step 2: Check for Audit Results
+
+Look for `ADS-AUDIT-REPORT.md` or any `*-audit-results.md` in the current directory.
+
+- **Found**: Read them. Note the top 3 weaknesses (creative fatigue, tracking gaps, wasted spend) to address in concepts.
+- **Not found**: Continue without. Note in the brief: "No audit data found; concepts are generalized. Run `/ads audit` for weakness-targeted concepts."
+
+### Step 3: Collect Campaign Parameters
+
+If `--platforms` or `--objective` flags were provided in the command, use those values
+and skip the corresponding questions below.
+
+Ask (combine into one message; omit any already provided via flags):
+1. **Platforms**: Which ad platforms? (Meta · Google · LinkedIn · TikTok · YouTube · Microsoft · All)
+2. **Objective**: Sales/Revenue · Leads/Demos · App Installs · Brand Awareness · Retargeting
+3. **Offer or brief**: Any specific offer, promotion, or message to highlight? (optional)
+4. **Number of concepts**: How many campaign concepts? (default: 3)
+
+### Step 4: Select Copy Framework
+
+Read `ads-agents/references/copy-frameworks.md` and recommend a framework based on
+campaign goal + platform + audience temperature:
+
+| Framework | Best For |
+|-----------|----------|
+| AIDA (Attention, Interest, Desire, Action) | Cold audiences, awareness campaigns |
+| PAS (Problem, Agitate, Solve) | Pain-point products, problem-aware audiences |
+| BAB (Before, After, Bridge) | Transformation offers, coaching, fitness |
+| 4P (Promise, Picture, Proof, Push) | Direct response, high-intent audiences |
+| FAB (Features, Advantages, Benefits) | Product-focused, comparison shoppers |
+| Star-Story-Solution | Brand storytelling, warm audiences |
+
+Include the selected framework name in campaign-brief.md for the copy-writer agent.
+
+### Step 5: Spawn Creative Agents in Sequence
+
+Agents must run **sequentially**; `copy-writer` reads the file that `creative-strategist`
+writes, so running them in parallel creates a race condition on `campaign-brief.md`.
+
+**Step 5a; Spawn `creative-strategist`** (Task tool):
+This agent creates `campaign-brief.md` and writes the strategic sections:
+`## Brand DNA Summary`, `## Campaign Concepts`, `## Image Generation Briefs`, `## Next Steps`.
+
+Additional instructions for `creative-strategist`:
+- For e-commerce businesses, also read `ads-agents/skills/ads-plan/assets/ecommerce-creative.md`
+  and select the appropriate creative playbook (Product Launch, Sale/Promotion,
+  Seasonal, Retargeting, Brand Awareness)
+- Include banana domain mode recommendations in each Image Generation Brief
+  (Product, Editorial, Cinema, UI/Web, or Portrait)
+
+Wait for `creative-strategist` to **fully complete** before continuing.
+
+**Step 5b; Spawn `copy-writer`** (Task tool):
+After `creative-strategist` completes, spawn `copy-writer`. It reads the existing
+`campaign-brief.md` and appends the `## Copy Deck` section with platform-specific
+headlines, primary text, and CTAs.
+
+Additional instructions for `copy-writer`:
+- Read `ads-agents/references/copy-frameworks.md` and apply the selected framework
+  structure to all ad copy
+- Generate 2 framework variants per platform: primary (recommended framework)
+  + secondary (alternative for A/B testing)
+
+Wait for `copy-writer` to complete before proceeding to Step 6.
+
+### Step 6: Review and Present
+
+After both agents complete, confirm `campaign-brief.md` exists and is complete.
+
+Present a summary to the user:
+```
+✓ campaign-brief.md generated
+
+Summary:
+  Concepts: [N] campaign concepts created
+  Platforms: [list]
+  Copy deck: Headlines, primary text, and CTAs for each concept × platform
+  Image briefs: [N] image generation briefs ready
+
+Next steps:
+  1. Review campaign-brief.md and adjust any messaging
+  2. Run `/ads generate` to produce AI images from the briefs
+  3. Upload copy and assets to your ad platforms
+```
+
+## campaign-brief.md Format Specification
+
+The following section headings are a **parsing contract**; agents downstream depend on these exact heading names.
+
+```markdown
+# Campaign Brief: [brand_name]
+**Generated:** [date]
+**Website:** [website_url]
+**Platforms:** [comma-separated list]
+**Objective:** [objective]
+**Concepts:** [N]
+
+## Brand DNA Summary
+[3-sentence synthesis of brand-profile.json: voice, visual identity, target audience]
+
+## Audit Context
+[If audit data found: top 3 weaknesses being addressed]
+[If no audit data: "No audit data; run /ads audit for weakness-targeted concepts"]
+
+## Campaign Concepts
+
+### Concept 1: [Name]
+**Hypothesis:** [why this will work; 1 sentence]
+**Primary Message:** [core message; 1 sentence]
+**Tone:** [voice reading from brand-profile.json]
+**Visual Direction:** [2-3 sentences describing imagery]
+**Target Platforms:** [platforms and rationale]
+**CTA:** [call to action text]
+**Addresses:** [audit finding or "general brand awareness"]
+
+### Concept 2: [Name]
+[same structure]
+
+[repeat for all concepts]
+
+## Copy Deck
+[appended by copy-writer agent; headlines, primary text, CTAs per concept per platform]
+
+## Image Generation Briefs
+
+### Brief 1: [Concept Name]: [Platform]
+**Prompt:** [exact generation prompt]
+**Dimensions:** [WxH]
+**Safe zone notes:** [constraint or "None"]
+
+### Brief 2: [Concept Name]: [Platform]
+**Prompt:** [exact generation prompt]
+**Dimensions:** [WxH]
+**Safe zone notes:** [constraint or "None"]
+
+[one brief per concept × platform combination]
+
+## Next Steps
+1. Review all concepts and select which to move forward with
+2. Run `/ads generate` to produce images from the briefs above
+3. Adjust CTAs and offers in the copy deck for your specific promotion
+4. Upload final assets to your ad platform managers
+```
+
+## Quality Gates
+
+- **Minimum 3 concepts** (unless user requests fewer)
+- **Distinct angles**: no two concepts share the same primary message angle
+- **Platform fit**: concepts targeting TikTok must acknowledge vertical-only format and sound-on context
+- **Offer anchoring**: if the user provided a specific offer, at least 1 concept must lead with it
+- **Image briefs**: every concept must have at least one image brief per requested platform
+
+## Meta Andromeda Optimization
+
+For Meta campaigns: recommend diverse creative concepts (different motivators, visual styles, messaging angles) to maximize Andromeda retrieval. Similarity Score >60% between ads triggers clustering and suppression.
+
+## Platform Character Limits
+
+Verify platform character limits are current. Meta reduced headline display length on mobile in 2025.

package/stacks/_shared/ads-agents/skills/ads-creative/SKILL.md

@@ -0,0 +1,208 @@
+---
+name: ads-creative
+version: 1.6.0
+description: "Cross-platform creative quality audit covering ad copy, video, image, and format diversity across all platforms. Detects creative fatigue, evaluates platform-native compliance, and provides production priorities. Use when user says creative audit, ad creative, creative fatigue, ad copy, ad design, or creative review."
+user-invokable: false
+---
+
+<!-- Updated: 2026-05-14 | v1.6: Andromeda 2026 (8-12 distinct concepts × 2-3 variations, similarity <40%, 2-3 week fatigue, 20+ tests/month), Meta Creative Similarity Score now visible in Ads Manager -->
+
+# Cross-Platform Creative Quality Audit
+
+## Process
+
+1. Collect creative assets or performance data from active platforms
+2. Read `ads-agents/references/platform-specs.md` for creative specifications
+3. Read `ads-agents/references/benchmarks.md` for CTR/engagement benchmarks
+4. Read `ads-agents/references/scoring-system.md` for weighted scoring algorithm
+5. **Validate**: confirm at least one platform has creative data (assets or performance metrics) before proceeding
+6. Evaluate creative quality per platform
+7. Assess cross-platform creative consistency
+8. **Validate**: verify fatigue signals reference actual performance trends, not assumptions
+9. Generate production priority recommendations
+
+## Per-Platform Assessment
+
+### Google Ads Creative
+- RSA: ≥8 unique headlines, ≥3 descriptions per ad group
+- RSA ad strength: "Good" or "Excellent"
+- Pin usage: minimal and strategic (over-pinning kills RSA flexibility)
+- Extensions: sitelinks (≥4), callouts (≥4), structured snippets, image
+- PMax asset groups: text + image + video + optional product feed
+- YouTube: video quality, hook, subtitles (see ads-youtube sub-skill)
+
+### Meta Ads Creative (Andromeda 2026)
+- Format diversity: ≥3 formats active (image, video, carousel, collection)
+- Creative volume: **target 8-12 conceptually distinct concepts** per campaign × 2-3 variations each (Andromeda standard). Top-third advertisers run ~395 live ads at any time
+- Fatigue detection: CTR declining >10% week-over-week OR >20% over 14 days = FAIL. **Andromeda fatigue window: 2-3 weeks** (down from 6+ pre-Andromeda)
+- High-spend accounts (>$5K/month): 5-15 new creatives/week required
+- Creative Similarity Score (visible in Ads Manager): keep **<40%** across active assets; >60% triggers retrieval suppression
+- Video length: 15s max Stories/Reels, 30s max Feed
+- UGC/testimonial content tested AND mixed with polished brand assets (both belong in rotation)
+- Advantage+ Creative enhancements enabled (~22% ROAS lift vs manual)
+- Headline under 40 chars, primary text under 125 chars
+- Variations must differ at visual/audio/structural level (not just headline swaps)
+
+### LinkedIn Creative
+- Thought Leader Ads active, ≥30% budget for B2B
+- Format diversity: ≥2 formats tested (single image, carousel, video, document)
+- Video ads tested
+- Creative refresh: every 4-6 weeks
+- Professional tone appropriate for platform
+
+### TikTok Creative
+- ≥6 creatives per ad group (Critical requirement)
+- All video 9:16 vertical 1080x1920 (non-negotiable)
+- Native-looking content (not corporate)
+- Hook in first 1-2 seconds
+- No creative active >7 days with declining CTR
+- Spark Ads tested (~3% CTR vs ~2% standard)
+- Sound-on optimization (never silent)
+- Safe zone compliance: X:40-940, Y:150-1470
+- Trending audio used
+
+### Microsoft Creative
+- RSA: ≥8 headlines, ≥3 descriptions
+- Multimedia Ads tested (unique rich format)
+- Ad copy optimized for Bing demographics (older, higher income, professional)
+- Action Extension utilized (unique to Microsoft)
+- Filter Link Extension tested
+
+## Creative Fatigue Detection
+
+### Signals of Fatigue
+| Signal | Threshold | Action |
+|--------|-----------|--------|
+| CTR declining | >20% over 14 days | Refresh creative |
+| Frequency (Meta) | >5.0 prospecting, >12.0 retargeting | New audience or creative |
+| Watch time declining (TikTok) | <3s average | New hook needed |
+| QS declining (Google) | Drop of 2+ points | Refresh ad copy |
+| Engagement rate drop | >30% decline | Full creative overhaul |
+
+### Refresh Cadence by Platform (2026 — Andromeda compressed Meta windows)
+| Platform | Recommended Refresh |
+|----------|-------------------|
+| TikTok | Every 7-10 days (fastest fatigue) |
+| Meta | Every 2-3 weeks (Andromeda compressed; was 14-21d) |
+| Meta (high spend >$5K/mo) | 5-15 new creatives per week |
+| LinkedIn Standard | Every 4-6 weeks |
+| LinkedIn Thought Leader Ads | Let winners run — peak CTR weeks 8-12, rotate ~week 18 |
+| Google Search | Every 8-12 weeks |
+| Microsoft | Every 8-12 weeks |
+| YouTube | Every 4-8 weeks |
+
+## Format Diversity Matrix
+
+Evaluate which formats are active per platform:
+
+| Format | Google | Meta | LinkedIn | TikTok | Microsoft |
+|--------|--------|------|----------|--------|-----------|
+| Static Image | RSA image ext | ✅ | ✅ | ❌ | Multimedia |
+| Video | YouTube, PMax | ✅ | ✅ | ✅ (required) | ✅ (9:16 vertical, April 2025) |
+| Carousel | ❌ | ✅ | ✅ | ❌ | ❌ |
+| Collection | ❌ | ✅ | ❌ | ❌ | ❌ |
+| Document | ❌ | ❌ | ✅ | ❌ | ❌ |
+| Shopping | PMax, Shopping | Catalog | ❌ | Shop | Shopping |
+
+**Apple Ads Format Support:**
+
+| Format | Apple Ads |
+|--------|-----------|
+| Static Image | ✅ (Custom Product Pages) |
+| Video | ✅ (App preview videos) |
+| Search Tab | ✅ (banner) |
+| Today Tab | ✅ (editorial-style) |
+
+## Andromeda Creative Similarity Score (Meta — 2026)
+
+Meta's Andromeda engine (global rollout complete October 2025) clusters ads with
+>60% similarity under a single Entity ID and suppresses delivery. 100 minor
+variations (color swaps, small text changes) perform no better than 10 genuinely
+distinct creatives. **Creative Similarity Score is now visible in Ads Manager.**
+
+**Thresholds:**
+- >60% similarity = retrieval suppression (ads compete with each other, not expand reach)
+- <40% similarity = recommended target across active assets
+- Variations must register at visual / audio / structural level, not just copy
+
+**Evaluate:**
+- Are creatives genuinely diverse in concept, angle, and format?
+- Are creatives passing the **8-12 distinct concepts × 2-3 variations** test?
+- Flag accounts relying on iterative variations rather than distinct concepts
+- Recommend testing fundamentally different hooks, formats, emotional triggers, and value propositions (not just A/B'd copy)
+- Are brands testing 20+ new ads/month? (Below 10 = 65% lower ROAS vs above 20)
+
+## Symphony Automation Awareness (TikTok, 2025)
+
+TikTok's Symphony AI (2025) generates creative variations from product URLs. Assess:
+- Whether account uses AI-generated vs original creatives
+- Quality and performance comparison of Symphony vs manual creatives
+- Impact on creative refresh strategy (Symphony can accelerate iteration)
+
+## Creative Health Scoring Weights
+
+```
+Format Diversity:      25%  ████████░░
+Fatigue Signals:       25%  ████████░░
+Platform Compliance:   20%  ██████░░░░
+Refresh Cadence:       15%  █████░░░░░
+Volume:                15%  █████░░░░░
+```
+
+Grade: A (90-100), B (75-89), C (60-74), D (40-59), F (<40).
+
+## Creative Check IDs
+
+| ID | Check | Severity |
+|----|-------|----------|
+| CR-01 | Format diversity: >=3 formats per platform | High |
+| CR-02 | Creative volume: meets platform minimums | High |
+| CR-03 | Fatigue detection: CTR/engagement declining past thresholds | Critical |
+| CR-04 | Refresh cadence: within platform-recommended cycle | High |
+| CR-05 | Platform compliance: specs, safe zones, text limits | Critical |
+| CR-06 | Hook quality: first 1-5s engagement (video) or headline impact (static) | High |
+| CR-07 | UGC ratio: UGC/testimonial content tested on Meta and TikTok | Medium |
+| CR-08 | Video specs: codec, resolution, aspect ratio per platform | Medium |
+| CR-09 | Safe zone compliance: critical elements within 900x1000px usable area | Medium |
+| CR-10 | Andromeda diversity: genuinely distinct concepts, not iterative variations (Meta) | High |
+
+## Universal Creative Best Practices
+
+### Cross-Platform Safe Zone
+- 900x1000px usable area works across all vertical placements
+- Keep critical elements centered and within safe margins
+- Test on mobile devices (75%+ of ad impressions are mobile)
+
+### Ad Copy Principles
+- Lead with benefit, not feature
+- Include clear CTA (what should they do next?)
+- Match ad message to landing page (message match)
+- Use numbers and specifics over vague claims
+- Test emotional vs rational appeals
+
+### Video Production Standards
+- H.264 codec, AAC audio, MP4 container
+- Minimum 720p (1080p preferred)
+- Subtitles/captions always (accessibility + sound-off viewing)
+- Brand mention within first 5s (awareness) or at CTA (performance)
+
+## Output
+
+### Creative Quality Report
+
+```
+Cross-Platform Creative Health
+
+Google:     ████████░░  X/X checks passing
+Meta:       ██████████  X/X checks passing
+LinkedIn:   ███████░░░  X/X checks passing
+TikTok:     █████░░░░░  X/X checks passing
+Microsoft:  ████████░░  X/X checks passing
+```
+
+### Deliverables
+- `CREATIVE-AUDIT-REPORT.md`: Per-platform creative assessment
+- Fatigue alerts (any creative past refresh cadence)
+- Format diversity gaps per platform
+- Production priority list (most impactful creative to produce next)
+- Quick Wins (format conversions, CTA changes, Spark Ads setup)