system-architecture-advisor

Determine suitable software architecture patterns and generate Mermaid diagrams.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/sitechfromgeorgia/georgian-distribution-system --skill system-architecture-advisor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: system-architecture-advisor
Source: https://github.com/sitechfromgeorgia/georgian-distribution-system/tree/main/.claude/skills/system-architecture-advisor
Command: npx skills add https://github.com/sitechfromgeorgia/georgian-distribution-system --skill system-architecture-advisor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

The System Architecture Advisor helps teams design robust, scalable architectures, select pattern strategies, generate visual diagrams with Mermaid, and create architecture documentation to accelerate engineering decision-making.

Core Features & Use Cases

  • Architecture pattern guidance for monolith, microservices, event-driven, and serverless architectures with rationale.
  • Mermaid diagram generation for system context, sequence, and deployment diagrams.
  • API design guidance across REST, GraphQL, and gRPC, including best practices and example schemas.
  • Stack evaluation and trade-off analyses to help choose technologies and hosting options.
  • Architecture documentation templates and governance aids to support ADRs and architecture reviews.

Quick Start

Ask for guidance like design a scalable architecture for a web app; request a Mermaid diagram of the system; or compare monolith vs microservices for a 100-person team.

Frequently Asked Questions about system-architecture-advisor

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

FAQPage Schema
How do I choose the right software architecture pattern for my project scale?

To design scalable system architecture, evaluate project scale, team structure, and constraints to select between monolith, microservices, event-driven, or serverless patterns. This ensures the chosen architecture handles performance and scalability requirements effectively.

Can I generate Mermaid diagrams for system context and deployment views?

Yes, you can generate Mermaid diagrams for system context, sequence, and deployment views. This visual output helps document architectural components and interactions clearly, accelerating engineering decision-making and system design communication.

What is the best way to compare monolith vs microservices for a large team?

Comparing monolith vs microservices for a large team involves evaluating trade-offs in scalability, governance, and operational complexity. The advisor provides stack evaluation and pattern guidance to determine the optimal architecture based on your specific team size and constraints.

How do I document API design guidance for REST, GraphQL, and gRPC?

Document API design guidance for REST, GraphQL, and gRPC by applying best practices and example schemas to ensure secure and scalable communication. The advisor generates architectural documentation templates covering these protocols comprehensively.

Does the system architecture documentation include security and governance aids?

Yes, system architecture documentation includes security and governance aids. It supports Architecture Decision Records (ADRs) and architecture reviews, ensuring that security, scalability, performance, and governance constraints are thoroughly covered in the final output.