# woffluon/system-design-compass architecture

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

- Interactive diagram: https://gitdiagram.com/woffluon/system-design-compass
- Repository: https://github.com/woffluon/system-design-compass

## Overview

System Design Compass is a portable Agent Skill: it guides a coding agent through system design, architecture review, safe evolution, focused decisions, and interview practice. The main workflow is to invoke the skill with a decision and available evidence; its entrypoint selects a mode and loads relevant guidance, which shapes an evidence-based recommendation and validation. The graph emphasizes the documented skill surface and its reference guides. Source excerpts chiefly cover evaluation utilities, so internal routing details beyond the README are not verified.

Main entry points: [`skills/system-design-compass/SKILL.md`](https://github.com/woffluon/system-design-compass/blob/main/skills/system-design-compass/SKILL.md) (Skill entrypoint), [`skills/system-design-compass/references/design.md`](https://github.com/woffluon/system-design-compass/blob/main/skills/system-design-compass/references/design.md) (Design workflow), [`skills/system-design-compass/references/review.md`](https://github.com/woffluon/system-design-compass/blob/main/skills/system-design-compass/references/review.md) (Review workflow), [`skills/system-design-compass/references/evolve.md`](https://github.com/woffluon/system-design-compass/blob/main/skills/system-design-compass/references/evolve.md) (Evolution workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Skill entry"]
  node_skill["Skill entrypoint<br/>[SKILL.md]"]
end

subgraph group_workflows["Decision workflows"]
  node_design["Design workflow<br/>[design.md]"]
  node_review["Review workflow<br/>[review.md]"]
  node_evolve["Evolution workflow<br/>[evolve.md]"]
  node_interview["Interview practice<br/>[interview.md]"]
end

subgraph group_guidance["Design guidance"]
  node_requirements["Requirements estimation"]
  node_interfaces["Interfaces data<br/>[interfaces-data.md]"]
  node_distributed["Distributed systems"]
  node_readiness["Production readiness"]
  node_validation["Decision validation"]
  node_deliverables["Deliverables diagrams"]
end

subgraph group_catalogs["Workload catalogs"]
  node_foundations["Foundations platform"]
  node_realtime["User-facing realtime"]
  node_infrastructure["Data infrastructure"]
  node_transactional["Transactional financial"]
end

node_agent(("Coding agent"))

node_agent -->|"invokes"| node_skill
node_skill -->|"routes to"| node_design
node_skill -->|"routes to"| node_review
node_skill -->|"routes to"| node_evolve
node_skill -->|"routes to"| node_interview
node_skill -->|"loads as needed"| node_requirements
node_skill -->|"loads as needed"| node_interfaces
node_skill -->|"loads as needed"| node_distributed
node_skill -->|"loads as needed"| node_readiness
node_skill -->|"loads as needed"| node_validation
node_skill -->|"loads as needed"| node_deliverables
node_skill -->|"selects catalog"| node_foundations
node_skill -->|"selects catalog"| node_realtime
node_skill -->|"selects catalog"| node_infrastructure
node_skill -->|"selects catalog"| node_transactional

click node_skill "https://github.com/woffluon/system-design-compass/blob/main/skills/system-design-compass/SKILL.md"
click node_design "https://github.com/woffluon/system-design-compass/blob/main/skills/system-design-compass/references/design.md"
click node_review "https://github.com/woffluon/system-design-compass/blob/main/skills/system-design-compass/references/review.md"
click node_evolve "https://github.com/woffluon/system-design-compass/blob/main/skills/system-design-compass/references/evolve.md"
click node_interview "https://github.com/woffluon/system-design-compass/blob/main/skills/system-design-compass/references/interview.md"
click node_requirements "https://github.com/woffluon/system-design-compass/blob/main/skills/system-design-compass/references/requirements-estimation.md"
click node_interfaces "https://github.com/woffluon/system-design-compass/blob/main/skills/system-design-compass/references/interfaces-data.md"
click node_distributed "https://github.com/woffluon/system-design-compass/blob/main/skills/system-design-compass/references/distributed-systems.md"
click node_readiness "https://github.com/woffluon/system-design-compass/blob/main/skills/system-design-compass/references/production-readiness.md"
click node_validation "https://github.com/woffluon/system-design-compass/blob/main/skills/system-design-compass/references/decision-validation.md"
click node_deliverables "https://github.com/woffluon/system-design-compass/blob/main/skills/system-design-compass/references/deliverables-diagrams.md"
click node_foundations "https://github.com/woffluon/system-design-compass/blob/main/skills/system-design-compass/references/archetypes-foundations-platform.md"
click node_realtime "https://github.com/woffluon/system-design-compass/blob/main/skills/system-design-compass/references/archetypes-user-facing-realtime.md"
click node_infrastructure "https://github.com/woffluon/system-design-compass/blob/main/skills/system-design-compass/references/archetypes-data-infrastructure.md"
click node_transactional "https://github.com/woffluon/system-design-compass/blob/main/skills/system-design-compass/references/archetypes-transactional-financial.md"

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_skill toneBlue
class node_design,node_review,node_evolve,node_interview toneAmber
class node_requirements,node_interfaces,node_distributed,node_readiness,node_validation,node_deliverables toneMint
class node_foundations,node_realtime,node_infrastructure,node_transactional toneRose
class node_agent toneIndigo
```

## Components

### Skill entry

- [Skill entrypoint](https://github.com/woffluon/system-design-compass/blob/main/skills/system-design-compass/SKILL.md): `skills/system-design-compass/SKILL.md`

### Decision workflows

- [Design workflow](https://github.com/woffluon/system-design-compass/blob/main/skills/system-design-compass/references/design.md): `skills/system-design-compass/references/design.md`
- [Review workflow](https://github.com/woffluon/system-design-compass/blob/main/skills/system-design-compass/references/review.md): `skills/system-design-compass/references/review.md`
- [Evolution workflow](https://github.com/woffluon/system-design-compass/blob/main/skills/system-design-compass/references/evolve.md): `skills/system-design-compass/references/evolve.md`
- [Interview practice](https://github.com/woffluon/system-design-compass/blob/main/skills/system-design-compass/references/interview.md): `skills/system-design-compass/references/interview.md`

### Design guidance

- [Requirements estimation](https://github.com/woffluon/system-design-compass/blob/main/skills/system-design-compass/references/requirements-estimation.md): `skills/system-design-compass/references/requirements-estimation.md`
- [Interfaces data](https://github.com/woffluon/system-design-compass/blob/main/skills/system-design-compass/references/interfaces-data.md): `skills/system-design-compass/references/interfaces-data.md`
- [Distributed systems](https://github.com/woffluon/system-design-compass/blob/main/skills/system-design-compass/references/distributed-systems.md): `skills/system-design-compass/references/distributed-systems.md`
- [Production readiness](https://github.com/woffluon/system-design-compass/blob/main/skills/system-design-compass/references/production-readiness.md): `skills/system-design-compass/references/production-readiness.md`
- [Decision validation](https://github.com/woffluon/system-design-compass/blob/main/skills/system-design-compass/references/decision-validation.md): `skills/system-design-compass/references/decision-validation.md`
- [Deliverables diagrams](https://github.com/woffluon/system-design-compass/blob/main/skills/system-design-compass/references/deliverables-diagrams.md): `skills/system-design-compass/references/deliverables-diagrams.md`

### Workload catalogs

- [Foundations platform](https://github.com/woffluon/system-design-compass/blob/main/skills/system-design-compass/references/archetypes-foundations-platform.md): `skills/system-design-compass/references/archetypes-foundations-platform.md`
- [User-facing realtime](https://github.com/woffluon/system-design-compass/blob/main/skills/system-design-compass/references/archetypes-user-facing-realtime.md): `skills/system-design-compass/references/archetypes-user-facing-realtime.md`
- [Data infrastructure](https://github.com/woffluon/system-design-compass/blob/main/skills/system-design-compass/references/archetypes-data-infrastructure.md): `skills/system-design-compass/references/archetypes-data-infrastructure.md`
- [Transactional financial](https://github.com/woffluon/system-design-compass/blob/main/skills/system-design-compass/references/archetypes-transactional-financial.md): `skills/system-design-compass/references/archetypes-transactional-financial.md`

### Other components

- **Coding agent**

## Connections

- Coding agent → Skill entrypoint: invokes (evidence: `README.md`)
- Skill entrypoint → Design workflow: routes to (evidence: `README.md`)
- Skill entrypoint → Review workflow: routes to (evidence: `README.md`)
- Skill entrypoint → Evolution workflow: routes to (evidence: `README.md`)
- Skill entrypoint → Interview practice: routes to (evidence: `README.md`)
- Skill entrypoint → Requirements estimation: loads as needed (evidence: `README.md`)
- Skill entrypoint → Interfaces data: loads as needed (evidence: `README.md`)
- Skill entrypoint → Distributed systems: loads as needed (evidence: `README.md`)
- Skill entrypoint → Production readiness: loads as needed (evidence: `README.md`)
- Skill entrypoint → Decision validation: loads as needed (evidence: `README.md`)
- Skill entrypoint → Deliverables diagrams: loads as needed (evidence: `README.md`)
- Skill entrypoint → Foundations platform: selects catalog (evidence: `README.md`)
- Skill entrypoint → User-facing realtime: selects catalog (evidence: `README.md`)
- Skill entrypoint → Data infrastructure: selects catalog (evidence: `README.md`)
- Skill entrypoint → Transactional financial: selects catalog (evidence: `README.md`)
