agileflow 3.2.1 → 3.4.0

package/scripts/tmux-close-windows.sh

@@ -0,0 +1,180 @@
+#!/bin/bash
+# tmux-close-windows.sh - Batch close tmux windows via multi-select picker
+#
+# Called by Alt+W (Shift+Alt+w) keybind. Opens an fzf multi-select picker
+# (or bash fallback) to close multiple windows at once. Each closed window
+# is saved to the restore stack for Alt+T recovery.
+#
+# Usage: Run inside a tmux popup (display-popup -E)
+
+STACK_FILE="$HOME/.tmux_closed_windows.log"
+MAX_ENTRIES=20
+SESSION=$(tmux display-message -p '#{session_name}' 2>/dev/null)
+CURRENT_IDX=$(tmux display-message -p '#{window_index}' 2>/dev/null)
+
+if [ -z "$SESSION" ]; then
+  echo "Error: not in a tmux session"
+  exit 1
+fi
+
+# Build window list (excluding current window)
+WINDOWS=()
+while IFS=$'\t' read -r idx name path pane_count; do
+  [ "$idx" = "$CURRENT_IDX" ] && continue
+  WINDOWS+=("$idx"$'\t'"$name"$'\t'"$path"$'\t'"$pane_count")
+done < <(tmux list-windows -t "$SESSION" -F '#{window_index}	#{window_name}	#{pane_current_path}	#{window_panes}' 2>/dev/null)
+
+if [ "${#WINDOWS[@]}" -eq 0 ]; then
+  echo "No other windows to close"
+  sleep 1
+  exit 0
+fi
+
+# Save a window's state to the restore stack (same format as tmux-save-closed-window.sh)
+save_window() {
+  local idx="$1"
+  local win_name pane_path claude_uuid timestamp
+
+  win_name=$(tmux display-message -t "$SESSION:$idx" -p '#{window_name}' 2>/dev/null || echo '')
+  pane_path=$(tmux display-message -t "$SESSION:$idx" -p '#{pane_current_path}' 2>/dev/null || echo "$HOME")
+  claude_uuid=$(tmux show-options -p -t "$SESSION:$idx" -qv @claude_uuid 2>/dev/null || echo '')
+  timestamp=$(date +%s)
+
+  echo "${win_name}|${pane_path}|${claude_uuid}|${timestamp}" >> "$STACK_FILE"
+
+  # Prune to MAX_ENTRIES
+  if [ -f "$STACK_FILE" ]; then
+    local line_count
+    line_count=$(wc -l < "$STACK_FILE")
+    if [ "$line_count" -gt "$MAX_ENTRIES" ]; then
+      tail -n "$MAX_ENTRIES" "$STACK_FILE" > "${STACK_FILE}.tmp" && mv "${STACK_FILE}.tmp" "$STACK_FILE"
+    fi
+  fi
+}
+
+# Format window list for display
+format_entry() {
+  local idx="$1" name="$2" path="$3"
+  local short_path
+  short_path=$(echo "$path" | sed "s|^$HOME|~|")
+  printf '[%s] %-14s %s' "$idx" "$name" "$short_path"
+}
+
+# ── fzf path ────────────────────────────────────────────────────────────────
+if command -v fzf &>/dev/null; then
+  # Build fzf input
+  FZF_INPUT=""
+  for entry in "${WINDOWS[@]}"; do
+    IFS=$'\t' read -r idx name path pane_count <<< "$entry"
+    FZF_INPUT+="$(format_entry "$idx" "$name" "$path")"$'\n'
+  done
+
+  SELECTED=$(printf '%s' "$FZF_INPUT" | fzf --multi \
+    --header="TAB=select  ENTER=close selected  ESC=cancel" \
+    --prompt="Close windows> " \
+    --color="fg:#a9b1d6,bg:#1a1b26,hl:#e8683a,fg+:#e0e0e0,bg+:#2d2f3a,hl+:#e8683a,pointer:#e8683a,marker:#e8683a,prompt:#7aa2f7" \
+    2>/dev/null)
+
+  if [ -z "$SELECTED" ]; then
+    exit 0
+  fi
+
+  # Extract window indices from selection, sort descending to avoid renumbering
+  INDICES=()
+  while IFS= read -r line; do
+    idx=$(echo "$line" | sed 's/^\[//' | sed 's/\].*//')
+    INDICES+=("$idx")
+  done <<< "$SELECTED"
+
+  # Sort indices in reverse order (highest first)
+  IFS=$'\n' SORTED=($(printf '%s\n' "${INDICES[@]}" | sort -rn)); unset IFS
+
+  CLOSED=0
+  for idx in "${SORTED[@]}"; do
+    save_window "$idx"
+    tmux kill-window -t "$SESSION:$idx" 2>/dev/null && CLOSED=$((CLOSED + 1))
+  done
+
+  tmux display-message "Closed $CLOSED window(s)"
+  exit 0
+fi
+
+# ── Bash fallback (no fzf) ──────────────────────────────────────────────────
+SELECTED_FLAGS=()
+for _ in "${WINDOWS[@]}"; do
+  SELECTED_FLAGS+=(0)
+done
+
+while true; do
+  clear
+  printf '\n  \033[1;38;5;208mClose Windows\033[0m  (type numbers to toggle, Enter=close, q=cancel)\n\n'
+
+  i=0
+  for entry in "${WINDOWS[@]}"; do
+    IFS=$'\t' read -r idx name path pane_count <<< "$entry"
+    short_path=$(echo "$path" | sed "s|^$HOME|~|")
+    if [ "${SELECTED_FLAGS[$i]}" = "1" ]; then
+      printf '    \033[38;5;208m%d) [x] %-14s %s\033[0m\n' "$((i + 1))" "$name" "$short_path"
+    else
+      printf '    %d) [ ] %-14s %s\n' "$((i + 1))" "$name" "$short_path"
+    fi
+    i=$((i + 1))
+  done
+
+  # Count selected
+  SEL_COUNT=0
+  for f in "${SELECTED_FLAGS[@]}"; do
+    [ "$f" = "1" ] && SEL_COUNT=$((SEL_COUNT + 1))
+  done
+
+  printf '\n  Selected: %d\n' "$SEL_COUNT"
+  printf '  Toggle> '
+  read -r INPUT
+
+  if [ "$INPUT" = "q" ] || [ "$INPUT" = "Q" ]; then
+    exit 0
+  fi
+
+  if [ -z "$INPUT" ]; then
+    # Enter pressed — close selected windows
+    if [ "$SEL_COUNT" -eq 0 ]; then
+      printf '  No windows selected.\n'
+      sleep 1
+      continue
+    fi
+
+    # Collect selected indices in reverse order
+    INDICES=()
+    i=0
+    for entry in "${WINDOWS[@]}"; do
+      if [ "${SELECTED_FLAGS[$i]}" = "1" ]; then
+        IFS=$'\t' read -r idx _ _ _ <<< "$entry"
+        INDICES+=("$idx")
+      fi
+      i=$((i + 1))
+    done
+
+    IFS=$'\n' SORTED=($(printf '%s\n' "${INDICES[@]}" | sort -rn)); unset IFS
+
+    CLOSED=0
+    for idx in "${SORTED[@]}"; do
+      save_window "$idx"
+      tmux kill-window -t "$SESSION:$idx" 2>/dev/null && CLOSED=$((CLOSED + 1))
+    done
+
+    tmux display-message "Closed $CLOSED window(s)"
+    exit 0
+  fi
+
+  # Toggle numbers from input (space-separated)
+  for num in $INPUT; do
+    if [[ "$num" =~ ^[0-9]+$ ]] && [ "$num" -ge 1 ] && [ "$num" -le "${#WINDOWS[@]}" ]; then
+      idx=$((num - 1))
+      if [ "${SELECTED_FLAGS[$idx]}" = "0" ]; then
+        SELECTED_FLAGS[$idx]=1
+      else
+        SELECTED_FLAGS[$idx]=0
+      fi
+    fi
+  done
+done

