architecture-auditor · qdhenry — Claude Code subagent: overview and setup
architecture-auditor audits software structure, design patterns, and layer separation. Helps spot circular imports and god objects before major refactoring.
no license ★ 1,357 updated 2026-03-01
.claude/agents/architecture-auditor.mdWhat architecture-auditor 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.
What it helps with
- 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 for the agent
- 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
How to install architecture-auditor
Manually: put the files in place
.claude/agents/architecture-auditor.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/architecture-auditor.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/architecture-auditor.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about architecture-auditor
How do I install architecture-auditor in Claude Code?
Save the agent configuration into .claude/agents/architecture-auditor.md inside your project root.
What does architecture-auditor do?
It inspects codebase organization, evaluates design pattern quality, catches anti-patterns like god objects, and produces a structured review report.
What tools does the architecture-auditor subagent require?
It relies on Bash, Grep, Glob, and Read tools to execute shell searches, walk directory trees, and inspect source files.
Similar subagents
All subagents for Code review and refactoring →architecture-auditor by other authors comes first.