architecture git:20260919.176b605A

Immutable. This exact content never changes and is served at /api/v1/blob/06a3065668f7e9e0.

---
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 workflow 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`.

Read the linked document in full and follow its complete workflow, including prechecks and stop conditions. Resolve its link relative to this SKILL.md, not the project working directory. The plugin root is three directories above this file. Resolve package paths such as `skills/` and `scripts/` from that root and relative links in the canonical document from its own directory. Keep the user’s project as the target of project operations.