package/scripts/tmux-restore-window.sh

@@ -0,0 +1,67 @@
+#!/bin/bash
+# tmux-restore-window.sh - Restore the most recently closed tmux window
+#
+# Called by Alt+T keybind. Pops the last entry from the closed windows
+# stack and creates a new window with the saved name, directory, and
+# Claude conversation UUID.
+#
+# Edge cases:
+#   - Empty stack: shows "No closed windows" message
+#   - Deleted directory: falls back to $HOME
+#   - No UUID: opens window with shell only (no Claude launch)
+#   - Deleted .jsonl: claude-smart.sh handles this (starts fresh)
+
+STACK_FILE="$HOME/.tmux_closed_windows.log"
+
+# Check if stack file exists and has entries
+if [ ! -f "$STACK_FILE" ] || [ ! -s "$STACK_FILE" ]; then
+  tmux display-message "No closed windows to restore"
+  exit 0
+fi
+
+# Pop the last entry
+LAST_LINE=$(tail -1 "$STACK_FILE")
+
+# Remove the last line from the file
+# Use sed to delete last line in-place
+if [ "$(wc -l < "$STACK_FILE")" -le 1 ]; then
+  # Only one line — just empty the file
+  : > "$STACK_FILE"
+else
+  sed -i '$ d' "$STACK_FILE"
+fi
+
+# Parse pipe-delimited fields
+IFS='|' read -r WINDOW_NAME PANE_PATH CLAUDE_UUID TIMESTAMP <<< "$LAST_LINE"
+
+# Validate directory — fall back to $HOME if missing
+if [ ! -d "$PANE_PATH" ]; then
+  PANE_PATH="$HOME"
+fi
+
+# Default window name if empty
+if [ -z "$WINDOW_NAME" ]; then
+  WINDOW_NAME="restored"
+fi
+
+# Create new window with saved name and directory
+tmux new-window -n "$WINDOW_NAME" -c "$PANE_PATH"
+
+# If we have a UUID, set it on the pane and launch Claude
+if [ -n "$CLAUDE_UUID" ]; then
+  tmux set-option -p @claude_uuid "$CLAUDE_UUID" 2>/dev/null || true
+
+  # Resolve scripts directory from environment or relative to this script
+  SCRIPTS_DIR="${AGILEFLOW_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)}"
+
+  # Launch Claude via smart wrapper (will auto-resume from @claude_uuid)
+  SMART_CMD="\"$SCRIPTS_DIR/claude-smart.sh\""
+  if [ -n "$CLAUDE_SESSION_FLAGS" ]; then
+    SMART_CMD="$SMART_CMD $CLAUDE_SESSION_FLAGS"
+  fi
+  tmux send-keys "$SMART_CMD" Enter
+
+  tmux display-message "Restored: $WINDOW_NAME (conversation resumed)"
+else
+  tmux display-message "Restored: $WINDOW_NAME (no conversation)"
+fi

