system-architect

Plan software architecture for scalable web service systems.

27|9|Updated Jan 4, 2026
One-click install
npx skills add https://github.com/georgekhananaev/claude-skills-vault --skill system-architect-georgekhananaev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: system-architect
Source: https://github.com/georgekhananaev/claude-skills-vault/tree/main/.claude/skills/system-architect
Command: npx skills add https://github.com/georgekhananaev/claude-skills-vault --skill system-architect-georgekhananaev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams design scalable, maintainable software systems by guiding architecture decisions, trade-offs, and best practices across microservices, monoliths, API design, data/storage choices, caching, security, and scalability planning.

Core Features & Use Cases

  • System Design Guidance: Evaluate architectural patterns (monolith vs microservices) and propose a solid system architecture.
  • Architecture Decision Process: Apply a structured approach to select patterns, data models, and security strategies for given requirements.
  • Documentation Template: Generate an Architecture Design Document including goals, components, data flow, and security considerations.
  • Use Case: When starting a new project, run through a design sprint to outline system goals, components, and non-functional requirements.

Quick Start

Provide a high-level system design outline for a new service handling user profiles, including at least 3 components and one data model.

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 system architecture for new web services?

To design a scalable system architecture, evaluate architectural patterns like monolith versus microservices, define components, map data flows, and establish security controls. This process yields a structured architecture document covering goals, non-functional requirements, and scalability planning.

What's the best way to evaluate architectural trade-offs between microservices and monoliths?

Evaluating architectural trade-offs between microservices and monoliths requires a structured decision process selecting patterns based on specific requirements. Compare data models, API design needs, and scalability goals to determine the most maintainable system architecture for your application.

How does API design fit into overall system architecture planning?

API design integrates into system architecture planning by defining how components interact within the data flow. A structured architecture approach selects appropriate API patterns alongside data storage choices and caching strategies to ensure scalable and maintainable web services.

Can I generate an architecture design document that includes security and scalability considerations?

Yes, you can generate an architecture design document that includes security and scalability considerations. The documentation outlines system goals, component definitions, data flows, and security controls to satisfy comprehensive architectural requirements for scalable web services.

When do I need to formalize caching and data layer decisions in my system design?

You need to formalize caching and data layer decisions during architectural planning when addressing scalability and performance requirements. Applying a structured architecture decision process ensures data storage choices and caching strategies align with your system's component definitions and data flows.