skills sourced live from GitHub · all skills listed are free · each skill is provided under its author's license.
home / Coding / Improve Codebase Architecture Skill by @mattpocock
The skill is the skills/engineering/improve-codebase-architecture folder inside that repository. Copy it into the folder your agent loads skills from; check your agent's documentation for where that is.
Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.
Scans a codebase for places where modules could be made deeper, shows the candidates in a visual HTML report, then walks you through the one you choose in a questioning loop. It is a design conversation, not an automatic refactor.
The original SKILL.md is organised into these sections:
Written and maintained by @mattpocock. It is published under the MIT license, which allows reuse with attribution. See the author profile. SkillDirectory does not claim authorship: this page adds our own review and links back to the original, and the skill's text belongs to its author.
# Improve Codebase Architecture Surface architectural friction and propose **deepening opportunities**: refactors that turn shallow modules into deep ones. The aim is testability and AI-navigability. This command is _informed_ by the project's domain model and built on a shared design vocabulary: - Call the Skill tool with "codebase-design" for the architecture vocabulary (**module**, **interface**, **depth**, **seam**, **adapter**, **leverage**, **locality**) and its principles (the deletion test, "the interface is the test surface", "one adapter = hypothetical seam, two = real"). Use these terms exactly in every suggestion, and don't drift into "component," "service," "API," or "boundary." - The domain language in `GLOSSARY.md` gives names to good seams; ADRs in `docs/adr/` record decisions this command should not re-litigate. ## Process ### 1. Explore …
Excerpt only, quoted from the author's repository. Open the repository for the complete file.