Improve Codebase Architecture

Find the refactors that make a codebase easier to change.

By

Matt Pocock

Price

Free

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

Matt Pocock

Code Review

Matt Pocock

Review a branch against your standards and the spec.

Matt Pocock

Prototype

Matt Pocock

Answer a design question with throwaway code.

Jakub Krehel

Better Typography

Jakub Krehel

Set the type scale, spacing, and wrapping right.

Emil Kowalski

Learn Taste

Emil Kowalski

Turn your design corrections into rules.

Improve Codebase Architecture

Find the refactors that make a codebase easier to change.

By

Matt Pocock

Price

Free

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

Matt Pocock

Code Review

Matt Pocock

Review a branch against your standards and the spec.

Matt Pocock

Prototype

Matt Pocock

Answer a design question with throwaway code.

Jakub Krehel

Better Typography

Jakub Krehel

Set the type scale, spacing, and wrapping right.

Emil Kowalski

Learn Taste

Emil Kowalski

Turn your design corrections into rules.

Improve Codebase Architecture

Find the refactors that make a codebase easier to change.

By

Matt Pocock

Price

Free

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

Matt Pocock

Code Review

Matt Pocock

Review a branch against your standards and the spec.

Matt Pocock

Prototype

Matt Pocock

Answer a design question with throwaway code.

Jakub Krehel

Better Typography

Jakub Krehel

Set the type scale, spacing, and wrapping right.

Emil Kowalski

Learn Taste

Emil Kowalski

Turn your design corrections into rules.