13 REFACTORING Development and operations High

Large-Scale Legacy Code Refactoring

Massive legacy code migration with checkpoints, rollback, and provenance of 87% AI-generated changes.

◻ intake ★★☆

△ architect ★★★

◇ vigil ★★★

⬡ licit ★★☆

Architecture diagram

Context

Large-scale legacy code refactoring with dry-run preview, checkpoints every N iterations, and automatic rollback on failure.

Flow with 4 tools

△ Phase 01 — architect

Execution with checkpoints

Loop with pytest, vigil, and mypy as checks, with checkpoints every 3 iterations.

△ architect

architect loop "Migrate src/services/auth/ to async httpx" \
  --check "pytest tests/ -q" \
  --check "vigil scan src/" \
  --check "mypy src/ --strict" \
  --max-iterations 15 \
  --checkpoint-every 3

⬡ Phase 02 — licit

Document the massive change

Refactoring provenance report and guardrail change detection.

⬡ licit

licit trace
licit changelog