From 657f228b105f29c585af4b72ead8f94f0e8b247d Mon Sep 17 00:00:00 2001
From: forge-bot <bot@forge.local>
Date: Tue, 14 Jul 2026 11:08:13 +0000
Subject: [PATCH] =?UTF-8?q?Reviewer=20=EC=97=AD=ED=95=A0=20=EA=B2=80?=
 =?UTF-8?q?=EC=A6=9D=20=EB=B3=B4=EA=B3=A0=EC=84=9C=20smoke=20(runtime-role?=
 =?UTF-8?q?-matrix-live-20260714105818-v9-reviewer-001)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/reviewer-role-spec.md | 45 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)
 create mode 100644 docs/reviewer-role-spec.md

diff --git a/docs/reviewer-role-spec.md b/docs/reviewer-role-spec.md
new file mode 100644
index 0000000..2f03d53
--- /dev/null
+++ b/docs/reviewer-role-spec.md
@@ -0,0 +1,45 @@
+# 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)
\ No newline at end of file