solution-architect

Design scalable architectures for distributed systems with patterns and ADRs.

13|6|Updated Dec 23, 2025
One-click install
npx skills add https://github.com/olehsvyrydov/AI-development-team --skill solution-architect-olehsvyrydov
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: solution-architect
Source: https://github.com/olehsvyrydov/AI-development-team/tree/main/claude/skills/architecture/solution-architect
Command: npx skills add https://github.com/olehsvyrydov/AI-development-team --skill solution-architect-olehsvyrydov

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps engineering teams design scalable, maintainable architectures for complex distributed systems, guiding decisions and trade-offs.

Core Features & Use Cases

  • Architecture Decision Guidance: Recommends patterns (Saga, CQRS, Event Sourcing) and helps document ADRs.
  • Integration Planning: Plans cross-service interactions and data flows across microservices or modular monoliths.
  • Architecture Artifacts: Produces decisions, diagrams, and rationales to align stakeholders and execution teams.

Quick Start

Provide a high-level architecture proposal for a new service, including recommended patterns and ADRs.

Frequently Asked Questions about solution-architect

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

FAQPage Schema
How do I design scalable architectures for complex distributed systems?

To design scalable architectures for distributed systems, you need structured guidance on pattern selection and trade-offs. This skill provides architectural recommendations using proven patterns like Saga, CQRS, and Event Sourcing to ensure maintainability and alignment across stakeholders.

What is the best way to document architectural decisions for microservices?

Documenting architectural decisions is best achieved by creating Architecture Decision Records (ADRs). This skill enforces the creation of ADRs to capture rationales, recommended patterns, and trade-offs, ensuring execution teams and stakeholders stay aligned on cross-service interactions.

When do I need to use CQRS and Event Sourcing patterns?

You need CQRS and Event Sourcing patterns when designing complex distributed systems that require strict data consistency and scalable cross-service data flows. This skill guides you on enforcing these patterns during technology evaluations and integration planning.

Can I use this to plan cross-service integration and data flows for a modular monolith?

Yes, you can use this to plan cross-service integration and data flows across microservices or modular monoliths. It supports the production of architecture diagrams and rationales to map out interactions and align execution teams during architectural planning.

How do I generate a high-level architecture proposal for a new service?

Generating a high-level architecture proposal for a new service involves selecting appropriate patterns and documenting ADRs. This skill helps you produce architecture artifacts, including decisions, diagrams, and scalability analyses to guide your technology evaluation.