Skip to main content
subagent CX Codex

architect-reviewer · qdhenry — Claude Code subagent: what it does

architect-reviewer — a Claude subagent that reads a change for architectural fit: patterns, SOLID, dependency direction. Useful after structural edits or a new service.

no license ★ 1,357 updated 2026-03-01

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

What architect-reviewer does

This subagent reviews a diff the way an architect would: where service boundaries sit, which way dependencies point, whether the change follows patterns the repo already uses. Handy after a module moves, a new service appears, or an API contract shifts and the layering has drifted.

It carries a role definition, a set of design principles (SOLID, DDD, coupling analysis) and a five-step routine: work out why the change exists, find the boundaries it crosses, compare against existing conventions, judge the effect on modularity, then write recommendations. Output has a fixed shape: an impact rating of High, Medium or Low, a compliance checklist, violations tied to file locations and principles, refactoring suggestions.

Tool access is reading and search only: Read, Grep, Glob, LS, plus WebFetch, WebSearch and Task. There are no edit tools, so the agent reports rather than patches. Some entries belong to the sequential-thinking and context7 MCP servers, and those calls need the servers connected in the project first. The model field is set to haiku.

What it helps with

  • check that a new service keeps layer boundaries intact
  • spot circular references between modules after a merge
  • catch SOLID violations in a pending pull request
  • work out what an API contract change costs neighbouring components
  • map component coupling after a large refactor

Example prompts for the agent

  • Run architect-reviewer over the latest commit and check service boundaries and dependency direction
  • Review the billing module for SOLID violations and circular imports, and point to the exact lines
  • Do an architecture pass on this branch before I merge it

How to install architect-reviewer

Manually: 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

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about architect-reviewer

How do I install architect-reviewer in Claude Code?

Put the agent file at .claude/agents/architect-review.md inside your project. It holds the role, the tool list and the haiku model setting.

What does architect-reviewer do?

It reads a change against the architectural patterns and SOLID principles already in the codebase, looks for circular dependencies, and estimates the effect on modularity. The result is a structured review with impact rating and refactoring steps.

Does it fix the code it reviews?

No. Its tool list has no editing entries, so it describes the problem and suggests a fix while you make the change.

Similar subagents

All subagents for Code review and refactoring →

architect-reviewer by other authors comes first.

architect-reviewer VoltAgent Community architect-reviewer evaluates system design decisions, architecture patterns, and tech stack choices at a macro level. Useful before large-scale refactoring or when designing new service boundaries. CX Codex 743installs architect-reviewer VoltAgent architect-reviewer — a subagent for architecture review: module coupling, system boundaries, failure risk, long-term maintainability. Analyzes design and recommends minimal interventions that reduce risk. CX Codex ★ 6,505repo stars code-reviewer coco-research code-reviewer — a subagent for code, architecture and security review. Checks SOLID, DDD, vulnerabilities, API design and performance before merging PRs. CX Codex ★ 328repo stars ns-reviewer nextstage-brasil ns-reviewer grades code changes against SOLID principles, clean code patterns, performance, security, and testability. Approves only at score 10; score 9 triggers rejection. CX Codex +1 140installs plan-reviewer diet103 plan-reviewer reviews technical plans, migrations, and system integrations before writing code. Catches architectural traps, missing dependencies, and edge cases early. CX Codex ★ 10,055repo stars design-patterns-implementation aj-geddes design-patterns-implementation — a skill for Claude Code and Codex that picks and applies design patterns to architectural problems. It kicks in during refactoring, architecture review, and when building extensible systems. CX Codex +1 601installs solid ramziddin Enforces TDD workflows, SOLID design, and strict clean code constraints across coding tasks. Useful when designing architecture or refactoring messy codebases. CX Codex +1 3,700installs

From the same set112

The whole set →
clean-branches clean-branches — a command that systematically removes merged and inactive branches from Git. Keeps your repository clean by deleting obsolete branches and syncing local state with the remote. CX Codex +1 ★ 1,357repo stars performance-engineer performance-engineer is a Claude Code subagent for finding performance bottlenecks and planning optimization work. It joins tasks involving scalability, profiling, or load testing. CX Codex ★ 1,357repo stars semantic-architect semantic-architect is a Claude Code subagent that organizes dialogue context into tree structures and preserves persistent memory across sessions. CX Codex ★ 1,357repo stars golang-pro golang-pro — a Go-focused subagent for architecture, implementation, refactoring, concurrency, APIs, testing, and performance work in Claude Code. CX Codex ★ 1,357repo stars orchestration-readme orchestration-readme breaks large features into structured task files, tracks active stages, and aligns code changes with Git commits inside Claude Code. CX Codex +1 ★ 1,357repo stars data-engineer The data-engineer subagent designs data pipelines, warehouses, and streaming systems. Use it for ETL/ELT work, Spark jobs, Airflow flows, or Kafka architectures. CX Codex ★ 1,357repo stars database-optimizer database-optimizer — a subagent for database performance analysis: finds bottlenecks in SQL queries, indexing, schema design and infrastructure. CX Codex ★ 1,357repo stars ui-designer ui-designer — a Claude Code subagent for building interface mockups, design systems, and accessible layouts using magic and context7 MCP servers. CX Codex ★ 1,357repo stars

Project sponsors

Companies that keep this analytics open