Agent skill

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.

View SKILL.md on GitHub Repository
Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/development/refactor-arch-hotspots

SKILL.md

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:

  1. High churn AND high complexity
  2. Frequently causing bugs
  3. Blocking feature development

Didn't find tool you were looking for?

Be as detailed as possible for better results