Quality Gates Parallel (Native Multi-Agent)

Orchestrator integration for launching 4 quality subagents in parallel using the native Task tool with teammate coordination.

v2.88 Key Changes (MODEL-AGNOSTIC)

Model-agnostic: Uses model configured in ~/.claude/settings.json or CLI/env vars
No flags required: Works with the configured default model
Flexible: Model-agnostic — runs on whatever model the session runs
Settings-driven: Model selection via ANTHROPICDEFAULT*_MODEL env vars

Quick Start

# Launch quality checks after implementation
/quality-gates-parallel src/auth.ts --complexity 7

# Read aggregated results post-analysis
/quality-gates-parallel --read-results <run_id>

Native Multi-Agent Architecture (Claude Code 2.1.16+)

Based on: claude-sneakpeek native-multiagent-gates

Features Available

TaskCreate: Create tasks for subagents
TaskUpdate: Update task status
TaskList: List all tasks
TaskGet: Get task details
Parallel execution: Multiple agents work independently
Result aggregation: Collect findings from all agents

Agent Teams Integration (v2.88)

Optimal Scenario: Integrated (Agent Teams + Custom Subagents)

Parallel quality gates combine Agent Teams coordination with specialized ralph-* agents for comprehensive parallel validation.

Why Scenario C for Quality Gates Parallel

Designed specifically for parallel execution
Quality hooks (TeammateIdle, TaskCompleted) are core functionality
4 different check types need coordinated distribution
Task list tracks all parallel quality phases

Subagent Roles

Subagent	Quality Gate Role
`ralph-tester`	Test execution and coverage
`ralph-reviewer`	Code quality analysis
`ralph-coder`	Auto-fix application

Agent Teams Parallel Workflow

When Agent Teams is active:

Team Lead creates quality gate task list
ralph-tester runs tests in parallel
ralph-reviewer performs linting and type checks
ralph-coder applies auto-fixes for issues

Native Integration

This skill was designed for Agent Teams with:

TaskCreate for each quality phase
Parallel execution via Task tool
TaskCompleted hooks for gate validation

Workflow

Phase 1: Launch Parallel Quality Checks

After implementation (orchestrator step 6b), launch 4 subagents:

// Pseudo-code for orchestrator integration
1. Classify task complexity (1-10)
2. If complexity >= 5:
3.    Create 4 tasks using TaskCreate:
4.      - Security auditor (sec-context-depth)
5.      - Code reviewer (code-reviewer)
6.      - Code cleanup (deslop)
7.      - Prose cleanup (stop-slop)
8.    Tasks execute in parallel (non-blocking)
9.    Continue orchestrator workflow
10. Else: Skip quality checks (low complexity)

Phase 2: Read Results (Pre-Validation)

Before validation (orchestrator step 7), poll for results:

# Run results reader
.claude/scripts/read-quality-results.sh <run_id>

Phase 3: Orchestrator Decision-Making

Orchestrator reads aggregated results and decides:

// Pseudo-code for decision logic
results = readQualityResults(run_id)

if (results.total_findings == 0) {
    // No issues - proceed to validation
    proceedToValidation()
} else if (results.critical_findings > 0) {
    // Critical issues - block and fix
    blockMerge()
    requireFixes()
} else {
    // Minor issues - advisory only
    proceedWithWarnings()
}

Quality Agents (4 Parallel)

1. Security Auditor (`sec-context-depth`)

Agent: ralph-security Purpose: 27 security anti-patterns (OWASP/CWE) Findings: P0 (Critical), P1 (High), P2 (Medium) Command: /sec-context-depth <file>

Coverage:

86% XSS failure rate detection
72% Java AI code vulnerability detection
SQL injection, command injection, XSS
JWT none algorithm, weak hashing, ECB mode

2. Code Reviewer (`code-reviewer`)

Agent: code-reviewer Purpose: Official Claude Code plugin with 4 parallel agents Features: Confidence scoring (≥80 threshold) Command: /code-review <file>

Architecture:

Agent #1: CLAUDE.md compliance
Agent #2: CLAUDE.md compliance (redundancy)
Agent #3: Bug detection (changes only)
Agent #4: Git blame/history analysis

3. Code Cleanup (`deslop`)

Agent: ralph-coder Purpose: Remove AI-generated code slop Command: /deslop

Removes:

Extra comments inconsistent with codebase
Extra defensive checks/try/catch blocks
Casts to any for type issues
Inline imports (move to top)

4. Prose Cleanup (`stop-slop`)

Agent: docs-writer Purpose: Remove AI writing patterns from prose Command: /stop-slop <file>

