refactor-arch-hotspots

[Code Quality] Identifies architectural hotspots: high-churn files, coupling issues, layer violations, and dependency tangles. Use to find systemic issues that cause repeated bugs or slow development.

Refactor: Architecture Hotspots

Find structural issues that create ongoing maintenance burden.

Hotspot Categories

1. High-Churn Files

Files changed frequently indicate poor abstraction boundaries.

2. Coupling Analysis

Afferent Coupling (Ca): Who depends on this?
Efferent Coupling (Ce): What does this depend on?
Instability (I): Ce / (Ca + Ce)

3. Layer Violations

UI accessing database directly
Business logic in controllers
Circular module dependencies

4. Dependency Tangles

Import cycles
Bidirectional dependencies
God modules everything imports

Prioritization

Focus on hotspots that are:

High churn AND high complexity
Frequently causing bugs
Blocking feature development