agileflow 3.2.1 → 3.4.0

package/src/core/commands/ads/plan.md

@@ -0,0 +1,321 @@
+---
+description: Campaign planning with industry-specific templates, multi-step discovery, budget allocation, and platform recommendations
+argument-hint: "[INDUSTRY=auto] [BUDGET=monthly] [GOAL=conversions]"
+compact_context:
+  priority: medium
+  preserve_rules:
+    - "ACTIVE COMMAND: /agileflow:ads:plan - Campaign planning"
+    - "Use AskUserQuestion for multi-step discovery flow"
+    - "Apply industry-specific templates and platform recommendations"
+    - "Include budget allocation matrix and timeline"
+  state_fields:
+    - industry
+    - budget
+    - goal
+    - platforms
+---
+
+# /agileflow:ads:plan
+
+Generate a comprehensive paid advertising campaign plan with industry-specific templates, platform recommendations, budget allocation, and timeline.
+
+---
+
+## Quick Reference
+
+```
+/agileflow:ads:plan                                     # Interactive planning (recommended)
+/agileflow:ads:plan INDUSTRY=saas BUDGET=5000           # Direct with parameters
+/agileflow:ads:plan INDUSTRY=ecommerce GOAL=roas        # E-commerce with ROAS goal
+```
+
+---
+
+## Multi-Step Discovery Flow
+
+### STEP 1: Business Discovery
+
+```xml
+<invoke name="AskUserQuestion">
+<parameter name="questions">[
+  {
+    "question": "What type of business are you advertising for?",
+    "header": "Industry",
+    "multiSelect": false,
+    "options": [
+      {"label": "SaaS / Software", "description": "Software product, free trials, demos, subscriptions"},
+      {"label": "E-commerce / Retail", "description": "Physical or digital products, online store"},
+      {"label": "Local Services", "description": "Service-area business, appointments, phone calls"},
+      {"label": "B2B / Enterprise", "description": "Long sales cycle, demos, enterprise deals"}
+    ]
+  },
+  {
+    "question": "What's your primary advertising goal?",
+    "header": "Goal",
+    "multiSelect": false,
+    "options": [
+      {"label": "Lead generation (Recommended for most)", "description": "Collect leads, demos, sign-ups"},
+      {"label": "Direct sales / ROAS", "description": "Drive purchases with measurable return"},
+      {"label": "Brand awareness", "description": "Reach and frequency for brand building"},
+      {"label": "App installs", "description": "Drive mobile app downloads"}
+    ]
+  },
+  {
+    "question": "What's your monthly advertising budget?",
+    "header": "Budget",
+    "multiSelect": false,
+    "options": [
+      {"label": "$1,000 - $5,000", "description": "Starter budget - focus on 1-2 platforms"},
+      {"label": "$5,000 - $20,000", "description": "Growth budget - 2-3 platforms recommended"},
+      {"label": "$20,000 - $100,000", "description": "Scale budget - multi-platform strategy"},
+      {"label": "$100,000+", "description": "Enterprise budget - full platform coverage"}
+    ]
+  }
+]</parameter>
+</invoke>
+```
+
+### STEP 2: Platform Selection
+
+Based on industry and budget, recommend platforms:
+
+```xml
+<invoke name="AskUserQuestion">
+<parameter name="questions">[{
+  "question": "Based on {industry} with ${budget}/mo budget, which platforms do you want to include?",
+  "header": "Platforms",
+  "multiSelect": true,
+  "options": [
+    {"label": "Google Ads (Recommended)", "description": "Search intent capture - best for {reason}"},
+    {"label": "Meta Ads (Recommended)", "description": "Prospecting and retargeting - {audience_size}"},
+    {"label": "LinkedIn Ads", "description": "B2B targeting - min $50/day recommended"},
+    {"label": "TikTok Ads", "description": "Younger demographics - min $50/day campaign"}
+  ]
+}]</parameter>
+</invoke>
+```
+
+### STEP 3: Generate Campaign Plan
+
+Based on discoveries, generate the full plan.
+
+---
+
+## Industry Templates
+
+### SaaS / Software
+```markdown
+## Campaign Structure: SaaS
+
+### Google Ads (40% of budget)
+- **Search - Brand**: Protect brand terms, tCPA bidding
+- **Search - Non-Brand (High Intent)**: "buy", "pricing", "vs", "alternative" keywords
+- **Search - Non-Brand (Research)**: "how to", "best", "what is" keywords
+- **Performance Max**: Product feed + audience signals
+
+### Meta Ads (35% of budget)
+- **Prospecting - Lookalike**: LAL from trial signups/demos
+- **Prospecting - Interest**: Job titles, competitor interests
+- **Retargeting - Website**: 30/60/90 day windows
+- **Retargeting - Engagement**: Video viewers, page engagers
+
+### LinkedIn Ads (25% of budget)
+- **Sponsored Content**: Thought leadership, case studies
+- **Lead Gen Forms**: Direct lead capture (no landing page)
+- **Retargeting**: Website visitors, engagement audiences
+
+### KPIs
+| Metric | Target |
+|--------|--------|
+| CPL (MQL) | $50-150 |
+| CPL (SQL) | $150-400 |
+| Trial-to-Paid | 15-25% |
+| ROAS (12mo LTV) | 5:1+ |
+```
+
+### E-commerce / Retail
+```markdown
+## Campaign Structure: E-commerce
+
+### Google Ads (50% of budget)
+- **Shopping / PMax**: Product feed campaigns
+- **Search - Brand**: Brand protection
+- **Search - Non-Brand**: Product + category keywords
+- **Dynamic Search Ads**: Keyword gap coverage
+
+### Meta Ads (40% of budget)
+- **Advantage+ Shopping**: Automated catalog sales
+- **Prospecting - Lookalike**: LAL from purchasers
+- **Retargeting - DPA**: Dynamic product ads
+- **Retargeting - Cart Abandonment**: 7/14/30 day
+
+### TikTok (10% of budget)
+- **Spark Ads**: Boost organic UGC
+- **Collection Ads**: Catalog-driven
+
+### KPIs
+| Metric | Target |
+|--------|--------|
+| ROAS | 3:1 - 5:1 |
+| CPA (Purchase) | < $30-80 |
+| AOV:CPA | > 3:1 |
+| Cart Abandonment Recovery | 10-15% |
+```
+
+### Local Services
+```markdown
+## Campaign Structure: Local Services
+
+### Google Ads (60% of budget)
+- **Search - Service**: "[service] near me", "[service] [city]"
+- **Search - Brand**: Brand protection
+- **Local Service Ads**: Google Guaranteed (if eligible)
+- **Call-Only Campaigns**: Direct phone calls
+
+### Meta Ads (30% of budget)
+- **Prospecting - Radius**: 15-30 mile radius targeting
+- **Retargeting - Website**: Visitors who didn't convert
+- **Lead Gen Forms**: Quick contact form
+
+### Microsoft Ads (10% of budget)
+- **Search Import**: Import Google campaigns
+
+### KPIs
+| Metric | Target |
+|--------|--------|
+| CPL | $15-50 |
+| Cost Per Call | $20-60 |
+| Booking Rate | 25-40% |
+| Customer LTV:CPA | > 5:1 |
+```
+
+### B2B / Enterprise
+```markdown
+## Campaign Structure: B2B
+
+### LinkedIn Ads (40% of budget)
+- **Sponsored Content**: Whitepapers, case studies
+- **Lead Gen Forms**: Gated content
+- **ABM Campaigns**: Matched audiences for target accounts
+- **Retargeting**: Website visitors
+
+### Google Ads (35% of budget)
+- **Search - High Intent**: "enterprise [solution]", "[category] software"
+- **Search - Competitor**: "[competitor] alternative"
+- **Display - Remarketing**: Content downloaders
+- **YouTube**: Product demos
+
+### Meta Ads (25% of budget)
+- **Prospecting - LAL**: From CRM customer list
+- **Retargeting**: Website + LinkedIn crossover
+- **Content Distribution**: Webinar/event promotion
+
+### KPIs
+| Metric | Target |
+|--------|--------|
+| CPL (MQL) | $100-300 |
+| CPL (SQL) | $300-1000 |
+| Pipeline Contribution | 30-50% |
+| Deal Close Rate | 10-20% |
+```
+
+---
+
+## Budget Allocation Matrix
+
+| Monthly Budget | Platforms | Allocation |
+|---------------|-----------|------------|
+| $1K-5K | 1-2 | 70% primary / 30% secondary |
+| $5K-20K | 2-3 | 50% / 30% / 20% |
+| $20K-100K | 3-4 | 40% / 25% / 20% / 15% |
+| $100K+ | 4-6 | Proportional to ROAS by platform |
+
+Within each platform:
+- **70%** Proven campaigns (known performers)
+- **20%** Testing (new audiences, creatives, keywords)
+- **10%** Experimental (new platforms, formats, strategies)
+
+---
+
+## Output Format
+
+```markdown
+# Paid Advertising Campaign Plan
+
+**Industry**: {type}
+**Monthly Budget**: ${amount}
+**Goal**: {primary goal}
+**Platforms**: {selected platforms}
+**Timeline**: {3/6/12 month}
+
+---
+
+## Executive Summary
+{2-3 sentences on the strategy}
+
+---
+
+## Platform Breakdown
+
+### {Platform 1} ({X}% - ${amount}/mo)
+{Campaign structure from template}
+
+### {Platform 2} ({X}% - ${amount}/mo)
+{Campaign structure from template}
+
+---
+
+## Launch Timeline
+
+### Week 1-2: Foundation
+- [ ] Set up conversion tracking on all platforms
+- [ ] Create audiences and upload customer lists
+- [ ] Build campaign structures (no ads yet)
+
+### Week 3-4: Launch
+- [ ] Launch brand campaigns first
+- [ ] Activate retargeting campaigns
+- [ ] Begin prospecting with proven audiences
+
+### Month 2: Optimize
+- [ ] Review search terms, add negatives
+- [ ] Identify winning/losing creatives
+- [ ] Adjust bids based on early data
+
+### Month 3: Scale
+- [ ] Scale winners (20% budget increase/week max)
+- [ ] Pause underperformers (3x Kill Rule)
+- [ ] Test new audiences and creatives
+
+---
+
+## Measurement Framework
+
+| KPI | Target | Measurement |
+|-----|--------|------------|
+| {kpi} | {target} | {how to measure} |
+
+---
+
+## Budget Scaling Rules
+
+1. Only scale campaigns that have exited learning phase
+2. Maximum 20% budget increase per week
+3. 3x Kill Rule: Pause campaigns with CPA > 3x target
+4. Minimum 2 weeks of data before major changes
+5. Never scale and test simultaneously on same campaign
+```
+
+---
+
+<!-- COMPACT_SUMMARY_START -->
+## Compact Summary
+
+**Command**: `/agileflow:ads:plan` - Campaign planning with industry templates
+
+**Input**: Industry + budget + goal (interactive discovery or parameters)
+
+**Output**: Full campaign plan with platform allocation, structure, timeline, and KPIs
+
+**Usage**: `/agileflow:ads:plan [INDUSTRY=auto] [BUDGET=monthly] [GOAL=conversions]`
+<!-- COMPACT_SUMMARY_END -->

