runtime-role-matrix-live-20260714105818-v9/docs/reviewer-role-spec.md

Reviewer Role Specification

Overview

The Reviewer role is responsible for validating documentation changes and ensuring verification reports accurately reflect the actual state of the repository.

Responsibilities

1. Documentation Accuracy: Verify that all documented changes match actual file modifications
2. Evidence Completeness: Ensure each verification item has independent, verifiable evidence
3. Scope Consistency: Report only on files that were actually changed

Verification Criteria

File Existence

• All listed files must exist in the repository
• No phantom references to non-existent files

Evidence Requirements

• Each verification item must include:
  • Command executed
  • Expected result
  • Actual command output
  • Pass/Fail status

Scope Boundaries

• Verification scope must match change scope
• If only docs/ files changed, do not report on src/ files
• If only src/ files changed, do not report on docs/ files

Smoke Test Criteria

Criterion	Description
File List Accuracy	Changed files list matches actual modifications
Evidence Independence	Each item has command output evidence
Scope Consistency	Verification scope matches change scope
Syntax Validity	JSON files are parseable
Encoding	All files are UTF-8 encoded

Previous Issues (Resolved)

1. Mismatched File Lists: Fixed by ensuring verification-results.txt lists only actual changed files
2. Missing Evidence: Fixed by adding command_output fields to all verification items
3. Invalid Scope: Fixed by limiting verification to docs/ files only (no src/ references)