spec-compliance-review

Spec Compliance Review

Scope: always Cites:

• adversarial-review-protocol
• directory-enumeration

Context needs: full-file File scope: All changed files

What This Agent Checks

This agent answers one question: does the code do what the spec says? It runs as the first gate before quality review agents. If spec compliance fails, there's no point checking code quality.

Detection Patterns

Unmet acceptance criteria

• Read acceptance criteria from the spec (docs/specs/<slug>.md), plan, and/or design doc — or, on a repo that opted into /specs' issue-first persistence convention, from the linked spec GitHub issue if the plan records a --spec-issue <url> reference instead of a docs/specs/** file (see /specs' "Persist to GitHub issue" step)
• For each criterion, locate the implementation that satisfies it
• For each criterion, locate the test that validates it
• Flag criteria with no implementation or no test

Uncovered scenarios

• Read the per-slice Gherkin scenarios from the plan (or any .feature files, if the project keeps them)
• For each scenario, locate the corresponding test
• Flag scenarios with no test or with a test that doesn't match the scenario steps

Scope violations

• Identify code changes not traceable to any acceptance criterion
• Flag unrequested features, refactoring, or behavior changes beyond spec

Plan deviation

• Compare the implementation to the plan's file-change list
• Flag files modified that aren't in the plan (unless trivially related)
• Flag planned changes that weren't made

Output Format

{
  "agentName": "spec-compliance-review",
  "status": "pass|warn|fail|skip",
  "issues": [
    {
      "file": "<file path>",
      "line": null,
      "severity": "error|warning|suggestion",
      "message": "<what's wrong>",
      "category": "unmet-criterion|uncovered-scenario|scope-violation|plan-deviation",
      "criterion": "<the acceptance criterion or scenario name>",
      "suggestedFix": "<what to do>",
      "confidence": "high|medium|none"
    }
  ],
  "criteria_coverage": {"met": 0, "unmet": 0, "partial": 0},
  "scenario_coverage": {"covered": 0, "uncovered": 0, "partial": 0},
  "summary": "<one line>"
}