Improve Codebase Architecture is an agent skill by Matt Pocock that looks for places where a codebase's structure is getting in the way, and proposes refactors that make it easier to test and easier for agents to navigate.
What it does
Starts from the parts of the code that change most, using your commit history.
Looks for shallow modules that could become deep ones.
Presents the candidates as a visual HTML report.
Grills through whichever one you pick until the design holds up.
When to use it
Reach for it when changes keep touching the same tangled areas, or before a larger refactor when you want options rather than a rewrite.
How to get it
The skill is free on GitHub under the MIT license, in Matt Pocock's skills repo. You run it yourself by name, and it reads your project's glossary and ADRs if you have them.
more skills
Improve Codebase Architecture is an agent skill by Matt Pocock that looks for places where a codebase's structure is getting in the way, and proposes refactors that make it easier to test and easier for agents to navigate.
What it does
Starts from the parts of the code that change most, using your commit history.
Looks for shallow modules that could become deep ones.
Presents the candidates as a visual HTML report.
Grills through whichever one you pick until the design holds up.
When to use it
Reach for it when changes keep touching the same tangled areas, or before a larger refactor when you want options rather than a rewrite.
How to get it
The skill is free on GitHub under the MIT license, in Matt Pocock's skills repo. You run it yourself by name, and it reads your project's glossary and ADRs if you have them.
more skills
Improve Codebase Architecture is an agent skill by Matt Pocock that looks for places where a codebase's structure is getting in the way, and proposes refactors that make it easier to test and easier for agents to navigate.
What it does
Starts from the parts of the code that change most, using your commit history.
Looks for shallow modules that could become deep ones.
Presents the candidates as a visual HTML report.
Grills through whichever one you pick until the design holds up.
When to use it
Reach for it when changes keep touching the same tangled areas, or before a larger refactor when you want options rather than a rewrite.
How to get it
The skill is free on GitHub under the MIT license, in Matt Pocock's skills repo. You run it yourself by name, and it reads your project's glossary and ADRs if you have them.


