agileflow 3.2.1 → 3.4.0

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

@@ -0,0 +1,112 @@
+---
+description: Google Ads deep-dive audit with 74 deterministic checks across conversion tracking, spend efficiency, account structure, keywords, ad copy, and settings
+argument-hint: "<account-data>"
+compact_context:
+  priority: medium
+  preserve_rules:
+    - "ACTIVE COMMAND: /agileflow:ads:google - Google Ads deep-dive"
+    - "Delegate to ads-audit-google agent for 74 checks"
+    - "Quality gates: tracking required, no Broad without Smart Bidding, 3x Kill Rule"
+  state_fields:
+    - google_score
+---
+
+# /agileflow:ads:google
+
+Run a deep-dive audit on a Google Ads account using the `ads-audit-google` agent with 74 deterministic checks across 6 categories.
+
+---
+
+## Quick Reference
+
+```
+/agileflow:ads:google <account-data>                  # Full Google Ads audit
+```
+
+---
+
+## Process
+
+### STEP 1: Validate Input
+
+If no account data provided, ask the user to paste or describe their Google Ads setup including:
+- Campaign types and objectives
+- Budget and spend data
+- Keyword match types and Quality Scores
+- Ad copy and extensions
+- Conversion tracking setup
+- Bid strategies in use
+
+### STEP 2: Deploy Google Ads Analyzer
+
+```xml
+<invoke name="Task">
+<parameter name="description">Google Ads deep-dive audit</parameter>
+<parameter name="prompt">TASK: Run a comprehensive Google Ads audit.
+
+ACCOUNT DATA:
+{account_data}
+
+Apply ALL 74 checks across 6 weighted categories:
+- Conversion Tracking (25%) - 12 checks
+- Wasted Spend (25%) - 15 checks
+- Account Structure (15%) - 12 checks
+- Keyword Strategy (15%) - 14 checks
+- Ad Copy Quality (10%) - 11 checks
+- Campaign Settings (10%) - 10 checks
+
+Enforce ALL quality gates:
+1. No optimization without conversion tracking
+2. No Broad Match without Smart Bidding
+3. 3x Kill Rule for CPA
+4. Brand/non-brand separation
+
+OUTPUT: Full findings with Google Ads Score X/100</parameter>
+<parameter name="subagent_type">ads-audit-google</parameter>
+</invoke>
+```
+
+### STEP 3: Present Results
+
+Show the Google Ads Score and key findings, then offer next steps:
+
+```xml
+<invoke name="AskUserQuestion">
+<parameter name="questions">[{
+  "question": "Google Ads Audit: Score {X}/100. {N} findings ({critical} critical). Quality gates: {status}.",
+  "header": "Next steps",
+  "multiSelect": false,
+  "options": [
+    {"label": "Fix critical issues (Recommended)", "description": "{top issues}"},
+    {"label": "Run full multi-platform audit", "description": "Check all platforms together"},
+    {"label": "Optimize budget allocation", "description": "Run /agileflow:ads:budget"},
+    {"label": "Review creative quality", "description": "Run /agileflow:ads:creative"}
+  ]
+}]</parameter>
+</invoke>
+```
+
+---
+
+## 74 Checks Overview
+
+| Category | Weight | Checks | Focus |
+|----------|--------|--------|-------|
+| Conversion Tracking | 25% | 12 | Tag, enhanced conversions, CAPI, consent mode |
+| Wasted Spend | 25% | 15 | Negatives, search terms, 3x rule, QS, network |
+| Account Structure | 15% | 12 | Naming, ad groups, PMax isolation, experiments |
+| Keyword Strategy | 15% | 14 | Match types, QS distribution, intent alignment |
+| Ad Copy Quality | 10% | 11 | RSAs, headlines, CTAs, extensions, testing |
+| Campaign Settings | 10% | 10 | Bidding, location, auto-apply, remarketing |
+
+---
+
+<!-- COMPACT_SUMMARY_START -->
+## Compact Summary
+
+**Command**: `/agileflow:ads:google` - Google Ads deep-dive audit
+
+**Agent**: `ads-audit-google` (74 checks, 6 categories)
+
+**Quick Usage**: `/agileflow:ads:google <account-data>`
+<!-- COMPACT_SUMMARY_END -->

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

