What problem does it solve?
This skill eliminates the guesswork of improving codebase architecture by automatically identifying shallow modules, cross-seam leakage, and other friction points that reduce testability, maintainability, and AI navigability of software projects.
Core Features & Use Cases
- Architectural Friction Scanning: Organically explores codebases to flag shallow modules, untested hard-to-test components, and tightly coupled code that leaks across seams.
- Visual HTML Report Generation: Creates a self-contained, styled HTML report with before/after diagrams of proposed deepening refactors, including Mermaid flowcharts, mass diagrams, and cross-sections to illustrate changes clearly.
- Guided Refinement Loop: Walks users through a structured grilling process to refine their chosen refactor, integrates with domain modeling to update project context, and respects existing ADRs to avoid re-litigating settled decisions.
- Use Case: A software team struggling with a hard-to-test order processing module can use this skill to get a prioritized list of refactors, visual explanations of each change, and guided support to implement the highest-impact improvement.
Quick Start
Use the improve-codebase-architecture skill to scan your current project's codebase and generate a visual report of prioritized architecture improvement opportunities.