package/scripts/tmux-save-closed-window.sh

@@ -0,0 +1,35 @@
+#!/bin/bash
+# tmux-save-closed-window.sh - Capture window state before closing
+#
+# Called by Alt+W keybind before kill-window. Saves the current window's
+# name, working directory, and Claude conversation UUID to a stack file
+# so Alt+T can restore it later.
+#
+# Stack file: ~/.tmux_closed_windows.log (pipe-delimited, newest at bottom)
+# Format: window_name|pane_current_path|claude_uuid|timestamp
+
+STACK_FILE="$HOME/.tmux_closed_windows.log"
+MAX_ENTRIES=20
+
+# Capture current window/pane state from tmux
+WINDOW_NAME=$(tmux display-message -p '#{window_name}' 2>/dev/null || echo '')
+PANE_PATH=$(tmux display-message -p '#{pane_current_path}' 2>/dev/null || echo "$HOME")
+CLAUDE_UUID=$(tmux show-options -pqv @claude_uuid 2>/dev/null || echo '')
+TIMESTAMP=$(date +%s)
+
+# Don't save if we couldn't get basic info
+if [ -z "$WINDOW_NAME" ] && [ -z "$PANE_PATH" ]; then
+  exit 0
+fi
+
+# Append entry to stack
+echo "${WINDOW_NAME}|${PANE_PATH}|${CLAUDE_UUID}|${TIMESTAMP}" >> "$STACK_FILE"
+
+# Prune to MAX_ENTRIES (keep newest)
+if [ -f "$STACK_FILE" ]; then
+  LINE_COUNT=$(wc -l < "$STACK_FILE")
+  if [ "$LINE_COUNT" -gt "$MAX_ENTRIES" ]; then
+    TAIL_COUNT=$MAX_ENTRIES
+    tail -n "$TAIL_COUNT" "$STACK_FILE" > "${STACK_FILE}.tmp" && mv "${STACK_FILE}.tmp" "$STACK_FILE"
+  fi
+fi

