Improve Codebase Architecture

SKILL.md preview

# Improve Codebase Architecture

This is a Critique Marketplace source link for a public agent skill. It does not vendor the upstream SKILL.md; use the links below to inspect and install the maintained source.

## Upstream links

- Source: https://github.com/mattpocock/skills
- skills.sh listing: https://www.skills.sh/mattpocock/skills/improve-codebase-architecture
- Upstream install: `npx skills add mattpocock/skills`

## Use this when

- A PR exposes duplicated concepts, unclear module ownership, or missing domain boundaries.
- You want architectural feedback before a refactor becomes a broad rewrite.

## Review before installing

- Require findings to cite concrete files and explain why the abstraction fits the existing codebase.
- Avoid applying architecture advice mechanically to small tactical fixes.

## Critique usage

When this skill shapes a PR review, cite the exact upstream version or commit you inspected. Treat source-linked skills as discovery entries until your team has reviewed the upstream SKILL.md and any scripts it brings with it.