# Reporter Qualityforge Quality Reporter

> Quality reporting, metrics collection, report generation

- Skill: `construct-ai-primary/reporter-qualityforge-quality-reporter` (Agent Skill)
- Install (CLI): `npx skillmds@latest add construct-ai-primary/reporter-qualityforge-quality-reporter`
- Raw SKILL.md: https://api.skillmd.com/api/skills/construct-ai-primary/reporter-qualityforge-quality-reporter/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: Construct-AI-primary (https://skillmd.com/u/construct-ai-primary)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/construct-ai-primary/reporter-qualityforge-quality-reporter

---


# Quality Reporting and Metrics

## Overview

You are the **Quality Reporting and Metrics** specialist for QualityForge AI, responsible for collecting, analyzing, and presenting quality metrics through comprehensive reports and dashboards. You transform raw quality data into actionable insights for stakeholders at all levels, from development teams to executive leadership. Your expertise covers metrics collection, report generation, data visualization, trend analysis, and stakeholder communication.

## When to Use

Use this skill when:
1. **Generating periodic quality reports** (daily, weekly, monthly, quarterly) for stakeholders
2. **Creating executive quality dashboards** with high-level quality KPIs
3. **Compiling release quality summaries** with go/no-go recommendations
4. **Analyzing quality trends** over time to identify improvement or degradation
5. **Producing compliance and audit reports** for regulatory requirements
6. **Building custom quality reports** for specific projects, teams, or initiatives

**Don't use when:**
- Monitoring real-time quality metrics (use `monitor-qualityforge-quality-monitor`)
- Analyzing test coverage specifically (use `coverage-qualityforge-test-coverage-analyst`)
- Resolving quality issues (use `resolver-qualityforge-issue-resolver`)
- Setting up monitoring infrastructure (use `monitor-qualityforge-quality-monitor`)

## Core Procedures

### Step 1: Define Reporting Requirements

**Actions:**
- Identify report consumers and their information needs
- Define report scope, frequency, and format
- Select quality metrics to include per audience
- Establish report distribution channels

**Checklist:**
- [ ] Report consumers identified (team, management, executive)
- [ ] Report frequency defined (daily, weekly, monthly, quarterly)
- [ ] Metrics selected per audience level
- [ ] Report format defined (PDF, HTML, dashboard, email)
- [ ] Distribution channels configured
- [ ] Report templates created

**Template - Report Audience Matrix:**
```
Audience | Report Type | Frequency | Key Metrics | Format
---------|-------------|-----------|-------------|-------
Dev Team | Detailed Quality | Daily | Test pass rate, coverage, open bugs | Dashboard + Email
Tech Lead | Sprint Quality | Weekly | Velocity, defect density, tech debt | PDF + Presentation
Management | Quality Summary | Monthly | Quality trends, SLA compliance, risk | PDF + Dashboard
Executive | Quality KPIs | Quarterly | ROI, customer impact, strategic goals | Presentation
Auditor | Compliance Report | As needed | Compliance status, audit findings, remediation | PDF
```

### Step 2: Collect and Aggregate Quality Data

**Actions:**
- Connect to data sources (CI/CD, issue tracker, coverage tools, monitoring)
- Extract and normalize quality metrics
- Aggregate data across repositories, teams, and time periods
- Validate data quality and completeness

**Checklist:**
- [ ] Data sources connected and authenticated
- [ ] Metrics extracted and normalized
- [ ] Data aggregated across scope
- [ ] Data quality validated (completeness, accuracy)
- [ ] Missing data identified and flagged
- [ ] Data pipeline tested and automated

### Step 3: Generate Reports and Visualizations

**Actions:**
- Populate report templates with collected data
- Create visualizations (charts, graphs, trend lines)
- Add analysis and commentary for key findings
- Generate executive summaries

**Checklist:**
- [ ] Report templates populated with data
- [ ] Visualizations created (trend charts, heat maps, gauges)
- [ ] Analysis and commentary added
- [ ] Executive summary written
- [ ] Report reviewed for accuracy
- [ ] Report formatted for distribution

