agileflow 3.4.0 → 3.4.1

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

@@ -0,0 +1,327 @@
+---
+description: Unified marketing health scorecard — runs ads, SEO, landing page, and tracking audits in parallel to produce a combined score with cross-domain insights
+argument-hint: "<account-data-and-url> [SCOPE=all]"
+compact_context:
+  priority: high
+  preserve_rules:
+    - "ACTIVE COMMAND: /agileflow:ads:health - Unified marketing health scorecard"
+    - "CRITICAL: Deploy ads audit + SEO audit + landing page analysis IN PARALLEL"
+    - "CRITICAL: Combine scores into unified Marketing Health Score with domain weights"
+    - "Domain weights: Ads 40%, SEO 25%, Landing Pages 20%, Tracking 15%"
+    - "Cross-domain insights: tracking gaps affect ads + SEO, landing page quality affects ad ROAS"
+  state_fields:
+    - ads_score
+    - seo_score
+    - landing_score
+    - tracking_score
+    - unified_score
+---
+
+# /agileflow:ads:health
+
+Unified marketing health scorecard that orchestrates ads, SEO, landing page, and tracking audits in parallel, then synthesizes into a single Marketing Health Score with cross-domain insights.
+
+---
+
+## Quick Reference
+
+```
+/agileflow:ads:health <account-data> <landing-page-url>               # Full health check
+/agileflow:ads:health <account-data> SCOPE=ads,seo                    # Ads + SEO only
+/agileflow:ads:health <account-data> SCOPE=ads,landing                # Ads + landing pages only
+```
+
+---
+
+## How It Works
+
+```
++-------------------------------------------------------------------+
+|                    /agileflow:ads:health                            |
+|                                                                     |
+|  1. Parse inputs (ad data + URLs)                                  |
+|  2. Deploy domain audits IN PARALLEL                                |
+|  3. Collect all domain scores                                       |
+|  4. Cross-reference findings across domains                         |
+|  5. Calculate unified Marketing Health Score                        |
+|  6. Generate shareable scorecard                                    |
++-------------------------------------------------------------------+
+
+    +-----------+    +----------+    +-----------+    +----------+
+    |   Ads     |    |   SEO    |    |  Landing  |    | Tracking |
+    |  Audit    |    |  Audit   |    |  Page     |    |  Audit   |
+    | (6 agents)|    |(6 agents)|    | Analysis  |    | (shared) |
+    +-----+-----+    +----+-----+    +-----+-----+    +----+-----+
+          |               |               |               |
+          +---------------+---------------+---------------+
+                                |
+                    +-----------+-----------+
+                    |  Health Score         |
+                    |  Synthesis &          |
+                    |  Cross-Domain         |
+                    |  Insights             |
+                    +-----------------------+
+```
+
+---
+
+## Arguments
+
+| Argument | Values | Default | Description |
+|----------|--------|---------|-------------|
+| account-data | Text, file, or description | Required for ads | Ad account data for ads audit |
+| URL | Landing page URL(s) | Optional | URLs for SEO + landing page analysis |
+| SCOPE | all, ads, seo, landing, tracking | all | Which domains to include |
+
+---
+
+## Step-by-Step Process
+
+### STEP 1: Parse Inputs
+
+Accept a combination of:
+- **Ad account data** (pasted, file, or described) — triggers ads audit
+- **URL(s)** — triggers SEO audit + landing page analysis
+- **Both** — triggers full health check
+
+If insufficient data provided:
+
+```xml
+<invoke name="AskUserQuestion">
+<parameter name="questions">[
+  {
+    "question": "What data do you have for the health check? More data = more comprehensive score.",
+    "header": "Data Sources",
+    "multiSelect": true,
+    "options": [
+      {"label": "Ad account data (Recommended)", "description": "Paste from Google Ads, Meta Ads Manager — enables ads audit (40% of score)"},
+      {"label": "Website/landing page URL", "description": "Your main URL for SEO + landing page analysis (45% of score)"},
+      {"label": "Tracking setup description", "description": "Describe your GTM, pixels, conversion events (15% of score)"}
+    ]
+  }
+]</parameter>
+</invoke>
+```
+
+### STEP 2: Deploy Domain Audits in Parallel
+
+**CRITICAL**: Deploy ALL applicable audits in a SINGLE message with multiple Task calls using `run_in_background: true`.
+
+#### Ads Audit (if ad data provided)
+
+```xml
+<invoke name="Task">
+<parameter name="description">Ads audit for health scorecard</parameter>
+<parameter name="prompt">Run a complete ads audit on this account data. Apply all checks from all 6 analyzers (Google, Meta, Budget, Creative, Tracking, Compliance). Calculate the Ads Health Score.
+
+ACCOUNT DATA:
+{account_data}
+
+OUTPUT: Your Ads Health Score X/100 with category breakdown and top 5 findings by severity.</parameter>
+<parameter name="subagent_type">ads-consensus</parameter>
+<parameter name="run_in_background">true</parameter>
+</invoke>
+```
+
+#### SEO Audit (if URL provided)
+
+```xml
+<invoke name="Task">
+<parameter name="description">SEO audit for health scorecard</parameter>
+<parameter name="prompt">Run a complete SEO audit on this URL. Apply all checks from all 6 analyzers (Technical, Content, Schema, Performance, Images, Sitemap). Calculate the SEO Health Score.
+
+URL: {url}
+
+OUTPUT: Your SEO Health Score X/100 with category breakdown and top 5 findings by severity.</parameter>
+<parameter name="subagent_type">seo-consensus</parameter>
+<parameter name="run_in_background">true</parameter>
+</invoke>
+```
+
+#### Landing Page Analysis (if URL provided)
+
+```xml
+<invoke name="Task">
+<parameter name="description">Landing page analysis for health scorecard</parameter>
+<parameter name="prompt">Analyze this landing page for conversion optimization. Score across these dimensions:
+
+URL: {url}
+
+## Landing Page Scoring (100 points total)
+
+### Above-the-Fold (30 points)
+- Clear headline matching ad intent (10)
+- Visible CTA above fold (10)
+- Social proof visible without scrolling (5)
+- Load time under 3 seconds (5)
+
+### Message Match (25 points)
+- Headline matches ad copy themes (10)
+- Value proposition clarity (10)
+- Single clear conversion goal (5)
+
+### Trust & Proof (20 points)
+- Customer testimonials/logos (8)
+- Security badges/certifications (4)
+- Clear contact information (4)
+- Privacy policy linked (4)
+
+### Form/CTA Optimization (15 points)
+- Minimal form fields for stage (5)
+- CTA button contrast and copy (5)
+- Multiple CTAs on long pages (5)
+
+### Mobile Experience (10 points)
+- Responsive layout (4)
+- Touch-friendly buttons (3)
+- Fast mobile load (3)
+
+OUTPUT: Landing Page Score X/100 with breakdown and top 5 recommendations.</parameter>
+<parameter name="subagent_type">general-purpose</parameter>
+<parameter name="run_in_background">true</parameter>
+</invoke>
+```
+
+#### Tracking Audit (always runs if any data provided)
+
+The tracking score is extracted from the ads audit (if run) or assessed independently from the URL/description.
+
+### STEP 3: Collect Results
+
+Wait for all background tasks to complete using TaskOutput with `block: true`.
+
+### STEP 4: Cross-Domain Insights
+
+After collecting all scores, identify cross-domain correlations:
+
+| Pattern | Domains | Insight |
+|---------|---------|---------|
+| Tracking broken + low ads ROAS | Tracking + Ads | "Your ROAS numbers are unreliable — fix tracking first" |
+| Slow landing page + high CPC | Landing + Ads | "Slow pages increase bounce rate, raising your CPC" |
+| Missing schema + low organic | SEO + Landing | "No structured data means fewer rich snippets in SERPs" |
+| Ad copy mismatch + low CVR | Ads + Landing | "Your ads promise X but landing page delivers Y" |
+| No retargeting pixel + high bounce | Tracking + Landing | "Losing bounced visitors with no way to retarget them" |
+
+### STEP 5: Calculate Unified Score
+
+```
+Marketing Health Score = sum(Domain Score * Domain Weight)
+```
+
+**Domain Weights:**
+| Domain | Weight | Why |
+|--------|--------|-----|
+| Ads | 40% | Direct spend efficiency — highest dollar impact |
+| SEO | 25% | Organic acquisition — compounding long-term value |
+| Landing Pages | 20% | Conversion rate — multiplier for all traffic |
+| Tracking | 15% | Data quality — foundation for all optimization |
+
+**If a domain is excluded** (not in SCOPE or no data), redistribute its weight proportionally to included domains.
+
+**Grade Scale:**
+| Grade | Score | Meaning |
+|-------|-------|---------|
+| A | 90-100 | Excellent — optimized marketing funnel |
+| B | 80-89 | Good — minor improvements available |
+| C | 70-79 | Needs Work — significant gaps in the funnel |
+| D | 60-69 | Poor — major issues across multiple domains |
+| F | < 60 | Critical — fundamental problems, likely wasting significant spend |
+
+### STEP 6: Generate Scorecard
+
+Output a compact, shareable scorecard:
+
+```markdown
+# Marketing Health Scorecard
+
+**Generated**: {YYYY-MM-DD}
+**Account**: {name/description}
+**Scope**: {domains audited}
+
+---
+
+## Marketing Health Score: {X}/100 ({grade})
+
+```
+Ads:      ████████████████████░░░░░░  78/100 (40%)
+SEO:      ██████████████░░░░░░░░░░░░  58/100 (25%)
+Landing:  ████████████████████████░░  92/100 (20%)
+Tracking: ██████░░░░░░░░░░░░░░░░░░░░  25/100 (15%)
+          ──────────────────────────
+Overall:  ██████████████████░░░░░░░░  71/100 (C)
+```
+
+| Domain | Score | Grade | Top Issue |
+|--------|-------|-------|-----------|
+| **Ads** | {X}/100 | {grade} | {top finding} |
+| **SEO** | {X}/100 | {grade} | {top finding} |
+| **Landing Pages** | {X}/100 | {grade} | {top finding} |
+| **Tracking** | {X}/100 | {grade} | {top finding} |
+
+---
+
+## Cross-Domain Insights
+
+1. **{insight title}** ({domains affected})
+   {description and impact}
+
+2. **{insight title}** ({domains affected})
+   {description and impact}
+
+---
+
+## Priority Actions (by estimated $ impact)
+
+| # | Action | Domain | Impact | Effort |
+|---|--------|--------|--------|--------|
+| 1 | {action} | {domain} | {$$} | {Low/Med/High} |
+| 2 | {action} | {domain} | {$$} | {Low/Med/High} |
+| 3 | {action} | {domain} | {$$} | {Low/Med/High} |
+
+---
+
+## Domain Deep-Dives
+
+Run individual audits for detailed findings:
+- `/agileflow:ads:audit` — Full 190-check ads analysis
+- `/agileflow:seo:audit` — Full 6-analyzer SEO audit
+- `/agileflow:ads:landing` — Detailed landing page optimization
+```
+
+Save scorecard to `docs/08-project/health-scorecards/health-scorecard-{YYYYMMDD}.md`.
+
+### STEP 7: Present Results
+
+```xml
+<invoke name="AskUserQuestion">
+<parameter name="questions">[{
+  "question": "Marketing Health Score: {X}/100 ({grade}). Lowest domain: {domain} ({score}/100). {N} cross-domain insights found.",
+  "header": "Next steps",
+  "multiSelect": false,
+  "options": [
+    {"label": "Fix {lowest_domain} issues first (Recommended)", "description": "{top_issue} — estimated ${impact}/mo impact"},
+    {"label": "Deep-dive ads audit", "description": "Run full /agileflow:ads:audit for 190-check analysis"},
+    {"label": "Deep-dive SEO audit", "description": "Run full /agileflow:seo:audit for comprehensive SEO analysis"},
+    {"label": "Generate fix artifacts", "description": "Auto-generate corrected ad copy, schema markup, and meta tags"}
+  ]
+}]</parameter>
+</invoke>
+```
+
+---
+
+<!-- COMPACT_SUMMARY_START -->
+## Compact Summary
+
+**Command**: `/agileflow:ads:health` - Unified marketing health scorecard
+
+**What It Does**: Deploy ads + SEO + landing page + tracking audits in parallel -> cross-domain insights -> Marketing Health Score 0-100
+
+**Domain Weights**: Ads 40%, SEO 25%, Landing Pages 20%, Tracking 15%
+
+**Output**: Shareable scorecard with bar chart, cross-domain insights, and priority actions
+
+**Usage**: `/agileflow:ads:health <account-data> <url> [SCOPE=all]`
+
+**File**: `docs/08-project/health-scorecards/health-scorecard-{YYYYMMDD}.md`
+<!-- COMPACT_SUMMARY_END -->

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

