# architecture-auditor

architecture-auditor audits software structure, design patterns, and layer separation. Helps spot circular imports and god objects before major refactoring.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 1357 repo stars
- Author: qdhenry
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/agents/architecture-auditor.md
- Updated: 2026-03-01
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/architecture-auditor

## What it does

The subagent analyzes project structure using file system inspection and pattern matching. It traverses directory layouts, traces imports across files, and flags oversized components handling too many responsibilities.

The review checks SOLID principles, boundary isolation between domain logic and persistence, and decoupling strategies. It flags architectural debt. Results arrive as a scored audit summary covering violation details and actionable refactoring steps.

Execution depends on `Bash`, `Grep`, `Glob`, and `Read` permissions. Without terminal access, the agent cannot map module dependencies accurately.

## Install

### Claude Code (native platform)

**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/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/agents/architecture-auditor.md

## When to use it
- detect circular dependencies across project modules
- locate god classes and oversized files prior to refactoring
- verify layer isolation between domain logic and persistence
- outline actionable steps to cut technical debt

## Example prompts
- Run an architecture audit on this repository and highlight high-coupling areas
- Check our service folder structure before we implement the new billing module
- Inspect project imports for circular dependencies and propose an interface fix

## 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 · gupsammy](https://affpapa.org/en/nevibecode/agents/samarth-gupta-architecture-auditor.md) — ★ 276 repo stars

From the same set: [qdhenry/claude-command-suite](https://affpapa.org/en/nevibecode/by/qdhenry/claude-command-suite.md) — 112 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
