git:20260906.9b0a555 to git:20260919.176b605

3 added, 1 removed. Audit A to A.

---

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

+ > **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.