Skip to main content
subagent CX Codex

architecture-auditor · gupsammy — Claude Code subagent: setup and use

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

no license ★ 276 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add gupsammy/Claudest
/plugin install claude-coding@Claudest
Open on GitHub

What architecture-auditor 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.

What it helps with

  • 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 for the agent

  • 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

How to install architecture-auditor

1Plugin marketplace

/plugin marketplace add gupsammy/Claudest
/plugin install claude-coding@Claudest

2Manually: 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 to install architecture-auditor in Claude Code?

Add the marketplace source with /plugin marketplace add gupsammy/Claudest, then install it by running /plugin install claude-coding@Claudest.

What is the difference between Advisor and Auditor modes?

Advisor mode provides brief design guidance when planning code changes. Auditor mode inspects files, maps dependencies, and builds a structured issue report categorized by severity.

Does the agent check linter rules or code style?

No, it ignores formatting, naming, and single-file linter warnings. Its checks are strictly confined to module relationships and structural design choices.

Similar subagents

All subagents for Code review and refactoring →

architecture-auditor by other authors comes first.

architecture-auditor qdhenry architecture-auditor audits software structure, design patterns, and layer separation. Helps spot circular imports and god objects before major refactoring. CX Codex ★ 1,357repo 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 set47

The whole set →
clean-branches clean-branches is a Claude Code skill that finds merged and stale git branches, marks protected ones, and asks before deletion. It helps clear accumulated branch clutter. CX Codex +1 ★ 276repo stars council council launches parallel personas to deliberate on technical questions, examine codebase files, and formulate an opinionated verdict. CX Codex +1 ★ 276repo stars claw-advisor claw-advisor is a Claude Code skill for OpenClaw setup, troubleshooting, and architecture questions. It handles requests about channels, gateways, models, and automation. CX Codex +1 ★ 276repo stars update-readme update-readme rewrites an existing README.md using the current code, git log and changelog. Useful once the docs drift away from what the repo actually does. CX Codex +1 ★ 276repo stars make-changelog make-changelog creates or updates CHANGELOG.md from Git history in Keep a Changelog format. Use it when preparing release notes or catching up on missing entries. CX Codex +1 ★ 276repo stars recall-conversations recall-conversations reads back your earlier Claude sessions: finds a decision, restores context, or builds a retro from the local conversation database. CX Codex +1 ★ 276repo stars make-readme make-readme inspects repository context, runs a brief questionnaire, and builds a complete README.md with status badges. CX Codex +1 ★ 276repo stars push-pr push-pr is a Claude Code skill that pushes a branch and creates or updates its GitHub pull request. For large or mixed changes, it can propose splitting them into stacked PRs. CX Codex +1 ★ 276repo stars

Project sponsors

Companies that keep this analytics open