agileflow 3.3.0 → 3.4.0

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

@@ -0,0 +1,97 @@
+---
+description: Budget allocation and bidding strategy optimizer with industry benchmarks, platform minimums, scaling rules, and reallocation recommendations
+argument-hint: "<account-data>"
+compact_context:
+  priority: medium
+  preserve_rules:
+    - "ACTIVE COMMAND: /agileflow:ads:budget - Budget & bidding strategy"
+    - "Delegate to ads-audit-budget agent for 24 checks"
+    - "Include platform minimums and scaling rules"
+  state_fields:
+    - budget_score
+    - total_spend
+---
+
+# /agileflow:ads:budget
+
+Run a budget allocation and bidding strategy audit using the `ads-audit-budget` agent with 24 checks, including industry benchmarks and specific reallocation recommendations.
+
+---
+
+## Quick Reference
+
+```
+/agileflow:ads:budget <account-data>                  # Full budget audit
+```
+
+---
+
+## Process
+
+### STEP 1: Validate Input
+
+If no data provided, ask for:
+- Monthly spend per platform
+- Campaign-level budgets and performance
+- Bid strategies in use
+- Conversion data (volume, CPA, ROAS)
+- Industry and target metrics
+
+### STEP 2: Deploy Budget Analyzer
+
+```xml
+<invoke name="Task">
+<parameter name="description">Budget and bidding audit</parameter>
+<parameter name="prompt">TASK: Audit budget allocation and bidding strategy.
+
+ACCOUNT DATA:
+{budget_data}
+
+Apply ALL 24 checks across 4 categories:
+- Budget Allocation (35%) - 8 checks
+- Bidding Strategy (30%) - 8 checks
+- Scaling & Pacing (20%) - 4 checks
+- Platform Mix (15%) - 4 checks
+
+Enforce platform minimums, scaling rules, and 3x Kill Rule.
+Include specific dollar reallocation recommendations.
+
+OUTPUT: Full findings with Budget Score X/100</parameter>
+<parameter name="subagent_type">ads-audit-budget</parameter>
+</invoke>
+```
+
+### STEP 3: Present Results
+
+Show Budget Score with specific reallocation recommendations.
+
+---
+
+## Platform Minimums
+
+| Platform | Campaign Minimum | Ad Set/Group Minimum |
+|----------|-----------------|---------------------|
+| Google Ads | $10/day | $5/day |
+| Meta Ads | $20/day | $10/day |
+| LinkedIn Ads | $50/day | $25/day |
+| TikTok Ads | $50/day campaign | $20/day ad group |
+| Microsoft Ads | $10/day | $5/day |
+
+## Scaling Rules
+
+1. Max 20% budget increase per week
+2. Only scale campaigns that exited learning phase
+3. 3x Kill Rule: Pause if CPA > 3x target
+4. Minimum 2 weeks data before major changes
+
+---
+
+<!-- COMPACT_SUMMARY_START -->
+## Compact Summary
+
+**Command**: `/agileflow:ads:budget` - Budget & bidding strategy audit
+
+**Agent**: `ads-audit-budget` (24 checks, 4 categories)
+
+**Quick Usage**: `/agileflow:ads:budget <account-data>`
+<!-- COMPACT_SUMMARY_END -->

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

