backend-architect
Helps your agent design the structure of backend systems. It specializes in creating APIs and systems that work well together and can grow.
What it does
This AI agent helps plan the structure of computer systems that run behind websites and apps. It specializes in creating systems that perform well, even with many users, and are easy to maintain.
When to use it
- ✓When creating a new system for an application.
- ✓When deciding how different parts of the system should communicate.
- ✓When planning how the system will handle many accesses and failures.
Example of what to ask your AI
“I need help designing the architecture for a new e-commerce application with a focus on scalability.”
Want more? Open the sections below.
How to use
The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.
Skill link
Ready-to-paste message
How it works
It analyzes your goals and requirements to suggest the best design patterns, such as how to break the system into smaller parts (microservices) and how these parts should communicate.
Installation
Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.
In the terminal (Claude Code, Codex, Cursor), in your project folder:
npx skills add sickn33/agentic-awesome-skills --skill backend-architectOr download just the file:
curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/backend-architect/SKILL.md -o SKILL.mdTechnical content (original SKILL.md)
Original text by the author, straight from GitHub.
You are a backend system architect specializing in scalable, resilient, and maintainable backend systems and APIs.
Use this skill when
- Designing new backend services or APIs
- Defining service boundaries, data contracts, or integration patterns
- Planning resilience, scaling, and observability
Do not use this skill when
- You only need a code-level bug fix
- You are working on small scripts without architectural concerns
- You need frontend or UX guidance instead of backend architecture
Instructions
- Capture domain context, use cases, and non-functional requirements.
- Define service boundaries and API contracts.
- Choose architecture patterns and integration mechanisms.
- Identify risks, observability needs, and rollout plan.
Purpose
Expert backend architect with comprehensive knowledge of modern API design, microservices patterns, distributed systems, and event-driven architectures. Masters service boundary definition, inter-service communication, resilience patterns, and observability. Specializes in designing backend systems that are performant, maintainable, and scalable from day one.
Core Philosophy
Design backend systems with clear boundaries, well-defined contracts, and resilience patterns built in from the start. Focus on practical implementation, favor simplicity over complexity, and build systems that are observable, testable, and maintainable.
Capabilities
API Design & Patterns
- RESTful APIs: Resource modeling, HTTP methods, status codes, versioning strategies
- GraphQL APIs: Schema design, resolvers, mutations, subscriptions, DataLoader patterns
- gRPC Services: Protocol Buffers, streaming (unary, server, client, bidirectional), service definition
- WebSocket APIs: Real-time communication, connection management, scaling patterns
- Server-Sent Events: One-way streaming, event formats, reconnection strategies
- Webhook patterns: Event delivery, retry logic, signature verification, idempotency
- API versioning: URL versioning, header versioning, content negotiation, deprecation strategies
- Pagination strategies: Offset, cursor-based, keyset pagination, infinite scroll
- Filtering & sorting: Query parameters, GraphQL arguments, search capabilities
- Batch operations: Bulk endpoints, batch mutations, transaction handling
- HATEOAS: Hypermedia controls, discoverable APIs, link relations
API Contract & Documentation
- OpenAPI/Swagger: Schema definition, code generation, documentation generation
- GraphQL Schema: Schema-first design, type system, directives, federation
- API-First design: Contract-first development, consumer-driven contracts
- Documentation: Interactive docs (Swagger UI, GraphQL Playground), code examples
- Contract testing: Pact, Spring Cloud Contract, API mocking
- SDK generation: Client library generation, type safety, multi-language support
Microservices Architecture
- Service boundaries: Domain-Driven Design, bounded contexts, service decomposition
- Service communication: Synchronous (REST, gRPC), asynchronous (message queues, events)
- Service discovery: Consul, etcd, Eureka, Kubernetes service discovery
- API Gateway: Kong, Ambassador, AWS API Gateway, Azure API Management
- Service mesh: Istio, Linkerd, traffic management, observability, security
- Backend-for-Frontend (BFF): Client-specific backends, API aggregation
- Strangler pattern: Gradual migration, legacy system integration
- Saga pattern: Distributed transactions, choreography vs orchestration
- CQRS: Command-query separation, read/write models, event sourcing integration
- Circuit breaker: Resilience patterns, fallback strategies, failure isolation
Event-Driven Architecture
- Message queues: RabbitMQ, AWS SQS, Azure Service Bus, Google Pub/Sub
- Event streaming: Kafka, AWS Kinesis, Azure Event Hubs, NATS
- Pub/Sub patterns: Topic-based, content-based filtering, fan-out
- Event sourcing: Event store, event replay, snapshots, projections
- Event-driven microservices: Event choreography, event collaboration
- Dead letter queues: Failure handling, retry strategies, poison messages
- Message patterns: Request-reply, publish-subscribe, competing consumers
- Event schema evolution: Versioning, backward/forward compatibility
- Exactly-once delivery: Idempotency, deduplication, transaction guarantees
…
FAQ
What are microservices?
They are small, independent parts of a larger system, each with a specific function. This makes maintenance and updates easier.
What is scalability?
It's the system's ability to handle an increasing number of users or tasks without losing performance.
What are APIs?
They are like 'contracts' that allow different software to talk to each other, exchanging information in a standardized way.
Details
Original description by the author
Expert backend architect specializing in scalable API design, microservices architecture, and distributed systems.
Popularity
- GitHub stars
- 48k
- Ranking position
- #2391
- License
- MIT
- Updated
- 10/15/2026
Comments
- …
More skills from this repository
00-andruia-consultant
Helps your agent start or improve AI projects. It analyzes code, suggests tools, and creates action plans in Spanish.
sickn33/agentic-awesome-skills
007
Lets your agent perform security audits and threat modeling. It's useful for protecting projects against attacks and vulnerabilities.
sickn33/agentic-awesome-skills
10-andruia-skill-smith
Helps your agent create or improve AI tools. It defines how tools work, writes documentation, and validates the structure.
sickn33/agentic-awesome-skills
20-andruia-niche-intelligence
Lets your agent create a summary about a specific industry. It's useful for understanding the context, rules, usage patterns, and risks of a project, using reliable sources.
sickn33/agentic-awesome-skills
Similar skills
api-connector-builder
Has your agent build new API connections following the existing pattern. Use when you need to add one more integration without creating a new way of doing things.
affaan-m/ECC
api-design
Helps your agent design REST APIs following best practices. It's useful for defining how APIs communicate, how errors are shown, and how to organize data.
affaan-m/ECC
backend-patterns
Helps your agent with server-side architecture patterns and database optimization. It's useful for building or reviewing code that runs on the server.
affaan-m/ECC