# Audit single specification
/spec-driven-development:audit .specs/user-auth/spec.md

# Audit all specifications
/spec-driven-development:audit --all

# JSON output for tooling
/spec-driven-development:audit .specs/user-auth/spec.md --format json

# Specification Audit Report

**Specification:** user-auth
**Audited:** 2024-01-15T10:30:00Z
**Grade:** B (84/100)

## Category Scores

| Category | Score | Max | % |
| --- | --- | --- | --- |
| Structure | 18 | 20 | 90% |
| Requirements | 21 | 25 | 84% |
| Acceptance Criteria | 20 | 25 | 80% |
| Traceability | 13 | 15 | 87% |
| Quality | 12 | 15 | 80% |
| **TOTAL** | **84** | **100** | **84%** |

## Issues Found

### Critical (0)
None

### Major (2)
1. **FR-3:** Missing acceptance criteria for error case
2. **NFR-1:** Performance threshold not testable

### Minor (3)
1. **FR-1.AC-2:** Could be more specific
2. **FR-2:** Consider splitting into smaller requirements
3. **Dependencies:** Missing link to FR-1

## Recommendations

1. Add acceptance criteria for FR-3 error handling
2. Specify measurable threshold for NFR-1
3. Consider refining FR-2 for better INVEST score

## Comparison (if previous audit exists)

| Metric | Previous | Current | Change |
| --- | --- | --- | --- |
| Grade | C (75) | B (84) | +9 |
| Issues | 8 | 5 | -3 |