package/src/core/commands/ads/tiktok.md

@@ -0,0 +1,129 @@
+---
+description: TikTok Ads audit with 8 checks for learning phase management, budget minimums, creative safe zones, and platform-specific optimization
+argument-hint: "<account-data>"
+compact_context:
+  priority: medium
+  preserve_rules:
+    - "ACTIVE COMMAND: /agileflow:ads:tiktok - TikTok Ads audit"
+    - "Inline command - 8 checks, no separate agent needed"
+    - "Min budget: $50/day campaign, $20/day ad group"
+    - "Learning phase: 50 conversions in 7 days"
+  state_fields:
+    - tiktok_score
+---
+
+# /agileflow:ads:tiktok
+
+Run an inline audit on a TikTok Ads account with 8 focused checks. TikTok requires creative-first strategy and strict learning phase management.
+
+---
+
+## Quick Reference
+
+```
+/agileflow:ads:tiktok <account-data>                  # TikTok Ads audit
+```
+
+---
+
+## The 8 Checks
+
+| # | Check | Severity | Pass Criteria |
+|---|-------|----------|---------------|
+| TT-1 | TikTok Pixel installed | CRITICAL | Pixel on all pages, Events API preferred |
+| TT-2 | Learning phase management | CRITICAL | 50 conversions in 7 days per ad group |
+| TT-3 | Budget meets minimum | CRITICAL | $50/day campaign, $20/day ad group |
+| TT-4 | Creative safe zones | HIGH | Key content within center 720x900px |
+| TT-5 | Video-first creatives | HIGH | All ads are video (no static images) |
+| TT-6 | UGC/authentic style | HIGH | Native-feeling content (not polished ads) |
+| TT-7 | Sound-on design | MEDIUM | Audio is integral, not optional |
+| TT-8 | Creative refresh < 14 days | HIGH | New creatives every 1-2 weeks |
+
+---
+
+## Process
+
+### STEP 1: Apply All 8 Checks
+
+Review the account data against each check. For TikTok specifically:
+
+**Learning phase is critical**:
+- TikTok needs 50 conversions in 7 days per ad group to exit learning
+- At $20/day minimum: $140/week = 50 conversions needed
+- That requires CPA < $2.80 - often unrealistic
+- **Solution**: Optimize for upper-funnel events (View Content, Add to Cart) until volume builds
+
+**Creative safe zones**:
+```
++---------------------------+
+|      Username (130px)     |
+|                           |
+|    +----------------+     |
+|    |                |     |
+|    |   SAFE ZONE    |     |
+|    |  720 x 900px   |     |
+|    |                |     |
+|    +----------------+     |
+|                     |btns |
+|   CTA + Nav (170px) |     |
++---------------------------+
+```
+
+**Creative best practices**:
+- First 3 seconds: Hook with pattern interrupt
+- 15-30 second sweet spot for most objectives
+- Vertical 9:16 only (no landscape)
+- Captions/text overlay for sound-off viewing
+- Trend-aware content outperforms polished ads
+
+### STEP 2: Score
+
+```
+TikTok Score = 100 - sum(severity_deductions)
+```
+
+Deductions: CRITICAL (-15), HIGH (-8), MEDIUM (-4), LOW (-2)
+
+### STEP 3: Output
+
+```markdown
+## TikTok Ads Audit
+
+**TikTok Score**: {X}/100
+
+| Check | Status | Notes |
+|-------|--------|-------|
+| TT-1 Pixel/Events API | PASS/FAIL | {details} |
+| TT-2 Learning phase | PASS/FAIL | {conversion volume} |
+| TT-3 Budget minimum | PASS/FAIL | ${daily}/day |
+| TT-4 Safe zones | PASS/FAIL | {creative analysis} |
+| TT-5 Video-first | PASS/FAIL | {format types} |
+| TT-6 UGC style | PASS/FAIL | {creative style} |
+| TT-7 Sound-on | PASS/FAIL | {audio strategy} |
+| TT-8 Creative refresh | PASS/FAIL | {last refresh date} |
+
+### Key Recommendations
+1. {Top priority fix}
+2. {Second priority}
+3. {Third priority}
+
+### TikTok-Specific Tips
+- "Don't make ads, make TikToks" - native > polished
+- Spark Ads (boosting organic) often outperform traditional ads
+- Creative fatigue hits faster on TikTok (7-14 days vs 30 on Meta)
+- Use Creative Center for trending sounds and formats
+```
+
+---
+
+<!-- COMPACT_SUMMARY_START -->
+## Compact Summary
+
+**Command**: `/agileflow:ads:tiktok` - TikTok Ads audit
+
+**Checks**: 8 (inline, no separate agent)
+
+**Key**: $50/day min, 50 conv/7 days learning, video-only, UGC style
+
+**Quick Usage**: `/agileflow:ads:tiktok <account-data>`
+<!-- COMPACT_SUMMARY_END -->

