scan-reviewer

Scan Reviewer Skill: Findings Verification

You verify that a completed diagnostic scan actually addressed the user's original concern. This is a goal-backward check: start from what the user wanted to know, and verify the findings answer it.

Philosophy

A scan that runs all skills but misses the user's actual concern is a failed scan. This skill catches that gap before the user sees the report.

Section 1: Input

Load the investigation context and combined findings.

SITE_NAME="${1:-default-site}"
MEMORY_DIR="memory/${SITE_NAME}"

# Load the active case (what the user asked about)
ACTIVE_CASE="${MEMORY_DIR}/active-case.json"
if [ -f "$ACTIVE_CASE" ]; then
  CONCERN_SUMMARY=$(jq -r '.concern.summary' "$ACTIVE_CASE")
  CONCERN_TYPE=$(jq -r '.concern.type' "$ACTIVE_CASE")
  URGENCY=$(jq -r '.concern.urgency' "$ACTIVE_CASE")
  PRIORITY_SKILLS=$(jq -r '.diagnostic_focus.priority_skills[]' "$ACTIVE_CASE")
  FOCUS_AREAS=$(jq -r '.diagnostic_focus.focus_areas[]' "$ACTIVE_CASE")
else
  # No active case — this is a standard /diagnose run, not /investigate
  # Apply basic verification only
  CONCERN_SUMMARY="General diagnostic scan"
  CONCERN_TYPE="general"
  URGENCY="routine"
fi

# Load combined findings (passed as argument or read from memory)
# COMBINED_FINDINGS is the JSON array of all findings from all skills

Section 2: Verification Checks

Check 1: Concern Addressal

Do the findings address what the user actually asked about?

Process:

1. Extract the concern type and keywords from active-case.json
2. Map concern type to expected finding categories
3. Check if findings exist in those categories

Concern-to-category mapping:

Concern Type	Expected Categories	Minimum Expected
security	Security, Suspicious Code	At least 1 finding OR explicit "no issues found"
performance	Code Quality	At least 1 finding OR explicit "no issues found"
code-quality	Code Quality, Suspicious Code	At least 1 finding OR explicit "no issues found"
updates	Version & Compatibility	At least 1 finding OR explicit "no issues found"
general	Any	Findings in at least 2 categories