What problem does it solve?
Analyzes codebases to identify refactoring opportunities based on Martin Fowler's catalog
of code smells and refactoring techniques. Detects duplicated code, high coupling, complex
conditionals, primitive obsession, long functions, and other structural issues. Produces
a structured refactoring report with prioritized findings saved to docs/_refacs/.
Use when auditing code quality, preparing for a refactoring sprint, or reviewing
architectural health. Don't use for style/formatting issues, performance optimization,
or security audits.
Core Features & Use Cases
- Smell detection: Identify broad categories like Duplicated Code, Long Functions, and
Large Modules, and classify severity to guide remediation.
- Refactoring mapping: Provide recommended Fowler techniques with before/after sketches
and rationale.
- Targeted reports: Generate a structured report stored under docs/_refacs/ with
prioritized findings and actionable recommendations.
Quick Start
Run the analysis workflow on your project to generate a prioritized refactoring report.