moai-domain-backend

Guide backend development across REST, GraphQL, gRPC, and data stores.

1.2k|214|Updated Sep 16, 2025
One-click install
npx skills add https://github.com/modu-ai/moai-adk --skill moai-domain-backend
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: moai-domain-backend
Source: https://github.com/modu-ai/moai-adk/tree/main/.claude/skills/moai-domain-backend
Command: npx skills add https://github.com/modu-ai/moai-adk --skill moai-domain-backend

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes examples (resource) and references (resource) components.

What problem does it solve?

Designing and scaling robust backend systems is complex, requiring expertise in architecture, APIs, databases, and cloud-native patterns. This Skill provides comprehensive guidance for building high-performance, observable, and secure backend services, from microservices to serverless.

Core Features & Use Cases

  • Modern Architecture Patterns: Guides on layered, microservices (Kubernetes 1.31, Istio 1.21), serverless (AWS Lambda), and event-driven (Kafka 3.7) architectures.
  • API Design Expertise: Best practices for RESTful, GraphQL, and gRPC API design, including OWASP API Security Top 10 (2023).
  • Advanced Observability: Integrates OpenTelemetry 1.24, Prometheus 2.48, and Jaeger 1.51 for full-stack monitoring, tracing, and logging.
  • Use Case: When planning a new microservice, this Skill can help you choose the right communication protocol (REST vs. gRPC), design its API endpoints, and integrate it with your existing Kubernetes and Istio infrastructure.

Quick Start

Example: Deploy a Go microservice to Kubernetes with Istio

(This is a conceptual workflow, not a single command)

1. Define Dockerfile for your Go service.

2. Create Kubernetes Deployment and Service YAMLs.

3. Apply Istio VirtualService and DestinationRule for traffic management.

4. Instrument your Go service with OpenTelemetry for tracing.

Claude can generate these configurations based on your requirements.

Frequently Asked Questions about moai-domain-backend

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

FAQPage Schema
How do I design scalable microservices with Kubernetes and API best practices?

Design scalable microservices by defining clear API contracts (REST, GraphQL, or gRPC), structuring services with layered architecture, deploying to Kubernetes 1.31, and applying service discovery and load balancing. Use Istio 1.21 for traffic management and implement OWASP API Security Top 10 (2023) patterns to secure endpoints across your cluster.

What's the best way to implement observability in production backend systems?

Implement observability by instrumenting services with OpenTelemetry 1.24 for distributed tracing, collecting metrics with Prometheus 2.48, and visualizing traces with Jaeger 1.51. This full-stack approach provides visibility into latency, errors, and dependencies across microservices, Kubernetes deployments, and event-driven workflows.

Can I use REST, GraphQL, and gRPC together in the same backend architecture?

Yes. REST, GraphQL, and gRPC serve different use cases within the same system. REST works well for public APIs, GraphQL for flexible client queries, and gRPC for high-performance service-to-service communication. Design each protocol's API surface independently while sharing underlying data access layers and authentication strategies.

How do I integrate PostgreSQL, MongoDB, and Redis caching in a microservices backend?

Layer your data access: use PostgreSQL for relational data, MongoDB for document-oriented data, and Redis for distributed caching. Implement cache-aside or write-through strategies at the data access layer, manage cache invalidation across services, and ensure consistency between primary stores and cache using event-driven updates.

What authentication and authorization patterns work with Kubernetes and Istio deployments?

Apply authentication at API gateways and service boundaries using JWT or mTLS, enforce authorization with role-based access control (RBAC), and leverage Istio's authorization policies for fine-grained traffic control. Coordinate Kubernetes RBAC with application-level authorization to secure both infrastructure and business logic.

When should I use event-driven architecture with Kafka instead of synchronous microservices communication?

Use event-driven architecture with Kafka 3.7 when services need loose coupling, asynchronous processing, or high throughput. Events suit order processing, notifications, and analytics pipelines. Reserve synchronous protocols (gRPC, REST) for request-response patterns where immediate replies are required and coupling is acceptable.