feat(qcsd): add QCSD analysis exclusion, E2E test framework, and n8n validation

- Add Agentic QCSD/ and L2C/ to gitignore (site-specific analysis reports)
- Add n8n instance-specific files to gitignore (internal URLs protection)
- Add Sauce Demo E2E test suite with Playwright (Page Object Model)
- Add n8n workflow validator with webhook testing
- Add QCSD agent implementations (QualityCriteriaRecommender, RiskAssessor)
- Add GitHub Actions workflows for E2E and n8n CI
- Add agent catalog documentation
- Add v3 benchmark and coherence comparison reports

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: Lalit

.claude/agents/v3/README.md

@@ -0,0 +1,100 @@
+# AQE V3 Agents Index
+
+This directory contains V3 QE agents installed by `aqe init`.
+
+> **Note**: This directory only contains AQE-specific agents (v3-qe-*).
+> Claude-flow core agents (adr-architect, memory-specialist, etc.) are part of
+> the claude-flow system and are available separately.
+
+## Summary
+
+- **Total Agents**: 1
+- **V3 QE Domain Agents**: 1
+- **V3 Subagents**: 0
+
+## V2 → V3 Migration Guide
+
+| V2 Agent | V3 Agent | Domain | Key Changes |
+|----------|----------|--------|-------------|
+| `qe-a11y-ally` | `qe-accessibility-auditor` | visual-accessibility | **MANDATORY video pipeline** |
+| `qe-test-generator` | `qe-test-architect` | test-generation | ReasoningBank learning |
+| `qe-coverage-analyzer` | `qe-coverage-specialist` | coverage-analysis | O(log n) sublinear |
+| `qe-coordinator` | `qe-learning-coordinator` | learning-optimization | Cross-domain patterns |
+| `qe-flaky-investigator` | `qe-flaky-hunter` | defect-intelligence | ML-powered detection |
+
+## Critical: qe-accessibility-auditor
+
+The V3 accessibility auditor has a **MANDATORY video accessibility pipeline**.
+
+### V2 Behavior (qe-a11y-ally)
+
+Generated these files when videos detected:
+- `*-captions.vtt` - For deaf/hard-of-hearing users
+- `*-audiodesc.vtt` - For blind/low-vision users
+- Implementation instructions
+
+### V3 Behavior (qe-accessibility-auditor)
+
+**MUST** execute the same pipeline:
+
+1. **Detect** - Find `<video>`, `<iframe>` elements
+2. **Download** - `curl -L -o video.mp4 URL`
+3. **Extract** - `ffmpeg -vf "fps=1/3" -frames:v 10`
+4. **Analyze** - Read each .jpg with Claude Vision
+5. **Generate** - Create .vtt from actual descriptions
+6. **Save** - Output to `docs/accessibility/captions/{page-slug}/`
+
+### Expected Output Structure
+
+```
+docs/accessibility/captions/{page-slug}/
+├── video-001-captions.vtt     # Captions
+├── video-001-audiodesc.vtt    # Audio descriptions
+├── implementation.md          # HTML integration
+└── audit-report.md            # WCAG report
+```
+
+### Invocation
+
+Use the skill for guaranteed video pipeline execution:
+
+```
+/qe-a11y-ally https://example.com/page
+```
+
+Or via Task with explicit video pipeline requirement:
+
+```javascript
+Task({
+  prompt: "Audit accessibility including MANDATORY video pipeline for URL",
+  subagent_type: "qe-accessibility-auditor"
+})
+```
+
+## Usage
+
+Spawn agents using Claude Code's Task tool:
+
+```javascript
+Task("Generate tests for UserService", "...", "qe-test-architect")
+Task("Analyze coverage gaps", "...", "qe-coverage-specialist")
+Task("Audit accessibility with video captions", "...", "qe-accessibility-auditor")
+```
+
+## V3 QE Domain Agents (1)
+
+Quality Engineering agents mapped to the 12 DDD bounded contexts.
+
+| Agent | Domain | File |
+|-------|--------|------|
+| `qe-accessibility-auditor` | visual-accessibility | `qe-accessibility-auditor.md` |
+
+## V3 Subagents (0)
+
+Specialized sub-task agents for TDD and code review.
+
+*None installed*
+
+---
+
+*Updated 2026-01-26 - Added V2→V3 migration guide and video pipeline documentation*

.claude/agents/v3/qe-accessibility-auditor.md

@@ -53,17 +53,118 @@ Proceed with testing without confirmation when standards are clear.
 Apply multi-tool testing by default for comprehensive coverage.
 Generate remediation guidance with code examples automatically.
 