@@ -0,0 +1,119 @@
+---
+description: Landing page optimization audit for ad campaigns - Core Web Vitals, CTA effectiveness, trust signals, mobile experience, and message match
+argument-hint: "<URL>"
+compact_context:
+  priority: medium
+  preserve_rules:
+    - "ACTIVE COMMAND: /agileflow:ads:landing - Landing page optimization"
+    - "Use WebFetch to analyze the actual landing page"
+    - "Check CWV, CTA, trust signals, mobile, message match"
+  state_fields:
+    - target_url
+    - landing_score
+---
+
+# /agileflow:ads:landing
+
+Audit a landing page for paid advertising effectiveness. Analyzes the page for conversion rate optimization factors that directly impact ad campaign performance.
+
+---
+
+## Quick Reference
+
+```
+/agileflow:ads:landing https://example.com/offer           # Audit landing page
+```
+
+---
+
+## Process
+
+### STEP 1: Fetch Landing Page
+
+Use WebFetch to retrieve the target URL. Extract:
+- Page structure (H1, form, CTA buttons)
+- Load performance indicators
+- Trust signals (testimonials, badges, reviews)
+- Mobile responsiveness indicators
+- Form fields and friction points
+
+### STEP 2: Run 15 Checks
+
+| # | Check | Severity | Pass Criteria |
+|---|-------|----------|---------------|
+| LP-1 | Page loads < 3 seconds | HIGH | LCP < 2.5s, FCP < 1.8s |
+| LP-2 | Single clear CTA | HIGH | One primary CTA visible above fold |
+| LP-3 | Headline matches ad copy | CRITICAL | H1 reflects the ad's promise |
+| LP-4 | Mobile responsive | HIGH | Viewport meta + responsive design |
+| LP-5 | Form friction | HIGH | < 5 form fields for lead gen |
+| LP-6 | Trust signals present | MEDIUM | Testimonials, reviews, badges, logos |
+| LP-7 | No navigation distractions | MEDIUM | Minimal or no top navigation |
+| LP-8 | Social proof | MEDIUM | Customer count, ratings, case studies |
+| LP-9 | Urgency element | LOW | Deadline, limited availability (if genuine) |
+| LP-10 | Phone number visible | MEDIUM | Click-to-call for service businesses |
+| LP-11 | Privacy policy linked | HIGH | Required for ad platform compliance |
+| LP-12 | SSL certificate | CRITICAL | HTTPS required |
+| LP-13 | No broken images/links | HIGH | All resources load correctly |
+| LP-14 | Thank you page/confirmation | MEDIUM | Post-conversion confirmation page |
+| LP-15 | Tracking pixels present | CRITICAL | GTM/Pixel/tag detected on page |
+
+### STEP 3: Score and Report
+
+```markdown
+## Landing Page Audit: {URL}
+
+**Landing Page Score**: {X}/100
+
+| Check | Status | Severity | Notes |
+|-------|--------|----------|-------|
+| LP-1 Page speed | PASS/FAIL | HIGH | {LCP time} |
+| ... | ... | ... | ... |
+
+### Critical Issues
+{List any CRITICAL failures}
+
+### Quick Wins
+{Easy fixes that improve conversion rate}
+
+### Message Match Analysis
+- **Ad headline**: {if provided}
+- **Landing page H1**: {extracted}
+- **Match quality**: {Strong/Weak/Mismatch}
+
+### Conversion Rate Optimization Suggestions
+1. {Specific suggestion with expected impact}
+2. {Suggestion}
+3. {Suggestion}
+```
+
+### STEP 4: Offer Next Steps
+
+```xml
+<invoke name="AskUserQuestion">
+<parameter name="questions">[{
+  "question": "Landing page score: {X}/100. {N} issues found. What would you like to do?",
+  "header": "Next steps",
+  "multiSelect": false,
+  "options": [
+    {"label": "Fix critical issues (Recommended)", "description": "{top issue}"},
+    {"label": "Run full ads audit", "description": "Check ad account + landing page together"},
+    {"label": "Test another landing page", "description": "Compare multiple landing pages"},
+    {"label": "Optimize for specific platform", "description": "Platform-specific landing page requirements"}
+  ]
+}]</parameter>
+</invoke>
+```
+
+---
+
+<!-- COMPACT_SUMMARY_START -->
+## Compact Summary
+
+**Command**: `/agileflow:ads:landing` - Landing page optimization for ads
+
+**Input**: URL of landing page
+
+**Output**: 15-check audit with CRO suggestions
+
+**Quick Usage**: `/agileflow:ads:landing <URL>`
+<!-- COMPACT_SUMMARY_END -->

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

