harness-review
Harness Review
Review for concrete defects and risks. Reviews are read-only by default: identify actionable findings without changing files, commits, branches, pull requests, or external state.
Review Procedure
-
Establish the requested scope and applicable repository rules.
-
Inspect the complete relevant diff and enough surrounding code, tests, configuration, or documentation to understand behavior.
-
Verify each suspected issue. Trace inputs, control flow, affected callers, and existing tests instead of relying on pattern matching alone.
-
Classify actionable findings with references/review-severity.md.
-
Keep line ranges tight and ensure the cited line is part of, or directly explains, the defect.
-
Optionally validate structured findings before rendering them:
python3 scripts/validate_review.py findings.json -
Present findings in priority order. If none remain after verification, state that no actionable findings were found and mention any material verification gap.