improve-codebase-architecture

Identify shallow modules by scanning for areas where interface complexity nearly matches implementation complexity. This Skill detects tightly-coupled modules causing architectural friction and surfaces targeted deepening opportunities to improve testability and maintainability across legacy projects of any size.

Module deepening is the process of turning shallow modules into deep, high-leverage ones by consolidating interface and implementation complexity. It improves testability by reducing tight coupling across architectural seams, making codebases easier to test and maintain for both developers and AI navigability.

Yes, architectural refactoring recommendations respect recorded architectural decisions by tracking ADR conflicts. All deepening suggestions use existing domain language from CONTEXT.md to ensure proposed module consolidation aligns with prior architectural choices without introducing conflicting design patterns.

Improve AI navigability by detecting tightly-coupled modules that leak across seams and applying targeted module deepening refactors. This Skill surfaces hidden architectural friction and delivers actionable opportunities to make the codebase more navigable for AI coding assistants and human developers.

Yes, codebase architecture analysis applies to projects of any size. It scans for shallow, tightly-coupled modules and hard-to-test areas regardless of scale, delivering domain-aligned deepening opportunities and interface design exploration tailored to the specific project context.