---

name: refactor-verify description: Before/after verification for refactoring - ensures nothing breaks

refactor-verify

Overview

Mandatory verification skill for any refactoring task. Captures state before refactor, then verifies nothing broke after.

⚠️ CRITICAL: Must Use Before Any Refactor

Copy# BEFORE refactoring - capture baseline
refactor-verify before /path/to/project

# DO YOUR REFACTORING WORK

# AFTER refactoring - verify nothing broke
refactor-verify after /path/to/project

What It Checks

Before Phase

1. Runs all tests → saves pass/fail count
2. Runs code-analyze metrics → saves file/line counts
3. Runs code-analyze complexity → saves complexity scores
4. Captures git status
5. Saves snapshot to .refactor-baseline.json

After Phase

1. Runs all tests → compares to baseline
2. Runs code-analyze metrics → compares
3. Runs code-analyze complexity → compares
4. Generates diff report
5. FAILS if:
   • Any test that passed before now fails
   • Complexity increased significantly
   • Dead code introduced

Usage

Copy# Step 1: Before refactoring
cd /home/alex/kapu-ti
refactor-verify before backend/src/services

# Step 2: Do your refactoring work
# ... edit files ...

# Step 3: Verify after refactoring
refactor-verify after backend/src/services

# Optional: View baseline
refactor-verify status

# Optional: Clear baseline (start fresh)
refactor-verify reset

Commands

Output Example

Copy📊 REFACTOR VERIFICATION REPORT
================================

Tests:
  Before: 47 passed, 0 failed
  After:  47 passed, 0 failed
  ✅ All tests still passing

Metrics:
  Before: 1,473 lines in 1 file
  After:  1,512 lines in 5 files
  ✅ Lines increased slightly (acceptable for splitting)

Complexity:
  Before: Max 45, Avg 12
  After:  Max 18, Avg 8
  ✅ Complexity reduced!

Overall: ✅ REFACTOR VERIFIED

Integration with cc Workflow

cc MUST run this skill for ANY refactoring task:

1. Read task file
2. Search AI Kitchen RAG for patterns
3. Run refactor-verify before
4. Do refactoring work
5. Run refactor-verify after
6. Only complete task if verification passes

Files

• scripts/refactor-verify.sh - Main verification script
• .refactor-baseline.json - Stored in project root during refactor

Dependencies

• code-analyze skill (for metrics)
• pnpm test (for test execution)
• git (for status tracking)