/verification-quality

name: "Verification & Quality Assurance"
description: "Comprehensive truth scoring, code quality verification, and automatic rollback system with 0.95 accuracy threshold for ensuring high-quality agent outputs and codebase reliability."
version: "2.0.0"
category: "quality-assurance"
tags: ["verification", "truth-scoring", "quality", "rollback", "metrics", "ci-cd"]

Verification & Quality Assurance Skill

What This Skill Does

This skill provides a comprehensive verification and quality assurance system that ensures code quality and correctness through:

• **Truth Scoring**: Real-time reliability metrics (0.0-1.0 scale) for code, agents, and tasks
• **Verification Checks**: Automated code correctness, security, and best practices validation
• **Automatic Rollback**: Instant reversion of changes that fail verification (default threshold: 0.95)
• **Quality Metrics**: Statistical analysis with trends, confidence intervals, and improvement tracking
• **CI/CD Integration**: Export capabilities for continuous integration pipelines
• **Real-time Monitoring**: Live dashboards and watch modes for ongoing verification

Prerequisites

• Claude Flow installed (`npx claude-flow@alpha`)
• Git repository (for rollback features)
• Node.js 18+ (for dashboard features)

Quick Start

# View current truth scores
npx claude-flow@alpha truth

# Run verification check
npx claude-flow@alpha verify check

# Verify specific file with custom threshold
npx claude-flow@alpha verify check --file src/app.js --threshold 0.98

# Rollback last failed verification
npx claude-flow@alpha verify rollback --last-good

---

Complete Guide

Truth Scoring System

View Truth Metrics

Display comprehensive quality and reliability metrics for your codebase and agent tasks.

**Basic Usage:**

# View current truth scores (default: table format)
npx claude-flow@alpha truth

# View scores for specific time period
npx claude-flow@alpha truth --period 7d

# View scores for specific agent
npx claude-flow@alpha truth --agent coder --period 24h

# Find files/tasks below threshold
npx claude-flow@alpha truth --threshold 0.8

**Output Formats:**

# Table format (default)
npx claude-flow@alpha truth --format table

# JSON for programmatic access
npx claude-flow@alpha truth --format json

# CSV for spreadsheet analysis
npx claude-flow@alpha truth --format csv

# HTML report with visualizations
npx claude-flow@alpha truth --format html --export report.html

**Real-time Monitoring:**

# Watch mode with live updates
npx claude-flow@alpha truth --watch

# Export metrics automatically
npx claude-flow@alpha truth --export .claude-flow/metrics/truth-$(date +%Y%m%d).json

Truth Score Dashboard

Example dashboard output:

📊 Truth Metrics Dashboard
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Overall Truth Score: 0.947 ✅
Trend: ↗️ +2.3% (7d)

Top Performers:
  verification-agent   0.982 ⭐
  code-analyzer       0.971 ⭐
  test-generator      0.958 ✅

Needs Attention:
  refactor-agent      0.821 ⚠️
  docs-generator      0.794 ⚠️

Recent Tasks:
  task-456  0.991 ✅  "Implement auth"
  task-455  0.967 ✅  "Add tests"
  task-454  0.743 ❌  "Refactor API"

Metrics Explained

**Truth Scores (0.0-1.0):**

• `1.0-0.95`: Excellent ⭐ (production-ready)
• `0.94-0.85`: Good ✅ (acceptable quality)
• `0.84-0.75`: Warning ⚠️ (needs attention)
• `<0.75`: Critical ❌ (requires immediate action)

**Trend Indicators:**

• ↗️ Improving (positive trend)
• → Stable (consistent performance)
• ↘️ Declining (quality regression detected)

**Statistics:**

• **Mean Score**: Average truth score across all measurements
• **Median Score**: Middle value (less affected by outliers)
• **Standard Deviation**: Consistency of scores (lower = more consistent)
• **Confidence Interval**: Statistical reliability of measurements

Verification Checks

Run Verification

Execute comprehensive verification checks on code, tasks, or agent outputs.

**File Verification:**

# Verify single file
npx claude-flow@alpha verify check --file src/app.js

# Verify directory recursively
npx claude-flow@alpha verify check --directory src/

# Verify with auto-fix enabled
npx claude-flow@alpha verify check --file src/utils.js --auto-fix

# Verify current working directory
npx claude-flow@alpha verify check

**Task Verification:**

# Verify specific task output
npx claude-flow@alpha verify check --task task-123

# Verify with custom threshold
npx claude-flow@alpha verify check --task task-456 --threshold 0.99

# Verbose output for debugging
npx claude-flow@alpha verify check --task task-789 --verbose

**Batch Verification:**

# Verify multiple files in parallel
npx claude-flow@alpha verify batch --files "*.js" --parallel

# Verify with pattern matching
npx claude-flow@alpha verify batch --pattern "src/**/*.ts"

# Integration test suite
npx claude-flow@alpha verify integration --test-suite full

Verification Criteria

The verification system evaluates:

1. **Code Correctness**

• Syntax validation
• Type checking (TypeScript)
• Logic flow analysis
• Error handling completeness

2. **Best Practices**

• Code style adherence
• SOLID principles
• Design patterns usage
• Modularity and reusability

3. **Security**

• Vulnerability scanning
• Secret detection
• Input validation
• Authentication/authorization checks

4. **Performance**

• Algorithmic complexity
• Memory usage patterns
• Database query optimization
• Bundle size impact

5. **Documentation**

• JSDoc/TypeDoc completeness
• README accuracy
• API documentation
• Code comments quality

JSON Output for CI/CD

# Get structured JSON output
npx claude-flow@alpha verify check --json > verification.json

# Example JSON structure:
{
  "overallScore": 0.947,
  "passed": true,
  "threshold": 0.95,
  "checks": [
    {
      "name": "code-correctness",
      "score": 0.98,