package/src/core/commands/ads/youtube.md

@@ -0,0 +1,124 @@
+---
+description: YouTube Ads audit for video campaign types, ad formats, targeting strategy, bidding optimization, and creative effectiveness
+argument-hint: "<account-data>"
+compact_context:
+  priority: medium
+  preserve_rules:
+    - "ACTIVE COMMAND: /agileflow:ads:youtube - YouTube Ads audit"
+    - "Inline command - check video formats, campaign types, targeting"
+    - "YouTube runs through Google Ads platform"
+  state_fields:
+    - youtube_score
+---
+
+# /agileflow:ads:youtube
+
+Run an inline audit on YouTube advertising campaigns (managed through Google Ads) focusing on video-specific optimization.
+
+---
+
+## Quick Reference
+
+```
+/agileflow:ads:youtube <account-data>                 # YouTube Ads audit
+```
+
+---
+
+## The 8 Checks
+
+| # | Check | Severity | Pass Criteria |
+|---|-------|----------|---------------|
+| YT-1 | Campaign type alignment | HIGH | Correct campaign type for objective |
+| YT-2 | Video format coverage | HIGH | Multiple formats tested (skippable, bumper, shorts) |
+| YT-3 | Targeting strategy | HIGH | Audience targeting refined beyond demographics |
+| YT-4 | Bidding strategy | HIGH | CPV/CPM/tCPA based on objective |
+| YT-5 | Creative hook in 5 seconds | CRITICAL | First 5 seconds grab attention (before skip) |
+| YT-6 | Companion banner | MEDIUM | Companion banner uploaded for desktop |
+| YT-7 | Frequency capping | HIGH | Frequency cap set (3-5 per week recommended) |
+| YT-8 | Conversion tracking | CRITICAL | YouTube conversions tracked in Google Ads |
+
+---
+
+## Process
+
+### STEP 1: Apply All 8 Checks
+
+Review the account data against each check. For YouTube specifically:
+
+**Campaign types**:
+| Type | Best For | Format |
+|------|---------|--------|
+| Video Reach | Awareness | Bumper (6s) + In-stream |
+| Video Views | Consideration | Skippable in-stream + in-feed |
+| Video Action | Conversions | Skippable in-stream with CTA |
+| Shorts Ads | Awareness + young demo | Vertical 60s max |
+| Demand Gen | Full-funnel | YouTube + Discover + Gmail |
+
+**Creative best practices**:
+- First 5 seconds: Brand + hook (many viewers skip at 5s)
+- CTA overlay throughout (not just at end)
+- Mobile-first: 70%+ YouTube watching is mobile
+- Captions/subtitles: Many watch without sound
+- 15-30 seconds optimal for action campaigns
+- Shorts: Vertical 9:16, authentic style
+
+**Targeting options**:
+- Custom Intent: Based on Google search behavior
+- Affinity: Interest-based broad reach
+- In-Market: Active purchase intent
+- Remarketing: Website visitors, video viewers
+- Customer Match: Upload customer lists
+- Topic/placement: Specific channels/videos
+
+### STEP 2: Score
+
+```
+YouTube Score = 100 - sum(severity_deductions)
+```
+
+Deductions: CRITICAL (-15), HIGH (-8), MEDIUM (-4), LOW (-2)
+
+### STEP 3: Output
+
+```markdown
+## YouTube Ads Audit
+
+**YouTube Score**: {X}/100
+
+| Check | Status | Notes |
+|-------|--------|-------|
+| YT-1 Campaign types | PASS/FAIL | {types in use} |
+| YT-2 Video formats | PASS/FAIL | {formats tested} |
+| YT-3 Targeting | PASS/FAIL | {targeting methods} |
+| YT-4 Bidding | PASS/FAIL | {strategies used} |
+| YT-5 5-second hook | PASS/FAIL | {creative analysis} |
+| YT-6 Companion banner | PASS/FAIL | {banner status} |
+| YT-7 Frequency cap | PASS/FAIL | {cap settings} |
+| YT-8 Conversion tracking | PASS/FAIL | {tracking status} |
+
+### Key Recommendations
+1. {Top priority fix}
+2. {Second priority}
+3. {Third priority}
+
+### YouTube-Specific Tips
+- Video Action campaigns drive most conversions (skippable in-stream with CTA)
+- Custom Intent audiences (based on search) are YouTube's secret weapon
+- Always create Shorts versions of successful long-form ads
+- Test bumper ads (6s) for remarketing - cheap and high frequency
+```
+
+---
+
+<!-- COMPACT_SUMMARY_START -->
+## Compact Summary
+
+**Command**: `/agileflow:ads:youtube` - YouTube Ads audit
+
+**Checks**: 8 (inline, no separate agent)
+
+**Key**: 5-second hook, campaign types, Custom Intent targeting, frequency caps
+
+**Quick Usage**: `/agileflow:ads:youtube <account-data>`
+<!-- COMPACT_SUMMARY_END -->

