Finding Architecture Problems with Improve Codebase Architecture

Tue, 09 Jun 2026 00:00:00 +0000

What It Discovers

Ask AI to “optimize my code” and it does local improvements — extracting functions, adding types, renaming. Useful, but surface-level. Improve Codebase Architecture does something different: it makes AI understand your domain model first, then finds architectural issues from that perspective. Cross-module coupling that local optimization can never see.

Part of Matt Pocock’s Suite

One of 18 skills. Install the full set:

npx skills@latest add mattpocock/skills

Run /setup-matt-pocock-skills first to configure your issue tracker, labels, and doc paths. AI needs to know whether you use GitHub Issues or Linear and where docs live.

Improve Codebase Architecture

Thu, 04 Jun 2026 00:00:00 +0000

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