Home / hoangnguyen0403 / agent-skills-standard · .claude/skills/system-design/system-design-principles/SKILL.md · GitHub

system-design-principles skillA

system-design-principles is agent-read markdown (skill) from hoangnguyen0403/agent-skills-standard: Define module boundaries, dependency direction, data ownership, resilience, and distributed-system trade-offs. Use for architecture, service boundaries, coupling, scalability, or failure-cascade decisions; defer session facilitation to system-design-methodology..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# System Design Principles

## **Priority: P0 (CRITICAL)**

## Workflow: Evaluate Architecture for New Feature

1. Identify bounded contexts and module boundaries
2. Name the data owner and define dependency direction (outer layers depend on inner)
3. Select communication pattern (sync REST, async event, or hybrid) and failure behavior
4. Validate CAP trade-offs only for distributed components
5. Record boundary, trade-off, and rollback in an ADR

For a failing synchronous dependency, keep the critical path explicit: timeout and circuit-break the dependency, return a defined degraded/fallback result where safe, and move non-critical notifications to an asynchronous event.

## Architectural Principles

- **SoC**: Divide into distinct sections per concern.
- **SSOT**: One source, reference elsewhere.
- **Fail Fast**: Fail visibly when errors occur.
- **Graceful Degradation**: Core functional even if secondary fails.

## Modularity & Coupling

- **High Cohesion**: Related functionality in one module.
- **Loose Coupling**: Use interfaces for communication.
- **DI**: Inject dependencies, don't hardcode.
…

Read the whole file at its exact version.

How to install

Latest version
mdr add hoangnguyen0403/agent-skills-standard/system-design-principles@git:20260830.00e03f4
Exact content
mdr add hoangnguyen0403/agent-skills-standard/system-design-principles@sha256:f5b25c01c1471f4e

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_ctgttlf26g56dz27.svg)](https://markdownregistry.com/a/art_ctgttlf26g56dz27)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260830.00e03f4 latest2026-08-30 00e03f4 3,433 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (3433 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

hoangnguyen0403/agent-skills-standard · 571 stars · license MIT · pushed 2026-09-24 · branch develop

API

GET https://markdownregistry.com/api/v1/artifacts/art_ctgttlf26g56dz27
GET https://markdownregistry.com/api/v1/resolve?ref=hoangnguyen0403/agent-skills-standard/system-design-principles
GET https://markdownregistry.com/api/v1/blob/f5b25c01c1471f4efc02bd64ce7dd7636b549c85d42765b5bfe03c60ec1615dc

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from hoangnguyen0403/agent-skills-standard

caveman-commit skill
hoangnguyen0403/agent-skills-standard · .agents/skills/caveman-commit/SKILL.md · Ultra-compressed commit message generator. Cuts noise from commit messages while preserving intent and reasoning…
git:20260509.3e36716 · audit A · 571 stars
caveman-compress skill
hoangnguyen0403/agent-skills-standard · .agents/skills/caveman-compress/SKILL.md · Compress natural language memory files (CLAUDE.md, todos, preferences) into caveman format to save input tokens…
git:20260509.3e36716 · audit A · 571 stars
caveman-review skill
hoangnguyen0403/agent-skills-standard · .agents/skills/caveman-review/SKILL.md · Ultra-compressed code review comments. Cuts noise from PR feedback while preserving the actionable signal. Each comment…
git:20260509.3e36716 · audit A · 571 stars
caveman skill
hoangnguyen0403/agent-skills-standard · .agents/skills/caveman/SKILL.md · Ultra-compressed communication mode. Cuts token usage ~75% by speaking like caveman while keeping full technical…
git:20260509.3e36716 · audit A · 571 stars
common-architecture-diagramming skill
hoangnguyen0403/agent-skills-standard · .agents/skills/common/common-architecture-diagramming/SKILL.md · Draw architecture diagrams as editable draw.io files with a fixed house style, C4 levels, and evidence-tagged shapes…
git:20260913.58fa467 · audit A · 571 stars
common-best-practices skill
hoangnguyen0403/agent-skills-standard · .agents/skills/common/common-best-practices/SKILL.md · Enforce SOLID principles, guard-clause style, function size limits, and intention-revealing naming across all…
git:20260714.6bf9b5e · audit A · 571 stars
common-business-requirements skill
hoangnguyen0403/agent-skills-standard · .agents/skills/common/common-business-requirements/SKILL.md · Standardize BRD and BRD-lite discovery for business goals, stakeholder impact, current-to-future state, and measurable…
git:20260704.611f52a · audit A · 571 stars
common-code-review skill
hoangnguyen0403/agent-skills-standard · .agents/skills/common/common-code-review/SKILL.md · Conduct high-quality, persona-driven code reviews. Use when reviewing PRs, critiquing code quality, or analyzing…
git:20260714.6bf9b5e · audit A · 571 stars
common-context-optimization skill
hoangnguyen0403/agent-skills-standard · .agents/skills/common/common-context-optimization/SKILL.md · Maximize context window efficiency, reduce latency, and prevent lost-in-middle issues through strategic masking and…
git:20260714.6bf9b5e · audit A · 571 stars
common-dast-tooling skill
hoangnguyen0403/agent-skills-standard · .agents/skills/common/common-dast-tooling/SKILL.md · Standardize dynamic application security testing for backend APIs, frontend web apps, and mobile clients. Covers ZAP…
git:20260714.6bf9b5e · audit A · 571 stars
common-debugging skill
hoangnguyen0403/agent-skills-standard · .agents/skills/common/common-debugging/SKILL.md · Troubleshoot systematically using the Scientific Method. Use when debugging crashes, tracing errors, diagnosing…
git:20260714.6bf9b5e · audit A · 571 stars
common-documentation skill
hoangnguyen0403/agent-skills-standard · .agents/skills/common/common-documentation/SKILL.md · Write effective code comments, READMEs, and technical documentation following intent-first principles. Use when adding…
git:20260714.6bf9b5e · audit A · 571 stars

Every file in hoangnguyen0403/agent-skills-standard

Other files named system-design-principles

system-design-principles skill
hoangnguyen0403/agent-skills-standard · .agents/skills/system-design/system-design-principles/SKILL.md · Define module boundaries, dependency direction, data ownership, resilience, and distributed-system trade-offs. Use for…
git:20260830.00e03f4 · audit A · 571 stars

Browse by kind, by grade A, or by owner.