Claude-Code-Workflow/.claude/skills/investigate/phases/05-verification-report.md

Phase 5: Verification & Report

Run full test suite, check for regressions, and generate the structured debug report.

Objective

• Run the full test suite to verify no regressions were introduced
• Generate a structured debug report for future reference
• Output the report to .workflow/.debug/ directory

Execution Steps

Step 1: Run Full Test Suite

# Detect and run the project's test framework
# npm test / pytest / go test / cargo test / etc.

Record results:

{
  "test_results": {
    "total": 0,
    "passed": 0,
    "failed": 0,
    "skipped": 0,
    "regression_test_passed": true,
    "new_failures": []
  }
}

If new failures are found:

• Check if the failures are related to the fix
• If related: the fix introduced a regression — return to Phase 4 to adjust
• If unrelated: document as pre-existing failures, proceed with report

Step 2: Regression Check

Verify specifically:

1. The new regression test passes
2. All tests that passed before the fix still pass
3. No new warnings or errors in test output

Step 3: Generate Structured Debug Report

Create the report following the schema in specs/debug-report-format.md:

mkdir -p .workflow/.debug

{
  "bug_description": "concise description of the bug",
  "reproduction_steps": [
    "step 1",
    "step 2",
    "step 3: observe error"
  ],
  "root_cause": "confirmed root cause description with technical detail",
  "evidence_chain": [
    "Phase 1: error message X observed in module Y",
    "Phase 2: pattern analysis found N similar occurrences",
    "Phase 3: hypothesis H1 confirmed — specific condition at file:line"
  ],
  "fix_description": "what was changed and why",
  "files_changed": [
    {
      "path": "src/module/file.ts",
      "change_type": "modify",
      "description": "added null check before property access"
    }
  ],
  "tests_added": [
    {
      "file": "src/module/__tests__/file.test.ts",
      "test_name": "should handle null return from X",
      "type": "regression"
    }
  ],
  "regression_check_result": {
    "passed": true,
    "total_tests": 0,
    "new_failures": [],
    "pre_existing_failures": []
  },
  "completion_status": "DONE|DONE_WITH_CONCERNS|BLOCKED",
  "concerns": [],
  "timestamp": "ISO-8601",
  "investigation_duration_phases": 5
}

Step 4: Write Report File

const slug = bugDescription.toLowerCase().replace(/[^a-z0-9]+/g, '-').substring(0, 40)
const dateStr = new Date().toISOString().substring(0, 10)
const reportPath = `.workflow/.debug/debug-report-${dateStr}-${slug}.json`

Write({ file_path: reportPath, content: JSON.stringify(report, null, 2) })

Step 5: Output Completion Status

Follow the Completion Status Protocol from _shared/SKILL-DESIGN-SPEC.md section 13:

DONE:

## STATUS: DONE

**Summary**: Fixed {bug_description} — root cause was {root_cause_summary}

### Details
- Phases completed: 5/5
- Root cause: {confirmed_root_cause}
- Fix: {fix_description}
- Regression test: {test_name} in {test_file}

### Outputs
- Debug report: {reportPath}
- Files changed: {list}
- Tests added: {list}

DONE_WITH_CONCERNS:

## STATUS: DONE_WITH_CONCERNS

**Summary**: Fixed {bug_description} with concerns

### Details
- Phases completed: 5/5
- Concerns:
  1. {concern} — Impact: {low|medium} — Suggested fix: {action}

Output

• File: debug-report-{YYYY-MM-DD}-{slug}.json
• Location: .workflow/.debug/
• Format: JSON (see specs/debug-report-format.md)

Quality Checks

• Full test suite executed
• Regression test specifically verified
• No new test failures introduced (or documented if pre-existing)
• Debug report written to .workflow/.debug/
• Completion status output follows protocol