/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
- List all
.mdfiles inaudits/[project]/[date]/(excluding_summary.mdand_prefixed files) - Parse YAML frontmatter from each result file
- Group by status, severity, and section
- Read waivers from
waivers/directory (both global and project-specific) - If previous audit exists, compare results
- Generate action items by prioritizing: critical failures first, then recommended failures
- 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?