backend-architect

Automate backend architecture design with API contracts and resilience patterns.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/BoraPerusic/agents --skill backend-architect-boraperusic
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: backend-architect
Source: https://github.com/BoraPerusic/agents/tree/main/skills/to%20try/backend-architect
Command: npx skills add https://github.com/BoraPerusic/agents --skill backend-architect-boraperusic

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Expert backend architecture planning and documentation to help teams define scalable, maintainable systems with clear boundaries, contracts, and observability from day one.

Core Features & Use Cases

  • API Design & Patterns: REST, GraphQL, gRPC, WebSocket, and event-driven interfaces.
  • Microservices Architecture: defining bounded contexts, service boundaries, inter-service communication, and deployment patterns.
  • Resilience & Observability: built-in circuit breakers, retries, timeouts, logging, metrics, tracing, and health checks.
  • Architecture Documentation: ADRs, runbooks, architecture diagrams, and contract-first design.

Quick Start

Draft a scalable backend architecture for a new service, including boundaries, API contracts, and resilience patterns.

Frequently Asked Questions about backend-architect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design scalable backend architecture for a new microservice?

To design scalable backend architecture, define bounded contexts for microservices, establish contract-first API design, and implement resilience patterns like circuit breakers alongside observability metrics for deployment readiness.

What is contract-first API design and when do I need it for distributed systems?

Contract-first API design defines interface contracts before implementation, ensuring clear boundaries for REST, GraphQL, or gRPC. It is needed when planning distributed systems to maintain interoperability across separate teams and services.

How do I define microservice boundaries and inter-service communication patterns?

Define microservice boundaries by establishing bounded contexts within your domain. Inter-service communication is then structured using REST, gRPC, or event-driven interfaces to ensure maintainable and decoupled distributed systems.

What's the best way to add resilience patterns and observability to backend systems?

Add resilience patterns like circuit breakers, retries, and timeouts to backend systems, while implementing observability through comprehensive logging, metrics, tracing, and health checks to maintain operational stability.

Can I generate architecture documentation like ADRs and runbooks for distributed systems?

Yes, you can generate architecture documentation including ADRs, runbooks, and architecture diagrams to ensure maintainable backend systems with clearly defined boundaries and deployment readiness.

Does this approach support event-driven architecture and WebSocket API design?

Yes, the backend architecture approach supports event-driven architecture and WebSocket API design, alongside REST and gRPC, to define scalable interfaces and inter-service communication across distributed domains.