agileflow 3.4.1 → 3.4.2

package/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.4.2] - 2026-03-07
+
+### Added
+- DEPTH=ultradeep|extreme for SEO and Ads audit commands
+
 ## [3.4.1] - 2026-03-06
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agileflow",
-  "version": "3.4.1",
+  "version": "3.4.2",
   "description": "AI-driven agile development system for Claude Code, Cursor, Windsurf, and more",
   "keywords": [
     "agile",

package/scripts/lib/audit-registry.js

@@ -188,6 +188,42 @@ const AUDIT_TYPES = {
     ],
   },
 
+  seo: {
+    name: 'SEO Audit',
+    prefix: 'SEO',
+    color: '#ff9e64', // rose/orange
+    command: 'seo/audit',
+    analyzers: {
+      technical: { subagent_type: 'seo-analyzer-technical', label: 'Technical SEO' },
+      content: { subagent_type: 'seo-analyzer-content', label: 'Content Quality' },
+      schema: { subagent_type: 'seo-analyzer-schema', label: 'Schema Markup' },
+      images: { subagent_type: 'seo-analyzer-images', label: 'Image Optimization' },
+      performance: { subagent_type: 'seo-analyzer-performance', label: 'Core Web Vitals' },
+      sitemap: { subagent_type: 'seo-analyzer-sitemap', label: 'Sitemap' },
+    },
+    consensus: { subagent_type: 'seo-consensus', label: 'SEO Consensus' },
+    quick_analyzers: ['technical', 'content', 'schema', 'images', 'performance', 'sitemap'],
+    deep_analyzers: ['technical', 'content', 'schema', 'images', 'performance', 'sitemap'],
+  },
+
+  ads: {
+    name: 'Ads Audit',
+    prefix: 'Ads',
+    color: '#89ddff', // ice
+    command: 'ads/audit',
+    analyzers: {
+      google: { subagent_type: 'ads-audit-google', label: 'Google Ads' },
+      meta: { subagent_type: 'ads-audit-meta', label: 'Meta Ads' },
+      budget: { subagent_type: 'ads-audit-budget', label: 'Budget & Bidding' },
+      creative: { subagent_type: 'ads-audit-creative', label: 'Creative Quality' },
+      tracking: { subagent_type: 'ads-audit-tracking', label: 'Conversion Tracking' },
+      compliance: { subagent_type: 'ads-audit-compliance', label: 'Compliance' },
+    },
+    consensus: { subagent_type: 'ads-consensus', label: 'Ads Consensus' },
+    quick_analyzers: ['google', 'meta', 'budget', 'creative', 'tracking', 'compliance'],
+    deep_analyzers: ['google', 'meta', 'budget', 'creative', 'tracking', 'compliance'],
+  },
+
   legal: {
     name: 'Legal Risk',
     prefix: 'Legal',

package/scripts/lib/tmux-group-colors.js

@@ -23,8 +23,8 @@ const GROUP_PALETTE = [
   { name: 'amber', hex: '#e0af68', audit: 'test' },
   { name: 'violet', hex: '#bb9af7', audit: 'completeness' },
   { name: 'lime', hex: '#9ece6a', audit: 'legal' },
-  { name: 'rose', hex: '#ff9e64', audit: null },
-  { name: 'ice', hex: '#89ddff', audit: null },
+  { name: 'rose', hex: '#ff9e64', audit: 'seo' },
+  { name: 'ice', hex: '#89ddff', audit: 'ads' },
 ];
 
 /**

package/scripts/spawn-audit-sessions.js

@@ -420,7 +420,7 @@ async function spawnAuditInTmux(options) {
 
   if (!auditType) {
     console.error(`Unknown audit type: ${options.audit}`);
-    console.error(`Valid types: logic, security, performance, test, completeness, legal`);
+    console.error(`Valid types: logic, security, performance, test, completeness, legal, seo, ads`);
     process.exit(1);
   }
 

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

@@ -1,6 +1,6 @@
 ---
 description: Full multi-platform paid advertising audit with 6 parallel analyzers, industry detection, weighted Ads Health Score 0-100, and prioritized action plan
-argument-hint: "<account-data> [PLATFORMS=all]"
+argument-hint: "<account-data> [DEPTH=quick|deep|ultradeep|extreme] [PLATFORMS=all]"
 compact_context:
   priority: high
   preserve_rules:
@@ -8,10 +8,12 @@ compact_context:
     - "CRITICAL: Deploy 6 analyzers IN PARALLEL in ONE message with multiple Task calls"
     - "CRITICAL: Wait for all results before running consensus (use TaskOutput with block=true)"
     - "CRITICAL: Weighted scoring - Tracking 25%, Wasted Spend 20%, Structure 15%, Creative 15%, Budget 15%, Compliance 10%"
+    - "MUST parse DEPTH argument: quick (default), deep, ultradeep, extreme"
     - "MUST detect industry type before deploying analyzers"
     - "Pass all analyzer outputs to ads-consensus for final report"
     - "Quality Gates: No optimization without tracking, 3x Kill Rule, Broad Match needs Smart Bidding"
   state_fields:
+    - depth
     - platforms
     - industry_type
     - analyzers_deployed
@@ -27,7 +29,10 @@ Deploy 6 specialized advertising analyzers in parallel to audit ad accounts, the
 ## Quick Reference
 
 ```
-/agileflow:ads:audit <account-data>                       # Full audit (all platforms detected)
+/agileflow:ads:audit <account-data>                       # Quick audit (all platforms detected)
+/agileflow:ads:audit <account-data> DEPTH=deep             # Deep audit (more thorough)
+/agileflow:ads:audit <account-data> DEPTH=ultradeep        # Each analyzer in its own tmux session
+/agileflow:ads:audit <account-data> DEPTH=extreme          # Platform-partitioned audit
 /agileflow:ads:audit <account-data> PLATFORMS=google,meta  # Specific platforms only
 ```
 
@@ -74,13 +79,67 @@ Deploy 6 specialized advertising analyzers in parallel to audit ad accounts, the
 | Argument | Values | Default | Description |
 |----------|--------|---------|-------------|
 | account-data | Text, file path, or description | Required | Account data to audit |
+| DEPTH | quick, deep, ultradeep, extreme | quick | quick = standard, deep = comprehensive, ultradeep = tmux sessions, extreme = platform partitions |
 | PLATFORMS | google,meta,linkedin,tiktok,microsoft,youtube | all detected | Limit to specific platforms |
 
 ---
 
 ## Step-by-Step Process
 
-### STEP 1: Parse Account Data
+### STEP 1: Parse Arguments & Account Data
+
+```
+DEPTH = quick (default), deep, ultradeep, or extreme
+PLATFORMS = all detected (default) or comma-separated list
+```
+
+**DEPTH behavior**:
+- `quick` (default): Deploy all 6 analyzers in-process. Standard analysis.
+- `deep`: Deploy all 6 analyzers in-process. More thorough, includes lower-priority findings.
+- `ultradeep`: Spawn each analyzer as a separate Claude Code session in tmux. Requires tmux. Falls back to `deep` if tmux unavailable.
+- `extreme`: Partition-based multi-agent audit. Account data is split by platform and each platform runs ALL analyzers.
+
+**ULTRADEEP mode** (DEPTH=ultradeep):
+1. Show cost estimate:
+   ```bash
+   node .agileflow/scripts/spawn-audit-sessions.js --audit=ads --target=account-data --model=MODEL --dry-run
+   ```
+2. Confirm with user before launching
+3. Spawn sessions (use `--json` to capture trace ID):
+   ```bash
+   node .agileflow/scripts/spawn-audit-sessions.js --audit=ads --target=account-data --model=MODEL --json
+   ```
+   Parse the JSON output to get `traceId`. Example: `{"ok":true,"traceId":"abc123ef",...}`
+4. Wait for all analyzers to complete:
+   ```bash
+   node .agileflow/scripts/lib/tmux-audit-monitor.js wait TRACE_ID --timeout=1800
+   ```
+   - Exit 0 = all complete (JSON results on stdout)
+   - Exit 1 = timeout (partial results on stdout, `missing` array shows what's left)
+5. Parse `results` array from the JSON output. Pass all findings to consensus coordinator.
+6. If tmux unavailable (spawn exits code 2), fall back to `DEPTH=deep` with warning
+
+**EXTREME mode** (DEPTH=extreme):
+Partition-based multi-agent audit. Instead of auditing all platforms together, each platform runs ALL 6 analyzers independently.
+1. Identify active platforms from account data (Google, Meta, LinkedIn, TikTok, etc.)
+2. Group into partitions by platform (each platform = 1 partition)
+   - If user provided PARTITIONS=N (a number), merge smaller platforms into N groups
+   - If user provided PARTITIONS=google,meta, use those exact platforms
+3. Show the partition plan and agent count to the user, confirm before launching:
+   Example: "3 platforms x 6 analyzers = 18 agents. Estimated cost: $X. Proceed?"
+4. Spawn sessions with partitions:
+   ```bash
+   node .agileflow/scripts/spawn-audit-sessions.js --audit=ads --target=account-data --depth=extreme --partitions=google,meta,linkedin --model=MODEL --json
+   ```
+5. Wait and collect results (same as ultradeep - use tmux-audit-monitor.js)
+6. Run consensus on combined results from all platform partitions
+
+**PARTITIONS argument** (only used with DEPTH=extreme):
+| Value | Behavior |
+|-------|----------|
+| Not set | AI decides partitions (1 per detected platform) |
+| `PARTITIONS=3` | AI merges into 3 platform groups |
+| `PARTITIONS=google,meta` | Use these exact platforms |
 
 Accept data in any format:
 - **Pasted CSV/text** - Parse columns and metrics
@@ -355,8 +414,11 @@ After consensus completes, show summary and offer next steps:
 
 **Quick Usage**:
 ```
-/agileflow:ads:audit <account-data>                # Full audit
-/agileflow:ads:audit <data> PLATFORMS=google,meta   # Specific platforms
+/agileflow:ads:audit <account-data>                       # Quick audit
+/agileflow:ads:audit <account-data> DEPTH=deep             # Deep audit
+/agileflow:ads:audit <account-data> DEPTH=ultradeep        # Tmux sessions
+/agileflow:ads:audit <account-data> DEPTH=extreme          # Platform partition audit
+/agileflow:ads:audit <data> PLATFORMS=google,meta           # Specific platforms
 ```
 
 **What It Does**: Parse data -> Detect industry -> Deploy 6 analyzers in parallel -> Consensus weights scores -> Ads Health Score 0-100 -> Prioritized action plan

package/src/core/commands/seo/audit.md

@@ -1,6 +1,6 @@
 ---
 description: Full website SEO audit with 6 parallel analyzers, business type detection, weighted health score 0-100, and prioritized action plan
-argument-hint: "URL [DEPTH=quick|deep] [MAX_PAGES=50]"
+argument-hint: "URL [DEPTH=quick|deep|ultradeep|extreme] [MAX_PAGES=50]"
 compact_context:
   priority: high
   preserve_rules:
@@ -8,7 +8,7 @@ compact_context:
     - "CRITICAL: Deploy 6 analyzers IN PARALLEL in ONE message with multiple Task calls"
     - "CRITICAL: Wait for all results before running consensus (use TaskOutput with block=true)"
     - "CRITICAL: Weighted scoring - Technical 20%, Content 20%, Schema 15%, Performance 15%, Images 15%, Sitemap 15%"
-    - "MUST parse arguments: URL (required), DEPTH (quick/deep), MAX_PAGES (default 50)"
+    - "MUST parse arguments: URL (required), DEPTH (quick/deep/ultradeep/extreme), MAX_PAGES (default 50)"
     - "Fetch homepage FIRST to detect business type before deploying analyzers"
     - "Pass all analyzer outputs to seo-consensus for final report"
   state_fields:
@@ -31,6 +31,8 @@ Deploy 6 specialized SEO analyzers in parallel to audit a website, then synthesi
 ```
 /agileflow:seo:audit https://example.com                     # Quick audit (all 6 analyzers)
 /agileflow:seo:audit https://example.com DEPTH=deep           # Deep audit (more thorough per-analyzer)
+/agileflow:seo:audit https://example.com DEPTH=ultradeep      # Each analyzer in its own tmux session
+/agileflow:seo:audit https://example.com DEPTH=extreme        # Multi-page partition audit
 /agileflow:seo:audit https://example.com MAX_PAGES=100        # Audit up to 100 pages
 ```
 
@@ -76,7 +78,7 @@ Deploy 6 specialized SEO analyzers in parallel to audit a website, then synthesi
 | Argument | Values | Default | Description |
 |----------|--------|---------|-------------|
 | URL | Any valid URL | Required | Homepage URL to audit |
-| DEPTH | quick, deep | quick | quick = standard analysis, deep = comprehensive |
+| DEPTH | quick, deep, ultradeep, extreme | quick | quick = standard, deep = comprehensive, ultradeep = tmux sessions, extreme = page partitions |
 | MAX_PAGES | 1-500 | 50 | Maximum pages to analyze |
 
 ---
@@ -87,10 +89,61 @@ Deploy 6 specialized SEO analyzers in parallel to audit a website, then synthesi
 
 ```
 URL = first argument (required - ask if missing)
-DEPTH = quick (default) or deep
+DEPTH = quick (default), deep, ultradeep, or extreme
 MAX_PAGES = 50 (default)
 ```
 
+**DEPTH behavior**:
+- `quick` (default): Deploy all 6 analyzers in-process. Standard analysis.
+- `deep`: Deploy all 6 analyzers in-process. More thorough per-analyzer, includes lower-priority findings.
+- `ultradeep`: Spawn each analyzer as a separate Claude Code session in tmux. Requires tmux. Falls back to `deep` if tmux unavailable.
+- `extreme`: Partition-based multi-agent audit. Site pages are split into groups and each group runs ALL analyzers.
+
+**ULTRADEEP mode** (DEPTH=ultradeep):
+1. Show cost estimate:
+   ```bash
+   node .agileflow/scripts/spawn-audit-sessions.js --audit=seo --target=URL --model=MODEL --dry-run
+   ```
+2. Confirm with user before launching
+3. Spawn sessions (use `--json` to capture trace ID):
+   ```bash
+   node .agileflow/scripts/spawn-audit-sessions.js --audit=seo --target=URL --model=MODEL --json
+   ```
+   Parse the JSON output to get `traceId`. Example: `{"ok":true,"traceId":"abc123ef",...}`
+4. Wait for all analyzers to complete:
+   ```bash
+   node .agileflow/scripts/lib/tmux-audit-monitor.js wait TRACE_ID --timeout=1800
+   ```
+   - Exit 0 = all complete (JSON results on stdout)
+   - Exit 1 = timeout (partial results on stdout, `missing` array shows what's left)
+   - To check progress without blocking: `node .agileflow/scripts/lib/tmux-audit-monitor.js status TRACE_ID`
+   - To retry stalled analyzers: `node .agileflow/scripts/lib/tmux-audit-monitor.js retry TRACE_ID`
+5. Parse `results` array from the JSON output. Pass all findings to consensus coordinator (same as deep mode).
+6. If tmux unavailable (spawn exits code 2), fall back to `DEPTH=deep` with warning
+
+**EXTREME mode** (DEPTH=extreme):
+Partition-based multi-agent audit. Instead of auditing the entire site as one unit, pages are split into groups and each group runs ALL 6 analyzers.
+1. Fetch sitemap or crawl to discover pages. Group pages into 3-7 logical partitions:
+   - By section: `/blog/`, `/docs/`, `/products/`, `/about/`
+   - By priority: high-traffic landing pages, content pages, utility pages
+   - If user provided PARTITIONS=N (a number), split into exactly N groups
+   - If user provided PARTITIONS=/blog,/docs,/products, use those URL path prefixes
+2. Show the partition plan and agent count to the user, confirm before launching:
+   Example: "4 page groups x 6 analyzers = 24 agents. Estimated cost: $X. Proceed?"
+3. Spawn sessions with partitions:
+   ```bash
+   node .agileflow/scripts/spawn-audit-sessions.js --audit=seo --target=URL --depth=extreme --partitions=/blog,/docs,/products --model=MODEL --json
+   ```
+4. Wait and collect results (same as ultradeep - use tmux-audit-monitor.js)
+5. Run consensus on combined results from all partitions
+
+**PARTITIONS argument** (only used with DEPTH=extreme):
+| Value | Behavior |
+|-------|----------|
+| Not set | AI decides partitions (3-7 based on site structure) |
+| `PARTITIONS=5` | AI creates exactly 5 page groups |
+| `PARTITIONS=/blog,/docs,/products` | Use these exact URL path prefixes |
+
 If URL is missing, ask:
 ```xml
 <invoke name="AskUserQuestion">
@@ -343,8 +396,10 @@ CRITICAL: 1 | HIGH: 3 | MEDIUM: 5 | LOW: 2
 
 **Quick Usage**:
 ```
-/agileflow:seo:audit https://example.com                # Quick audit
-/agileflow:seo:audit https://example.com DEPTH=deep      # Deep audit
+/agileflow:seo:audit https://example.com                     # Quick audit
+/agileflow:seo:audit https://example.com DEPTH=deep           # Deep audit
+/agileflow:seo:audit https://example.com DEPTH=ultradeep      # Tmux sessions
+/agileflow:seo:audit https://example.com DEPTH=extreme        # Page partition audit
 ```
 
 **What It Does**: Fetch homepage → Detect business type → Deploy 6 analyzers in parallel → Consensus weights scores → Health Score 0-100 → Prioritized action plan