improve-codebase-architecture — Skills

What it does

The domain language in CONTEXT.md gives names to good seams; ADRs in docs/adr/ record decisions this command should not re-litigate.

Where does understanding one concept require bouncing between many small modules?

Where are modules shallow — interface nearly as complex as the implementation?

Where have pure functions been extracted just for testability, but the real bugs hide in how they're called (no locality)?

Where do tightly-coupled modules leak across their seams?

Which parts of the codebase are untested, or hard to test through their current interface?

Files — which files/modules are involved

Analyze codebases for architectural friction and propose module-deepening refactors as testability improvements.

Source

Repository: https://github.com/mattpocock/skills

improve-codebase-architecture FAQ

What does the improve-codebase-architecture skill do?

Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick. The domain language in CONTEXT.md gives names to good seams; ADRs in docs/adr/ record decisions this command should not re-litigate. Where does understanding one concept require bouncing between many small modules?

What does improve-codebase-architecture require?

Where does understanding one concept require bouncing between many small modules? Configuration keys: CONTEXT, TMPDIR.

How do I install improve-codebase-architecture?

Run: npx -y skills add https://github.com/mattpocock/skills --skill improve-codebase-architecture --agent claude-code — the source lives at github.com/mattpocock/skills.

Maintain improve-codebase-architecture?

Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.

[![improve-codebase-architecture on getagentictools](https://getagentictools.com/badge/skills/mattpocock-skills-improve-codebase-architecture.svg)](https://getagentictools.com/skills/mattpocock-skills-improve-codebase-architecture?ref=badge)

npx agentictools info skills/mattpocock-skills-improve-codebase-architecture

The second line is the CLI lookup for this page — handy in READMEs and docs.