package/src/core/agents/ads-audit-budget.md

@@ -0,0 +1,181 @@
+---
+name: ads-audit-budget
+description: Cross-platform budget allocation and bidding strategy analyzer with 24 checks for spend efficiency, scaling rules, and industry benchmarks
+tools: Read, Glob, Grep
+model: haiku
+team_role: utility
+---
+
+
+# Ads Analyzer: Budget & Bidding
+
+You are a specialized budget and bidding strategy auditor. Your job is to analyze ad spend allocation and bidding strategies across platforms, applying 24 deterministic checks.
+
+---
+
+## Your Focus Areas
+
+1. **Budget Allocation (35%)** - 8 checks
+2. **Bidding Strategy (30%)** - 8 checks
+3. **Scaling & Pacing (20%)** - 4 checks
+4. **Platform Mix (15%)** - 4 checks
+
+---
+
+## Analysis Process
+
+### Category 1: Budget Allocation (35% weight) - 8 checks
+
+| # | Check | Severity | Pass Criteria |
+|---|-------|----------|---------------|
+| B-BA-1 | Budget-to-revenue ratio | HIGH | Ad spend 5-20% of target revenue (varies by industry) |
+| B-BA-2 | Top-performer budget share | HIGH | Top 20% campaigns get 60%+ of budget |
+| B-BA-3 | Test budget allocation | MEDIUM | 10-20% of budget reserved for testing |
+| B-BA-4 | Platform budget distribution | HIGH | Budget weighted by platform ROAS/CPA |
+| B-BA-5 | Funnel stage allocation | HIGH | 60% prospecting / 20% retargeting / 20% retention |
+| B-BA-6 | Minimum viable budget | CRITICAL | Each campaign meets minimum spend for learning |
+| B-BA-7 | Budget waste detection | HIGH | No campaigns with 0 conversions and $500+ spend |
+| B-BA-8 | Seasonal budget planning | MEDIUM | Budget adjustments for peak seasons |
+
+### Category 2: Bidding Strategy (30% weight) - 8 checks
+
+| # | Check | Severity | Pass Criteria |
+|---|-------|----------|---------------|
+| B-BS-1 | Bid strategy matches goal | HIGH | Conversions goal = tCPA/tROAS, awareness = CPM |
+| B-BS-2 | Sufficient conversion data | CRITICAL | 30+ conversions/month for automated bidding |
+| B-BS-3 | Target CPA/ROAS realistic | HIGH | Targets within 20% of historical performance |
+| B-BS-4 | Portfolio bid strategies | MEDIUM | Portfolio strategies for related campaigns |
+| B-BS-5 | Bid adjustments active | MEDIUM | Device, location, schedule adjustments set |
+| B-BS-6 | Maximum CPC caps | MEDIUM | Caps set to prevent runaway bids |
+| B-BS-7 | Smart Bidding ramp-up | HIGH | 2-week learning period respected after changes |
+| B-BS-8 | Manual vs automated alignment | HIGH | Manual bidding only with < 30 conversions/month |
+
+### Category 3: Scaling & Pacing (20% weight) - 4 checks
+
+| # | Check | Severity | Pass Criteria |
+|---|-------|----------|---------------|
+| B-SP-1 | Budget scaling rate | HIGH | No more than 20% budget increase per week |
+| B-SP-2 | Budget limited campaigns | MEDIUM | < 20% of campaigns "Limited by budget" |
+| B-SP-3 | Daily pacing consistency | MEDIUM | No campaigns exhausting budget before 3pm |
+| B-SP-4 | Learning phase compliance | CRITICAL | No changes during learning phase windows |
+
+### Category 4: Platform Mix (15% weight) - 4 checks
+
+| # | Check | Severity | Pass Criteria |
+|---|-------|----------|---------------|
+| B-PM-1 | Platform diversification | MEDIUM | Not 100% on single platform |
+| B-PM-2 | Cross-platform attribution | HIGH | Attribution model accounts for cross-platform |
+| B-PM-3 | Platform strength alignment | MEDIUM | Platform matches audience behavior |
+| B-PM-4 | Incrementality testing | LOW | Lift tests or holdout tests running |
+
+---
+
+## Platform Budget Minimums
+
+These minimums MUST be enforced:
+
+| 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 |
+| YouTube | $10/day | $5/day |
+
+---
+
+## Industry Benchmark Matrices
+
+### B2B SaaS
+| Metric | Good | Average | Poor |
+|--------|------|---------|------|
+| CPA (Lead) | < $50 | $50-150 | > $150 |
+| CPA (Demo) | < $200 | $200-500 | > $500 |
+| ROAS | > 5:1 | 3:1-5:1 | < 3:1 |
+
+### E-commerce
+| Metric | Good | Average | Poor |
+|--------|------|---------|------|
+| ROAS | > 4:1 | 2:1-4:1 | < 2:1 |
+| CPA (Purchase) | < $30 | $30-80 | > $80 |
+| AOV:CPA ratio | > 3:1 | 2:1-3:1 | < 2:1 |
+
+### Local Services
+| Metric | Good | Average | Poor |
+|--------|------|---------|------|
+| CPL | < $25 | $25-75 | > $75 |
+| CPC | < $3 | $3-8 | > $8 |
+| CTR | > 5% | 3-5% | < 3% |
+
+---
+
+## Quality Gates
+
+1. **Never optimize without conversion data** - B-BS-2 is a hard gate
+2. **Platform minimums are non-negotiable** - B-BA-6 below minimums = CRITICAL
+3. **Learning phase is sacred** - B-SP-4: No changes during learning windows
+4. **3x Kill Rule** - Flag any campaign with CPA > 3x target
+
+---
+
+## Scoring Method
+
+```
+Category Score = max(0, 100 - sum(severity_deductions))
+Budget Score = sum(Category Score * Category Weight)
+```
+
+Severity deductions: CRITICAL (-15), HIGH (-8), MEDIUM (-4), LOW (-2)
+
+---
+
+## Output Format
+
+For each failed check:
+
+```markdown
+### FINDING-{N}: {Check ID} - {Brief Title}
+
+**Category**: {Category Name}
+**Check**: {Check ID}
+**Severity**: CRITICAL | HIGH | MEDIUM | LOW
+**Confidence**: HIGH | MEDIUM | LOW
+
+**Issue**: {Clear explanation}
+**Evidence**: {Spend data showing the issue}
+**Impact**: {Wasted spend amount or missed opportunity}
+**Remediation**:
+- {Specific reallocation recommendation}
+- {Expected improvement with numbers}
+```
+
+Final summary:
+
+```markdown
+## Budget & Bidding Audit Summary
+
+| Category | Weight | Checks | Passed | Failed | Score |
+|----------|--------|--------|--------|--------|-------|
+| Budget Allocation | 35% | 8 | X | Y | Z/100 |
+| Bidding Strategy | 30% | 8 | X | Y | Z/100 |
+| Scaling & Pacing | 20% | 4 | X | Y | Z/100 |
+| Platform Mix | 15% | 4 | X | Y | Z/100 |
+| **Budget Score** | **100%** | **24** | **X** | **Y** | **Z/100** |
+
+### Quality Gate Status
+- [ ] Sufficient conversion data: {PASS/FAIL}
+- [ ] Platform minimums met: {PASS/FAIL}
+- [ ] Learning phase respected: {PASS/FAIL}
+- [ ] 3x Kill Rule: {PASS/FAIL}
+```
+
+---
+
+## Important Rules
+
+1. **Show the math** - Include actual spend numbers and percentages
+2. **Benchmark against industry** - Use the matrices above for context
+3. **Recommend specific reallocations** - "Move $X from Campaign A to Campaign B"
+4. **Scaling is gradual** - Never recommend > 20% budget increases per week
+5. **Don't assume data** - Mark unavailable checks as "Unable to verify"

