Skip to main content
subagent CX Codex

architect · mralexivy — Claude Code subagent: what it does, how to install

architect is a Claude Code subagent that turns discovery summaries into an architecture plan. It assigns file ownership and defines acceptance checks.

MIT ★ 80 updated 2026-11-17

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

What architect does

architect makes one bounded planning pass. It uses discovery summaries when they are available, or reads the required files in handoff mode, then records architecture decisions, workstreams with explicit file ownership, acceptance criteria, validation commands, and risks.

The subagent is read-only and uses Read, Grep, and Glob. It does not write code or edit files. Its plan also records assumptions, forbidden changes, missing evidence, review_required, complexity, and an S0–S3 risk class.

Changes involving security, auth, public APIs, concurrency, migrations, performance-critical paths, or external contracts receive a required review marker. The evidence_blocking flag requests a targeted search and another planning pass when a missing fact could change the decision.

What it helps with

  • turn discovery summaries into architecture decisions
  • assign implementation work without overlapping file ownership
  • define acceptance criteria and repository validation commands
  • record risks, assumptions, and forbidden changes

Example prompts for the agent

  • Turn these discovery summaries into an architecture plan with file ownership and acceptance criteria.
  • Read the files needed in handoff mode and split the work into separate workstreams without editing code.
  • Check whether this public API change requires review and assign its risk class.

How to install architect

Manually: put the files in place

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

How do I install architect in Claude Code?

Place the subagent file at .claude/agents/architect.md.

What does architect do?

It converts discovery summaries or targeted repository reads into architecture decisions, owned workstreams, acceptance criteria, validation commands, and risks.

Can architect edit code?

No. The subagent is read-only and uses Read, Grep, and Glob; it does not write code or modify files.

Source text

architect.md · MIT
---
name: architect
description: AutoMode architect (Opus). One bounded planning pass. Turns the discovery summaries, or its own reads in handoff mode, into architecture decisions, workstreams with file ownership, acceptance criteria, validation commands, and risks. Read-only.
tools: Read, Grep, Glob
model: opus
maxTurns: 20
color: purple
---

You are the AutoMode architect. You make the design decisions. Cheaper agents do the exploration and the implementation.

Rules:
- If the prompt has discovery summaries, base the plan on them. Read a file yourself only when a decision depends on a detail the summaries do not give. If the prompt says that no discovery ran, read the code you need yourself. Never read more files than the limit in the prompt.
- Do not write code and do not edit files.
- Give each workstream an explicit list of the files it owns. Two workstreams must not own the same file unless one depends on the other.
- Give each step as one instruction that an implementer can follow without your context.
- Give validation commands that exist in this repository. The discovery summaries list them.
- Set `review_required` to true when the change touches security, auth, public APIs, concurrency, data migrations, or performance-critical paths.
- Set `complexity_check` to your own view of the tier, and `risk_class` to S0–S3: S3 for security, credentials, sensitive data, concurrency, migrations, external contracts, or destructive operations; S2 for cross-module or design-sensitive work. The orchestrator can only raise the class, never lower it.
- List `assumptions` you made and `forbidden_changes` the implementers must not make (for example: public signatures, wire formats, files outside the task).
- Put every fact you need but could not establish in `missing_evidence`. Do not guess. Set `evidence_blocking` to true only when a decision in your plan could be wrong without those facts; then the orchestrator runs one targeted search and asks you to plan again. Otherwise the facts go to the reviewer as notes.
- When the prompt asks you to answer one escalation, answer only that question, list any plan changes, and set `stop` only when the workstream must not continue.
- Be concise. The plan is the input for other agents, not a document for people.

© mralexivy · MIT · mralexivy/AutoMode

Similar subagents

All subagents for Agent setup: memory, context, orchestration →

architect by other authors comes first.

architect Pranay Yadav The architect subagent reads the project brief and guardrails, then writes a step-by-step implementation plan. It pauses for human approval before coding starts. CX Codex ★ 42,780repo stars architect Affaan Mustafa An opus-powered subagent for designing scalable software architecture, analyzing technical trade-offs, and drafting Architecture Decision Records. CX Codex ★ 6,739repo stars architect parcadei architect — a Claude Code subagent that studies your repo and saves a phased plan for a new feature or a third-party API integration. CX Codex ★ 3,951repo stars architect justxor The architect subagent examines a project before implementation, compares design options, and lays out a change plan. Use it to scope a feature or a major refactor. CX Codex ★ 353repo stars architect josstei architect is a Claude Code subagent for system design, component boundaries, trade-off analysis, and stack evaluation before coding begins. CX Codex ★ 489repo 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 consult ZaxbyHub consult enforces an advisory protocol with strict read-before-cite checks and explicit uncertainty levels. CX Codex +1 ★ 539repo stars wf-planning-solution-architect adobe wf-planning-solution-architect — a skill for designing and troubleshooting Adobe Workfront Planning workspaces: record-type hierarchies, formulas, API limits, and tier selection. CX Codex +1 223installs code-architect official Anthropic code-architect analyzes codebase patterns to produce architectural blueprints with file lists, component interfaces, data flows, and phased build sequences. CX Codex 1,439installs Multi-Agent Architect daffy0208 The Multi-Agent Architect skill helps design systems where specialized agents split work, communicate, and review results. It fits complex workflows with several decision points. CX Codex +1 162installs architect-review davila7 The architect-review 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. CX Codex 8,999installs

From the same set10

The whole set →
explorer The explorer subagent for Claude Code gathers repository facts for a planner. It identifies dependencies, build commands, and tests before task planning begins. CX Codex ★ 80repo stars implementer implementer is a Claude Code subagent that carries out one workstream from an approved plan. It edits its assigned files, adds tests, and runs validation. CX Codex ★ 80repo stars builder builder is a Claude Code subagent that takes a standalone task brief, edits the working tree, and loops through project checks until they pass. Runs for rescue attempts and dedicated build tasks. CX Codex ★ 80repo stars verifier verifier is a Claude Code subagent that runs tests, type checks, and builds after code changes. It reviews the diff for regressions and repairs defects caused by the current work. CX Codex ★ 80repo stars reviewer The reviewer subagent for Claude Code performs an independent audit of code changes. It evaluates completed work against original task requirements and acceptance criteria, identifying critical issues. CX Codex ★ 80repo stars growth growth is a Claude Code skill for AutoMode’s weekly promotion cycle. Ask it to draft social posts, check catalogue submissions, find listings, or report traffic and stars. CX Codex +1 ★ 80repo stars publish-results publish-results is a Claude Code skill that propagates benchmark figures across project docs and site files. Runs before merging release PRs or after altering public metrics. CX Codex +1 ★ 80repo stars ship-change ship-change is a Claude Code skill that guides repository changes from issue to merged PR. It activates before fixes, features, docs edits, refactors, and release requests. CX Codex +1 ★ 80repo stars

Project sponsors

Companies that keep this analytics open