# architect-reviewer

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

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 1357 repo stars
- Author: qdhenry
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/agents/quality-testing/architect-review.md
- Updated: 2026-03-01
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/qdhenry-architect-reviewer

## What it 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`.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/architect-review.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.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/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/architect-review.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/agents/quality-testing/architect-review.md

## When to use it
- 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
- 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

## Similar
- [code-reviewer](https://affpapa.org/en/nevibecode/agents/coco-research-code-reviewer.md) — subagent · ★ 328 repo stars
- [ns-reviewer](https://affpapa.org/en/nevibecode/skills/ns-reviewer.md) — skill · 140 installs
- [plan-reviewer](https://affpapa.org/en/nevibecode/agents/plan-reviewer.md) — subagent · ★ 10055 repo stars
- [design-patterns-implementation](https://affpapa.org/en/nevibecode/skills/design-patterns-implementation.md) — skill · 601 installs
- [solid](https://affpapa.org/en/nevibecode/skills/solid.md) — skill · 3700 installs

## Other versions with the same name
- [architect-reviewer · voltagent](https://affpapa.org/en/nevibecode/agents/architect-reviewer.md) — 743 installs
- [architect-reviewer · voltagent](https://affpapa.org/en/nevibecode/agents/voltagent-architect-reviewer.md) — ★ 6505 repo stars

From the same set: [qdhenry/claude-command-suite](https://affpapa.org/en/nevibecode/by/qdhenry/claude-command-suite.md) — 112 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