Removes:

Filler phrases ("Certainly!", "It is important to note")
Structural clichés (binary contrasts, dramatic fragmentation)
Stylistic habits (tripling, metronomic endings)

Integration with Orchestrator

Step 6b.5: Quality Parallel (NEW)

Location: After implementation (6b), before validation (7)

Trigger: complexity >= 5 OR security-related code

Execution:

# Non-blocking parallel launch
.claude/scripts/quality-coordinator.sh <target_file> <complexity>

Output: JSON with 4 task definitions

Step 7: Validation with Quality Results

Before validation: Read aggregated results

# Poll for completed checks
.claude/scripts/read-quality-results.sh <run_id>

Output: Aggregated JSON with all findings

Decision Logic:

0 findings: Proceed to validation
Critical findings: Block and require fixes
Minor findings: Advisory warnings

Results Storage

.claude/quality-results/
├── aggregated_<run_id>.json        # Aggregated results
├── sec-context_<run_id>.json       # Security findings
├── code-review_<run_id>.json       # Code review findings
├── deslop_<run_id>.json            # Code cleanup findings
├── stop-slop_<run_id>.json         # Prose cleanup findings
├── *_<run_id>.done                 # Completion markers
└── coordinator.log                # Execution log

Usage Examples

Manual Execution

# Launch quality checks
./.claude/scripts/quality-coordinator.sh src/auth.ts 7

# Read results
./.claude/scripts/read-quality-results.sh 20250128_221437_12345

Orchestrator Integration

# In orchestrator step 6b (after implementation)
quality_check_result=$(./.claude/scripts/quality-coordinator.sh "$file" "$complexity")

# Parse result and create tasks
if [[ "$complexity" -ge 5 ]]; then
    # Create 4 tasks using TaskCreate
    # Tasks execute in parallel
    # Store run_id for later retrieval
fi

# In orchestrator step 7 (before validation)
quality_results=$(./.claude/scripts/read-quality-results.sh "$run_id")

# Parse results and make decision
critical_count=$(echo "$quality_results" | jq '.summary.critical_findings // 0')
if [[ "$critical_count" -gt 0 ]]; then
    # Block and require fixes
    echo "CRITICAL: $critical_count security issues found"
else
    # Proceed to validation
    echo "No critical issues, proceeding to validation"
fi

Scripts

quality-coordinator.sh: Launch 4 quality tasks in parallel
read-quality-results.sh: Poll and aggregate results

Hooks

quality-parallel-async.sh: Async hook for Edit/Write operations

- Uses async: true in settings.json - Non-blocking background execution - Results stored for later reading

Version History

1.0.0 (2026-01-28): Initial native multi-agent integration

- 4 parallel quality agents - Result aggregation and polling

Action Reporting (v2.93.0)

Esta skill genera reportes automáticos completos para trazabilidad:

Reporte Automático

Cuando esta skill completa, se genera automáticamente:

En la conversación de Claude: Resultados visibles
En el repositorio: docs/actions/quality-gates-parallel/{timestamp}.md
Metadatos JSON: .claude/metadata/actions/quality-gates-parallel/{timestamp}.json

Contenido del Reporte

Cada reporte incluye:

✅ Summary: Descripción de la tarea ejecutada
✅ Execution Details: Duración, iteraciones, archivos modificados
✅ Results: Errores encontrados, recomendaciones
✅ Next Steps: Próximas acciones sugeridas

Ver Reportes Anteriores

# Listar todos los reportes de esta skill
ls -lt docs/actions/quality-gates-parallel/

# Ver el reporte más reciente
cat $(ls -t docs/actions/quality-gates-parallel/*.md | head -1)

# Buscar reportes fallidos
grep -l "Status: FAILED" docs/actions/quality-gates-parallel/*.md

Generación Manual (Opcional)

source .claude/lib/action-report-lib.sh
start_action_report "quality-gates-parallel" "Task description"
# ... ejecución ...
complete_action_report "success" "Summary" "Recommendations"

Referencias del Sistema

[Action Reports System](docs/actions/README.md) - Documentación completa
[action-report-lib.sh](.claude/lib/action-report-lib.sh) - Librería helper
[action-report-generator.sh](.claude/lib/action-report-generator.sh) - Generador

Native Multi-Agent Gates: claude-sneakpeek documentation
Claude Code 2.1.16+ features: Swarms, TeammateTool, teammate coordination
Quality consolidation: docs/analysis/QUALITYPARALLELCONSOLIDATION_v2.80.3.md
Async hooks correction: docs/analysis/ASYNCHOOKSCORRECTION_v2.80.2.md