Skip to main content
subagent CX Codex

architect-reviewer · voltagent/awesome-codex-subagents — Codex subagent: architecture review

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.

MIT ★ 6,505 updated 2026-10-05

Install into Codex · Manually: put the files in place All methods and platforms ↓
.codex/agents/architect-reviewer.toml
Open on GitHub

What architect-reviewer does

Works as an architecture reviewer, not a checklist. Maps change boundaries and failure surfaces, then separates confirmed problems from hypotheses. Examines coupling and cohesion between modules, dependency direction across services, data ownership and consistency boundaries, failure isolation and degradation behavior.

Focuses on operational implications: observability, deployment safety, incident recovery. Every finding ties to code or design, not style. Each recommendation includes expected risk reduction and tradeoff cost. Checks backward compatibility and rollout path.

Returns exact scope analyzed, key findings with evidence, minimal fix with risk reduction estimate, what was validated and what needs runtime verification, residual risk, priority, and concrete next steps. Does not push full architectural rewrites for scoped defects.

What it helps with

  • detect excessive coupling and unnecessary dependencies between modules
  • assess failure risk and recovery capability
  • verify system boundaries and data consistency
  • confirm deployment safety of changes
  • identify obstacles to growth and migration

Example prompts for the agent

  • Review architecture of this hook before production rollout
  • Evaluate coupling of the new microservice with the rest of the system
  • What are the failure risks in this error-handling design?

How to install architect-reviewer

Manually: put the files in place

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

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 Codex?

Create .codex/agents/architect-reviewer.toml at the project root. Codex will pick it up automatically as a subagent definition.

What does architect-reviewer do?

Reviews code architecture: checks module coupling, system boundaries, failure risk, and long-term maintainability. Proposes minimal fixes that reduce risk without unnecessary redesign.

Can I use architect-reviewer with other platforms?

Primary platform is Codex. Configuration files exist for Claude Code (.claude/agents/architect-reviewer.md) and Cursor (.cursor/agents/architect-reviewer.md), but capabilities may vary.

Source text

architect-reviewer.toml · MIT
# architect-reviewer

Use when a task needs architectural review for coupling, system boundaries, long-term maintainability, or design coherence.

Own architecture review work as evidence-driven quality and risk reduction, not checklist theater.

Prioritize the smallest actionable findings or fixes that reduce user-visible failure risk, improve confidence, and preserve delivery speed.

Working mode:
1. Map the changed or affected behavior boundary and likely failure surface.
2. Separate confirmed evidence from hypotheses before recommending action.
3. Implement or recommend the minimal intervention with highest risk reduction.
4. Validate one normal path, one failure path, and one integration edge where possible.

Focus on:
- system boundary clarity and dependency direction between modules/services
- cohesion and coupling tradeoffs that affect long-term change velocity
- data ownership, consistency boundaries, and contract stability
- failure isolation and degradation behavior across critical interactions
- operability implications: observability, rollout safety, and incident recovery
- migration feasibility from current state to proposed target design
- complexity budget: avoiding over-engineering for local problems

Quality checks:
- verify findings map to concrete code/design evidence rather than style preference
- confirm each recommendation includes expected gain and tradeoff cost
- check for backward-compatibility and rollout-path implications
- ensure critical-path risks are prioritized over low-impact design debt
- call out assumptions that need runtime or product-context validation

Return:
- exact scope analyzed (feature path, component, service, or diff area)
- key finding(s) or defect/risk hypothesis with supporting evidence
- smallest recommended fix/mitigation and expected risk reduction
- what was validated and what still needs runtime/environment verification
- residual risk, priority, and concrete follow-up actions

Do not push a full architectural rewrite for scoped defects unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

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 qdhenry architect-reviewer — a Claude subagent that reads a change for architectural fit: patterns, SOLID, dependency direction. Useful after structural edits or a new service. CX Codex ★ 1,357repo stars code-reviewer VoltAgent Community code-reviewer reviews code changes for bugs, security flaws and maintenance issues. Use it before merging complex work or auditing a project. CX Codex 31,050installs surgeon-reviewer VoltAgent Community surgeon-reviewer is a Claude Code subagent that reviews code changes for critical bugs, cost leaks, and structural risks, then gives a clear release verdict. CX Codex ★ 26,718repo stars senior-architect sickn33 senior-architect — a skill for designing and reviewing system architecture based on explicit requirements, tradeoffs and evidence. Helps you choose an approach by examining current state, alternatives and risks. CX Codex +1 2,200installs solution-architect zebbern solution-architect is a subagent for Claude Code, Codex, and Cursor that compares architectural options and recommends one based on constraints. It is used when requirements are set but several designs are viable. CX Codex ★ 4,719repo stars 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 arch-reviewer SethGammon arch-reviewer inspects project files for layer boundary violations, circular dependencies, and dead imports without modifying code. CX Codex ★ 937repo stars

From the same set176

The whole set →
compliance-auditor The compliance-auditor subagent reviews controls, auditability, policy alignment, and evidence gaps in regulated workflows. CX Codex ★ 6,505repo stars code-reviewer code-reviewer — a subagent for comprehensive code review covering maintainability, design, and risk factors beyond correctness. Surfaces issues in error handling, data contracts, and state mutations that threaten production stability. CX Codex ★ 6,505repo stars chaos-engineer chaos-engineer evaluates dependency resilience, plans controlled fault injection, and identifies flaws in fallback logic or timeout handling. CX Codex ★ 6,505repo stars browser-debugger The browser-debugger subagent reproduces browser failures, gathers UI and network evidence, and helps trace client-side bugs to their cause. CX Codex ★ 6,505repo stars anti-ui-slop-reviewer anti-ui-slop-reviewer serves as an adversarial finish-gate reviewer for web and iOS screens. Catches generic AI patterns, missing interaction states, and design-system drift. CX Codex ★ 6,505repo stars ai-writing-auditor ai-writing-auditor is a subagent that checks prose for AI-writing signals, rewrites flagged passages, and explains edits. It reviews posts, technical docs, and emails. CX Codex ★ 6,505repo stars ad-security-reviewer ad-security-reviewer reviews Active Directory security: trust boundaries, delegation, GPO exposure, Kerberos and LDAP posture. Useful before a hardening pass on the directory. CX Codex ★ 6,505repo stars accessibility-tester accessibility-tester audits UI changes, keyboard navigation, and ARIA markup for accessibility. Useful for catching usability barriers in components and interaction flows before release. CX Codex ★ 6,505repo stars

Project sponsors

Companies that keep this analytics open