deepenlisted

# Deepen Surface architectural friction and propose **deepening opportunities** — refactors that turn shallow modules into deep ones. The aim is testability and AI-navigability. > **Prerequisites:** the HTML report renderer runs via `uv` (https://docs.astral.sh/uv/) — `uv run` reads the script's inline PEP 723 header and fetches its deps (network needed on first run). The analysis itself needs no network. Ported from Matt Pocock's `improve-codebase-architecture` skill; the vocabulary and process are his. The localization adds per-language idiom packs and moves the HTML report into a tested Python renderer. ## Glossary Use these terms exactly in every suggestion. Consistent language is the point — don't drift into "component," "service," "API," or "boundary." Full definitions in [LANGUAGE.md](LANGUAGE.md). - **Module** — anything with an interface and an implementation (function, class, package, slice). - **Interface** — everything a caller must know to use the module: types, invariants, error modes, ordering, config. Not just the type signature. - **Implementation** — the code inside. - **Depth** — leverage at the interface: a lot of behaviour behind a small interface. **Deep** = high leverage. **Shallow** = interface nearly as complex as the implementation. - **Seam** — where an interface lives; a place behaviour can be altered without editing in place. (Use this, not "boundary.") - **Adapter** — a concrete thing satisfying an interface at a seam. - **Leverage** — what