/aqe-report

name: aqe-report
description: Generate comprehensive quality engineering reports with metrics, trends, and actionable insights

AQE Generate Reports

Generate comprehensive quality engineering reports with metrics, trends, and actionable insights.

Usage

aqe report [type] [options]
# or
/aqe-report [type] [options]

Options

| Option | Type | Default | Description | |--------|------|---------|-------------| | `type` | string | `summary` | Report type: summary, detailed, trend, executive, custom | | `--format` | string | `markdown` | Format: markdown, html, pdf, json | | `--output` | path | `stdout` | Output file path | | `--period` | string | `last-7-days` | Time period: last-24h, last-7-days, last-30-days, all-time | | `--include` | string[] | `all` | Sections: coverage, performance, quality, trends, recommendations | | `--charts` | boolean | `true` | Include charts and visualizations |

Examples

Summary Report

aqe report summary

Generates a quick summary report in markdown format.

Detailed HTML Report

aqe report detailed --format html --output qe-report.html --charts

Generates comprehensive HTML report with charts and visualizations.

Executive Summary

aqe report executive --format pdf --output exec-summary.pdf

Generates high-level executive summary in PDF format.

Trend Analysis Report

aqe report trend --period last-30-days --format markdown

Generates 30-day trend analysis report.

Custom Report

aqe report custom --include coverage,performance --format json --output metrics.json

Generates custom report with specific sections in JSON format.

Integration with Claude Code

Spawning Reporter Agent

// Use Claude Code's Task tool to spawn the reporter agent
Task("Generate comprehensive QE report", `
  Create detailed quality engineering report:
  - Include all metrics from last 30 days
  - Generate charts for coverage trends
  - Add actionable recommendations
  - Format: HTML with embedded charts

  Store report metadata: aqe/reports/{report-id}
  Notify stakeholders of report availability.
`, "qe-quality-gate")

Automated Reporting Workflow

// Generate multiple report formats in parallel
[Single Message]:
  Task("Generate HTML report", "Create detailed HTML report for team", "qe-quality-gate")
  Task("Generate PDF summary", "Create executive PDF summary", "qe-quality-gate")
  Task("Generate JSON metrics", "Export metrics for dashboard", "qe-quality-gate")

  TodoWrite({ todos: [
    {content: "Collect metrics data", status: "in_progress", activeForm: "Collecting metrics"},
    {content: "Generate HTML report", status: "in_progress", activeForm: "Generating HTML"},
    {content: "Generate PDF summary", status: "in_progress", activeForm: "Generating PDF"},
    {content: "Export JSON metrics", status: "pending", activeForm: "Exporting metrics"}
  ]})

Agent Coordination

Primary Agent

• **qe-quality-gate**: Main agent with reporting module

Supporting Agents

• **qe-coverage-analyzer**: Provides coverage metrics
• **qe-test-executor**: Provides execution metrics
• **qe-performance-tester**: Provides performance metrics

Coordination Flow

1. Pre-Task Hook
   ├─> Retrieve coverage data
   ├─> Retrieve execution history
   ├─> Retrieve performance metrics
   └─> Retrieve optimization results

2. Report Generation
   ├─> Aggregate metrics from all sources
   ├─> Generate charts and visualizations
   ├─> Calculate trends and projections
   ├─> Generate recommendations
   └─> Format report in target format

3. Post-Task Hook
   ├─> Store report metadata
   ├─> Update report history
   ├─> Notify fleet of completion
   └─> Archive report

Memory Operations

Input Memory Keys

# Retrieve coverage data
npx claude-flow@alpha memory retrieve --key "aqe/coverage/current"

# Retrieve execution history
npx claude-flow@alpha memory retrieve --key "aqe/execution/history"

# Retrieve performance metrics
npx claude-flow@alpha memory retrieve --key "aqe/performance/metrics"

# Retrieve optimization results
npx claude-flow@alpha memory retrieve --key "aqe/optimization/results"

Output Memory Keys

# Store report metadata
npx claude-flow@alpha memory store \
  --key "aqe/reports/${report_id}" \
  --value '{"type": "detailed", "format": "html", "timestamp": "2025-09-30T10:20:00Z"}'

# Store report history
npx claude-flow@alpha memory store \
  --key "aqe/reports/history" \
  --value '[{"id": "report-123", "date": "2025-09-30"}]'

Hooks and Coordination

Pre-Task Hook

npx claude-flow@alpha hooks pre-task \
  --description "Generate ${report_type} report" \
  --agent "qe-quality-gate"

Post-Task Hook

npx claude-flow@alpha hooks post-task \
  --task-id "${REPORT_ID}" \
  --results "${REPORT_META}"

Notify Fleet

npx claude-flow@alpha hooks notify \
  --message "Report generated: ${REPORT_TYPE} (${REPORT_ID})"

Expected Outputs

Summary Report Output

# Quality Engineering Summary Report

**Generated:** 2025-09-30 10:20:00
**Period:** Last 7 days

## Overview

- **Test Coverage:** 93.5% (+1.2% from last week)
- **Tests Passing:** 118/120 (98.3%)
- **Avg Execution Time:** 12.3s
- **Flaky Tests:** 2 identified

## Key Metrics

### Coverage
- Lines: 1169/1250 (93.5%)
- Branches: 456/502 (90.8%)
- Functions: 234/245 (95.5%)

### Test Execution
- Total Tests: 120
- Passed: 118
- Failed: 2
- Duration: 12.3s

### Quality Indicators
- Code Complexity: Low
- Test Reliability: 98.3%
- Performance: Good

## Recommendations

1. ✅ Generate 5 tests for authentication module (coverage gap)
2. ✅ Fix 2 failing tests in auth-service
3. ✅ Investigate 2 flaky tests for retry logic
4. ℹ️  Consider optimizing test suite (29% reduction possible)

## Trend

Coverage has improved by 1.2% over the last 7 days.
Projected to reach 95% target in 4