system-design

Design scalable system architectures using a six-step process with ADRs.

186|15|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/kid-sid/claude-spellbook --skill system-design-kid-sid
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: system-design
Source: https://github.com/kid-sid/claude-spellbook/tree/main/skills/system-design
Command: npx skills add https://github.com/kid-sid/claude-spellbook --skill system-design-kid-sid

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

System design tasks are often ill-defined and brittle; this Skill provides a structured, end-to-end framework to design scalable, reliable architectures from first principles.

Core Features & Use Cases

  • Structured six-step design process guiding requirements, capacity, API contracts, data models, components, and bottlenecks.
  • ADRs and decision governance to capture rationale and consequences of architectural choices.
  • Capacity estimation & reliability patterns with actionable checklists and recommended patterns for scalability, availability, and resilience.
  • Use cases include designing a new service, selecting technology stacks, planning capacity, and evaluating trade-offs with risk analysis.

Quick Start

Follow the six-step design process to create a scalable architecture plan for a new service.

Frequently Asked Questions about system-design

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

FAQPage Schema
How do I design a scalable system architecture for a new service?

Design scalable system architecture using a structured six-step process covering requirements clarification, capacity estimation, API contracts, data modeling, component design, and ADR documentation. This framework enforces non-functional requirements and design patterns to improve reliability from first principles.

What is capacity estimation in system design and when do I need it?

Capacity estimation in system design calculates the resource requirements needed to handle expected loads reliably. You need it when planning a new service to ensure scalability, evaluate technology stack trade-offs, and apply appropriate availability and resilience patterns before deployment.

How do I document architectural decisions and evaluate design trade-offs?

Document architectural decisions using Architecture Decision Records (ADRs) to capture the rationale and consequences of your choices. This governance approach ensures design trade-offs and risk analyses are recorded, making system reliability and scalability decisions transparent for future evaluation.

Can I use this system design process for selecting technology stacks and evaluating bottlenecks?

Yes, this system design process supports selecting technology stacks and evaluating bottlenecks by guiding you through component design and capacity planning. It provides actionable checklists and recommended patterns to identify scalability limits and analyze trade-offs for new services.

What's the best way to structure non-functional requirements for a reliable architecture?

The best way to structure non-functional requirements for a reliable architecture is to enforce them throughout a six-step design process. Integrating capacity planning, reliability patterns, and ADRs ensures scalability and availability constraints are addressed during component design rather than retrofitted later.