@@ -0,0 +1,112 @@
+---
+description: LinkedIn Ads audit with 9 checks for lead gen forms, audience targeting, budget efficiency, and CRM integration
+argument-hint: "<account-data>"
+compact_context:
+  priority: medium
+  preserve_rules:
+    - "ACTIVE COMMAND: /agileflow:ads:linkedin - LinkedIn Ads audit"
+    - "Inline command - 9 checks, no separate agent needed"
+    - "Min budget: $50/day campaign, $25/day ad group"
+  state_fields:
+    - linkedin_score
+---
+
+# /agileflow:ads:linkedin
+
+Run an inline audit on a LinkedIn Ads account with 9 focused checks. LinkedIn has the highest CPCs in paid social, so efficiency is critical.
+
+---
+
+## Quick Reference
+
+```
+/agileflow:ads:linkedin <account-data>                # LinkedIn Ads audit
+```
+
+---
+
+## The 9 Checks
+
+| # | Check | Severity | Pass Criteria |
+|---|-------|----------|---------------|
+| LI-1 | Insight Tag installed | CRITICAL | LinkedIn Insight Tag on all pages |
+| LI-2 | Lead Gen Forms vs landing pages | HIGH | Lead Gen Forms tested (typically 2-5x better CVR) |
+| LI-3 | Audience size appropriate | HIGH | 50K-500K for Sponsored Content |
+| LI-4 | Company/title targeting precision | HIGH | Targeting by job title or function, not just industry |
+| LI-5 | Budget meets minimum | CRITICAL | Minimum $50/day per campaign |
+| LI-6 | CRM integration active | HIGH | Leads syncing to CRM within 24 hours |
+| LI-7 | Content type mix | MEDIUM | Single image + carousel + video tested |
+| LI-8 | Matched Audiences | MEDIUM | Website retargeting + company list + LAL active |
+| LI-9 | ABM alignment | LOW | Account-Based Marketing lists for enterprise |
+
+---
+
+## Process
+
+### STEP 1: Apply All 9 Checks
+
+Review the account data against each check. For LinkedIn specifically:
+
+**Budget reality check**: LinkedIn CPCs are $5-15 for Sponsored Content. With $50/day minimum:
+- Daily clicks: ~3-10
+- Monthly clicks: ~100-300
+- At 5% conversion rate: ~5-15 leads/month
+- **Minimum viable budget for lead gen: $100/day recommended**
+
+**Lead Gen Forms vs Landing Pages**:
+- Lead Gen Forms: 10-30% conversion rate (pre-filled data)
+- Landing Pages: 2-5% conversion rate
+- Always test Lead Gen Forms first on LinkedIn
+
+### STEP 2: Score
+
+```
+LinkedIn Score = 100 - sum(severity_deductions)
+```
+
+Deductions: CRITICAL (-15), HIGH (-8), MEDIUM (-4), LOW (-2)
+
+### STEP 3: Output
+
+```markdown
+## LinkedIn Ads Audit
+
+**LinkedIn Score**: {X}/100
+
+| Check | Status | Notes |
+|-------|--------|-------|
+| LI-1 Insight Tag | PASS/FAIL | {details} |
+| LI-2 Lead Gen Forms | PASS/FAIL | {details} |
+| LI-3 Audience size | PASS/FAIL | {size estimate} |
+| LI-4 Targeting precision | PASS/FAIL | {targeting method} |
+| LI-5 Budget minimum | PASS/FAIL | ${daily}/day |
+| LI-6 CRM integration | PASS/FAIL | {sync status} |
+| LI-7 Content types | PASS/FAIL | {formats in use} |
+| LI-8 Matched Audiences | PASS/FAIL | {audience types} |
+| LI-9 ABM alignment | PASS/FAIL | {ABM status} |
+
+### Key Recommendations
+1. {Top priority fix}
+2. {Second priority}
+3. {Third priority}
+
+### LinkedIn-Specific Tips
+- Use Lead Gen Forms for B2B lead generation (2-5x better CVR)
+- Minimum audience size 50K for Sponsored Content
+- Test Document Ads for thought leadership
+- Message Ads have highest response rate but lowest scale
+```
+
+---
+
+<!-- COMPACT_SUMMARY_START -->
+## Compact Summary
+
+**Command**: `/agileflow:ads:linkedin` - LinkedIn Ads audit
+
+**Checks**: 9 (inline, no separate agent)
+
+**Key**: Min $50/day, Lead Gen Forms > Landing Pages, 50K-500K audience
+
+**Quick Usage**: `/agileflow:ads:linkedin <account-data>`
+<!-- COMPACT_SUMMARY_END -->

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

