system-architect

Architect production-grade software systems using architecture patterns and trade-off analysis.

Updated Jan 7, 2026
One-click install
npx skills add https://github.com/marsolab/skills --skill system-architect-marsolab
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: system-architect
Source: https://github.com/marsolab/skills/tree/main/system-architect
Command: npx skills add https://github.com/marsolab/skills --skill system-architect-marsolab

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps engineering teams design production-grade software architectures by applying proven patterns, trade-off analysis, and ADR-driven decision records to guide scalable, maintainable systems.

Core Features & Use Cases

  • Architecture pattern selection for monoliths, microservices, and hybrid approaches.
  • ADR documentation to capture context and rationale for major architectural decisions.
  • Observability-first design with metrics, traces, and logs planning, including SLIs/SLOs.
  • Clear data ownership, service boundaries, and deployment strategies for reliable systems.
  • Use cases include cloud-native platform design, technology evaluation, and large-scale migration guidance.

Quick Start

Example task: Request a complete system design for a cloud-based order service, including service boundaries, data ownership, ADR recommendations, and deployment considerations.

Frequently Asked Questions about system-architect

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

FAQPage Schema
How do I design a scalable, production-grade system architecture for cloud-native applications?▼

Design scalable, production-grade system architecture by applying proven patterns, trade-off analysis, and ADR-driven decision records to guide reliable, maintainable cloud-native systems.

What's the best way to document architecture decisions for microservices and distributed systems?▼

Document architecture decisions using ADR records to capture context and rationale, ensuring clear data ownership, service boundaries, and deployment strategies for reliable distributed systems.

How do I plan observability with metrics, traces, and logs for a production system?▼

Plan observability-first design by defining metrics, traces, logs, and SLIs/SLOs to ensure operational reliability and monitor system health across distributed architectures.

Can I use this to evaluate technology and guide large-scale cloud migrations?▼

Yes, you can evaluate technology and guide large-scale cloud migrations by applying architecture pattern selection, trade-off analysis, and deployment strategies for monoliths or microservices.

When should I choose microservices over a monolithic architecture pattern?▼

Choose microservices or monolithic architecture patterns based on trade-off analysis covering scalability, data ownership, service boundaries, and operational decision-making for your specific production context.