system-architect

Generate Mermaid C4 diagrams and ADRs for system architecture design.

69|5|Updated Nov 16, 2025
One-click install
npx skills add https://github.com/nahisaho/musubi --skill system-architect-nahisaho
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: system-architect
Source: https://github.com/nahisaho/musubi/tree/main/.claude/skills/system-architect
Command: npx skills add https://github.com/nahisaho/musubi --skill system-architect-nahisaho

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? This Skill solves the challenge of designing complex software systems that are scalable, secure, maintainable, and cost-effective. It provides structured guidance to avoid common architectural pitfalls and ensures alignment with business goals.

Core Features & Use Cases:

  • Architecture Design: Defines overall system structure, component division, and responsibility.
  • C4 Model Diagrams: Visualizes architecture at different levels (Context, Container, Component) using Mermaid.
  • ADR (Architecture Decision Record) Creation: Documents critical architectural decisions and their rationale.
  • Technology Selection & Tradeoff Analysis: Evaluates and recommends optimal technology stacks.
  • Use Case: You're starting a new large-scale e-commerce platform. This Skill can help define the architecture (e.g., microservices vs. modular monolith), select cloud providers, design for high availability and scalability, and document all key decisions with C4 diagrams and ADRs.

Quick Start: I need to design a new scalable e-commerce system. Help me define the architecture and key technologies.

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 microservices?

System architecture design for microservices involves defining component boundaries, service responsibilities, and communication patterns. This Skill generates C4 diagrams visualizing Context, Container, and Component layers, creates Architecture Decision Records documenting trade-offs, and provides technology recommendations tailored to your scalability requirements.

What is an ADR and why do I need one for system design?

An Architecture Decision Record documents critical architectural choices, their rationale, and trade-offs. ADRs create institutional knowledge and prevent repeated decisions. This Skill generates ADRs automatically during system design, capturing functional and technical requirements alongside decision context.

How do I choose between a monolith and microservices architecture?

The choice depends on scalability needs, team structure, and deployment complexity. This Skill performs ATAM and payoff analyses comparing monolithic and microservices approaches, evaluates technology stacks for each model, and generates C4 diagrams to visualize the implications of each architectural choice.

Can I use C4 diagrams to document cloud-native system design?

Yes. C4 Model diagrams effectively represent cloud-native architectures across abstraction levels. This Skill generates Mermaid-based C4 diagrams for Context, Container, and Component views, integrating cloud services, security boundaries, and data flows into your architecture documentation.

What security considerations should I include in system architecture?

Security architecture covers authentication, authorization, data isolation, and threat boundaries. This Skill integrates security architecture into design workflows, documents security decisions in ADRs, and includes security trade-offs in technology evaluation to ensure scalable, maintainable, and secure systems.

How do I ensure my architecture aligns with business goals?

Structured architectural design captures both functional and technical requirements against business objectives. This Skill produces C4 diagrams, ADRs, and trade-off analyses that bridge business requirements and technical implementation, supporting alignment through documented decision rationale and steering memory integration.