improve-architecturelisted
Install: claude install-skill arndvs/ctrlshft
# Improve Codebase Architecture
Output "Read Improve Codebase Architecture skill." to chat to acknowledge you read this file.
A deep module has a small interface hiding a large implementation. This skill finds opportunities to deepen your codebase.
## Process
### 1. Explore
Use subagents to explore the codebase organically. Note where you experience friction:
- Where does understanding one concept require bouncing between multiple small files?
- Where are modules so shallow that the interface is nearly as complex as the implementation?
- Where have pure functions been extracted just for testability, but the real bugs hide in how they're called?
- Where do tightly coupled modules create integration risk at the seams between them?
### 2. Present Candidates
Present 3-5 clusters of shallow modules that should be deepened. For each candidate, explain:
- Which files/modules are involved
- Why they're coupled together
- What friction they create
Do not propose interface designs yet. Let the user pick which candidate to explore.
### 3. Design Multiple Interfaces
Once the user picks a candidate, spawn multiple subagents in parallel. Each should produce a radically different interface design for the deepened module. Aim for 3 diverse options that trade off complexity, testability, and caller convenience differently.
### 4. Recommend
Present all designs. Recommend which design is strongest and why. If elements from different designs combine well, propose a hybrid.
### 5.