system-design-primer-skill 1.2.0 → 2.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +106 -60
- package/SKILL.md +417 -93
- package/VERSION +1 -1
- package/package.json +44 -3
- package/references/10-workflows-and-checklists.md +1 -1
- package/references/13-architecture-intelligence.md +91 -0
- package/references/14-api-and-data-contracts.md +80 -0
- package/references/15-failure-analysis.md +84 -0
- package/references/16-multi-agent-architecture.md +76 -0
- package/references/17-agent-harness-and-runtime.md +87 -0
- package/references/18-mcp-architecture.md +67 -0
- package/references/19-agent-security-and-permissions.md +74 -0
- package/references/20-agent-state-and-memory.md +72 -0
- package/references/21-agent-evaluation-and-observability.md +90 -0
- package/references/22-kubernetes-and-container-platforms.md +29 -0
- package/references/23-service-mesh-and-traffic-management.md +21 -0
- package/references/24-multi-region-and-disaster-recovery.md +24 -0
- package/references/25-platform-engineering-and-developer-experience.md +26 -0
- package/references/26-finops-and-cloud-cost.md +29 -0
- package/references/27-production-observability-and-slo.md +29 -0
- package/references/28-event-streaming-and-kafka-pulsar.md +27 -0
- package/references/29-event-sourcing-and-cqrs.md +23 -0
- package/references/30-change-data-capture-and-debezium.md +27 -0
- package/references/31-data-lakehouse-and-stream-batch.md +24 -0
- package/references/32-workflow-orchestration-and-temporal.md +24 -0
- package/references/33-schema-registry-and-event-governance.md +22 -0
- package/references/34-postgresql-internals-and-performance.md +43 -0
- package/references/35-mysql-innodb-and-performance.md +27 -0
- package/references/36-sharding-and-distributed-sql.md +22 -0
- package/references/37-consensus-and-distributed-transactions.md +25 -0
- package/references/38-search-architecture-elasticsearch-opensearch.md +24 -0
- package/references/39-vector-databases-and-hybrid-retrieval.md +31 -0
- package/references/40-zero-downtime-database-migrations.md +27 -0
- package/references/41-api-gateway-and-edge-architecture.md +23 -0
- package/references/42-rest-api-design-and-lifecycle.md +23 -0
- package/references/43-graphql-architecture-and-governance.md +16 -0
- package/references/44-grpc-and-service-contracts.md +16 -0
- package/references/45-websocket-sse-and-realtime-systems.md +16 -0
- package/references/46-realtime-collaboration-ot-crdt.md +16 -0
- package/references/47-api-security-rate-limiting-and-abuse.md +16 -0
- package/references/48-oauth-oidc-and-passkeys.md +20 -0
- package/references/49-iam-rbac-abac-rebac.md +16 -0
- package/references/50-zero-trust-and-workload-identity.md +16 -0
- package/references/51-secrets-kms-pki-and-key-management.md +16 -0
- package/references/52-supply-chain-security-sbom-slsa.md +16 -0
- package/references/53-threat-modeling-stride-and-attack-trees.md +16 -0
- package/references/54-privacy-engineering-and-data-governance.md +16 -0
- package/references/55-opentelemetry-and-instrumentation.md +50 -0
- package/references/56-distributed-tracing-and-context-propagation.md +43 -0
- package/references/57-continuous-profiling-and-performance-diagnostics.md +45 -0
- package/references/58-load-stress-soak-testing-and-workload-modeling.md +44 -0
- package/references/59-capacity-planning-and-performance-modeling.md +34 -0
- package/references/60-chaos-engineering-and-resilience-experiments.md +41 -0
- package/references/61-incident-management-and-postmortems.md +34 -0
- package/references/62-dns-and-service-discovery.md +35 -0
- package/references/63-load-balancing-and-global-traffic-management.md +31 -0
- package/references/64-cdn-and-edge-caching.md +34 -0
- package/references/65-cloud-networking-and-connectivity.md +34 -0
- package/references/66-edge-computing-architecture.md +33 -0
- package/references/67-storage-infrastructure-and-storage-systems.md +30 -0
- package/references/68-tcp-quic-and-network-performance.md +27 -0
- package/references/69-task-routing-and-evidence.md +58 -0
- package/scripts/install.ps1 +10 -1
- package/scripts/install.sh +13 -6
- package/scripts/validate.py +133 -0
- package/templates/agent-evaluation-plan-template.md +57 -0
- package/templates/agent-security-review-template.md +46 -0
- package/templates/agent-system-design-template.md +74 -0
- package/templates/api-architecture-design-template.md +33 -0
- package/templates/api-security-and-rate-limit-review-template.md +29 -0
- package/templates/architecture-decision-matrix-template.md +48 -0
- package/templates/architecture-review-scorecard-template.md +36 -0
- package/templates/cdc-data-pipeline-template.md +41 -0
- package/templates/cdn-and-edge-strategy-template.md +36 -0
- package/templates/chaos-experiment-template.md +39 -0
- package/templates/cloud-cost-model-template.md +37 -0
- package/templates/database-architecture-review-template.md +33 -0
- package/templates/edge-computing-readiness-template.md +36 -0
- package/templates/event-sourcing-cqrs-template.md +41 -0
- package/templates/event-streaming-design-template.md +47 -0
- package/templates/failure-analysis-template.md +36 -0
- package/templates/identity-and-access-architecture-template.md +29 -0
- package/templates/incident-postmortem-template.md +39 -0
- package/templates/multi-region-disaster-recovery-template.md +43 -0
- package/templates/network-architecture-design-template.md +38 -0
- package/templates/observability-architecture-template.md +52 -0
- package/templates/performance-test-plan-template.md +52 -0
- package/templates/privacy-data-governance-template.md +24 -0
- package/templates/production-readiness-checklist-template.md +52 -0
- package/templates/realtime-system-design-template.md +28 -0
- package/templates/security-threat-model-template.md +26 -0
- package/templates/sharding-distributed-sql-design-template.md +34 -0
- package/templates/storage-architecture-design-template.md +35 -0
- package/templates/supply-chain-security-review-template.md +20 -0
- package/templates/zero-downtime-database-migration-template.md +32 -0
package/README.md
CHANGED
|
@@ -2,106 +2,132 @@
|
|
|
2
2
|
|
|
3
3
|
 
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
An installable Agent Skill for software architecture design, architecture reviews, performance optimization, technology evaluation, and migration planning. It uses Donne Martin's System Design Primer as its knowledge foundation and adds modern production engineering practices.
|
|
6
6
|
|
|
7
|
-
-
|
|
8
|
-
-
|
|
9
|
-
-
|
|
7
|
+
- **Version:** 2.3.0
|
|
8
|
+
- **Language:** English, with standard technical terminology
|
|
9
|
+
- **Runtime dependencies:** The Skill itself has no third-party runtime dependencies. Installation and validation require only Bash, PowerShell, or Python 3.
|
|
10
10
|
|
|
11
|
-
##
|
|
11
|
+
## Repository structure
|
|
12
12
|
|
|
13
13
|
system-design-primer/
|
|
14
14
|
├── SKILL.md
|
|
15
15
|
├── README.md / ATTRIBUTION.md / LICENSE / VERSION
|
|
16
|
-
├── references/
|
|
17
|
-
├── templates/
|
|
18
|
-
└── scripts/ Linux/macOS
|
|
16
|
+
├── references/ 70 progressive knowledge references
|
|
17
|
+
├── templates/ Design, review, ADR, decision, scorecard, failure, agent, production-readiness, disaster-recovery, FinOps, event-streaming, event-sourcing, CDC, database architecture, sharding, zero-downtime migration, API architecture, real-time systems, identity, threat modeling, supply chain, privacy, observability, performance testing, chaos engineering, incident response, network architecture, CDN/edge strategy, storage architecture, and edge computing templates
|
|
18
|
+
└── scripts/ Linux/macOS and Windows installers and validators
|
|
19
19
|
|
|
20
|
-
##
|
|
20
|
+
## Quality, task routing, and evaluation
|
|
21
21
|
|
|
22
|
-
|
|
22
|
+
Version 2.3.0 adds an evidence-first task-routing guide, explicit reference-loading paths, repository-review traceability rules, and a compact regression case set for design, review, optimization, security, and migration tasks. The validator checks the evaluation dataset structure and keeps the README, Skill metadata, package manifest, changelog, and VERSION aligned.
|
|
23
23
|
|
|
24
|
-
|
|
24
|
+
Run the regression cases as review prompts when changing routing instructions or output contracts; they are test fixtures, not claims that an LLM has passed a behavioral benchmark.
|
|
25
25
|
|
|
26
|
-
##
|
|
26
|
+
## Observability and performance engineering
|
|
27
27
|
|
|
28
|
-
|
|
28
|
+
Version 2.1.0 adds OpenTelemetry instrumentation and Collector architecture, distributed tracing and context propagation, continuous profiling, realistic load/stress/soak workload models, capacity planning, controlled chaos experiments, and incident management/postmortems. Four templates support observability architecture, performance test plans, chaos experiments, and incident postmortems.
|
|
29
29
|
|
|
30
|
-
|
|
30
|
+
## Networking, edge, and infrastructure architecture
|
|
31
|
+
|
|
32
|
+
Version 2.2.0 adds DNS and service discovery, load balancing and global traffic management, CDN and edge caching, cloud networking and connectivity, edge computing, storage infrastructure, and TCP/QUIC performance engineering. Four templates support network architecture, CDN/edge strategy, storage design, and edge readiness reviews.
|
|
33
|
+
|
|
34
|
+
## Downloads
|
|
35
|
+
|
|
36
|
+
We recommend downloading the versioned ZIP from [GitHub Releases](https://github.com/jack-001-a/system-design-primer-skill/releases). You can also download the source ZIP from the [main branch](https://github.com/jack-001-a/system-design-primer-skill/archive/refs/heads/main.zip).
|
|
37
|
+
|
|
38
|
+
The release ZIP contains a `system-design-primer/` directory, an embedded `MANIFEST.sha256.json`, and a matching `.sha256` checksum file. Checksums use SHA-256. A Release is published only after the Git tag matches `VERSION` and CI passes.
|
|
39
|
+
|
|
40
|
+
## Install via npm
|
|
41
|
+
|
|
42
|
+
This project is also published as the npm package `system-design-primer-skill`. The package includes `SKILL.md`, 70 reference documents, templates, and cross-platform installation scripts, with no third-party runtime dependencies.
|
|
43
|
+
|
|
44
|
+
Run the following in the target project root:
|
|
31
45
|
|
|
32
46
|
npm install --save-dev system-design-primer-skill skills
|
|
33
47
|
npx skills experimental_sync --yes
|
|
34
48
|
|
|
35
|
-
`skills experimental_sync`
|
|
49
|
+
`skills experimental_sync` discovers the `SKILL.md` at the root of installed npm dependencies and links the Skill into the current project's Agent Skill directory. To specify a host, append `--agent codex`, `--agent claude-code`, or another supported Agent identifier. This sync command is currently an experimental feature of the Skills CLI; consult its latest documentation for supported hosts and behavior.
|
|
36
50
|
|
|
37
|
-
|
|
51
|
+
You can also install directly from GitHub without npm:
|
|
38
52
|
|
|
39
53
|
npx skills add jack-001-a/system-design-primer-skill
|
|
40
54
|
|
|
41
|
-
npm
|
|
55
|
+
npm package: [system-design-primer-skill](https://www.npmjs.com/package/system-design-primer-skill).
|
|
42
56
|
|
|
43
|
-
##
|
|
57
|
+
## Supported Agent directories
|
|
44
58
|
|
|
45
|
-
| Agent |
|
|
59
|
+
| Agent | Project-level directory | User-level directory |
|
|
46
60
|
|---|---|---|
|
|
47
|
-
|
|
|
48
|
-
|
|
|
49
|
-
|
|
|
50
|
-
|
|
|
61
|
+
| DeepSeek Harness (DSH) | `.dsh/skills/` | `~/.dsh/skills/` |
|
|
62
|
+
| OpenAI Codex | `.agents/skills/` | `~/.agents/skills/` |
|
|
63
|
+
| Claude Code | `.claude/skills/` | `~/.claude/skills/` |
|
|
64
|
+
| Cursor | `.cursor/skills/` or `.agents/skills/` | `~/.cursor/skills/` or `~/.agents/skills/` |
|
|
65
|
+
| GitHub Copilot | `.github/skills/`, `.claude/skills/`, or `.agents/skills/` | `~/.copilot/skills/` |
|
|
66
|
+
|
|
67
|
+
DeepSeek Harness's filesystem Skill provider discovers directory bundles containing `<skill-name>/SKILL.md` under `.dsh/skills` in a project or `$DSH_HOME/skills` for a user. If `DSH_HOME` is unset, the user-level default is `~/.dsh`. The Skill bundle format used here is compatible; the references and templates remain alongside `SKILL.md`. DSH also scans `.agents/skills` for shared Agent Skills. When the same Skill is installed in both locations, DSH's documented source ranking prefers the native `.dsh/skills` copy; use `--agent dsh` for a DSH-only install if you want to avoid registering a duplicate copy with other hosts.
|
|
51
68
|
|
|
52
|
-
Cursor Cloud Agents
|
|
69
|
+
For Cursor Cloud Agents, install personal Skills in `~/.cursor/skills/` and enable **Sync Skills** in Cursor Settings → Agents. The `~/.agents/skills/` directory may be discovered by local Cursor installations for compatibility, but it does not automatically sync to Cloud Agents. Project-level Skills can live in `.cursor/skills/` or `.agents/skills/` in the repository.
|
|
53
70
|
|
|
54
|
-
|
|
71
|
+
For GitHub Copilot Cloud Agent, personal Skills must be placed in the `.copilot/skills/` directory of a personal dotfiles repository, and that dotfiles repository must be configured in Copilot Cloud settings. This applies to cloud sandboxes, not GitHub Actions sessions. See [Cursor Cloud Skills](https://cursor.com/docs/skills) and [GitHub Copilot Cloud sessions](https://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/personalize-cloud-sessions).
|
|
55
72
|
|
|
56
|
-
|
|
73
|
+
Directory references: [Codex Skills guide](https://learn.chatgpt.com/docs/build-skills), [Claude Agent Skills](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview), [Cursor Skills](https://cursor.com/docs/skills), [GitHub Copilot Skills](https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-skills), and [DeepSeek Harness Skills](https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/subsystems/skills.md).
|
|
57
74
|
|
|
58
|
-
|
|
75
|
+
## Installation
|
|
76
|
+
|
|
77
|
+
Extract the ZIP first. **Run the installation command from the root of the target code repository**; the script determines the project-level installation location from the current directory. The examples below assume the extracted folder is `/opt/system-design-primer`.
|
|
59
78
|
|
|
60
79
|
### macOS / Linux
|
|
61
80
|
|
|
62
81
|
cd /path/to/your-project
|
|
63
82
|
|
|
64
|
-
#
|
|
83
|
+
# Install for DeepSeek Harness only
|
|
84
|
+
bash /opt/system-design-primer/scripts/install.sh --agent dsh --scope project
|
|
85
|
+
|
|
86
|
+
# Install for Codex only
|
|
65
87
|
bash /opt/system-design-primer/scripts/install.sh --agent codex --scope project
|
|
66
88
|
|
|
67
|
-
#
|
|
89
|
+
# Install for Claude Code only
|
|
68
90
|
bash /opt/system-design-primer/scripts/install.sh --agent claude --scope project
|
|
69
91
|
|
|
70
|
-
#
|
|
92
|
+
# Install for Cursor only (uses the Cursor-specific directory)
|
|
71
93
|
bash /opt/system-design-primer/scripts/install.sh --agent cursor --scope project
|
|
72
94
|
|
|
73
|
-
#
|
|
95
|
+
# Install for GitHub Copilot only
|
|
74
96
|
bash /opt/system-design-primer/scripts/install.sh --agent copilot --scope project
|
|
75
97
|
|
|
76
|
-
#
|
|
98
|
+
# Install for multiple hosts at once, including DeepSeek Harness
|
|
77
99
|
bash /opt/system-design-primer/scripts/install.sh --agent all --scope project
|
|
78
100
|
|
|
79
|
-
#
|
|
101
|
+
# Install into the current user's home directory
|
|
80
102
|
bash /opt/system-design-primer/scripts/install.sh --agent all --scope user
|
|
81
103
|
|
|
104
|
+
# Install DSH under a custom DSH_HOME root (contains the skills/ directory)
|
|
105
|
+
DSH_HOME="$HOME/.config/deepseek-harness" bash /opt/system-design-primer/scripts/install.sh --agent dsh --scope user
|
|
106
|
+
|
|
82
107
|
### Windows PowerShell
|
|
83
108
|
|
|
84
109
|
Set-Location C:\path\to\your-project
|
|
85
110
|
|
|
86
|
-
#
|
|
87
|
-
& C:\path\to\system-design-primer\scripts\install.ps1 -Agent
|
|
111
|
+
# Choose dsh, codex, claude, cursor, copilot, or all as needed
|
|
112
|
+
& C:\path\to\system-design-primer\scripts\install.ps1 -Agent dsh -Scope project
|
|
88
113
|
|
|
89
|
-
#
|
|
114
|
+
# Install into the user-level directories for all supported hosts
|
|
90
115
|
& C:\path\to\system-design-primer\scripts\install.ps1 -Agent all -Scope user
|
|
91
116
|
|
|
92
|
-
##
|
|
117
|
+
## Installer behavior and security
|
|
93
118
|
|
|
94
|
-
-
|
|
95
|
-
-
|
|
96
|
-
-
|
|
97
|
-
-
|
|
98
|
-
-
|
|
99
|
-
-
|
|
100
|
-
-
|
|
119
|
+
- Existing Skills are not overwritten by default. Use `--force` or `-Force` explicitly to update them.
|
|
120
|
+
- `--dry-run` / `-WhatIf` previews target paths without creating or modifying files.
|
|
121
|
+
- The installer checks all targets first, then stages replacements in a same-directory staging folder. If installation fails, it makes a best effort to restore the previous directory.
|
|
122
|
+
- It copies only `SKILL.md`, `references`, `templates`, `scripts`, `ATTRIBUTION.md`, `LICENSE`, and `VERSION`. It does not copy `.git`, GitHub Actions, tests, or development tools.
|
|
123
|
+
- With `--agent all`, project-level targets are `.dsh/skills`, `.agents/skills`, `.claude/skills`, and `.github/skills`; user-level targets are `$DSH_HOME/skills`, `~/.agents/skills`, `~/.claude/skills`, and `~/.copilot/skills`. If `DSH_HOME` is unset, the DSH root defaults to `~/.dsh`.
|
|
124
|
+
- DeepSeek Harness scans both its native `.dsh/skills` directory and the shared `.agents/skills` directory. Installing with `--agent all` therefore makes the same Skill available through both discovery paths; DSH's source ranking prefers the native DSH copy. Use `--agent dsh` when only DSH should discover this installation.
|
|
125
|
+
- Cursor can also discover `.agents/skills` and `.claude/skills` for compatibility. If multiple hosts are enabled, prefer the corresponding single-host installation option to avoid duplicate discovery of the same Skill.
|
|
126
|
+
- The installation scripts do not install dependencies or automatically execute scripts included in the Skill.
|
|
101
127
|
|
|
102
|
-
##
|
|
128
|
+
## Validation and development
|
|
103
129
|
|
|
104
|
-
|
|
130
|
+
Run the following from the repository root:
|
|
105
131
|
|
|
106
132
|
python scripts/validate.py
|
|
107
133
|
python -m unittest discover -s tests -v
|
|
@@ -109,27 +135,47 @@ Cursor Cloud Agents 个人 Skill 应安装到 `~/.cursor/skills/` 并在 Cursor
|
|
|
109
135
|
bash tests/test_install.sh
|
|
110
136
|
python tools/package.py --output-dir dist
|
|
111
137
|
|
|
112
|
-
Windows
|
|
138
|
+
On Windows, you can also run:
|
|
113
139
|
|
|
114
140
|
.\tests\test_install.ps1
|
|
115
141
|
|
|
116
|
-
GitHub Actions
|
|
142
|
+
GitHub Actions runs validation and tests on Ubuntu, macOS, and Windows. Formal releases are triggered only by version tags: update `VERSION` and `CHANGELOG.md`, merge into `main`, wait for CI to pass, and then create a `v*` tag that exactly matches `VERSION`. The Release workflow validates on all three platforms before building the ZIP, generating SHA-256 checksums, and publishing the GitHub Release. Branches matching `release/**` do not trigger formal releases directly.
|
|
143
|
+
|
|
144
|
+
## Usage examples
|
|
145
|
+
|
|
146
|
+
Use the system-design-primer Skill to review this repository's overall architecture.
|
|
147
|
+
Focus on critical business flows, data models, transaction boundaries, caching,
|
|
148
|
+
asynchronous jobs, reliability, security, and observability. Sort findings by
|
|
149
|
+
severity and include file-level evidence. Review only; do not modify code.
|
|
150
|
+
|
|
151
|
+
Use the system-design-primer Skill to design a multi-tenant subscription billing system.
|
|
152
|
+
First clarify FRs/NFRs, capacity assumptions, data models, idempotency, reconciliation,
|
|
153
|
+
and failure recovery. Then provide an architecture diagram, alternatives, an ADR,
|
|
154
|
+
and a phased rollout plan.
|
|
155
|
+
|
|
156
|
+
Use the system-design-primer Skill to design a multi-agent research assistant.
|
|
157
|
+
Compare a single-agent baseline with supervisor/worker and pipeline topologies.
|
|
158
|
+
Define agent contracts, tool permissions, MCP boundaries, checkpoint/recovery,
|
|
159
|
+
evaluation datasets, and measurable quality, latency, and cost objectives.
|
|
160
|
+
|
|
161
|
+
## Attribution and license
|
|
162
|
+
|
|
163
|
+
This is an independent, unofficial Skill. Its knowledge topics are based on [Donne Martin/System Design Primer](https://github.com/donnemartin/system-design-primer), with original workflows and modern engineering practices added. Original explanations, templates, and reference text are licensed under CC BY 4.0. Third-party linked content remains under its respective copyright and license; see [ATTRIBUTION.md](ATTRIBUTION.md) for details.
|
|
164
|
+
|
|
165
|
+
Architecture decision matrices, evidence-based review scorecards, API/data contracts, and failure-analysis workflows are documented in [references/13-architecture-intelligence.md](references/13-architecture-intelligence.md), [references/14-api-and-data-contracts.md](references/14-api-and-data-contracts.md), and [references/15-failure-analysis.md](references/15-failure-analysis.md). Matching fill-in templates are available under `templates/`.
|
|
166
|
+
|
|
167
|
+
For in-depth AI systems architecture, see [references/12-ai-systems-architecture.md](references/12-ai-systems-architecture.md). Agent-specific architecture guidance is split into [multi-agent architecture](references/16-multi-agent-architecture.md), [agent harness and runtime](references/17-agent-harness-and-runtime.md), [MCP architecture](references/18-mcp-architecture.md), [agent security and permissions](references/19-agent-security-and-permissions.md), [agent state and memory](references/20-agent-state-and-memory.md), and [agent evaluation and observability](references/21-agent-evaluation-and-observability.md). Use the matching templates in `templates/` to create a system design, security review, or evaluation plan.
|
|
168
|
+
|
|
169
|
+
Production architecture guidance covers [Kubernetes and container platforms](references/22-kubernetes-and-container-platforms.md), [service mesh and traffic management](references/23-service-mesh-and-traffic-management.md), [multi-region architecture and disaster recovery](references/24-multi-region-and-disaster-recovery.md), [platform engineering](references/25-platform-engineering-and-developer-experience.md), [FinOps and cloud cost](references/26-finops-and-cloud-cost.md), and [production observability and SLOs](references/27-production-observability-and-slo.md). Matching templates support production readiness reviews, multi-region recovery plans, and cloud cost models.
|
|
117
170
|
|
|
118
|
-
|
|
171
|
+
Data-intensive and event-driven architecture guidance covers [Kafka and Pulsar event streaming](references/28-event-streaming-and-kafka-pulsar.md), [Event Sourcing and CQRS](references/29-event-sourcing-and-cqrs.md), [CDC and Debezium](references/30-change-data-capture-and-debezium.md), [data lakehouse and stream/batch processing](references/31-data-lakehouse-and-stream-batch.md), [durable workflow orchestration](references/32-workflow-orchestration-and-temporal.md), and [schema registry and event governance](references/33-schema-registry-and-event-governance.md). Matching templates support event-streaming designs, event-sourced domains, and CDC data pipelines.
|
|
119
172
|
|
|
120
|
-
|
|
121
|
-
重点分析关键业务流、数据模型、事务边界、缓存、异步任务、
|
|
122
|
-
可靠性、安全和可观测性。按严重程度排序,每条发现附文件证据。
|
|
123
|
-
先只审查,不要修改代码。
|
|
173
|
+
API and real-time architecture guidance covers [API gateway and edge architecture](references/41-api-gateway-and-edge-architecture.md), [REST API design and lifecycle](references/42-rest-api-design-and-lifecycle.md), [GraphQL architecture](references/43-graphql-architecture-and-governance.md), [gRPC and service contracts](references/44-grpc-and-service-contracts.md), [WebSocket, SSE, and real-time systems](references/45-websocket-sse-and-realtime-systems.md), [real-time collaboration with OT/CRDT](references/46-realtime-collaboration-ot-crdt.md), and [API security, rate limiting, and abuse prevention](references/47-api-security-rate-limiting-and-abuse.md). Matching templates support API design, real-time system design, and API security reviews.\n\nDatabase and distributed-data guidance covers [PostgreSQL internals and performance](references/34-postgresql-internals-and-performance.md), [MySQL/InnoDB](references/35-mysql-innodb-and-performance.md), [sharding and Distributed SQL](references/36-sharding-and-distributed-sql.md), [consensus and distributed transactions](references/37-consensus-and-distributed-transactions.md), [Elasticsearch/OpenSearch search architecture](references/38-search-architecture-elasticsearch-opensearch.md), [vector databases and hybrid retrieval](references/39-vector-databases-and-hybrid-retrieval.md), and [zero-downtime database migrations](references/40-zero-downtime-database-migrations.md). Matching templates support database architecture reviews, sharding decisions, and migration plans.
|
|
124
174
|
|
|
125
|
-
使用 system-design-primer Skill 设计多租户订阅计费系统。
|
|
126
|
-
先明确 FR/NFR、容量假设、数据模型、幂等、对账和失败恢复,
|
|
127
|
-
再给出架构图、替代方案、ADR 和分阶段上线计划。
|
|
128
175
|
|
|
129
|
-
## 归属与许可
|
|
130
176
|
|
|
131
|
-
|
|
177
|
+
Networking and infrastructure architecture guidance covers [DNS and service discovery](references/62-dns-and-service-discovery.md), [load balancing and global traffic management](references/63-load-balancing-and-global-traffic-management.md), [CDN and edge caching](references/64-cdn-and-edge-caching.md), [cloud networking and connectivity](references/65-cloud-networking-and-connectivity.md), [edge computing](references/66-edge-computing-architecture.md), [storage infrastructure](references/67-storage-infrastructure-and-storage-systems.md), and [TCP/QUIC network performance](references/68-tcp-quic-and-network-performance.md). Matching templates support network designs, CDN strategies, storage architecture, and edge readiness.
|
|
132
178
|
|
|
133
|
-
|
|
179
|
+
Security and identity architecture guidance covers [OAuth/OIDC and passkeys](references/48-oauth-oidc-and-passkeys.md), [IAM and authorization models](references/49-iam-rbac-abac-rebac.md), [Zero Trust and workload identity](references/50-zero-trust-and-workload-identity.md), [secrets, KMS, and PKI](references/51-secrets-kms-pki-and-key-management.md), [software supply chain security](references/52-supply-chain-security-sbom-slsa.md), [STRIDE threat modeling](references/53-threat-modeling-stride-and-attack-trees.md), and [privacy engineering and data governance](references/54-privacy-engineering-and-data-governance.md). Matching templates support identity architecture, threat models, supply-chain reviews, and privacy governance.
|
|
134
180
|
|
|
135
|
-
|
|
181
|
+
For more information, see [CHANGELOG.md](CHANGELOG.md), [CONTRIBUTING.md](CONTRIBUTING.md), and [SECURITY.md](SECURITY.md).
|