Refactoring Safe Skill

Goal: Prevent broken links and missing imports by checking references BEFORE moving files.

Protocol

1. •

   Identify Target:

   • •Source file: src/old/path.py
   • •Destination: src/new/path.py
2. •

   Trace References (Pre-Flight):

   • •Use grepai trace callers "path/basename" or grepai search "basename" to find all usages.
   • •CRITICAL: If grepai returns > 0 results outside the file itself, STOP and list them.
3. •

   Execute Move:

   • •Only if 0 critical references found OR user explicitly approves after warning.
   • •Use git mv (if git repo) or mv.
4. •

   Post-Move Update:

   • •Update known references (imports, includes).
   • •Verify: Run grep for the old path to ensure it's gone.

Usage

# Safe Move
/refactor move source.py dest/