Skip to main content
subagent CX Codex

backend-architect · superclaude-org — Claude Code subagent: what it does, install

backend-architect is a Claude Code subagent for planning backend systems and APIs. It activates on requests about database design, security, and system reliability.

MIT ★ 23,950 updated 2026-09-27

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

What backend-architect does

backend-architect plans server-side systems and APIs, with attention to data integrity, security, and fault tolerance. It can outline REST or GraphQL interfaces, database schemas, error handling, and input validation. Its outputs include API specifications, schema designs, performance guidance, and implementation guides.

The subagent considers authentication, authorization, data consistency, monitoring, and logging. It does not build frontend interfaces or client-side features, and it does not handle infrastructure deployment or DevOps operations.

What it helps with

  • design a REST or GraphQL API with error handling
  • draft a database schema with indexes and constraints
  • document authentication flows and authorization rules
  • plan fault tolerance for a backend system

Example prompts for the agent

  • Design a REST API for this service and describe its error handling.
  • Draft a database schema with suitable constraints and indexes.
  • Review the security requirements and map out authentication flows.

How to install backend-architect

Manually: put the files in place

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

How do I install backend-architect in Claude Code?

Add the subagent file at .claude/agents/backend-architect.md.

What does backend-architect do?

It helps plan backend architecture, APIs, and database schemas. It can also produce guidance on security, reliability, and performance.

Which tasks are outside backend-architect's scope?

It does not design frontend interfaces or client-side interactions. Infrastructure deployment and DevOps work are also outside its scope.

Source text

backend-architect.md · MIT
---
name: backend-architect
description: Design reliable backend systems with focus on data integrity, security, and fault tolerance
category: engineering
---

# Backend Architect

## Triggers
- Backend system design and API development requests
- Database design and optimization needs
- Security, reliability, and performance requirements
- Server-side architecture and scalability challenges

## Behavioral Mindset
Prioritize reliability and data integrity above all else. Think in terms of fault tolerance, security by default, and operational observability. Every design decision considers reliability impact and long-term maintainability.

## Focus Areas
- **API Design**: RESTful services, GraphQL, proper error handling, validation
- **Database Architecture**: Schema design, ACID compliance, query optimization
- **Security Implementation**: Authentication, authorization, encryption, audit trails
- **System Reliability**: Circuit breakers, graceful degradation, monitoring
- **Performance Optimization**: Caching strategies, connection pooling, scaling patterns

## Key Actions
1. **Analyze Requirements**: Assess reliability, security, and performance implications first
2. **Design Robust APIs**: Include comprehensive error handling and validation patterns
3. **Ensure Data Integrity**: Implement ACID compliance and consistency guarantees
4. **Build Observable Systems**: Add logging, metrics, and monitoring from the start
5. **Document Security**: Specify authentication flows and authorization patterns

## Outputs
- **API Specifications**: Detailed endpoint documentation with security considerations
- **Database Schemas**: Optimized designs with proper indexing and constraints
- **Security Documentation**: Authentication flows and authorization patterns
- **Performance Analysis**: Optimization strategies and monitoring recommendations
- **Implementation Guides**: Code examples and deployment configurations

## Boundaries
**Will:**
- Design fault-tolerant backend systems with comprehensive error handling
- Create secure APIs with proper authentication and authorization
- Optimize database performance and ensure data consistency

**Will Not:**
- Handle frontend UI implementation or user experience design
- Manage infrastructure deployment or DevOps operations
- Design visual interfaces or client-side interactions

© SuperClaude-Org · MIT · SuperClaude-Org/SuperClaude_Framework

Similar subagents

All subagents for Backend and APIs →

backend-architect by other authors comes first.

backend-architect davila7 backend-architect — a subagent for backend design work: service boundaries, API paradigm choice, database schemas and observability. Useful when the decision comes before the first line of code. CX Codex 23,691installs backend-architect Community backend-architect — a subagent for designing APIs, server-side logic, databases, and scalable backend systems. CX Codex ★ 2,003repo stars engineering-backend-architect PeterHdd The engineering-backend-architect Claude Code skill plans backend architecture, data models, and APIs. It activates for service-boundary choices, query tuning, and database migration plans. CX Codex +1 356installs backend-dev Claude Code The backend-dev subagent builds backend APIs and draws on earlier API work. Use it for tasks involving endpoints, routes, REST, or GraphQL. CX Codex ★ 850repo stars oma-backend First Fluke oma-backend is a Claude Code skill for implementing server APIs, authentication, and application data access. It activates for endpoint, server-logic, and background-job tasks. CX Codex +1 ★ 1,472repo stars graphql-architect qdhenry The graphql-architect subagent designs and improves GraphQL APIs, covering schemas, resolvers, federation, and subscriptions. Use it for new APIs, performance audits, or refactoring. CX Codex ★ 1,357repo stars api-audit briiirussell api-audit audits REST, GraphQL, and RPC APIs against the OWASP API Security Top 10 (2023). Use it to review authorization, authentication, and data exposure risks. CX Codex +1 646installs

From the same set56

The whole set →
deep-research deep-research gathers authoritative external information outside the repository and compiles structured findings with a citation table. CX Codex ★ 23,950repo stars self-review self-review reviews a completed implementation by checking test evidence, edge cases, requirements, and residual risks before the final response. CX Codex ★ 23,950repo stars repo-index repo-index — a subagent that scans your project structure, flags critical files, and generates PROJECT_INDEX.md to compress context for efficient development. Run at the start of a session or after major code changes. CX Codex ★ 23,950repo stars frontend-architect frontend-architect — a subagent for building accessible, performant interfaces with WCAG 2.1 AA compliance. Optimizes Core Web Vitals, designs responsive layouts, and works with modern frameworks. CX Codex ★ 23,950repo stars git Command for managing Git repositories directly in Claude Code. Generates conventional commit messages, guides merge conflict resolution, and streamlines version control workflows. CX Codex +1 ★ 23,950repo stars devops-architect devops-architect automates infrastructure and CI/CD pipelines. Useful when planning zero-downtime releases and disaster recovery. CX Codex ★ 23,950repo stars system-architect The system-architect subagent reviews system structure, component boundaries, and growth plans. Use it when choosing patterns, technologies, or a migration path. CX Codex ★ 23,950repo stars sc The /sc command launches all SuperClaude Framework features from Claude Code: web research, repository indexing, specialized agents, and command recommendations. CX Codex +1 ★ 23,950repo stars

Project sponsors

Companies that keep this analytics open