Skills
CodingDesign

Improve Codebase Architecture

GitHub:mattpocockUpdated Oct 29, 2026Stars 318.2kForks 26.6k
View on GitHub

Scan your codebase for architectural friction and get a visual HTML report of deepening opportunities: refactors that turn shallow modules into deep ones for better testability and AI-navigability. The scan prioritises recently changed hot spots (or a direction you name), reads your glossary and ADRs, and explores where understanding one concept means bouncing between many small modules. Each candidate card shows the files involved, the problem, the proposed solution, benefits in terms of locality and leverage, a before/after diagram, and a recommendation strength, ending with a top recommendation. Pick one and the agent walks the decision tree with you.

Try it

  • Scan my codebase for deepening opportunities and give me a visual HTML report of the candidates.
  • Look at the billing module and show me where the architecture is causing friction, with before/after diagrams.
  • I want to explore the top recommendation from the architecture report — walk me through the constraints and what tests survive.

Details

Publisher
mattpocock
Source
mattpocock/skills
GitHub stars
318.2k
Runtime
No sandbox needed
Last updated
Oct 29, 2026