What is the System Design skill for Claude Code?

It is a specialized capability that guides users through creating architectural designs, evaluating tech stack trade-offs, and generating structured technical documentation.

Can this skill help with existing monolithic applications?

Yes, it includes specific workflows for reviewing existing architecture for maintainability concerns and planning the decomposition of monoliths.

What kind of design artifacts does it produce?

It generates structured markdown documents covering context, requirements, component descriptions, key decisions (ADRs), data models, and risk assessments.

Does it follow specific architectural principles?

Yes, the skill enforces principles such as starting simple, making trade-offs explicit, separation of concerns, and designing for graceful failure.

System Architecture & Design

Name: System Architecture & Design
Author: s-hiraoku

bys-hiraoku

0•

API 개발

Guides high-level architectural decision-making and generates comprehensive technical design artifacts for scalable software systems.

This skill empowers developers to architect robust, scalable, and maintainable software systems by providing a structured framework for complex decision-making. It guides users through the entire design lifecycle—from clarifying non-functional requirements and identifying core components to evaluating technical trade-offs and generating production-ready design documents. Whether you are decomposing a monolith, planning a greenfield project, or creating Architecture Decision Records (ADRs), this skill ensures that essential principles like separation of concerns, failure handling, and observability are baked into your system's foundation.

주요 기능

01Comprehensive review checklist for reliability, security, and scalability

02Comparative trade-off analysis between multiple architectural options

03Automated generation of detailed design artifacts and ADRs

040 GitHub stars

05Structured requirement gathering for functional and non-functional constraints

06Component identification including data stores, services, and interfaces

사용 사례

01Creating formal Architecture Decision Records (ADRs) for stakeholder alignment

02Architecting a new microservices-based system from scratch

03Evaluating and documenting the migration path from a monolith to services

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add s-hiraoku/synapse-a2a system-design

For use in Claude.ai and ChatGPT

Download Skill