backend-architect

Design scalable backend architectures with API contracts and service boundaries.

6|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/ChrstprJohn/SamsonDentalCenter --skill backend-architect-chrstprjohn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: backend-architect
Source: https://github.com/ChrstprJohn/SamsonDentalCenter/tree/main/.agent/skills/Backend/backend-architect
Command: npx skills add https://github.com/ChrstprJohn/SamsonDentalCenter --skill backend-architect-chrstprjohn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Backend system design often fails to address scale, resilience, and clear boundaries early, leading to brittle APIs and complex maintenance tasks. This skill provides a blueprint for crafting scalable, maintainable backend architectures from the start by defining domain boundaries, contracts, and patterns.

Core Features & Use Cases

  • Service boundary definition: Identify bounded contexts and split systems into maintainable services with clear responsibilities.
  • API design & patterns: Choose REST, gRPC, GraphQL, and event-driven approaches with robust contracts and versioning.
  • Resilience, observability & deployment: Integrate circuit breakers, retries, metrics, tracing, and rollout strategies to ensure reliability.
  • Use case: Design a scalable API layer for a new product, including data flows, integration points, and deployable architectures.

Quick Start

Outline a high-level backend architecture plan for a new service, including boundaries, API contracts, data flow, and deployment strategy.

Frequently Asked Questions about backend-architect

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

FAQPage Schema
How do I define service boundaries for scalable backend microservices?

Defining service boundaries for microservices involves identifying bounded contexts to split systems into maintainable services with clear responsibilities. This approach prevents brittle APIs and complex maintenance tasks by establishing clear domain limits from the start.

What's the best way to design contract-first APIs for distributed systems?

Designing contract-first APIs for distributed systems requires selecting appropriate protocols like REST, gRPC, or GraphQL, alongside event-driven approaches. This ensures robust contracts, clear versioning, and well-defined integration points across your backend architecture.

How do I add resilience patterns like circuit breakers to my backend architecture?

Adding resilience patterns to backend architecture involves integrating circuit breakers and retries alongside deployment rollout strategies. These mechanisms ensure system reliability and maintain service availability during partial failures or unexpected load spikes.

When do I need observability and tracing in microservices deployment?

You need observability and tracing in microservices deployment when managing distributed systems that require reliable monitoring. Integrating metrics and tracing allows teams to track data flows, identify performance bottlenecks, and govern complex service interactions.

Can I use this for designing a new product's API layer and data flows?

Yes, you can use this to design a scalable API layer for a new product. It helps outline a high-level backend architecture plan including service boundaries, data flows, integration points, and deployable architecture strategies.