Skip to content
Development
Skill

/system-design

System design patterns and architectural decision frameworks for web applications and iOS native apps. Use when making technology choices, selecting architecture patterns, designing APIs, choosing databases, planning authentication, or architecting mobile app backends. Provides

From plugin
claude-setup
1314 skills7 agents1 command

Claude Code

$ npx -y skills add shahtuyakov/claude-setup --skill system-design --agent claude-code

SKILL.md

system-design.SKILL.md
name: system-design
description: System design patterns and architectural decision frameworks for web applications and iOS native apps. Use when making technology choices, selecting architecture patterns, designing APIs, choosing databases, planning authentication, or architecting mobile app backends. Provides comparison matrices for informed decision-making.

System Design

Architectural decision framework for web apps and iOS native applications with custom backends.

Decision Process

1. Identify requirements (scale, platform, constraints) 2. Load relevant reference file (see table below) 3. Use comparison matrix to evaluate options 4. Verify compatibility using MCP context7 for latest docs 5. Document decision with rationale

Reference Navigation

| Decision Type | Load | Use When | |---------------|------|----------| | API style | `references/api-patterns.md` | Choosing REST vs GraphQL vs gRPC | | Database | `references/database-patterns.md` | Selecting primary database, caching layer | | Authentication | `references/auth-patterns.md` | Designing auth flow, token strategy | | Real-time | `references/realtime-patterns.md` | Adding live updates, push notifications | | iOS architecture | `references/ios-patterns.md` | Native iOS app structure, offline-first | | Backend architecture | `references/architecture-patterns.md` | Monolith vs microservices, serverless | | File storage | `references/storage-patterns.md` | Media uploads, CDN, cloud storage |

Decision Documentation

Record each decision in `.agents/architect/decisions.md`:

## [date] - [decision title]
Context: [what prompted this decision]
Options: [what was considered]
Decision: [what was chosen]
Rationale: [why]

Platform Considerations

Web + iOS Projects

  • Design API with mobile constraints in mind (bandwidth, battery)
  • Plan for offline-first on iOS with backend sync
  • Consider BFF (Backend for Frontend) if needs diverge significantly

iOS-Specific

  • Always check `references/ios-patterns.md` for native patterns
  • Auth must include Keychain storage and biometrics
  • Push notifications require APNs backend integration
Read more
@shahtuyakov
Ships withclaude-setup

A multi-agent orchestration framework for Claude Code. Build production software with 7 specialized AI agents that coordinate automatically through a Hub Architecture.

1314 skills7 agents
Get the whole plugin

Stars on GitHub

Momentum

stars in total
13
Star history of shahtuyakov/claude-setup on GitHub, a chart by star-history.com

Other skills on claude-setup.

canvas-design

canvas-design

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to…

More skills from other plugins.

brainstorming
Auto-invoked

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…

@obra@obraInstall Skill
ask-matt

ask-matt

Ask which skill or flow fits your situation. A router over the skills in this repo.

skills2w309k
@mattpocock@mattpocockInstall Skill
accessibility
Auto-invoked

accessibility

Design, implement, and audit accessible UI to WCAG 2.2 Level AA across Web, iOS, and Android — semantic ARIA roles and labels,…

ecc2w293k
@affaan-m@affaan-mInstall Skill
compiler-commit

compiler-commit

Use when you want to verify compiler changes and commit with the correct convention. Runs tests, lint, and format, then commits…

react5d252k
@facebook@facebookInstall Skill

Questions about system-design.

Which coding agents can use system-design?
system-design installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.