system-architect

Generate system architecture designs with C4 diagrams and ADRs.

Updated Dec 12, 2025
One-click install
npx skills add https://github.com/ref-docs/sdd-stl --skill system-architect-ref-docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: system-architect
Source: https://github.com/ref-docs/sdd-stl/tree/main/.claude/skills/system-architect
Command: npx skills add https://github.com/ref-docs/sdd-stl --skill system-architect-ref-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps with system architecture design, choosing patterns, creating ADRs, and performing trade-off analyses to deliver maintainable, scalable, and secure systems.

Core Features & Use Cases

  • Architecture Design: Define overall structure, container/component boundaries, and responsibilities.
  • Architecture Patterns: Layered, Hexagonal/Clean, Microservices, Event-driven, Serverless.
  • Trade-off Analysis: Use ADRs and ATAM-style evaluations to balance quality attributes.
  • Documentation: Produce C4 diagrams, ADRs, and architecture documents.

Quick Start

Propose an architecture pattern and create a basic C4-context and container diagram for a given system.

Frequently Asked Questions about system-architect

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

FAQPage Schema
How do I create a C4 diagram for system architecture?

C4 diagrams model system architecture across four levels: context, container, component, and code. Use this Skill to generate Mermaid-formatted C4 diagrams that define boundaries, responsibilities, and relationships between system parts, enabling stakeholders to visualize architecture at appropriate abstraction levels.

What is an Architecture Decision Record (ADR) and when should I write one?

An ADR documents a significant architectural decision, its context, alternatives considered, and rationale. Write ADRs during architecture reviews to capture trade-offs, justify choices between patterns, and create a searchable decision history that helps teams understand why the system was designed a particular way.

How do I perform trade-off analysis for architecture patterns?

Trade-off analysis evaluates quality attributes—scalability, maintainability, security, cost—across candidate patterns like microservices, layered, or serverless architectures. This Skill applies ATAM-style and Payoff matrix approaches to weigh pros and cons, helping you select the pattern that best balances your system's requirements.

Can I use this for microservices and serverless architecture design?

Yes. This Skill covers multiple architecture patterns including microservices, event-driven, serverless, layered, and hexagonal designs. Generate pattern-specific C4 diagrams, ADRs, and trade-off analyses tailored to your chosen pattern and functional requirements.

What documentation outputs does architecture design produce?

Architecture design generates C4 diagrams in Mermaid format, ADR templates in Markdown, trade-off analyses, and architecture documentation. Outputs integrate with steering files and are exported as Markdown, providing maintainable, version-controllable records of your design decisions.

How do I document component boundaries and responsibilities?

Define container and component boundaries in C4 diagrams, then specify responsibilities through architecture documentation and ADRs. This Skill generates the diagrams and decision records needed to communicate how your system separates concerns and assigns ownership across layers and services.