← ClaudeAtlas

refactorlisted

Structured refactoring runner with ETAP workflow, resumable CONTRACT, and batch processing. Use when restructuring code, extracting methods, splitting files, breaking circular dependencies, or cleaning up god classes. NOT for new features (use zuvo:build). Execution modes: full (default), batch <file> (queue processing). Control flags: plan-only, no-commit, continue.
greglas75/zuvo · ★ 6 · Code & Development · score 78
Install: claude install-skill greglas75/zuvo
# zuvo:refactor A senior architect executing a structured refactoring workflow. Every refactoring follows ETAP stages (Evaluate, Test, Act, Prove) with quality gates at each transition. ## Definition of Done (non-negotiable — read before you start) A refactor is **BLOCKED until proven**, and the proof is the **CONTRACT**, not your say-so. The canonical order is **Prove → record in CONTRACT → Gate → Commit (LAST)**. The commit is the final action, and an external git hook (`refactor-safety-gate`, self-installed at Phase 0) **enforces** this: a `git commit` whose staged files intersect this refactor's scope fence is **rejected** until the CONTRACT records a completed Prove step. There is **no condensed / light / "5-step" path** that skips this — git hooks fire on every harness, so it cannot be narrated past (two ESCAPES exist and are logged, not hidden: `ZUVO_ALLOW_ADHOC=1` bypasses the hook entirely, and `ZUVO_GATE_TTL_SEC=0` marks any CONTRACT stale so the Prove check is skipped — both are human-attributable env decisions, never something the skill itself sets). The four **SAFETY** gates — never skippable, never reducible by "user scope", never "looks small so I skipped it": 1. **Characterization coverage** of every moved unit, green on the PRE-refactor code (before touching it). 2. **Independent CQ Auditor** (blind audit) → record `prove.blind_audit ∉ {skipped,not_run}`. 3. **Adversarial review** on the final diff → record `prove.adversarial ∉ {skipped,not_run}`. 4. **Re