@@ -0,0 +1,112 @@
+---
+description: Competitive intelligence for paid advertising - market positioning, messaging gaps, ad copy analysis, and strategic recommendations
+argument-hint: "<industry-or-competitors>"
+compact_context:
+  priority: medium
+  preserve_rules:
+    - "ACTIVE COMMAND: /agileflow:ads:competitor - Competitive intelligence"
+    - "Use WebSearch for competitor research"
+    - "Focus on ad-specific competitive factors"
+  state_fields:
+    - industry
+    - competitors
+---
+
+# /agileflow:ads:competitor
+
+Analyze competitive landscape for paid advertising, including competitor ad strategies, messaging positioning, and market gaps.
+
+---
+
+## Quick Reference
+
+```
+/agileflow:ads:competitor "SaaS project management"      # Industry research
+/agileflow:ads:competitor "competitor1, competitor2"       # Specific competitors
+```
+
+---
+
+## Process
+
+### STEP 1: Identify Competitors
+
+If competitors not specified, use WebSearch to identify top advertisers in the space:
+- Search for industry keywords and note who's advertising
+- Look for "Sponsored" results on Google
+- Check Meta Ad Library for active advertisers
+
+### STEP 2: Analyze Competitor Ads
+
+For each competitor, research:
+
+| Factor | How to Find | What to Note |
+|--------|------------|-------------|
+| **Ad copy themes** | Google search, Ad Library | Headlines, CTAs, value props |
+| **Landing pages** | Click through ads | Page structure, offers, forms |
+| **Platforms active** | Ad libraries, social | Which platforms they invest in |
+| **Offer positioning** | Ad copy, landing pages | Free trial, discount, demo |
+| **Audience signals** | LinkedIn ads, social targeting | Who they're targeting |
+| **Creative style** | Ad Library | Video vs image, UGC, professional |
+
+### STEP 3: Gap Analysis
+
+Identify opportunities the user can exploit:
+
+```markdown
+## Competitive Intelligence Report
+
+### Competitor Overview
+
+| Competitor | Platforms | Key Message | Offer | Ad Style |
+|-----------|-----------|------------|-------|---------|
+| {name} | {platforms} | {message} | {offer} | {style} |
+
+### Messaging Gaps
+{Where competitors are NOT messaging - opportunities for differentiation}
+
+### Ad Format Gaps
+{Ad types/platforms competitors aren't using}
+
+### Positioning Recommendations
+1. **Differentiate on**: {unique angle}
+2. **Counter-position**: {how to position against top competitor}
+3. **Underserved keyword themes**: {keyword areas competitors miss}
+
+### Suggested Ad Copy Angles
+- **Angle 1**: {headline idea} - Why: {competitive reason}
+- **Angle 2**: {headline idea} - Why: {competitive reason}
+- **Angle 3**: {headline idea} - Why: {competitive reason}
+```
+
+### STEP 4: Offer Next Steps
+
+```xml
+<invoke name="AskUserQuestion">
+<parameter name="questions">[{
+  "question": "Competitive analysis complete. {N} competitors analyzed, {M} messaging gaps found.",
+  "header": "Next steps",
+  "multiSelect": false,
+  "options": [
+    {"label": "Build campaign plan using these insights (Recommended)", "description": "Run /agileflow:ads:plan with competitive positioning"},
+    {"label": "Audit our current ads against findings", "description": "Compare your ads to competitor strategies"},
+    {"label": "Deep-dive into specific competitor", "description": "More detailed analysis of one competitor"},
+    {"label": "Generate ad copy based on gaps", "description": "Create ad copy exploiting found gaps"}
+  ]
+}]</parameter>
+</invoke>
+```
+
+---
+
+<!-- COMPACT_SUMMARY_START -->
+## Compact Summary
+
+**Command**: `/agileflow:ads:competitor` - Competitive intelligence for ads
+
+**Input**: Industry or competitor names
+
+**Output**: Competitor ad analysis, messaging gaps, positioning recommendations
+
+**Quick Usage**: `/agileflow:ads:competitor <industry-or-competitors>`
+<!-- COMPACT_SUMMARY_END -->

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

@@ -0,0 +1,85 @@
+---
+description: Cross-platform creative quality review with 21 checks for ad copy effectiveness, visual compliance, format coverage, and performance testing
+argument-hint: "<account-data>"
+compact_context:
+  priority: medium
+  preserve_rules:
+    - "ACTIVE COMMAND: /agileflow:ads:creative - Creative quality review"
+    - "Delegate to ads-audit-creative agent for 21 checks"
+  state_fields:
+    - creative_score
+---
+
+# /agileflow:ads:creative
+
+Run a creative quality audit across all ad platforms using the `ads-audit-creative` agent with 21 checks.
+
+---
+
+## Quick Reference
+
+```
+/agileflow:ads:creative <account-data>                # Cross-platform creative review
+```
+
+---
+
+## Process
+
+### STEP 1: Validate Input
+
+If no data provided, ask the user to share:
+- Ad copy (headlines, descriptions, primary text)
+- Creative assets (image specs, video details)
+- Platform-specific formatting
+- Performance metrics (CTR, CPC, frequency)
+
+### STEP 2: Deploy Creative Analyzer
+
+```xml
+<invoke name="Task">
+<parameter name="description">Creative quality audit</parameter>
+<parameter name="prompt">TASK: Audit creative quality across all platforms.
+
+ACCOUNT DATA:
+{creative_data}
+
+Apply ALL 21 checks across 4 categories:
+- Ad Copy Effectiveness (30%) - 7 checks
+- Visual & Format Compliance (25%) - 6 checks
+- Platform-Specific Requirements (25%) - 4 checks
+- Performance & Testing (20%) - 4 checks
+
+Check safe zones (TikTok, Meta Stories), character limits, and restricted content.
+
+OUTPUT: Full findings with Creative Score X/100</parameter>
+<parameter name="subagent_type">ads-audit-creative</parameter>
+</invoke>
+```
+
+### STEP 3: Present Results
+
+Show Creative Score and offer actionable next steps.
+
+---
+
+## 21 Checks Overview
+
+| Category | Weight | Checks | Focus |
+|----------|--------|--------|-------|
+| Ad Copy Effectiveness | 30% | 7 | Value prop, CTA, social proof, keyword alignment |
+| Visual & Format | 25% | 6 | Resolution, text overlay, brand, mobile-first |
+| Platform Requirements | 25% | 4 | Format coverage, native style, char limits, compliance |
+| Performance & Testing | 20% | 4 | Diversity, winner ID, refresh cadence, A/B testing |
+
+---
+
+<!-- COMPACT_SUMMARY_START -->
+## Compact Summary
+
+**Command**: `/agileflow:ads:creative` - Cross-platform creative quality review
+
+**Agent**: `ads-audit-creative` (21 checks, 4 categories)
+
+**Quick Usage**: `/agileflow:ads:creative <account-data>`
+<!-- COMPACT_SUMMARY_END -->

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 -->