-**Video Accessibility Pipeline (MANDATORY for pages with videos):**
-1. Extract video URLs using Playwright/network interception
-2. Download videos locally with curl/ffmpeg
-3. Extract frames: `ffmpeg -i video.mp4 -vf "fps=1/3" -frames:v 10 frame_%02d.jpg`
-4. Analyze each frame with Claude Vision (Read tool on .jpg files)
-5. Generate WebVTT captions from ACTUAL frame descriptions
-6. Generate audio descriptions for blind users
-7. Save files to `docs/accessibility/captions/` ready to deploy
-
-**NEVER skip video analysis when videos are detected.**
-**NEVER generate generic/template captions - use actual frame descriptions.**
+## CRITICAL: VIDEO ACCESSIBILITY PIPELINE
+
+**This pipeline is MANDATORY when ANY video is detected on the page.**
+**Failure to execute this pipeline is a CRITICAL ERROR.**
+
+### Detection Phase
+Look for these video indicators in fetched HTML:
+- `<video>` elements with `src` or `<source>` children
+- `<iframe>` with YouTube/Vimeo/Wistia URLs
+- `video-container`, `video-player` class elements
+- JavaScript video players (Video.js, Plyr, etc.)
+
+### Execution Phase (FOR EACH VIDEO)
+
+**Step 1: Download Video**
+```bash
+# Create working directory
+mkdir -p /tmp/a11y-video-work
+
+# For direct MP4/WebM URLs
+curl -L -o /tmp/a11y-video-work/video-001.mp4 "VIDEO_URL"
+
+# For YouTube (if yt-dlp available)
+yt-dlp -f "best[height<=720]" -o /tmp/a11y-video-work/video-001.mp4 "YOUTUBE_URL" 2>/dev/null || echo "yt-dlp not available"
+```
+
+**Step 2: Extract Frames**
+```bash
+mkdir -p /tmp/a11y-video-work/frames-001
+ffmpeg -i /tmp/a11y-video-work/video-001.mp4 \
+  -vf "fps=1/3" \
+  -frames:v 10 \
+  /tmp/a11y-video-work/frames-001/frame_%02d.jpg \
+  2>/dev/null
+```
+
+**Step 3: Analyze Each Frame with Claude Vision**
+Use the Read tool on EACH extracted .jpg file:
+```
+Read /tmp/a11y-video-work/frames-001/frame_01.jpg
+Read /tmp/a11y-video-work/frames-001/frame_02.jpg
+Read /tmp/a11y-video-work/frames-001/frame_03.jpg
+... (continue for all 10 frames)
+```
+
+For each frame, document:
+- Scene: Setting, environment, lighting conditions
+- People: Who is present, what they're doing, expressions
+- Objects: Products, props, vehicles, equipment
+- Text: Any visible text, logos, signs, labels
+- Action: What's happening, movement, transitions
+- Colors: Dominant colors, contrasts, accessibility-relevant
+
+**Step 4: Generate WebVTT Captions**
+```vtt
+WEBVTT
+Kind: captions
+
+00:00:00.000 --> 00:00:03.000
+[Description from frame_01.jpg analysis]
+
+00:00:03.000 --> 00:00:06.000
+[Description from frame_02.jpg analysis]
+
+00:00:06.000 --> 00:00:09.000
+[Description from frame_03.jpg analysis]
+```
+
+**Step 5: Generate Audio Descriptions**
+```vtt
+WEBVTT
+Kind: descriptions
+
+00:00:00.000 --> 00:00:03.000
+SCENE: [Detailed scene description for blind users]
+VISUAL: [What's on screen]
+TEXT: [Any readable text]
+ACTION: [What's happening]
+```
+
+**Step 6: Save Output Files**
+```bash
+# Create output directory
+mkdir -p docs/accessibility/captions/{page-slug}
+
+# Save generated files
+# - video-001-captions.vtt
+# - video-001-audiodesc.vtt
+# - implementation.md (HTML code examples)
+```
+
+### Enforcement Rules
+
+1. **NEVER** complete an accessibility audit without checking for videos
+2. **NEVER** skip the video pipeline if videos are detected
+3. **NEVER** generate placeholder/template captions - use ACTUAL frame analysis
+4. **ALWAYS** use the Read tool on actual .jpg frame files for Vision analysis
+5. **ALWAYS** save output to `docs/accessibility/captions/{page-slug}/`
+6. **ALWAYS** include implementation instructions in the output
+
+### Validation Checklist (Self-Check Before Completing)
+
+- [ ] Did I check for `<video>` and `<iframe>` elements?
+- [ ] Did I download each detected video?
+- [ ] Did I extract frames with ffmpeg?
+- [ ] Did I use Read tool on each .jpg frame file?
+- [ ] Did I generate captions.vtt from ACTUAL frame descriptions?
+- [ ] Did I generate audiodesc.vtt with detailed scene info?
+- [ ] Did I save files to docs/accessibility/captions/?
+- [ ] Did I include implementation instructions?
+
+**If ANY checkbox is NO and videos were detected, the task is INCOMPLETE.**
 </default_to_action>
 
 <parallel_execution>

.claude/mcp.json

@@ -55,8 +55,18 @@
       ],
       "env": {
         "NODE_NO_WARNINGS": "1",
-        "VIBIUM_HEADLESS": "false"
+        "VIBIUM_HEADLESS": "true",
+        "CHROMEDRIVER_PATH": "/usr/bin/chromedriver",
+        "CHROME_PATH": "/usr/bin/chromium"
+      }
+    },
+    "aqe": {
+      "command": "aqe-mcp",
+      "args": [],
+      "env": {
+        "AQE_PROJECT_ROOT": "/workspaces/agentic-qe",
+        "NODE_ENV": "production"
       }
     }
   }
-}
+}