Complexitysmash

Perform a top-down complexity audit. Focus on why the codebase is hard to change, not just what can be deleted.

Core Model

• Separate essential complexity from accidental complexity.
• Treat accidental complexity as contagious. If an abstraction leaks, the next layer inherits that mess as a constraint.
• Prefer simplification moves that reduce cognitive load for future work, not just local elegance.
• Gather broadly, report narrowly. Do the full audit internally, but only present the highest-severity findings.

Positioning

• Use this skill for repo-wide or subsystem-wide simplification work.
• Use spring-cleaning when the job is mostly dead code removal, dependency cleanup, or local restructuring.
• Use this skill when the user wants findings, a simplification plan, or a diagnosis of structural drag before editing code.

Audit Workflow