---
name: architecture
description: Use when the user asks to improve architecture, find refactoring opportunities, surface deepening opportunities, consolidate tightly-coupled modules, or make a codebase more testable and AI-navigable. Surfaces shallow modules and hypothetical seams using a precise vocabulary (Module / Interface / Implementation / Depth / Seam / Adapter / Leverage / Locality from LANGUAGE.md).
license: MIT
metadata:
  model: inherit
  derived-from: mattpocock/skills@90ea8ee
  upstream-url: https://github.com/mattpocock/skills/tree/main/improve-codebase-architecture
---

# architecture

> **Portable mirror — generated, do not edit.** The canonical skill body lives at
> [`skills/architecture/SKILL.md`](../../../skills/architecture/SKILL.md); read that file for the full instructions.
> This mirror carries only agentskills.io-spec-legal frontmatter so harnesses that
> discover skills under `.agents/skills/` can find and route to the skill.
>
> Regenerate with `node scripts/generate-agents-skills.mjs`.