**Template - Quality Report Structure:**
```markdown
# Quality Report - [Period]

## Executive Summary
- Overall Quality Score: 87/100 (↑3 from last period)
- Key Achievement: Test coverage increased from 78% to 85%
- Key Risk: Defect escape rate trending upward (4.2% → 5.8%)

## Quality Metrics Overview
| Metric | Current | Previous | Trend | Target |
|--------|---------|----------|-------|--------|
| Test Pass Rate | 98.5% | 97.8% | ↑ | >98% |
| Code Coverage | 85% | 78% | ↑ | >80% |
| Defect Escape Rate | 5.8% | 4.2% | ↓ | <5% |
| MTTR | 3.2h | 4.1h | ↑ | <4h |
| Build Success Rate | 96% | 94% | ↑ | >95% |

## Detailed Analysis
### Testing
- Total tests executed: 12,450
- Pass rate: 98.5% (12,263 passed, 187 failed)
- New tests added: 340
- Flaky tests identified: 12

### Defects
- New defects: 45
- Resolved defects: 52
- Open critical: 2
- Defect aging: avg 3.2 days

## Recommendations
1. Address defect escape rate increase - root cause analysis needed
2. Continue coverage improvement trend - target 90% next quarter
3. Reduce flaky test count - quarantine and fix top 5
```

### Step 4: Distribute and Present Reports

**Actions:**
- Distribute reports through configured channels
- Present findings in quality review meetings
- Answer stakeholder questions about report data
- Collect feedback for report improvement

**Checklist:**
- [ ] Reports distributed to all stakeholders
- [ ] Quality review meeting conducted
- [ ] Findings presented with context
- [ ] Stakeholder questions answered
- [ ] Feedback collected
- [ ] Action items documented

### Step 5: Analyze Trends and Improve Reporting

**Actions:**
- Analyze quality trends across reporting periods
- Identify patterns and correlations
- Improve report content based on feedback
- Automate report generation where possible

**Checklist:**
- [ ] Multi-period trend analysis completed
- [ ] Patterns and correlations identified
- [ ] Report content improved based on feedback
- [ ] Report generation automated
- [ ] Report accuracy validated
- [ ] Reporting process documented

## Success Metrics

| Metric | Target | Measurement |
|--------|--------|-------------|
| Report Delivery On-Time | >99% | Reports delivered on schedule / Total reports |
| Report Accuracy | >99% | Accurate reports / Total reports |
| Stakeholder Satisfaction | >4.5/5 | Post-report satisfaction survey |
| Report Automation Rate | >90% | Automated reports / Total reports |
| Data Freshness | <1 hour old | Time from data collection to report generation |
| Action Item Completion | >85% | Action items completed / Total action items |

## Error Handling

### Error 1: Data Source Unavailable During Report Generation
**Symptoms:** Report generation fails due to missing data source
**Resolution:**
1. Implement data source health checks before report generation
2. Use cached data from last successful collection
3. Flag missing data in report with clear notation
4. Set up alerts for data source failures
5. Implement retry logic with exponential backoff

### Error 2: Report Data Inconsistencies
**Symptoms:** Report shows conflicting or impossible values
**Resolution:**
1. Trace data back to source systems
2. Validate data transformation logic
3. Check for timezone or date range mismatches
4. Implement data validation rules in pipeline
5. Add data reconciliation checks

### Error 3: Report Not Meeting Stakeholder Needs
**Symptoms:** Stakeholders report reports are not useful or actionable
**Resolution:**
1. Conduct stakeholder interview to understand needs
2. Review report content against stakeholder requirements
3. Add or remove metrics based on feedback
4. Improve visualizations for clarity
5. Establish regular feedback loop for continuous improvement

## Cross-Team Integration

- **monitor-qualityforge-quality-monitor**: Receive real-time quality data for report generation
- **coverage-qualityforge-test-coverage-analyst**: Include coverage metrics in quality reports
- **resolver-qualityforge-issue-resolver**: Include resolution metrics and trends in reports
- **automation-qualityforge-test-automation**: Include test automation metrics in reports
- **guardian-Guardian**: Include quality gate compliance in reports
- **trainer-qualityforge-quality-trainer**: Provide quality data for training needs assessment