Architecture Debt Skill

Goal

Identify architectural anti-patterns through dependency analysis and propose concrete, phased migration paths. Architecture debt is more expensive than code debt — it blocks entire teams.

Steps

1. Run import/dependency graph analysis

   JavaScript/TypeScript:

   # Circular dependency detection
   npx madge --circular --extensions ts,js,tsx src/
   
   # Full dependency graph visualization
   npx madge --image dependency-graph.svg --extensions ts,js src/
   
   # Dependency rules enforcement
   npx dependency-cruiser --config .dependency-cruiser.cjs src/