architecture-paradigm-microservices

name	architecture-paradigm-microservices
role	library
description	Applies microservices for independent deployment and per-service scaling. Use when teams need autonomous release cycles with distinct capability scaling needs.
alwaysApply	false
category	architectural-pattern
tags	["architecture","microservices","distributed-systems","team-autonomy","scalability"]
dependencies	[]
tools	[]
usage_patterns	["paradigm-implementation","distributed-system-design","team-scaling","api-gateway-planning"]
complexity	high
model_hint	deep
estimated_tokens	900

Table of Contents

• When to Employ This Paradigm
• When NOT to Use This Paradigm
• Adoption Steps
• Key Deliverables
• Technology Guidance
• Risks & Mitigations

The Microservices Architecture Paradigm

When to Employ This Paradigm

• When the organizational structure requires high levels of team autonomy and independent release cycles.
• When different business capabilities (bounded contexts) have distinct scaling requirements or would benefit from different technology stacks.
• When there is a significant organizational commitment to investing in DevOps and SRE maturity, including advanced observability, CI/CD, and incident response capabilities.

When NOT To Use This Paradigm

• When team size is small and organizational complexity is low
• When lack of DevOps maturity or limited platform engineering resources
• When system requires strong transactional consistency across operations
• When early-stage startup with rapidly evolving requirements
• When regulatory constraints make distributed data management challenging

Adoption Steps

1. Define Bounded Contexts: Map each microservice to a clear business capability and establish unambiguous data ownership.
2. validate Service Data Autonomy: Each service must own and control its own database or persistence mechanism. All data sharing between services must occur via APIs or events, not shared tables.
3. Build a production-grade Platform: Before deploying services, establish foundational infrastructure for service discovery, distributed tracing, centralized logging, CI/CD templates, and automated contract testing.
4. Design for Resilience: Implement resilience patterns such as timeouts, retries, circuit breakers, and bulkheads for all inter-service communication. Formally document Service Level Indicators (SLIs) and Objectives (SLOs).
5. Automate Governance: Implement automated processes to enforce security scanning, dependency management policies, and consistent versioning strategies across all services.

Key Deliverables

• An Architecture Decision Record (ADR) cataloging all service boundaries, their corresponding data stores, and their communication patterns (e.g., synchronous API vs. asynchronous events).
• A set of "golden path" templates and runbooks for creating and operating new services on the platform.