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

Grill With Docs

Matt Pocock

Stress-test a plan and write the docs as you go.

Theo Browne

Full Send

Theo Browne

Hand off a task and get back a merged PR.

Sync Styles

Andres Gonzalez

Bring your codebase's colors, type, and icons into Framer.

Convert Prompt

Andres Gonzalez

Turn React or Tailwind prompts into Framer agent prompts.

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

Grill With Docs

Matt Pocock

Stress-test a plan and write the docs as you go.

Theo Browne

Full Send

Theo Browne

Hand off a task and get back a merged PR.

Sync Styles

Andres Gonzalez

Bring your codebase's colors, type, and icons into Framer.

Convert Prompt

Andres Gonzalez

Turn React or Tailwind prompts into Framer agent prompts.

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

Grill With Docs

Matt Pocock

Stress-test a plan and write the docs as you go.

Theo Browne

Full Send

Theo Browne

Hand off a task and get back a merged PR.

Sync Styles

Andres Gonzalez

Bring your codebase's colors, type, and icons into Framer.

Convert Prompt

Andres Gonzalez

Turn React or Tailwind prompts into Framer agent prompts.