/audit-summary Results & Reporting

Generate a summary report for an audit. Creates _summary.md in the audit folder with full results.

Audit Summary

You are generating an audit summary report.

Usage

/audit-summary
/audit-summary backend-api
/audit-summary backend-api 2026-02-04

Generate Summary

Read all result files from the audit folder and create audits/[project]/[date]/_summary.md:

# Audit Summary: [Project Name]

**Date:** [YYYY-MM-DD]
**Auditor:** claude-session

## Overview

| Metric | Value |
|--------|-------|
| Total Items | [count] |
| Passed | [count] ([%]) |
| Failed | [count] ([%]) |
| Partial | [count] |
| Skipped | [count] |
| Not Applicable | [count] |

**Overall Score:** [X]% compliant

## Critical Items

### Passing
- [ID]: [Title]
- [ID]: [Title]

### Failing
- [ID]: [Title] - [brief reason from notes/evidence]
- [ID]: [Title] - [brief reason]

## Section Breakdown

| Section | Pass | Fail | Skip | Score |
|---------|------|------|------|-------|
| 01 Git Repo Setup | 18 | 2 | 0 | 90% |
| 02 Dependencies | 6 | 1 | 0 | 86% |
| ... | | | | |

## Action Items

Based on failing items, prioritized recommendations:

1. **[ID]: [Title]** (Critical)
   [Brief recommendation based on evidence/notes]

2. **[ID]: [Title]** (Critical)
   [Brief recommendation]

3. **[ID]: [Title]** (Recommended)
   [Brief recommendation]

## Waivers Applied

| Item | Reason | Review Date |
|------|--------|-------------|
| [ID] | [reason from waiver file] | [date] |

## Compared to Previous Audit

[If previous audit exists in audits/[project]/]

| Metric | Previous | Current | Change |
|--------|----------|---------|--------|
| Pass Rate | 76% | 91% | +15% |
| Critical Pass | 85% | 95% | +10% |

### Improvements
- [ID]: [Title] now passing

### Regressions
- [ID]: [Title] now failing

---
Generated by CTO Audit Workflow

How to Build the Summary

  1. List all .md files in audits/[project]/[date]/ (excluding _summary.md and _ prefixed files)
  2. Parse YAML frontmatter from each result file
  3. Group by status, severity, and section
  4. Read waivers from waivers/ directory (both global and project-specific)
  5. If previous audit exists, compare results
  6. Generate action items by prioritizing: critical failures first, then recommended failures
  7. Write _summary.md

After Generation

Summary generated: audits/[project]/[date]/_summary.md

Key findings:

  • Overall: [X]% compliant
  • [Y] critical items need attention
  • [Z] items improved since last audit

View the full report or export it?