← ClaudeAtlas

improve-codebase-architecturelisted

Scan a codebase for deepening opportunities, present them as a reviewable artifact, then grill through whichever one you pick. Use when the user asks for an architecture review, wants to find refactors that make code more testable or navigable, or asks what to restructure.
rexchao1/not-so-simple-software-factory · ★ 3 · Code & Development · score 77
Install: claude install-skill rexchao1/not-so-simple-software-factory
# 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. Everything here is 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 - don't drift into "component," "service," "API," or "boundary." - If the repo keeps a domain glossary, its terms name the good seams; if it keeps decision records, those record decisions this skill should not re-litigate. Read both before scanning, and skip this quietly when the repo has neither. ## Process ### 1. Explore **Scope before you scan - YAGNI.** Deepening a module pays off by making future changes to it easier, so put extra weight on the parts of the codebase that have recently changed. Decide *where* to look before you look: - If the user named a direction - a module, a subsystem, a pain point - take it, and skip the inference below. - Otherwise, walk back a good stretch of the commit history (`git log --oneline`) to find the codebase's hot spots - the files and areas that keep coming up - and let those paths pull your attention first. If the changes are scattered with