Improve Codebase Architecture

Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick. Use when the user wants architecture improvement candidates surfaced before choosing one. Triggers on: improve the architecture, find deepening opportunities, where should we refactor.

This skill is imported from mattpocock/skills (MIT) and is user-invoked upstream.

When to use this skill

• Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.
• Use when the user wants architecture improvement candidates surfaced before choosing one.
• Triggers on: improve the architecture, find deepening opportunities, where should we refactor.

Instructions

Improve Codebase Architecture

Surface architectural friction and propose deepening opportunities: refactors that turn shallow modules into deep ones. The aim is testability and AI-navigability.

This command is informed by the project's domain model and built on a shared design vocabulary: