architect-reviewer

architect-reviewer is an agent for Claude Code from tzachbon/smart-ralph. It costs 49 tokens per session (1,997 once invoked), scanned A, original, MIT.

A software architecture reviewer that creates technical designs and defines how system parts should be organized.

In plain words
What is it for?
Use it to design systems, plan components, assess technical feasibility, analyze trade-offs, and create a design document.
Why use it?
It helps clarify component boundaries, technical choices, and trade-offs before code is written.

Agent for Claude Code

Written for Claude Code: ${CLAUDE_PLUGIN_ROOT} variable. Also seen: mentions subagents.

Runs only inside its plugin — its command needs a path that Claude Code sets for a plugin’s own hooks and for nothing else. Install the plugin, not this.

Part of the ralph-specum plugin — 3 skills, 11 commands, 7 agents shipped together

Good fit Use it to design systems, plan components, assess technical feasibility, analyze trade-offs, and create a design document.

Compare 6 agents from other repositories ↓
Install

Getting it into your agent

This one installs as part of its plugin. Adding the marketplace and installing the plugin brings it with everything else the plugin ships.

Claude Code
/plugin marketplace add tzachbon/smart-ralph
Claude Code
/plugin install ralph-specum

Made for: Claude Code.

Or install ralph-specum, the plugin that ships this one along with the rest of its 3 skills, 11 commands, 7 agents.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for architect-reviewer

README.md
[![agentmods](https://agentmods.dev/badge/agents/tzachbon/smart-ralph/architect-reviewer.svg)](https://agentmods.dev/agents/tzachbon/smart-ralph/architect-reviewer)
Your own site
<a href="https://agentmods.dev/agents/tzachbon/smart-ralph/architect-reviewer"><img src="https://agentmods.dev/badge/agents/tzachbon/smart-ralph/architect-reviewer.svg" alt="Measured on agentmods" height="20"></a>
Per session 49 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,997 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00049 $0.01997
Opus 5 $0.00024 $0.00999
Sonnet 5 $0.00010 $0.00399
Haiku 4.5 $0.00005 $0.00200

Measured 8d ago against content hash 260f29d1a8a3, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade A, and why

architect-reviewer scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/ralph-specum/agents/architect-reviewer.md · 302 lines

How it starts

The opening of the file, as written. The whole thing — 302 lines — stays where its author put it; the contents beside it link to each section on GitHub.

You are a senior systems architect with expertise in designing scalable, maintainable systems. Your focus is architecture decisions, component boundaries, patterns, and technical feasibility.

When Invoked

You receive via Task delegation:

  • basePath: Full path to spec directory (e.g., ./specs/my-feature or ./packages/api/specs/auth)
  • specName: Spec name
  • Context from coordinator
  • artifactAgentId: Unique Task or teammate dispatch name for gate receipts

Use basePath for ALL file operations. Never hardcode ./specs/ paths.

Phase Gate and Skill Reload

The Task prompt must include a [RALPH_PHASE_GATE] marker and the complete selected-skill manifest. Before the first artifact or .progress.md write:

  1. Read every body and required resource whose parent manifest receipt is loaded. Preserve and report exact domain warnings; do not retry sources whose parent receipt failed. Do not execute prescribed task actions during preload.
  2. Verify each successfully loaded file's current SHA-256 against the manifest.
  3. Record one phase_gate.py record-agent-load receipt per body and resource with agent artifactAgentId.
  4. Call phase_gate.py check-agent-write with the marker state, phase, interview ID, discovery revision, context digest, and agent artifactAgentId.
  5. Stop without writing when any load, hash, receipt, or gate check fails.

Follow the approved interview brief. Return new material conflicts to the coordinator for another grill and approval round.

  1. Read and understand the requirements
  2. Analyze the existing codebase for patterns and conventions
  3. Design architecture that satisfies requirements
  4. Document technical decisions and trade-offs
  5. Define interfaces and data flow
  6. Append learnings to .progress.md

Use Explore for Codebase Analysis

When to spawn Explore:

  • Discovering existing architectural patterns
  • Finding component boundaries and interfaces
  • Analyzing dependencies between modules
  • Understanding data flow in existing code
  • Finding conventions for error handling, testing, etc.

Read the full file on GitHub · 302 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 302 lines · 49 tokens per session scan A 260f29d1a8a3

Subscribe to this mod's changes

architect-reviewer is an agent published in the GitHub repository tzachbon/smart-ralph (535 stars, last pushed 5d ago), licensed MIT. It adds 49 tokens to every session and 1,997 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other agents, from other repositories

check

Code quality auditor for the Trellis channel runtime. Reviews uncommitted diffs against task artifacts and specs, self-fixes issues, and reports verification results.

mindfold-ai/Trellis · 34 tokens

integrations-engineer

Third-party integration specialist for SMB Product-Builder archetypes. Owns the integration contract — OAuth2/API-key flows, webhook signature verification, idempotency keys, retry/backoff with jitter, rate-limit handling, secret storage, and sandbox→prod promotion — for Stripe, Twilio, QuickBooks, Google/Microsoft…

avelikiy/great_cto · 106 tokens

config-safety-reviewer

Configuration safety specialist focusing on production reliability, magic numbers, pool sizes, timeouts, and connection limits. Use proactively for configuration changes and production safety reviews.

alirezarezvani/claude-code-tresor · 37 tokens

loom-senior-software-engineer

Use PROACTIVELY for architecture design, complex debugging, design patterns, code review, test strategy, data modeling, ML system design, UX strategy, documentation architecture, and strategic technical decisions across all domains.

cosmix/loom · 51 tokens

discovery-threat-reviewer

Discovery-time threat-modeling + regulated-domain compliance ONLY — a forked-context, read-only reviewer for discovery artifacts (the intent tree, domain framing, journey map, service blueprint, screen flows, architecture, decision brief). Required at the discovery loop's G2 reconcile. A DISTINCT agent from…

eugenelim/agent-ready-repo · 142 tokens

loom-advisor

Read-only advisory agent for debugging and repeated failures. Spawned instead of a blind retry when an implementer has failed twice on the same task, or a bug resists straightforward diagnosis. Returns a root-cause diagnosis plus one concrete next step.

cosmix/loom · 53 tokens