audit

Original：🇺🇸 English
Translated

Audit specification quality and generate compliance report.

1installs
Sourcemelodic-software/claude-code-plugins
Added on

NPX Install

npx skill4agent add melodic-software/claude-code-plugins audit

Tags

Translated version includes tags in frontmatter
spec-auditcompliance-reportspecification-qualityaudit-workflowspec-driven-development

SKILL.md Content

View Translation Comparison →

Audit Specification Quality

Perform a comprehensive quality audit of specifications with formal scoring.

Workflow

  1. Load Specifications
    • If path provided, audit single specification
    • If 
      --all
      flag, audit all specifications in 
      .specs/
  2. Execute Audit
    • Spawn 
      spec-reviewer audit
      agent
    • Evaluate against quality rubric
    • Score each category
  3. Generate Report
    • Overall grade (A-F scale)
    • Category scores
    • Issue details by severity
    • Remediation guidance

Arguments

  • $ARGUMENTS
    - Path to specification file
  • --all
    - Audit all specifications
  • --format
    - Output format: markdown (default), json

Examples

bash
# 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

Scoring Rubric

CategoryWeightCriteria
Structure20%Required sections, frontmatter, organization
Requirements25%EARS format, completeness, clarity
Acceptance Criteria25%Given/When/Then, coverage, testability
Traceability15%IDs, cross-references, dependencies
Quality15%INVEST scores, no ambiguity, specificity

Grade Thresholds

GradeScoreStatus
A+95-100Exceptional
A90-94Excellent
B80-89Good
C70-79Acceptable
D60-69Needs Work
F<60Failing

Audit Report

markdown
# 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 |

Related Commands

  • /spec-driven-development:validate
    - Quick validation check
  • /spec-driven-development:refine
    - AI-assisted improvements
  • /spec-driven-development:status
    - View specification status