# proyecto26/system-design-skills architecture

> Architecture diagram of the GitHub repository proyecto26/system-design-skills, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/proyecto26/system-design-skills
- Repository: https://github.com/proyecto26/system-design-skills

## Overview

system-design-skills is a Claude Code plugin and portable skill catalog for reasoning through system designs. The main workflow starts with a design prompt, enters the /design command or conversational orchestrator, clarifies requirements, estimates scale, composes relevant building blocks, evaluates trade-offs and failure modes, and iterates before rendering and scoring a design document. Users can also invoke individual blocks directly. The README documents these relationships; sampled site files implement an onboarding presentation, not the design workflow itself, so the graph does not infer runtime calls between skill files.

Main entry points: [`commands/design.md`](https://github.com/proyecto26/system-design-skills/blob/main/commands/design.md) (/design command), [`skills/system-design/SKILL.md`](https://github.com/proyecto26/system-design-skills/blob/main/skills/system-design/SKILL.md) (System-design skill), [`skills/back-of-the-envelope/SKILL.md`](https://github.com/proyecto26/system-design-skills/blob/main/skills/back-of-the-envelope/SKILL.md) (Back-of-envelope), [`skills/architecture-diagram/SKILL.md`](https://github.com/proyecto26/system-design-skills/blob/main/skills/architecture-diagram/SKILL.md) (Architecture diagram)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry points"]
  node_design_command["/design command<br/>[design.md]"]
  node_orchestrator_agent["Orchestrator agent"]
  node_system_design_skill["System-design skill<br/>[SKILL.md]"]
end

subgraph group_method["Design method"]
  node_requirements["Requirements scoping<br/>[SKILL.md]"]
  node_estimation["Back-of-envelope<br/>[SKILL.md]"]
  node_calculator["Sizing calculator<br/>[botec.py]"]
  node_design_reasoning["Design and iteration<br/>[SKILL.md]"]
end

subgraph group_blocks["Building blocks"]
  node_edge_blocks["Edge blocks"]
  node_service_blocks["Service blocks"]
  node_state_blocks["State blocks"]
  node_async_blocks["Async blocks"]
  node_correctness_block["Correctness block<br/>[SKILL.md]"]
  node_ops_blocks["Operations blocks"]
  node_growth_block["Growth block<br/>[SKILL.md]"]
end

subgraph group_deliverables["Design outputs"]
  node_diagram_skill["Architecture diagram<br/>[SKILL.md]"]
  node_design_document["Scored design document"]
  node_site_app["Onboarding presentation<br/>[App.jsx]"]
  node_site_diagrams["Presentation diagrams<br/>[diagrams.jsx]"]
end

node_designer(("Designer"))

node_designer -->|"starts design"| node_design_command
node_designer -->|"asks conversationally"| node_system_design_skill
node_designer -->|"asks one question"| node_edge_blocks
node_design_command -.->|"dispatches optionally"| node_orchestrator_agent
node_design_command -->|"runs workflow"| node_requirements
node_design_command -->|"runs workflow"| node_estimation
node_design_command -->|"invokes blocks"| node_edge_blocks
node_design_command -->|"renders design"| node_diagram_skill
node_design_command -->|"scores and persists"| node_design_document
node_system_design_skill -->|"clarifies scope"| node_requirements
node_system_design_skill -->|"sizes design"| node_estimation
node_system_design_skill -->|"routes to blocks"| node_edge_blocks
node_system_design_skill -->|"iterates trade-offs"| node_design_reasoning
node_estimation -.->|"can calculate"| node_calculator
node_design_reasoning -->|"renders architecture"| node_diagram_skill
node_diagram_skill -->|"produces diagram"| node_design_document
node_site_app -->|"renders diagrams"| node_site_diagrams

click node_design_command "https://github.com/proyecto26/system-design-skills/blob/main/commands/design.md"
click node_orchestrator_agent "https://github.com/proyecto26/system-design-skills/blob/main/agents/system-design-orchestrator.md"
click node_system_design_skill "https://github.com/proyecto26/system-design-skills/blob/main/skills/system-design/SKILL.md"
click node_requirements "https://github.com/proyecto26/system-design-skills/blob/main/skills/requirements-scoping/SKILL.md"
click node_estimation "https://github.com/proyecto26/system-design-skills/blob/main/skills/back-of-the-envelope/SKILL.md"
click node_calculator "https://github.com/proyecto26/system-design-skills/blob/main/skills/back-of-the-envelope/scripts/botec.py"
click node_design_reasoning "https://github.com/proyecto26/system-design-skills/blob/main/skills/system-design/SKILL.md"
click node_edge_blocks "https://github.com/proyecto26/system-design-skills/tree/main/skills"
click node_service_blocks "https://github.com/proyecto26/system-design-skills/tree/main/skills"
click node_state_blocks "https://github.com/proyecto26/system-design-skills/tree/main/skills"
click node_async_blocks "https://github.com/proyecto26/system-design-skills/tree/main/skills"
click node_correctness_block "https://github.com/proyecto26/system-design-skills/blob/main/skills/consistency-coordination/SKILL.md"
click node_ops_blocks "https://github.com/proyecto26/system-design-skills/tree/main/skills"
click node_growth_block "https://github.com/proyecto26/system-design-skills/blob/main/skills/scaling-evolution/SKILL.md"
click node_diagram_skill "https://github.com/proyecto26/system-design-skills/blob/main/skills/architecture-diagram/SKILL.md"
click node_site_app "https://github.com/proyecto26/system-design-skills/blob/main/site/src/App.jsx"
click node_site_diagrams "https://github.com/proyecto26/system-design-skills/blob/main/site/src/diagrams.jsx"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_design_command,node_orchestrator_agent,node_system_design_skill toneBlue
class node_requirements,node_estimation,node_calculator,node_design_reasoning toneAmber
class node_edge_blocks,node_service_blocks,node_state_blocks,node_async_blocks,node_correctness_block,node_ops_blocks,node_growth_block toneMint
class node_diagram_skill,node_design_document,node_site_app,node_site_diagrams toneRose
class node_designer toneIndigo
```

## Components

### Entry points

- [/design command](https://github.com/proyecto26/system-design-skills/blob/main/commands/design.md): `commands/design.md`
- [Orchestrator agent](https://github.com/proyecto26/system-design-skills/blob/main/agents/system-design-orchestrator.md): `agents/system-design-orchestrator.md`
- [System-design skill](https://github.com/proyecto26/system-design-skills/blob/main/skills/system-design/SKILL.md): `skills/system-design/SKILL.md`

### Design method

- [Requirements scoping](https://github.com/proyecto26/system-design-skills/blob/main/skills/requirements-scoping/SKILL.md): `skills/requirements-scoping/SKILL.md`
- [Back-of-envelope](https://github.com/proyecto26/system-design-skills/blob/main/skills/back-of-the-envelope/SKILL.md): `skills/back-of-the-envelope/SKILL.md`
- [Sizing calculator](https://github.com/proyecto26/system-design-skills/blob/main/skills/back-of-the-envelope/scripts/botec.py): `skills/back-of-the-envelope/scripts/botec.py`
- [Design and iteration](https://github.com/proyecto26/system-design-skills/blob/main/skills/system-design/SKILL.md): `skills/system-design/SKILL.md`

### Building blocks

- [Edge blocks](https://github.com/proyecto26/system-design-skills/tree/main/skills): `skills`
- [Service blocks](https://github.com/proyecto26/system-design-skills/tree/main/skills): `skills`
- [State blocks](https://github.com/proyecto26/system-design-skills/tree/main/skills): `skills`
- [Async blocks](https://github.com/proyecto26/system-design-skills/tree/main/skills): `skills`
- [Correctness block](https://github.com/proyecto26/system-design-skills/blob/main/skills/consistency-coordination/SKILL.md): `skills/consistency-coordination/SKILL.md`
- [Operations blocks](https://github.com/proyecto26/system-design-skills/tree/main/skills): `skills`
- [Growth block](https://github.com/proyecto26/system-design-skills/blob/main/skills/scaling-evolution/SKILL.md): `skills/scaling-evolution/SKILL.md`

### Design outputs

- [Architecture diagram](https://github.com/proyecto26/system-design-skills/blob/main/skills/architecture-diagram/SKILL.md): `skills/architecture-diagram/SKILL.md`
- **Scored design document**
- [Onboarding presentation](https://github.com/proyecto26/system-design-skills/blob/main/site/src/App.jsx): `site/src/App.jsx`
- [Presentation diagrams](https://github.com/proyecto26/system-design-skills/blob/main/site/src/diagrams.jsx): `site/src/diagrams.jsx`

### Other components

- **Designer**

## Connections

- Designer → /design command: starts design (evidence: `README.md`)
- Designer → System-design skill: asks conversationally (evidence: `README.md`)
- Designer → Edge blocks: asks one question (evidence: `README.md`)
- /design command → Orchestrator agent: dispatches optionally (evidence: `README.md`)
- /design command → Requirements scoping: runs workflow (evidence: `README.md`)
- /design command → Back-of-envelope: runs workflow (evidence: `README.md`)
- /design command → Edge blocks: invokes blocks (evidence: `README.md`)
- /design command → Architecture diagram: renders design (evidence: `README.md`)
- /design command → Scored design document: scores and persists (evidence: `README.md`)
- System-design skill → Requirements scoping: clarifies scope (evidence: `README.md`)
- System-design skill → Back-of-envelope: sizes design (evidence: `README.md`)
- System-design skill → Edge blocks: routes to blocks (evidence: `README.md`)
- System-design skill → Design and iteration: iterates trade-offs (evidence: `README.md`)
- Back-of-envelope → Sizing calculator: can calculate (evidence: `README.md`)
- Design and iteration → Architecture diagram: renders architecture (evidence: `README.md`)
- Architecture diagram → Scored design document: produces diagram (evidence: `README.md`)
- Onboarding presentation → Presentation diagrams: renders diagrams (evidence: `site/src/App.jsx`)
