architecture

Select cross-service system patterns with criteria and implementation plans.

7|Updated Jan 26, 2026
One-click install
npx skills add https://github.com/bricerising/enterprise-software-playbook --skill architecture-bricerising
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/bricerising/enterprise-software-playbook/tree/main/skills/architecture
Command: npx skills add https://github.com/bricerising/enterprise-software-playbook --skill architecture-bricerising

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Design or refactor cross-service architecture by selecting appropriate system patterns (Saga, CQRS, API gateway, event-driven vs request/response) to address domain boundaries, data ownership, and integration seams. Use when work spans multiple processes/services, requires eventual consistency, or needs clearer integration boundaries. NOT for in-process code structure like GoF patterns; NOT for applying timeouts/retries/breakers to a single call.

Core Features & Use Cases

  • Pattern chooser for cross-service pressures (reliability, consistency, domain boundaries).
  • Guidance on selecting primary pattern plus up to 1–2 supporting patterns.
  • Implementation planning, guardrails, and metrics alignment for migrations or refactors.

Quick Start

Describe your cross-service pressure in a brief sentence to receive a primary pattern recommendation and a high-level implementation plan.

Frequently Asked Questions about architecture

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

FAQPage Schema
How do I choose the right microservices architecture pattern for cross-service reliability and consistency?

To choose a microservices architecture pattern, evaluate cross-service pressures like data ownership and integration seams. This Skill selects a primary pattern, such as Saga or CQRS, plus supporting patterns to address your specific reliability and consistency challenges.

When do I need to use Saga or CQRS patterns for distributed systems?

You need Saga or CQRS patterns for distributed systems when work spans multiple services requiring eventual consistency or clearer domain boundaries. This Skill applies when you face integration seam challenges across teams, not for single-process code structure.

What is the best way to refactor cross-service architecture for event-driven vs request/response integration?

The best way to refactor cross-service architecture is to document criteria and select a primary pattern with up to two supporting patterns. This Skill provides an implementation plan with guardrails and metrics alignment for migrating between event-driven and request/response models.

Can I use this Skill to apply timeouts or retries to a single service call?

No, you cannot use this Skill for single service call timeouts or retries. It is designed specifically for multi-service boundaries addressing domain boundaries, data ownership, and integration seams, rather than in-process code structure or single-call resilience.

How do I plan a migration to a new system pattern across multiple services?

To plan a migration to a new system pattern, describe your cross-service pressure concisely. The Skill outputs a high-level implementation plan with guardrails and documented criteria, recommending one primary pattern and up to two supporting patterns for the refactor.

Does this Skill help with API gateway and domain boundary design for microservices?

Yes, this Skill helps with API gateway and domain boundary design by selecting appropriate system patterns. It addresses integration seams and data ownership across multi-service boundaries, determining the most suitable pattern for your specific cross-service pressures.