improve-codebase-architecture

Identify architectural friction by scanning for tightly coupled modules, pass-through layers, and shallow seams. Use the deletion test and seam classification to pinpoint high-leverage refactoring opportunities that consolidate behavior and improve modularity.

The deletion test evaluates module architecture by assessing whether a module earns its keep. It identifies shallow, pass-through layers lacking leverage, guiding refactoring opportunities that deepen modules and reorient tests around stable interfaces.

Improve codebase testability by reorienting tests around meaningful module boundaries. Analyze seams to consolidate behavior and verify functionality through stable interfaces instead of internal implementation details, reducing scattered complexity.

Make a repository easier for AI agents to navigate by grounding architectural recommendations in existing project context files, glossary terms, and prior decisions. Identify deepening opportunities that reduce friction and improve locality.

Consolidate modules to reduce scattered complexity when seam classification reveals pass-through layers and tightly coupled components lacking leverage. Apply the deletion test to confirm shallow modules do not earn their keep before refactoring.

Use existing project context files to guide architecture reviews by grounding recommendations in glossary terms and established decisions. This localized approach ensures refactoring suggestions align with your repository's current structure and AI-navigability requirements.