# architecture-auditor

architecture-auditor reviews system structure, detects circular dependencies, and suggests design patterns when features touch multiple modules.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 276 repo stars
- Author: Samarth Gupta
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/gupsammy/Claudest/tree/HEAD/plugins/claude-coding/agents/architecture-auditor.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/samarth-gupta-architecture-auditor

## What it does

The subagent runs in two distinct roles. As an advisor, it answers mid-implementation questions about patterns and trade-offs, grounding suggestions in the current codebase layout. As an auditor, it inspects directory structures, checks layer separation, and pinpoints issues down to the file and line number.

Inspection relies on `Read`, `Grep`, `Glob`, and read-only `Bash` calls like `tree`, `find -type f`, or `wc -l`. Mutating operations stay off limits: the agent never commits changes, deletes files, or runs test suites.

Styling details, naming nitpicks, and single-file formatting are intentionally ignored. The subagent focuses entirely on cross-module boundaries, God modules, and structural coupling.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add gupsammy/Claudest
```
In the agent chat (not a shell):
```text
/plugin install claude-coding@Claudest
```

2. **Manually: put the files in place**
- File: `.claude/agents/architecture-auditor.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/architecture-auditor.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/architecture-auditor.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/gupsammy/Claudest/tree/HEAD/plugins/claude-coding/agents/architecture-auditor.md

## When to use it
- detect circular dependencies and leaky abstractions across packages
- evaluate architectural trade-offs before introducing a new pattern
- audit layer boundaries after refactoring shared code
- spot oversized modules that break single-responsibility boundaries

## Example prompts
- Which pattern should I use to decouple our payment provider from billing?
- Audit the architecture of the recent changes across our core services
- Check whether these new modules introduce circular imports

## Similar
- [architecture-review](https://affpapa.org/en/nevibecode/commands/architecture-review.md) — command · 3419 installs
- [clean-architecture](https://affpapa.org/en/nevibecode/skills/pproenca-clean-architecture.md) — skill · 2100 installs
- [architecture-survey](https://affpapa.org/en/nevibecode/skills/architecture-survey.md) — skill · 201 installs
- [architecture-critic](https://affpapa.org/en/nevibecode/agents/architecture-critic.md) — subagent · ★ 47914 repo stars
- [guarding-architecture](https://affpapa.org/en/nevibecode/skills/guarding-architecture.md) — skill · 25600 installs
- [architecture-compass](https://affpapa.org/en/nevibecode/skills/architecture-compass.md) — skill · 2700 installs

## Other versions with the same name
- [architecture-auditor · qdhenry](https://affpapa.org/en/nevibecode/agents/architecture-auditor.md) — ★ 1357 repo stars

From the same set: [gupsammy/claudest](https://affpapa.org/en/nevibecode/by/gupsammy/claudest.md) — 47 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
