Improve Codebase Architecture in Claude Code: Review Module Depth
Improve Codebase Architecture examines module interfaces, tests, and change hot spots, then presents a visual shortlist of possible refactors for discussion.
中文Setup for Claude Code
Claude Code in a local Git checkout with access to the chosen source tree and an OS temp directory. The bundled report template uses CDN assets for styling and diagrams.
- Copy skills/engineering/improve-codebase-architecture into .claude/skills/improve-codebase-architecture/ and keep its HTML-REPORT.md template.
- Copy skills/engineering/codebase-design from the same commit into .claude/skills/codebase-design/.
- Start Claude Code at the Git project root. Invoke /improve-codebase-architecture and name one subsystem.
Example task
Create two tiny modules that independently calculate invoice totals and round at different points. Add a glossary entry for Invoice Total, commit the scratch project, and ask the skill to review only these modules without editing source code.Expected result
The temporary HTML report identifies the two files, compares the exposed interfaces, and presents a candidate seam with a plausible test strategy. The working tree stays unchanged.
Upstream documentation
Original SKILL.md on GitHub · MIT license · Source reviewed
Frequently asked question
Does the skill apply the recommended refactors?
It produces a report and asks the reader to select a candidate for discussion. The example requests review only.