Skip to main content
subagent CX Codex

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

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/architecture-auditor.md
Open on GitHub

What 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.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

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.

architecture-auditor Samarth Gupta architecture-auditor reviews system structure, detects circular dependencies, and suggests design patterns when features touch multiple modules. CX Codex ★ 276repo stars architecture-review davila7 architecture-review — a Claude Code command that walks through project structure and returns concrete improvement recommendations. Run it when the codebase has grown past the point where you can hold it in your head. CX Codex +1 3,419installs clean-architecture pproenca clean-architecture — a skill with 42 rules from Robert C. Martin's book: it tells the agent which way dependencies should point and where layer boundaries belong. CX Codex +1 2,100installs architecture-survey Yeachan-Heo architecture-survey inspects your module graph to spot shallow boundaries, false seams, and misplaced logic. Useful when changes start rippling across too many files at once. CX Codex +1 201installs architecture-critic official Anthropic architecture-critic — a subagent that audits architectural designs and modernized code with a skeptical lens. Spots over-engineering, unstated latency risks, and redundant service boundaries. CX Codex ★ 47,914repo stars guarding-architecture riekelt guarding-architecture enforces system boundaries by turning structural invariants into breaking build tests. Useful when code crosses module limits or adds unwanted cross-package imports. CX Codex +1 25,600installs architecture-compass stark-ai-de architecture-compass is a Claude Code and Codex skill that manages architecture decisions and checks code against them. It audits repositories, governs ADRs, and guides scoped refactors. CX Codex +1 2,700installs

From the same set112

The whole set →
mobile-developer mobile-developer — a Claude subagent for React Native and Flutter apps. It designs the architecture, hooks up native modules and handles offline sync, push and store releases. CX Codex ★ 1,357repo stars security-auditor security-auditor is a Claude Code subagent that finds application vulnerabilities and reviews security controls. It can assess source code, authentication flows, or a running application. CX Codex ★ 1,357repo stars migration-assistant migration-assistant — a Claude Code command that migrates issues, PRs and projects between GitHub and Linear. Works via GitHub CLI and Linear MCP server, preserves relationships and creates rollback points. CX Codex +1 ★ 1,357repo stars deployment-engineer deployment-engineer — a Claude subagent that drafts CI/CD pipelines, container builds and cloud infrastructure, then hands over a deployment runbook. CX Codex ★ 1,357repo stars prompt-engineer The prompt-engineer subagent for Claude Code designs prompts, agent workflows, and structured outputs. It helps clarify instructions and safety constraints. CX Codex ★ 1,357repo stars quickstart quickstart is a command that guides a first run of the skill builder, from task questions to a validated skill with examples. CX Codex +1 ★ 1,357repo stars issue-to-linear-task issue-to-linear-task exports individual GitHub issues into Linear tasks while keeping descriptions, comment threads, milestones, and assignees intact. CX Codex +1 ★ 1,357repo stars ml-engineer The ml-engineer subagent designs and runs the full ML model lifecycle, from data pipelines to deployment and monitoring. Use it for production MLOps work. CX Codex ★ 1,357repo stars

Project sponsors

Companies that keep this analytics open