candidates-folder-refactor

What problem does it solve?

It helps you quickly identify which folders in a codebase are most likely to be noisy, tangled, or responsibility-mixed so you can refactor where it will matter.

Core Features & Use Cases

• Noise triage ranking: Scans and ranks top candidate folders using file volume, direct children, extension mix, depth, test presence, churn, import/caller signals, and duplicate-name/symbol evidence.
• Evidence-first results: Produces a top-five list with inline metrics to support human verification rather than treating scores as proof.
• Safe scouting and handoff: Does not move or edit files; it writes a local reuse log for faster reruns and guides the next step toward a bounded /folder-refactor target.
• Common use cases: Finding good split points for large directories, narrowing refactor scope away from repo-root, and reusing prior scan findings during iterative ownership review.

Quick Start

Run the scanner from your repo root to get the top five noisy refactor candidates.