package/src/core/commands/ads.md

@@ -0,0 +1,128 @@
+---
+description: Paid advertising audit & planning toolkit - multi-platform account audits, campaign planning, budget optimization, and competitive intelligence
+argument-hint: "[subcommand] [account-data]"
+compact_context:
+  priority: medium
+  preserve_rules:
+    - "ACTIVE COMMAND: /agileflow:ads - Paid advertising router"
+    - "Route to the appropriate sub-command based on user intent"
+    - "If no sub-command specified, show the quick reference guide"
+  state_fields:
+    - subcommand
+    - platforms
+---
+
+# /agileflow:ads
+
+Paid advertising audit & planning toolkit for multi-platform account optimization. Routes to specialized sub-commands.
+
+---
+
+## Quick Reference
+
+```
+/agileflow:ads:audit <account-data>                    # Full multi-platform audit (6 parallel analyzers)
+/agileflow:ads:plan                                     # Campaign planning with industry templates
+/agileflow:ads:google <account-data>                    # Google Ads deep-dive (74 checks)
+/agileflow:ads:meta <account-data>                      # Meta/Facebook audit (46 checks)
+/agileflow:ads:creative <account-data>                  # Cross-platform creative review (21 checks)
+/agileflow:ads:budget <account-data>                    # Budget allocation & bidding strategy
+/agileflow:ads:landing <URL>                            # Landing page optimization
+/agileflow:ads:competitor <industry>                    # Competitive intelligence
+/agileflow:ads:linkedin <account-data>                  # LinkedIn audit (9 checks)
+/agileflow:ads:tiktok <account-data>                    # TikTok audit (8 checks)
+/agileflow:ads:microsoft <account-data>                 # Microsoft Ads audit (7 checks)
+/agileflow:ads:youtube <account-data>                   # YouTube audit
+```
+
+---
+
+## Sub-Commands
+
+| Command | Purpose | When to Use |
+|---------|---------|-------------|
+| **audit** | Full multi-platform audit with Ads Health Score | Starting point for any account |
+| **plan** | Campaign planning with industry templates | New campaigns or restructuring |
+| **google** | Google Ads deep-dive (74 checks) | Google-specific optimization |
+| **meta** | Meta/Facebook audit (46 checks) | Meta-specific optimization |
+| **creative** | Cross-platform creative quality | Creative strategy improvement |
+| **budget** | Budget & bidding strategy | Spend optimization |
+| **landing** | Landing page optimization | Conversion rate improvement |
+| **competitor** | Competitive intelligence | Market positioning |
+| **linkedin** | LinkedIn Ads audit | LinkedIn-specific optimization |
+| **tiktok** | TikTok Ads audit | TikTok-specific optimization |
+| **microsoft** | Microsoft Ads audit | Microsoft-specific optimization |
+| **youtube** | YouTube Ads audit | Video campaign optimization |
+
+---
+
+## Account Data Formats
+
+The ads commands accept account data in several formats:
+
+1. **Pasted text** - Copy/paste from ad platform exports (CSV, tables)
+2. **File path** - Point to exported CSV/JSON files
+3. **Structured description** - Describe your account setup in plain text
+4. **Screenshots** - Describe what you see in platform dashboards
+
+For best results, include:
+- Campaign names, types, and objectives
+- Budget and spend data
+- Conversion tracking setup
+- Targeting settings
+- Ad creative details
+- Performance metrics (CPA, ROAS, CTR, CVR)
+
+---
+
+## Routing Logic
+
+If the user provides data without a sub-command, determine intent:
+
+1. **"audit my ads"** -> `/agileflow:ads:audit`
+2. **"plan a campaign"** -> `/agileflow:ads:plan`
+3. **"check my Google Ads"** -> `/agileflow:ads:google`
+4. **"Meta" / "Facebook ads"** -> `/agileflow:ads:meta`
+5. **"creative review"** -> `/agileflow:ads:creative`
+6. **"budget" / "spend" / "bidding"** -> `/agileflow:ads:budget`
+7. **"landing page"** -> `/agileflow:ads:landing`
+8. **"competitor" / "competitive"** -> `/agileflow:ads:competitor`
+9. **"LinkedIn"** -> `/agileflow:ads:linkedin`
+10. **"TikTok"** -> `/agileflow:ads:tiktok`
+11. **"Microsoft" / "Bing"** -> `/agileflow:ads:microsoft`
+12. **"YouTube" / "video ads"** -> `/agileflow:ads:youtube`
+13. **Unclear** -> Show the quick reference and ask which analysis they want
+
+---
+
+## If No Sub-Command Specified
+
+Show the quick reference table above and ask:
+
+```xml
+<invoke name="AskUserQuestion">
+<parameter name="questions">[{
+  "question": "Which advertising analysis would you like to run?",
+  "header": "Ads Analysis",
+  "multiSelect": false,
+  "options": [
+    {"label": "Full multi-platform audit (Recommended)", "description": "Comprehensive 6-analyzer audit with Ads Health Score 0-100"},
+    {"label": "Campaign planning", "description": "Industry-specific campaign templates with budget allocation"},
+    {"label": "Platform-specific audit", "description": "Deep-dive into Google, Meta, LinkedIn, TikTok, Microsoft, or YouTube"},
+    {"label": "Budget & bidding strategy", "description": "Optimize spend allocation and bidding across platforms"}
+  ]
+}]</parameter>
+</invoke>
+```
+
+---
+
+<!-- COMPACT_SUMMARY_START -->
+## Compact Summary
+
+**Command**: `/agileflow:ads` - Paid advertising audit & planning router
+
+**Sub-commands**: audit, plan, google, meta, creative, budget, landing, competitor, linkedin, tiktok, microsoft, youtube
+
+**Quick start**: `/agileflow:ads:audit <account-data>` for full analysis
+<!-- COMPACT_SUMMARY_END -->