microservices

name	microservices
description	Microservices architecture patterns and best practices. Service decomposition, inter-service communication, and distributed data management.
sasmp_version	2.0.0
bonded_agent	04-architecture-patterns
bond_type	SECONDARY_BOND
atomic_operations	["SERVICE_DECOMPOSITION","API_GATEWAY_SETUP","SERVICE_DISCOVERY","DATA_MANAGEMENT"]
parameter_validation	{"query":{"type":"string","required":true,"minLength":5,"maxLength":3000},"pattern":{"type":"string","enum":["saga","cqrs","event-sourcing","api-gateway"],"required":false}}
retry_logic	{"max_attempts":2,"backoff":"exponential","initial_delay_ms":2000}
logging_hooks	{"on_invoke":"skill.microservices.invoked","on_success":"skill.microservices.completed","on_error":"skill.microservices.failed"}
exit_codes	{"SUCCESS":0,"INVALID_INPUT":1,"ANTI_PATTERN_DETECTED":2}

Microservices Skill

Bonded to: architecture-patterns-agent (Secondary)

---

Quick Start

# Invoke microservices skill
"Decompose my monolith into microservices"
"Design API gateway for my services"
"Implement Saga pattern for distributed transactions"

---

Decomposition Strategies

Strategy	Best For	Complexity
By Business Capability	Clear domains	Medium
By Subdomain (DDD)	Complex domains	High
By Team	Conway's Law	Medium
Strangler Fig	Migration	Low

---

Service Decomposition Example

E-commerce Monolith → Microservices

├── user-service          # Authentication, profiles
├── product-service       # Catalog, inventory
├── order-service         # Orders, checkout
├── payment-service       # Transactions
├── notification-service  # Email, push, SMS
└── api-gateway           # Routing, auth, rate limiting

---

Communication Patterns

Synchronous (REST/gRPC)

# Service-to-service call
import httpx

async def get_user_from_user_service(user_id: str):
    async with httpx.AsyncClient() as client:
        response = await client.get(f"http://user-service/users/{user_id}")
        return response.json()

Asynchronous (Events)

# Event publishing
from kafka import KafkaProducer

producer = KafkaProducer(bootstrap_servers=[])

 ():
    producer.send(, {
        : ,
        : order.,
        : order.user_id
    })