@@ -0,0 +1,91 @@
+---
+description: Meta/Facebook Ads deep-dive audit with 46 deterministic checks across Pixel/CAPI tracking, creative strategy, account structure, and audience targeting
+argument-hint: "<account-data>"
+compact_context:
+  priority: medium
+  preserve_rules:
+    - "ACTIVE COMMAND: /agileflow:ads:meta - Meta Ads deep-dive"
+    - "Delegate to ads-audit-meta agent for 46 checks"
+    - "Quality gates: Pixel required, domain verified, learning phase, Special Ad Categories"
+  state_fields:
+    - meta_score
+---
+
+# /agileflow:ads:meta
+
+Run a deep-dive audit on a Meta/Facebook Ads account using the `ads-audit-meta` agent with 46 deterministic checks across 4 categories.
+
+---
+
+## Quick Reference
+
+```
+/agileflow:ads:meta <account-data>                    # Full Meta Ads audit
+```
+
+---
+
+## Process
+
+### STEP 1: Validate Input
+
+If no account data provided, ask the user to paste or describe their Meta Ads setup including:
+- Pixel and CAPI setup
+- Campaign objectives and structure
+- Audience targeting (LAL, custom, interest)
+- Creative assets and formats
+- Budget and performance metrics
+
+### STEP 2: Deploy Meta Ads Analyzer
+
+```xml
+<invoke name="Task">
+<parameter name="description">Meta Ads deep-dive audit</parameter>
+<parameter name="prompt">TASK: Run a comprehensive Meta/Facebook Ads audit.
+
+ACCOUNT DATA:
+{account_data}
+
+Apply ALL 46 checks across 4 weighted categories:
+- Pixel & CAPI Tracking (30%) - 12 checks
+- Creative Strategy (25%) - 14 checks
+- Account Structure (25%) - 10 checks
+- Audience Targeting (20%) - 10 checks
+
+Enforce ALL quality gates:
+1. Pixel installed and firing
+2. Domain verified
+3. Learning phase healthy (50 conversions/week)
+4. Special Ad Categories declared
+
+OUTPUT: Full findings with Meta Ads Score X/100</parameter>
+<parameter name="subagent_type">ads-audit-meta</parameter>
+</invoke>
+```
+
+### STEP 3: Present Results
+
+Show the Meta Ads Score and key findings, then offer next steps.
+
+---
+
+## 46 Checks Overview
+
+| Category | Weight | Checks | Focus |
+|----------|--------|--------|-------|
+| Pixel & CAPI Tracking | 30% | 12 | Pixel, CAPI, EMQ, AEM, dedup, privacy |
+| Creative Strategy | 25% | 14 | Diversity, video, formats, refresh, DCO |
+| Account Structure | 25% | 10 | CBO, objectives, consolidation, learning phase |
+| Audience Targeting | 20% | 10 | LAL, custom, overlap, retargeting, exclusions |
+
+---
+
+<!-- COMPACT_SUMMARY_START -->
+## Compact Summary
+
+**Command**: `/agileflow:ads:meta` - Meta/Facebook Ads deep-dive audit
+
+**Agent**: `ads-audit-meta` (46 checks, 4 categories)
+
+**Quick Usage**: `/agileflow:ads:meta <account-data>`
+<!-- COMPACT_SUMMARY_END -->

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

