architecture-deepening
Installation
SKILL.md
Architecture Deepening
Find shallow modules and propose deepening opportunities. Not a code review -- does not find bugs or style violations. Finds modules where the interface is too close to the implementation, where users must understand internals to use the API, and where small interface changes would absorb disproportionate complexity.
When to use: After codebase onboarding, before a major feature push, when new contributors report confusion, or when "how do I use this?" questions recur.
Differs from full-repo-review: Full-repo-review finds defects. This skill finds structural improvement opportunities. Pair well: run full-repo-review first to fix defects, then architecture-deepening to raise the bar.
Reference Loading Table
| Signal | Load These Files | Why |
|---|---|---|
| Phase 1, module analysis, vocabulary terms | vocabulary.md |
Shared architecture vocabulary: module, depth, seam, leverage, locality, deletion test |
| Phase 2, interface alternatives, parallel exploration | interface-design.md |
Parallel sub-agent pattern for exploring alternative interfaces |
| Phase 2-3, dependency analysis, testing strategy | deepening-strategies.md |
Dependency categorization, safe deepening patterns, testing strategies |