← ClaudeAtlas

mkimprove-codebase-architecturelisted

Use when surfacing architectural friction and proposing deepening refactors (shallow modules → deep modules) for testability and AI-navigability. Triggers on "improve architecture", "find deepening opportunities", "where is this codebase shallow", "architecture review". Emits structured candidates + precise patches; delegates ALL rendering to mk:preview. NOT for diagram/HTML rendering (see mk:preview); NOT for trade-off deliberation (see mk:party); NOT for plan critique (see mk:plan-ceo-review).
ngocsangyem/MeowKit · ★ 14 · AI & Automation · score 81
Install: claude install-skill ngocsangyem/MeowKit
# mk: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 skill owns three things only: **structural analysis**, **dependency mapping**, and **type-safe patch emission**. It owns no rendering. Every visual artifact (before/after diagrams, candidate report, HTML) is produced by `mk:preview`. The skill emits structured findings; `mk:preview` draws them. ## Architecture vocabulary (use exactly) Self-contained glossary — every suggestion uses these nouns/verbs and no synonyms. - **module** — a unit with an interface and an implementation. Never "component", "service", "unit", "layer", "wrapper". - **interface** — the surface a caller depends on. Never "API", "signature". - **depth** — implementation complexity hidden behind a small interface. **deep** = small interface, large implementation. **shallow** = interface nearly as wide as implementation. - **seam** — the line where two modules meet. Never "boundary". - **adapter** — a substitutable implementation behind a seam. Rule: *one adapter = hypothetical seam, two = real seam.* - **leverage** — one interface serving N call sites. - **locality** — related logic (and its bugs) concentrated in one module, not scattered. - **deletion test** — would deleting this module *concentrate* complexity (good — it was shallow) or merely *move* it (it was load-bearing)? "Concentrates" is th