improve-codebase-architecture

Identify deepening opportunities by analyzing module interfaces and dependency categories where understanding repeatedly leaks across weak seams. This surfaces friction in shallow modules, guiding refactors that concentrate complexity and increase architectural leverage.

Diagnose weak seams and poor interface locality by analyzing dependency categories and module interfaces using the seam-and-adapter vocabulary. This highlights areas where testing cannot reliably target behavior and understanding leaks across boundaries.

Improve codebase architecture for AI-navigability and testability by guiding refactors toward depth using the interface as the test surface and applying the deletion test. This prioritizes high-leverage changes that concentrate complexity and increase leverage.

Prioritize refactoring candidates during architecture reviews by applying the deletion test to high-leverage changes and using a grilling loop. This crystallizes constraints, dependencies, seams, adapters, and test strategy to produce prioritized candidates with clear problem, solution, and benefits.

Use the seam and adapter vocabulary to diagnose dependency issues by analyzing where understanding repeatedly leaks across seams and where testing cannot reliably target behavior. This supports informed follow-ups and optionally explores alternative interface designs.