Skip to main content
subagent CX Codex

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

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

What 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.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 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.

architecture ruvnet A subagent for the Architecture stage of SPARC. It turns pseudocode into a component design, pulls similar patterns from claude-flow memory, and stores what worked. CX Codex ★ 850repo stars design-code-architecture wondelai design-code-architecture — a skill for Claude Code, Cursor, and other platforms that walks you through eight architecture phases — from boundaries and domain model through data choices to resilience. CX Codex +1 2,700installs architecture-designer https://github.com/Jeffallan architecture-designer designs distributed system architectures, creates Mermaid diagrams, and writes Architecture Decision Records. It helps balance trade-offs before writing service code. CX Codex +1 8,500installs architecture-optimization wondelai The architecture-optimization Claude Code skill guides architecture, code-quality, and performance work on a live codebase. It records decisions and measurements across eight phases. CX Codex +1 1,700installs designing-architecture CloudAI-X designing-architecture — a skill that guides you through selecting an architecture pattern, evaluating project size and team capacity, and structuring your codebase. CX Codex +1 ★ 1,424repo stars oma-architecture First Fluke oma-architecture is a Claude Code skill that helps design module and service boundaries, compare alternatives, and document architecture decisions as ADRs. CX Codex +1 ★ 1,472repo stars agent-architecture official github Designs AI agent architectures from requirements or audits existing agents for flaws. Focuses purely on architectural decisions and verification without implementing code. CX Codex +1 42installs

From the same set76

The whole set →
planner planner is a Claude Code subagent that breaks down engineering goals, maps dependencies, and allocates agents using execution memory. CX Codex ★ 850repo stars researcher The researcher subagent examines code, documentation, and module relationships, then organizes findings into a research summary. Use it to map an unfamiliar project or spot gaps in its docs. CX Codex ★ 850repo stars v3-integration-architect v3-integration-architect — a Claude subagent that carries out ADR-001: folding claude-flow into agentic-flow@alpha as an extension and cutting 10,000+ duplicated lines. CX Codex ★ 850repo stars sync-coordinator sync-coordinator aligns versions, dependencies, and docs across linked repositories. It orchestrates agent swarms using GitHub CLI and MCP tools. CX Codex +1 ★ 850repo stars repo-architect repo-architect optimizes repository layouts and synchronizes files across projects using agent swarms. Helpful when setting up standard templates and multi-repo workflows. CX Codex +1 ★ 850repo stars swarm-pr swarm-pr coordinates agents working on a GitHub pull request, from diff analysis and review to reporting results back to the PR. CX Codex ★ 850repo stars code-review-swarm code-review-swarm sends a pull request through several review agents at once: security, performance, style, architecture. Handy when a plain diff and a linter no longer catch the trouble. CX Codex +1 ★ 850repo stars swarm-issue swarm-issue is a Claude Code command that connects GitHub Issues to swarm work by splitting tasks into subtasks, suggesting agents, and tracking progress. It supports workflows managed through GitHub Issues. CX Codex +1 ★ 850repo stars

Project sponsors

Companies that keep this analytics open