improve-codebase-architecture

Code refactoring opportunities are identified by analyzing your codebase for shallow modules that can be deepened, improving testability and AI-navigability. The analysis uses domain language from CONTEXT.md and architectural decisions from ADRs to suggest structural improvements.

A deep module in codebase architecture is a structural design where a complex interface is simplified to expose minimal functionality while hiding significant implementation. Increasing module depth reduces complexity and enhances overall testability and AI-navigability.

You can visualize architectural changes by generating an HTML report. This report details before and after architecture visualizations, illustrating exactly how refactoring shallow modules into deep ones alters the structural depth of your codebase.

ADRs and CONTEXT.md are utilized to provide context during the codebase analysis. ADRs supply architectural decisions while CONTEXT.md provides the domain language, ensuring the identified refactoring opportunities align with your project's intended design and terminology.

Depth-first refactoring may not suit codebases lacking defined domain language or architectural decision records. Without CONTEXT.md or ADRs to guide the analysis, the tool cannot effectively map shallow modules to deeper structural alternatives.