@@ -0,0 +1,317 @@
+---
+description: CPC-first test planning — structured test matrix with budget allocation, CPC thresholds, winner/kill rules, and graduation criteria
+argument-hint: "[BUDGET=100] [DURATION=3d] [VARIANTS=from-generate]"
+compact_context:
+  priority: medium
+  preserve_rules:
+    - "ACTIVE COMMAND: /agileflow:ads:test-plan - CPC-first test planning"
+    - "Generate structured test matrix with decision criteria"
+    - "CPC threshold methodology: $100/3-day test, winner/kill rules"
+    - "Output includes budget allocation, measurement criteria, graduation rules"
+  state_fields:
+    - test_budget
+    - duration
+    - variants
+    - platform
+---
+
+# /agileflow:ads:test-plan
+
+Generate a structured A/B testing plan with budget allocation, CPC-first decision criteria, winner/kill rules, and graduation strategy. Based on the CPC-first testing methodology where cheap clicks validate messaging before optimizing for conversions.
+
+---
+
+## Quick Reference
+
+```
+/agileflow:ads:test-plan                                               # Interactive (recommended)
+/agileflow:ads:test-plan BUDGET=300 DURATION=5d                        # Custom budget/duration
+/agileflow:ads:test-plan VARIANTS=from-generate                        # Use variants from /ads:generate
+/agileflow:ads:test-plan BUDGET=100 PLATFORM=meta                      # Meta-specific test plan
+```
+
+---
+
+## Arguments
+
+| Argument | Values | Default | Description |
+|----------|--------|---------|-------------|
+| BUDGET | Dollar amount | $100 | Total test budget per round |
+| DURATION | Days | 3d | Test duration before decision |
+| VARIANTS | from-generate, manual, or count | from-generate | Source of ad variants to test |
+| PLATFORM | meta, google, linkedin, tiktok | meta | Platform to test on |
+
+---
+
+## CPC-First Testing Methodology
+
+### Why CPC First?
+
+```
+Traditional: Optimize for conversions → need 50+ conversions per variant → $$$
+CPC-First:   Optimize for clicks → need 100+ clicks per variant → $
+
+CPC validates MESSAGE RESONANCE at 1/50th the cost.
+Only graduate winners to conversion optimization.
+```
+
+### The 3-Stage Funnel
+
+```
+Stage 1: CPC Test ($100, 3 days)
+  → Does the message resonate? (CTR + CPC)
+  → Kill: CPC > 2x average
+  → Graduate: CPC < average AND CTR > 1%
+
+Stage 2: Landing Page Test ($300, 7 days)
+  → Do clicks convert? (CVR + CPA)
+  → Kill: CVR < 1% after 200+ clicks
+  → Graduate: CPA < 2x target
+
+Stage 3: Scale Test ($1000+, 14 days)
+  → Does it scale profitably? (ROAS + volume)
+  → Kill: ROAS < 1.5x at 2x budget
+  → Graduate: ROAS > 2x → move to always-on
+```
+
+---
+
+## Multi-Step Discovery Flow
+
+### STEP 1: Test Context
+
+```xml
+<invoke name="AskUserQuestion">
+<parameter name="questions">[
+  {
+    "question": "What stage of testing are you at?",
+    "header": "Test Stage",
+    "multiSelect": false,
+    "options": [
+      {"label": "Stage 1: Message testing (Recommended)", "description": "CPC-first — validate which angles/hooks resonate before spending on conversions"},
+      {"label": "Stage 2: Landing page testing", "description": "I have winning ad copy, now testing landing page variants"},
+      {"label": "Stage 3: Scale testing", "description": "I have winning ads + landing pages, testing budget scaling"},
+      {"label": "Full funnel from scratch", "description": "Generate a complete 3-stage test plan"}
+    ]
+  },
+  {
+    "question": "How many ad variants do you want to test?",
+    "header": "Variants",
+    "multiSelect": false,
+    "options": [
+      {"label": "Use variants from /ads:generate (Recommended)", "description": "Pull variants from the most recent ads-copy generation"},
+      {"label": "5 variants (minimum viable test)", "description": "Test 5 angles with $20 each"},
+      {"label": "10 variants (standard test)", "description": "Test 10 variants with $10 each"},
+      {"label": "20 variants (comprehensive)", "description": "Test 20 variants — requires $200+ budget"}
+    ]
+  }
+]</parameter>
+</invoke>
+```
+
+### STEP 2: Check for Existing Variants
+
+If VARIANTS=from-generate, look for recent ad copy:
+
+```
+docs/08-project/ads-copy/ads-copy-{YYYYMMDD}.md
+```
+
+If found, extract angle names and variant counts. If not found, suggest running `/agileflow:ads:generate` first.
+
+### STEP 3: Generate Test Plan
+
+Based on stage, budget, and variants, generate the test matrix.
+
+---
+
+## Output Format
+
+```markdown
+# Ad Testing Plan
+
+**Generated**: {YYYY-MM-DD}
+**Platform**: {platform}
+**Total Budget**: ${total across all stages}
+**Methodology**: CPC-First → CVR → Scale
+
+---
+
+## Stage 1: Message Resonance Test (CPC-First)
+
+**Budget**: ${budget}
+**Duration**: {duration}
+**Objective**: Traffic (optimize for link clicks)
+**Bidding**: Lowest cost (no cap)
+
+### Test Matrix
+
+| Variant | Angle | Headline | Daily Budget | Min Clicks | Decision By |
+|---------|-------|----------|-------------|------------|-------------|
+| A | Pain Point | "{headline}" | ${daily} | 33 | {date} |
+| B | Outcome | "{headline}" | ${daily} | 33 | {date} |
+| C | Social Proof | "{headline}" | ${daily} | 33 | {date} |
+| D | Urgency | "{headline}" | ${daily} | 33 | {date} |
+| E | Contrarian | "{headline}" | ${daily} | 33 | {date} |
+
+### Decision Criteria
+
+| Metric | Kill | Hold | Graduate |
+|--------|------|------|----------|
+| **CPC** | > ${2x_avg} | ${avg} - ${2x_avg} | < ${avg} |
+| **CTR** | < 0.5% | 0.5% - 1.0% | > 1.0% |
+| **Impressions** | < 500 (insufficient data) | 500-1000 | > 1000 |
+
+### Decision Rules
+
+1. **Kill immediately** if CPC > 2x average after 50+ clicks
+2. **Hold** if CPC is average but CTR is borderline — extend 2 more days
+3. **Graduate** if CPC < average AND CTR > 1.0% — move to Stage 2
+4. **Minimum data**: Do NOT make decisions with < 100 impressions per variant
+5. **Time minimum**: Run at least 48 hours to capture day-of-week variance
+
+### Expected Outcomes
+
+At $100 budget with ~$1.50 CPC:
+- ~67 total clicks across 5 variants
+- ~13 clicks per variant (marginal — consider $200 for statistical confidence)
+- Expected: 1-2 clear winners, 1-2 kills, 1-2 holds
+
+### Budget Scaling (if budget allows)
+
+| Budget | Variants | Clicks/Variant | Confidence |
+|--------|----------|---------------|------------|
+| $100 | 5 | ~13 | Low (directional only) |
+| $200 | 5 | ~27 | Medium (clear signal) |
+| $300 | 5 | ~40 | High (statistically significant) |
+| $500 | 10 | ~33 | High (wider angle coverage) |
+
+---
+
+## Stage 2: Conversion Validation Test
+
+**Budget**: ${stage2_budget}
+**Duration**: 7 days
+**Objective**: Conversions (optimize for leads/purchases)
+**Bidding**: Target CPA (set at 1.5x current CPA)
+
+### Graduates from Stage 1
+{Only variants that passed Stage 1 criteria}
+
+| Variant | Angle | Stage 1 CPC | Stage 1 CTR | Daily Budget |
+|---------|-------|-------------|-------------|-------------|
+| {winner} | {angle} | ${cpc} | {ctr}% | ${daily} |
+
+### Decision Criteria
+
+| Metric | Kill | Hold | Graduate |
+|--------|------|------|----------|
+| **CPA** | > 3x target | 1.5x - 3x target | < 1.5x target |
+| **CVR** | < 1% after 200+ clicks | 1% - 3% | > 3% |
+| **ROAS** (e-commerce) | < 1:1 | 1:1 - 2:1 | > 2:1 |
+
+### The 3x Kill Rule
+
+> **If any campaign's CPA exceeds 3x your target CPA, pause it immediately.**
+> No exceptions. No "let it learn longer." Kill it, iterate the creative, relaunch.
+
+---
+
+## Stage 3: Scale Test
+
+**Budget**: ${stage3_budget}
+**Duration**: 14 days
+**Objective**: Profitable scale
+**Bidding**: Target CPA or Target ROAS
+
+### Scaling Rules
+
+1. **20% Rule**: Never increase budget more than 20% per day
+2. **Learning Phase**: After budget changes, wait 3-5 days before judging
+3. **Diminishing Returns**: Track CPA at each budget level:
+
+| Budget Level | Expected CPA | Actual CPA | CPA Delta | Action |
+|-------------|-------------|-----------|-----------|--------|
+| Baseline ${x} | ${target} | — | — | — |
+| +20% ${x*1.2} | ${target*1.1} | — | — | Continue if < 1.5x |
+| +20% ${x*1.44} | ${target*1.2} | — | — | Pause if > 2x |
+| +20% ${x*1.73} | ${target*1.3} | — | — | — |
+
+4. **Exit criteria**: Stop scaling when CPA increase per 20% budget step exceeds 15%
+
+---
+
+## Test Calendar
+
+| Week | Stage | Action | Budget | Key Metric |
+|------|-------|--------|--------|-----------|
+| 1 | Setup | Create campaigns, install tracking | $0 | Pixel fires ✓ |
+| 1-2 | Stage 1 | CPC message test | ${s1} | CPC + CTR |
+| 2 | Decision | Kill/Hold/Graduate | — | — |
+| 2-3 | Stage 2 | Conversion test (winners) | ${s2} | CPA + CVR |
+| 3 | Decision | Kill/Graduate | — | — |
+| 4-5 | Stage 3 | Scale test | ${s3} | ROAS at scale |
+| 6 | Evergreen | Move winners to always-on | ${ongoing} | Monitor weekly |
+
+---
+
+## Tracking Requirements
+
+Before starting ANY test:
+
+- [ ] Conversion pixel/tag installed and firing
+- [ ] Conversion events defined (lead, purchase, sign-up)
+- [ ] UTM parameters on all ad URLs: `utm_source={platform}&utm_medium=paid&utm_campaign={test_name}&utm_content={variant}`
+- [ ] Google Analytics or equivalent receiving data
+- [ ] Baseline metrics recorded (current CPC, CTR, CPA if available)
+
+---
+
+## Post-Test Analysis Template
+
+After each stage, record:
+
+| Variant | Impressions | Clicks | CTR | CPC | Conversions | CVR | CPA | Decision |
+|---------|------------|--------|-----|-----|------------|-----|-----|----------|
+| A | — | — | — | — | — | — | — | Kill/Hold/Graduate |
+```
+
+Save test plan to `docs/08-project/ads-test-plans/test-plan-{YYYYMMDD}.md`.
+
+---
+
+## Present Results
+
+```xml
+<invoke name="AskUserQuestion">
+<parameter name="questions">[{
+  "question": "Test plan generated: {N} variants across {stages} stages, ${total_budget} total budget, {duration} timeline. Ready to launch?",
+  "header": "Next steps",
+  "multiSelect": false,
+  "options": [
+    {"label": "Generate ad variants to test (Recommended)", "description": "Run /agileflow:ads:generate to create the ad copy for this test plan"},
+    {"label": "Adjust budget or duration", "description": "Modify the test parameters before finalizing"},
+    {"label": "Review tracking setup", "description": "Verify conversion tracking is properly configured before testing"},
+    {"label": "Export for platform", "description": "Format the test plan as platform-specific campaign structure"}
+  ]
+}]</parameter>
+</invoke>
+```
+
+---
+
+<!-- COMPACT_SUMMARY_START -->
+## Compact Summary
+
+**Command**: `/agileflow:ads:test-plan` - CPC-first A/B test planning
+
+**Methodology**: Stage 1 (CPC message test, $100/3d) → Stage 2 (CVR validation, $300/7d) → Stage 3 (Scale test, $1000+/14d)
+
+**Key Rules**: 3x Kill Rule, 20% scaling rule, 48h minimum data, 100+ impressions before decisions
+
+**Output**: Test matrix with decision criteria, scaling rules, and timeline
+
+**Usage**: `/agileflow:ads:test-plan [BUDGET=100] [DURATION=3d] [VARIANTS=from-generate]`
+
+**File**: `docs/08-project/ads-test-plans/test-plan-{YYYYMMDD}.md`
+<!-- COMPACT_SUMMARY_END -->