Architecture Design

When the user needs to design or evaluate system architecture — service boundaries, data models, API contracts, infrastructure topology, database selection, or dependency analysis. Also activate for "design the system", "how should I architect this", "monolith vs microservices", or architecture decision records.

393 stars 46 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add shawnpang/startup-founder-skills --skill architecture-design
Manual install
git clone --depth 1 https://github.com/shawnpang/startup-founder-skills.git /tmp/startup-founder-skills
mkdir -p ~/.claude/skills
cp -r /tmp/startup-founder-skills/skills/architecture-design ~/.claude/skills/architecture-design

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Architecture Design

## When to Use
- Starting a new product or major feature that needs system design
- Choosing between monolith, modular monolith, microservices, or event-driven patterns
- Selecting a database (SQL vs NoSQL vs specialized) for a new project
- Analyzing dependencies for circular references, coupling issues, or outdated packages
- Creating architecture diagrams (Mermaid, PlantUML, ASCII) for documentation or review
- Writing Architecture Decision Records (ADRs) for technical choices
- Evaluating scalability bottlenecks or planning capacity

## Context Required
From `startup-context`: product description, tech stack, current state (prototype/beta/scaling), team size, expected scale (users, requests/sec, data volume). If missing, ask:
- What does this system need to do? (core use cases)
- What scale are you targeting? (users, requests/sec, data size)
- What is your team size and backend experience level?
- Are there hard constraints? (compliance, latency, budget, existing infra)

## Workflow
1. **Gather requirements** — Identify functional requirements (use cases), non-functional requirements (latency, throughput, availability, consistency), and constraints (budget, team size, compliance).
2. **Run architecture assessment** — Analyze the existing project structure to detect current patterns (MVC, layered, hexagonal, microservices indicators), code organization issues (god classes, mixed concerns), and layer violations.
Read the full skill on GitHub

Details

Skill name
architecture-design
Path
skills/architecture-design/SKILL.md
License
MIT
Repo updated
16 March 2026

FAQ

What does the Architecture Design skill do?

When the user needs to design or evaluate system architecture — service boundaries, data models, API contracts, infrastructure topology, database selection, or dependency analysis. Also activate for "design the system", "how should I architect this", "monolith vs microservices", or architecture decision records.

How do I install the Architecture Design skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add shawnpang/startup-founder-skills --skill architecture-design. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Architecture Design popular?

It lives in shawnpang/startup-founder-skills, which has 393 GitHub stars and 46 forks.

Related skills

Accelerator Application

393

shawnpang/startup-founder-skills

When the user wants to apply to startup accelerators, incubators, or fellowship programs. Also use when the user mentions "YC application", "Techstars", "accelerator", or "apply to programs".

Software Development46

Board Update

393

shawnpang/startup-founder-skills

When the user needs to write a monthly or quarterly investor update, prepare a board deck, or communicate company progress to stakeholders.

Finance & Crypto46

Churn Analysis

393

shawnpang/startup-founder-skills

When the user needs to identify at-risk accounts, understand why customers are leaving, reduce churn rate, build health scores, design save plays, or create win-back campaigns.

Marketing, Sales & Business46

Code Review

393

shawnpang/startup-founder-skills

When the user asks for a code review, shares code for feedback, or says "review this", "check my code", "what's wrong with this". Also activate when reviewing a pull request or diff.

Software Development46

Pnpm

398

JetBrains/skills

Node.js package manager with strict dependency resolution. Use when running pnpm specific commands, configuring workspaces, or managing dependencies with catalogs, patches, or overrides.

Software Development35

Time Blocking Scheduler

492

cosmicstack-labs/mercury-agent-skills

A structured time management coach that designs deep work schedules, energy-aligned routines, and priority-focused blocks for freelancers, solopreneurs, and creative professionals who need to protect their focus from the chaos of unstructured days.

Software Development68

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.