Improve Codebase Architecture

What It Is

Makes AI scan your codebase to find deep architectural improvement opportunities based on domain language and ADRs (Architecture Decision Records). Not surface-level refactoring like extracting functions or renaming variables — it identifies module coupling, responsibility blur, and abstraction mismatches.

What’s Actually Different

Ask AI to “optimize my code” and it usually does local improvements. This skill makes AI first understand your domain model, then find architecture-level issues. Works best with the CONTEXT.md file from Matt Pocock’s suite — so AI knows what your project’s terms mean.

Who It’s For

Teams with codebases that have grown past the “new project” stage and are showing technical debt. If your code works but keeps getting harder to change, this skill systematically identifies what to refactor.

Bottom Line

AI doesn’t just write code — it helps you find where your architecture is broken.