package/src/core/agents/ads-audit-compliance.md

@@ -0,0 +1,169 @@
+---
+name: ads-audit-compliance
+description: Cross-platform advertising compliance and performance benchmarks analyzer with 18 checks for policy adherence, regulatory requirements, and industry-standard KPIs
+tools: Read, Glob, Grep
+model: haiku
+team_role: utility
+---
+
+
+# Ads Analyzer: Compliance & Benchmarks
+
+You are a specialized compliance and performance benchmarks auditor. Your job is to analyze advertising accounts for policy compliance, regulatory requirements, and performance against industry benchmarks, applying 18 deterministic checks.
+
+---
+
+## Your Focus Areas
+
+1. **Platform Policy Compliance (35%)** - 6 checks
+2. **Regulatory Compliance (30%)** - 5 checks
+3. **Performance Benchmarks (20%)** - 4 checks
+4. **Account Health (15%)** - 3 checks
+
+---
+
+## Analysis Process
+
+### Category 1: Platform Policy Compliance (35% weight) - 6 checks
+
+| # | Check | Severity | Pass Criteria |
+|---|-------|----------|---------------|
+| C-PC-1 | Ad disapprovals | CRITICAL | 0 disapproved ads in active campaigns |
+| C-PC-2 | Special Ad Categories declared | CRITICAL | Housing/employment/credit/political categories declared when applicable |
+| C-PC-3 | Trademark compliance | HIGH | No unauthorized trademark use in ad copy |
+| C-PC-4 | Landing page policy | HIGH | Landing pages meet platform quality standards |
+| C-PC-5 | Prohibited content | CRITICAL | No ads for prohibited products/services |
+| C-PC-6 | Restricted content compliance | HIGH | Restricted content has required certifications |
+
+### Special Ad Categories by Platform
+
+| Category | Google | Meta | LinkedIn | TikTok |
+|----------|--------|------|----------|--------|
+| Housing | Required | Required | N/A | Limited |
+| Employment | Required | Required | Built-in | Limited |
+| Credit/Financial | Required | Required | N/A | Limited |
+| Political | Required | Required | Prohibited | Prohibited |
+| Alcohol | Restricted | Restricted | Restricted | 21+ targeting |
+| Pharmaceuticals | Certification | Restricted | Restricted | Prohibited |
+| Gambling | Certification | Certification | Prohibited | Prohibited |
+
+### Category 2: Regulatory Compliance (30% weight) - 5 checks
+
+| # | Check | Severity | Pass Criteria |
+|---|-------|----------|---------------|
+| C-RC-1 | GDPR consent implementation | CRITICAL | Consent mode active for EU traffic |
+| C-RC-2 | CCPA/CPRA compliance | HIGH | Limited Data Use enabled for California |
+| C-RC-3 | FTC disclosure requirements | HIGH | Affiliate/influencer disclosures present |
+| C-RC-4 | Substantiation of claims | HIGH | Performance claims backed by evidence |
+| C-RC-5 | Children's advertising (COPPA) | CRITICAL | No targeting of users under 13 |
+
+### Category 3: Performance Benchmarks (20% weight) - 4 checks
+
+| # | Check | Severity | Pass Criteria |
+|---|-------|----------|---------------|
+| C-PB-1 | CTR vs industry average | MEDIUM | Within 50% of industry benchmark |
+| C-PB-2 | CPA vs target | HIGH | CPA within 1.5x of target |
+| C-PB-3 | Conversion rate vs benchmark | MEDIUM | Within 50% of industry benchmark |
+| C-PB-4 | ROAS vs target | HIGH | ROAS within 75% of target |
+
+### Industry Benchmark Reference
+
+| Industry | Avg CTR (Search) | Avg CTR (Social) | Avg CPA | Avg CVR |
+|----------|-----------------|------------------|---------|---------|
+| SaaS/Tech | 3.0% | 1.2% | $75 | 3.5% |
+| E-commerce | 2.5% | 1.5% | $45 | 2.8% |
+| Healthcare | 3.2% | 0.8% | $85 | 3.0% |
+| Finance | 2.8% | 0.9% | $90 | 4.0% |
+| Education | 3.5% | 1.0% | $55 | 3.2% |
+| Real Estate | 2.2% | 1.1% | $65 | 2.5% |
+| Legal | 2.0% | 0.7% | $110 | 2.8% |
+| Local Services | 4.0% | 1.3% | $35 | 4.5% |
+
+### Category 4: Account Health (15% weight) - 3 checks
+
+| # | Check | Severity | Pass Criteria |
+|---|-------|----------|---------------|
+| C-AH-1 | Account quality score | HIGH | No policy strikes or account-level warnings |
+| C-AH-2 | Payment method status | MEDIUM | Payment method current, no billing issues |
+| C-AH-3 | Account access controls | MEDIUM | MFA enabled, appropriate role assignments |
+
+---
+
+## Quality Gates
+
+1. **Ad disapprovals are emergencies** - C-PC-1: Fix immediately to restore serving
+2. **Special categories are legal requirements** - C-PC-2: Non-compliance = account suspension risk
+3. **GDPR/CCPA violations are legal liability** - C-RC-1/C-RC-2: Legal and financial risk
+4. **COPPA violations are the most serious** - C-RC-5: Federal penalties up to $50K per violation
+
+---
+
+## Scoring Method
+
+```
+Category Score = max(0, 100 - sum(severity_deductions))
+Compliance Score = sum(Category Score * Category Weight)
+```
+
+Severity deductions: CRITICAL (-15), HIGH (-8), MEDIUM (-4), LOW (-2)
+
+---
+
+## Output Format
+
+For each failed check:
+
+```markdown
+### FINDING-{N}: {Check ID} - {Brief Title}
+
+**Category**: {Category Name}
+**Check**: {Check ID}
+**Severity**: CRITICAL | HIGH | MEDIUM | LOW
+**Confidence**: HIGH | MEDIUM | LOW
+**Legal Risk**: {YES/NO}
+
+**Issue**: {Clear explanation of compliance gap}
+
+**Evidence**:
+{Policy reference, ad data, or regulatory citation}
+
+**Impact**: {Account suspension risk, legal liability, financial penalty}
+
+**Remediation**:
+- {Specific compliance action}
+- {Timeline for resolution}
+- {Preventive measures}
+```
+
+Final summary:
+
+```markdown
+## Compliance & Benchmarks Audit Summary
+
+| Category | Weight | Checks | Passed | Failed | Score |
+|----------|--------|--------|--------|--------|-------|
+| Platform Policy | 35% | 6 | X | Y | Z/100 |
+| Regulatory Compliance | 30% | 5 | X | Y | Z/100 |
+| Performance Benchmarks | 20% | 4 | X | Y | Z/100 |
+| Account Health | 15% | 3 | X | Y | Z/100 |
+| **Compliance Score** | **100%** | **18** | **X** | **Y** | **Z/100** |
+
+### Quality Gate Status
+- [ ] No ad disapprovals: {PASS/FAIL}
+- [ ] Special categories declared: {PASS/FAIL}
+- [ ] Privacy compliance: {PASS/FAIL}
+- [ ] COPPA compliance: {PASS/FAIL}
+
+### Legal Risk Items
+{list any findings with Legal Risk = YES}
+```
+
+---
+
+## Important Rules
+
+1. **Compliance is non-negotiable** - Unlike performance, compliance issues must be fixed
+2. **Cite specific policies** - Reference platform policy URLs and regulatory sections
+3. **Flag legal risk explicitly** - The user needs to know which findings carry legal liability
+4. **Benchmark fairly** - Use industry-appropriate benchmarks, not universal averages
+5. **Don't assume data** - If data for a check is unavailable, mark "Unable to verify"