@@ -0,0 +1,115 @@
+---
+description: Microsoft Ads audit with 7 checks for search partner management, UET tag, LinkedIn targeting, and import quality from Google Ads
+argument-hint: "<account-data>"
+compact_context:
+  priority: medium
+  preserve_rules:
+    - "ACTIVE COMMAND: /agileflow:ads:microsoft - Microsoft Ads audit"
+    - "Inline command - 7 checks, no separate agent needed"
+    - "Often imported from Google - check import quality"
+  state_fields:
+    - microsoft_score
+---
+
+# /agileflow:ads:microsoft
+
+Run an inline audit on a Microsoft Ads (formerly Bing Ads) account with 7 focused checks. Microsoft Ads often runs as a Google import - verify it's optimized for the platform.
+
+---
+
+## Quick Reference
+
+```
+/agileflow:ads:microsoft <account-data>               # Microsoft Ads audit
+```
+
+---
+
+## The 7 Checks
+
+| # | Check | Severity | Pass Criteria |
+|---|-------|----------|---------------|
+| MS-1 | UET tag installed | CRITICAL | Universal Event Tracking tag on all pages |
+| MS-2 | Search partner performance | HIGH | Syndication partners monitored, disabled if poor |
+| MS-3 | Import quality from Google | HIGH | No broken bid strategies or unsupported features |
+| MS-4 | Bid adjustments set | MEDIUM | Microsoft-specific bids (not just Google copy) |
+| MS-5 | LinkedIn profile targeting | HIGH | LinkedIn demographics used for B2B targeting |
+| MS-6 | Audience ads opt-in reviewed | MEDIUM | Microsoft Audience Network reviewed for performance |
+| MS-7 | Conversion goals defined | HIGH | Microsoft-native conversion tracking active |
+
+---
+
+## Process
+
+### STEP 1: Apply All 7 Checks
+
+Review the account data against each check. For Microsoft Ads specifically:
+
+**Import quality matters**:
+- Google imports often bring unsupported features
+- Automated bid strategies may not transfer correctly
+- Negative keyword lists may not sync
+- Review every imported campaign for Microsoft compatibility
+
+**LinkedIn targeting advantage**:
+- Microsoft Ads uniquely offers LinkedIn profile targeting
+- Target by company, industry, job function
+- Powerful for B2B campaigns not using LinkedIn Ads directly
+- Can be layered on top of keyword targeting
+
+**Search partners**:
+- Microsoft Audience Network reaches Yahoo, AOL, DuckDuckGo
+- Performance varies significantly by partner
+- Review partner performance monthly
+- Disable underperforming partners individually
+
+### STEP 2: Score
+
+```
+Microsoft Score = 100 - sum(severity_deductions)
+```
+
+Deductions: CRITICAL (-15), HIGH (-8), MEDIUM (-4), LOW (-2)
+
+### STEP 3: Output
+
+```markdown
+## Microsoft Ads Audit
+
+**Microsoft Score**: {X}/100
+
+| Check | Status | Notes |
+|-------|--------|-------|
+| MS-1 UET tag | PASS/FAIL | {details} |
+| MS-2 Search partners | PASS/FAIL | {partner performance} |
+| MS-3 Import quality | PASS/FAIL | {import issues found} |
+| MS-4 Bid adjustments | PASS/FAIL | {Microsoft-specific bids} |
+| MS-5 LinkedIn targeting | PASS/FAIL | {targeting usage} |
+| MS-6 Audience Network | PASS/FAIL | {opt-in status} |
+| MS-7 Conversion goals | PASS/FAIL | {goals defined} |
+
+### Key Recommendations
+1. {Top priority fix}
+2. {Second priority}
+3. {Third priority}
+
+### Microsoft-Specific Tips
+- LinkedIn profile targeting is Microsoft's unique advantage
+- Don't just "set and forget" Google imports - optimize for Microsoft
+- Search partner performance varies - monitor and exclude poor performers
+- Microsoft audience skews older and higher income than Google
+```
+
+---
+
+<!-- COMPACT_SUMMARY_START -->
+## Compact Summary
+
+**Command**: `/agileflow:ads:microsoft` - Microsoft Ads audit
+
+**Checks**: 7 (inline, no separate agent)
+
+**Key**: UET tag, import quality, LinkedIn targeting, search partners
+
+**Quick Usage**: `/agileflow:ads:microsoft <account-data>`
+<!-- COMPACT_SUMMARY_END -->