What problem does it solve?
This Skill solves the common pain point of codebases with scattered, shallow modules that duplicate logic, are hard to test, and are difficult for AI tools to navigate, leading to slow development and frequent bugs when making changes.
Core Features & Use Cases
- Shallow Module Detection: Automatically identifies modules where the interface complexity nearly matches the implementation complexity, a key sign of poor depth and duplicated logic.
- Deepening Recommendations: Proposes concrete, domain-aligned refactors to consolidate scattered logic into deep modules with small, high-leverage interfaces, improving testability and maintainability.
- Visual Architecture Reports: Generates self-contained HTML reports with before/after diagrams of proposed changes, respecting your project's existing ADRs and domain language to avoid re-litigating past decisions.
- Use Case: For a codebase with 4 separate small modules each handling a piece of user authentication logic, this skill would identify that these can be deepened into a single AuthValidator module with one interface, eliminating duplication and making tests run against a single test surface.
Quick Start
Use the improve-codebase-architecture skill to scan the current repository and generate an HTML report of architecture deepening opportunities aligned with the project's domain language and existing ADRs.
