qcsd-ideation-swarm

# QCSD Ideation Swarm v7.0

Shift-left quality engineering swarm for PI Planning and Sprint Planning.

---

## Overview

The Ideation Swarm assesses stories and URLs before development begins, using HTSM v6.3
quality criteria, Risk Storming, and Testability analysis. It renders a
GO / CONDITIONAL / NO-GO decision and is the first gate in the QCSD lifecycle.

### QCSD Phase Positioning

| Phase | Swarm | Decision | When |
|-------|-------|----------|------|
| **Ideation** | **qcsd-ideation-swarm** | **GO / CONDITIONAL / NO-GO** | **PI/Sprint Planning** |
| Refinement | qcsd-refinement-swarm | READY / CONDITIONAL / NOT-READY | Sprint Refinement |
| Development | qcsd-development-swarm | SHIP / CONDITIONAL / HOLD | During Sprint |
| Verification | qcsd-cicd-swarm | RELEASE / REMEDIATE / BLOCK | Pre-Release / CI-CD |
| Production | qcsd-production-swarm | HEALTHY / DEGRADED / CRITICAL | Post-Release |

### Parameters

- `URL`: Website to analyze (required for URL mode)
- `OUTPUT_FOLDER`: Where to save reports (default: `${PROJECT_ROOT}/Agentic QCSD/{domain}/`)

### Unique Features

- **URL Mode**: Automated 5-tier browser cascade for live website analysis
- **HAS_VIDEO Flag**: Detects video content and recommends `/a11y-ally` follow-up
- **HTML Output**: Generates HTML reports when `html_output: true`
- **Browser Cascade**: Vibium -> agent-browser -> Playwright+Stealth -> WebFetch -> WebSearch-fallback

---

## ENFORCEMENT RULES - READ FIRST

| Rule | Enforcement |
|------|-------------|
| **E1** | You MUST spawn ALL THREE core agents (qe-quality-criteria-recommender, qe-risk-assessor, qe-requirements-validator) in Step 2. No exceptions. |
| **E2** | You MUST put all parallel Task calls in a SINGLE message. |
| **E3** | You MUST STOP and WAIT after each batch. No proceeding early. |
| **E4** | You MUST spawn conditional agents if flags are TRUE. No skipping. |
| **E5** | You MUST apply GO/CONDITIONAL/NO-GO logic exactly as specified in Step 5. |
| **E6** | You MUST generate the full report structure. No abbreviated versions. |
| **E7** | Each agent MUST read its reference files before analysis. |
| **E8** | You MUST execute Step 7 learning persistence. No skipping. |

**PROHIBITED BEHAVIORS:**
- Summarizing instead of spawning agents
- Skipping agents "for brevity"
- Proceeding before background tasks complete
- Providing your own analysis instead of spawning specialists
- Omitting report sections or using placeholder text

---

## Step Execution Protocol

This skill uses a micro-file step architecture. Each step is a self-contained file
loaded one at a time to avoid "lost in the middle" context degradation.

**Execute steps sequentially by reading each step file with the Read tool.**

### Steps

1. **Flag Detection** -- `steps/01-flag-detection.md` -- Fetch URL content (browser cascade), detect all 7 flags (HAS_UI, HAS_SECURITY, HAS_UX, HAS_VIDEO, HAS_MIDDLEWARE, HAS_SAP_INTEGRATION, HAS_AUTHORIZATION)
2. **Core Agents** -- `steps/02-core-agents.md` -- Spawn qe-quality-criteria-recommender, qe-risk-assessor, qe-requirements-validator in parallel
3. **Batch 1 Results** -- `steps/03-batch1-results.md` -- Wait for core agents, extract all metrics
4. **Conditional Agents** -- `steps/04-conditional-agents.md` -- Spawn flagged conditional agents in parallel
5. **Decision Synthesis** -- `steps/05-decision-synthesis.md` -- Apply GO/CONDITIONAL/NO-GO logic
6. **Report Generation** -- `steps/06-report-generation.md` -- Generate executive summary and full report
7. **Learning Persistence** -- `steps/07-learning-persistence.md` -- Store findings to memory, save persistence record, include video follow-up recommendation
8. **Final Output** -- `steps/08-final-output.md` -- Display completion summary with all scores and follow-up recommendations

