architecture · ruvnet — Claude Code subagent: what it does, how to install
architecture designs system structure from specifications and pseudocode, covering components, interfaces, technology choices, and deployment.
no license ★ 850 updated 2026-10-26
.claude/agents/architecture.mdWhat architecture does
This subagent handles the Architecture phase of the SPARC methodology. It can break a system into components, define their boundaries and contracts, select a technology stack, and plan for scaling. Its examples cover an authentication service, REST and gRPC interfaces, event flows, data schemas, and a Kubernetes Deployment.
Pre- and post-hooks record the current phase in memory; the pre-hook also searches for completed pseudocode. The PostgreSQL, Redis, and RabbitMQ stack shown in the architecture is an example, not a project requirement. The hooks call memory_store and memory_search, so the workflow uses memory operations.
What it helps with
- split a system into components with clear boundaries
- define REST and gRPC contracts between services
- design data schemas and entity relationships
- outline a Kubernetes deployment
Example prompts for the agent
- Design the system architecture from this specification and divide it into components.
- Define the service interfaces and the events they exchange.
- Plan the data schema and a Kubernetes deployment for this application.
How to install architecture
Manually: put the files in place
.claude/agents/architecture.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/architecture.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/architecture.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about architecture
How do I install architecture in Claude Code?
Add the subagent file at .claude/agents/architecture.md.
What does architecture do?
It supports system design during the SPARC Architecture phase, from component boundaries and interfaces to technology choices and deployment structure.
What do its memory hooks do?
The pre-hook records the phase and searches for completed pseudocode. The post-hook records that the architecture phase is complete.
Similar subagents
All subagents for Design →architecture by other authors comes first.