Skip to main content
subagent CX Codex

architecture-reviewer — Claude Code subagent: review system designs

The architecture-reviewer subagent for Claude Code independently checks architectural documents against repository code. It verifies declared structures, not runtime behavior.

Elastic-2.0 ★ 155 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add serpro69/claude-toolbox
/plugin install kk@claude-toolbox
Open on GitHub

What architecture-reviewer does

The subagent executes in structural isolation from the design authoring session. It has zero access to conversational history, discarded drafts, or file-writing tools, which eliminates confirmation bias. Operations are strictly limited to file reading, search via Grep and Glob, and knowledge retrieval through capy_search.

Execution follows three rigid stages. First, the reviewer parses the text in a repo-blind extraction pass to list every explicit claim. Next, it verifies the existence and topological layout of declared entities in the codebase, such as a database column or a specific endpoint. It explicitly leaves behavioral validity under retries or edge cases to code-review tools.

Without a valid absolute plugin path in its prompt, execution halts immediately because the agent lacks shell execution and cannot expand environment variables. Security boundaries, permission modeling, and data classification are routed out to dedicated security tools rather than handled directly.

What it helps with

  • verify ADR assertions against declared repository layout
  • evaluate reversibility and reasoning soundness in design docs
  • detect missing infrastructure mechanisms referenced in specifications
  • audit composite domain glossary and constraint kits

Example prompts for the agent

  • Run an architecture review on docs/adr/0004-idempotency.md
  • Validate the architecture section of docs/design/billing-v2.md against codebase
  • Audit domain reference files in docs/domain/ for missing links

How to install architecture-reviewer

1Plugin marketplace

/plugin marketplace add serpro69/claude-toolbox
/plugin install kk@claude-toolbox

2Manually: put the files in place

.claude/agents/architecture-reviewer.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-reviewer

How to install architecture-reviewer in Claude Code?

Run /plugin marketplace add serpro69/claude-toolbox in Claude Code, then execute /plugin install kk@claude-toolbox.

What scope does architecture-reviewer cover?

It confirms that declared architectural building blocks actually exist in the code structure and evaluates decision soundness. It deliberately avoids testing behavioral or runtime execution correctness.

Does this subagent handle threat modeling?

No, trust boundaries and authentication structures are delegated out to dedicated audit tooling rather than analyzed in the review report.

Similar subagents

All subagents for Code review and refactoring →

From the same set30

The whole set →
profile-resolver profile-resolver — a subagent that reads a diff and the worktree, works out which project profiles are active, and reports which checklists load. Handy when detection has to run apart from the review. CX Codex ★ 155repo stars brainstorm brainstorm guides technical ideation and architecture debates by asking focused questions one at a time before any code gets written. CX Codex +1 ★ 155repo stars design design is a Claude Code skill that turns requirements into design documents and task plans before coding begins. It can also resume a feature in docs/feat/wip/. CX Codex +1 ★ 155repo stars model model reads one bounded context and leaves a glossary, a traps page, and a queue of questions that need a human answer. CX Codex +1 ★ 155repo stars chain-of-verification chain-of-verification is a Claude Code skill that checks answers through independent questions and follow-up verification. It runs for fact-checking, technical claims, and multi-step reasoning. CX Codex +1 ★ 155repo stars review-architecture review-architecture is a Claude Code skill that checks a written architecture artifact against the system it describes. CX Codex +1 ★ 155repo stars review-code review-code reviews active git changes through an experienced engineering perspective. Identifies SOLID flaws, architecture issues, and security vulnerabilities. CX Codex +1 ★ 155repo stars review-design review-design is a Claude Code skill that checks design documents before implementation begins. It runs after $kk:design and reviews all documents by default. CX Codex +1 ★ 155repo stars

Project sponsors

Companies that keep this analytics open