### Execution Instructions

1. Use the Read tool to load the current step file (e.g., `Read({ file_path: ".claude/skills/qcsd-ideation-swarm/steps/01-flag-detection.md" })`)
2. Execute the step's instructions completely
3. Verify all success criteria are met before proceeding
4. Pass the step's output as context to the next step
5. If a step fails, halt and report the failure point -- do not skip ahead

### Resume Support

To resume from a specific step: specify `--from-step N` and the orchestrator will
skip to step N. Ensure you have the required prerequisite data from prior steps.

---

## Agent Inventory

| Agent | Type | Domain | Batch |
|-------|------|--------|-------|
| qe-quality-criteria-recommender | Core (always) | requirements-validation | 1 |
| qe-risk-assessor | Core (always) | coverage-analysis | 1 |
| qe-requirements-validator | Core (always) | requirements-validation | 1 |
| qe-accessibility-auditor | Conditional (HAS_UI) | visual-accessibility | 2 |
| qe-security-auditor | Conditional (HAS_SECURITY) | security-compliance | 2 |
| qe-qx-partner | Conditional (HAS_UX) | cross-domain | 2 |
| qe-middleware-validator | Conditional (HAS_MIDDLEWARE) | enterprise-integration | 2 |
| qe-sap-rfc-tester | Conditional (HAS_SAP_INTEGRATION) | enterprise-integration | 2 |
| qe-sod-analyzer | Conditional (HAS_AUTHORIZATION) | enterprise-integration | 2 |

**Total: 9 agents (3 core + 6 conditional)**

**Note**: The Ideation swarm has 8 steps (not 9) because it has no separate final
analysis agent step. The HAS_VIDEO flag triggers a follow-up recommendation for
`/a11y-ally` but does not spawn an additional agent.

---

## Quality Gate Thresholds

| Metric | GO | CONDITIONAL | NO-GO |
|--------|-----|-------------|-------|
| Testability Score | >= 70% | 40 - 69% | < 40% |
| Risk Score | LOW/MEDIUM | HIGH (mitigatable) | CRITICAL |
| Requirements Completeness | >= 80% | 50 - 79% | < 50% |
| Quality Criteria Coverage | >= 7/10 categories | 4-6/10 categories | < 4/10 categories |

---

## Report Filename Mapping

| Agent | Report Filename | Step |
|-------|----------------|------|
| qe-quality-criteria-recommender | `02-quality-criteria.md` | 2 |
| qe-risk-assessor | `03-risk-assessment.md` | 2 |
| qe-requirements-validator | `04-requirements-validation.md` | 2 |
| qe-accessibility-auditor | `05-accessibility-audit.md` | 4 |
| qe-security-auditor | `06-security-audit.md` | 4 |
| qe-qx-partner | `07-ux-assessment.md` | 4 |
| qe-middleware-validator | `08-middleware-assessment.md` | 4 |
| qe-sap-rfc-tester | `09-sap-assessment.md` | 4 |
| qe-sod-analyzer | `10-sod-compliance.md` | 4 |
| Learning Persistence | `11-learning-persistence.json` | 7 |
| Synthesis | `01-executive-summary.md` | 6 |

---

## Execution Model Options

| Model | When to Use | Agent Spawn |
|-------|-------------|-------------|
| **Task Tool** (PRIMARY) | Claude Code sessions | `Task({ subagent_type, run_in_background: true })` |
| **MCP Tools** | MCP server available | `fleet_init({})` / `task_submit({})` |
| **CLI** | Terminal/scripts | `swarm init` / `agent spawn` |

---

## Key Principle

**Quality is built in from the start, not tested in at the end. This swarm ensures
stories are viable, testable, and risk-assessed before any code is written.**