What problem does it solve?
Long, tangled, or idiomatically inconsistent code that is hard to read, maintain, and review without changing its observable behavior; it reduces cognitive load and technical debt by applying targeted, behavior-preserving refinements.
Core Features & Use Cases
- Multi-pass analysis: Reconnaissance, structural analysis, refactoring execution, verification, and reporting to ensure safe, incremental changes.
- Language-agnostic guidance: Tailored idiom recommendations and tactics for Python, Go, TypeScript/JavaScript, and Rust using embedded references.
- Automated metrics & verification: Uses a builtin Python complexity_report tool and git-based scope detection to quantify complexity deltas and run verification steps (tests, linters, manual trace).
- Conservative behavioral constraints: Enforces strict rules to never change observable behavior, public APIs, or introduce new dependencies, with configurable aggressiveness modes (quick, standard, deep, surgical).
- Developer-facing report generation: Produces per-file change summaries, complexity deltas, and risk assessments to build trust before committing.
Quick Start
Refine the recent git changes to reduce nesting and improve readability while preserving exact behavior.