subagent

architect-review — Claude Code subagent for architecture reviews

Q: How do I install architect-review in Claude Code?

Run `npx claude-code-templates@latest --agent expert-advisors/architect-review`. The subagent file is at `.claude/agents/architect-review.md`.

This subagent checks code changes against a project’s architecture and established patterns. Use it to review structural pull requests or assess a new service design.

Install into Claude Code · claude-code-templates All methods and platforms ↓

npx claude-code-templates@latest --agent expert-advisors/architect-review

Open on GitHub

What architect-review does

The subagent examines how a change fits the system: it looks at service boundaries, dependency direction, modularity, and consistency with existing patterns. It also checks SOLID principles and considers how design choices could affect maintenance or scaling.

Its review includes an impact assessment, a pattern compliance checklist, specific violations, and recommendations. It considers data flow, security boundaries, and performance implications too. The findings depend on the project context; without a clear picture of existing service boundaries, that part of the review has less to work with.

What it helps with

review architecture changes in a pull request
spot SOLID violations in a new component
assess boundaries and dependencies for a service
check API changes against existing design patterns
find design choices that make maintenance harder

Example prompts for the agent

Review the architecture of these pull request changes and flag SOLID violations.
Assess the boundaries of this new service and its dependencies on other components.
Compare these API changes with the project’s existing patterns and recommend revisions.

How to install architect-review

1claude-code-templates

npx claude-code-templates@latest --agent expert-advisors/architect-review

2Manually: put the files in place

.claude/agents/architect-review.md

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

Manually: put the files in place

.codex/agents/architect-review.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/

Manually: put the files in place

.cursor/agents/architect-review.md

Cursor 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 architect-review

How do I install architect-review in Claude Code?

Run npx claude-code-templates@latest --agent expert-advisors/architect-review. The subagent file is at .claude/agents/architect-review.md.

What does architect-review do?

It reviews code changes for architectural consistency, including patterns, SOLID principles, dependencies, and modularity. Its response includes an impact assessment, findings, and recommendations.

What does the architect-review report contain?

The report assesses architectural impact, checks pattern compliance, describes violations, and recommends changes. It also covers longer-term effects on maintainability and scaling.

Similar subagents

All subagents for Code review and refactoring →

code-reviewer official Anthropic Reviews code changes against CLAUDE.md project rules and flags material defects. Run it before a commit or pull request. 31,050installs code-reviewer official Anthropic This subagent checks code changes for bugs, security issues, and project-rule violations. Use it when a review should focus on findings that matter. 31,050installs security-auditor official Anthropic This subagent searches code for security flaws and gives engineers concrete fixes. Use it to review a project before hardening or modernization work. 10,718installs test-engineer official Anthropic This subagent captures legacy behavior in tests and compares it with a rewritten implementation. Use it before changing existing modules. 9,715installs code-reviewer VoltAgent Community Reviews code changes for bugs, security flaws and maintenance issues. Use it before merging complex work or auditing a project. 31,050installs debugger VoltAgent Community Diagnoses software failures, reads stack traces, and isolates root causes to fix elusive bugs. Helpful when logs alone do not explain a crash. 13,459installs

From the same set238

The whole set →

backend-architect A subagent for backend design work: service boundaries, API paradigm choice, database schemas and observability. Useful when the decision comes before the first line of code. 23,691installs generate-tests Creates a complete test suite for a specified component or file. The command inspects your testing setup and generates assertions following the AAA pattern. 12,378installs ultra-think Runs a structured analysis of a hard problem: surfaces hidden assumptions, proposes competing solutions, stress-tests each one. Useful when a decision is expensive to get wrong. 8,383installs documentation-expert This subagent creates, updates, and maintains project documentation, from README files to API references. Use it when docs need structure or a refresh. 6,992installs task-decomposition-expert Breaks down complex multi-step goals into a structured work breakdown structure with dependency graphs, effort estimates, and handoff plans. 6,870installs create-architecture-documentation A Claude slash command that turns your repo into architecture documentation: diagrams, ADRs and component descriptions. 6,136installs mcp-expert Designs and configures Model Context Protocol servers for Claude Code. It prepares ready-to-use JSON manifests for databases, APIs, and file access. 6,052installs nextjs-architecture-expert A Claude subagent for Next.js architecture: App Router, Server Components, Pages Router migration and performance work. 4,935installs