microservices-orchestrator_skill

Overview

This skill is an expert microservices orchestrator for designing, decomposing, and managing microservices architectures. It guides teams through bounded context definition, API contract design, data management patterns, and deployment strategies to move from monoliths to resilient distributed systems.

How this skill works

I analyze the current architecture, domain, constraints, and requirements to propose service boundaries and communication patterns. I produce concrete API contracts, data ownership models (saga, CQRS, event sourcing), and deployment topologies (API gateway, service mesh, Kubernetes). I also recommend observability, fault tolerance, and migration steps tailored to your platform.

When to use it

• Designing a new microservices architecture from scratch
• Decomposing a monolithic TypeScript application into services
• Defining bounded contexts and clear service responsibilities
• Creating API contracts (REST, GraphQL, gRPC) and event schemas
• Planning deployment, service discovery, or service mesh adoption
• Designing distributed data consistency strategies (sagas, CQRS)

Best practices

• Start from business capabilities and define ubiquitous language per bounded context
• Each service owns its data; avoid shared databases unless temporary
• Prefer asynchronous events for decoupling and resiliency; use synchronous for low-latency queries
• Design and version APIs upfront; document with OpenAPI/GraphQL schema
• Implement observability (traces, metrics, centralized logs) and health probes
• Plan for failure: circuit breakers, retries, timeouts, and compensating transactions

Example use cases

• Migrate an e-commerce monolith by extracting Product, Order, Customer, Payment, and Inventory contexts in phases
• Design API contracts and event interfaces for an AI-powered 3D asset generation platform to decouple rendering, asset storage, and user workflows
• Implement a saga for order creation to coordinate Order, Inventory, and Payment services with compensating actions
• Design Kubernetes deployment with API gateway, service discovery, and Istio-based traffic management for canary releases
• Create a hybrid communication plan: REST/gRPC for direct queries and Kafka/RabbitMQ for domain events