system-architecture SKILL.md skillA

system-architecture from endorphin-ai/hasbrains-agent-kit is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add endorphin-ai/hasbrains-agent-kit/system-architecture@git:20260731.4cba6d1

Pins git:20260731.4cba6d1 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
endorphin-ai/hasbrains-agent-kit
Path
agent-engineering/skills/system-architecture/SKILL.md
Versions recorded
2
Latest version
git:20260731.4cba6d1, committed Jul 31, 2026
First version recorded
Jul 3, 2026
Size
5,256 bytes
Repository stars
9
License
MIT

Use when designing a system, choosing an architecture pattern, making a technology decision, or doing capacity/scalability planning — BEFORE drilling into framework-specific mechanics. A lean MAP over three reference docs: pattern selection (monolith → modular monolith → microservices → event-driven → CQRS → event sourcing → hexagonal → clean → API gateway, with trade-offs), the how-to system-design workflows (system-design-interview approach, capacity planning, API design, DB schema design…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

TASKLANG
TYPE SKILL

IDENTITY "System Architecture"
  > General-purpose system-design knowledge for the planning step that comes
  > BEFORE technology-specific mechanics: pick the right architecture PATTERN,
  > make the load-bearing TECHNOLOGY decisions, and run the system-design
  > WORKFLOWS (capacity, API, schema, scalability, migration). This skill is a
  > lean MAP — the substance lives in three reference docs under references/.
  > Read the map, then open the one reference that matches the question.

!!! References FIRST — this SKILL.md only routes; the answers live in references/.
!!! This is technology-AGNOSTIC system design. Framework-specific mechanics —
!!! this stack's module/context boundaries, its ORM schema and migration syntax,
!!! its background-job and authorization APIs — belong to a stack-specific skill.
!!! system-architecture supports the PLANNING that precedes those mechanics.

---

## When to use this skill

KNOWLEDGE
  USE_WHEN
    - "Choosing an architecture pattern for a new system or a milestone (and weighing its trade-offs)."
    - "Making a technology decision — database, cache, message queue, auth, frontend framework, cloud provider, API style."
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add endorphin-ai/hasbrains-agent-kit/system-architecture@sha256:bbb3332e7ffce548

The line at the top of this page pins the label git:20260731.4cba6d1, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

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

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between Jul 3, 2026 and Jul 31, 2026, about one every 29 days.

versioncommittedcommitsizeaudit
git:20260731.4cba6d1 latest2026-07-31 4cba6d1 5,256 BA view · diff
git:20260703.877e2722026-07-03 877e272 5,161 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the 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 (5256 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

endorphin-ai/hasbrains-agent-kit · 9 stars · license MIT · pushed 2026-10-13 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_36oiiujifzxac6wy
GET https://markdownregistry.com/api/v1/resolve?ref=endorphin-ai/hasbrains-agent-kit/system-architecture
GET https://markdownregistry.com/api/v1/blob/bbb3332e7ffce548baf5f0989f12a068dc75125c457f88ae28bc5bc7e20d54dc

Your AI assistant 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.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from endorphin-ai/hasbrains-agent-kit

convert-to-copilot SKILL.md skill
endorphin-ai/hasbrains-agent-kit · agent-engineering/skills/convert-to-copilot/SKILL.md · This skill should be used when converting a Claude Code agent (+ its launch command + its skills) into a single GitHub…
git:20260923.b8444e7 · audit A · 9 stars
docs-project-management SKILL.md skill
endorphin-ai/hasbrains-agent-kit · agent-engineering/skills/docs-project-management/SKILL.md · Universal, project-agnostic playbook for managing an ENTIRE project inside the repo's docs/ folder — the docs/-native…
git:20260731.4cba6d1 · audit A · 9 stars
four-principles SKILL.md skill
endorphin-ai/hasbrains-agent-kit · agent-engineering/skills/four-principles/SKILL.md · Four always-on engineering principles for ALL work before, during, and after coding — Think Before Coding (surface…
git:20260731.4cba6d1 · audit A · 9 stars
pm SKILL.md skill
endorphin-ai/hasbrains-agent-kit · agent-engineering/skills/pm/SKILL.md · Universal, project-agnostic PRODUCT MANAGER playbook — the scope-disciplined PM that plans a project, gates its launch…
git:20260731.4cba6d1 · audit A · 9 stars
test-driven-development SKILL.md skill
endorphin-ai/hasbrains-agent-kit · agent-engineering/skills/test-driven-development/SKILL.md · Use when implementing any feature or bugfix, in any language or framework, before writing implementation code — write…
git:20260731.4cba6d1 · audit A · 9 stars
verification-before-completion SKILL.md skill
endorphin-ai/hasbrains-agent-kit · agent-engineering/skills/verification-before-completion/SKILL.md · Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running…
git:20260731.4cba6d1 · audit A · 9 stars
soc-media-writer SKILL.md skill
endorphin-ai/hasbrains-agent-kit · content-creation/skills/soc-media-writer/SKILL.md · Write high-performing social media content engineered around named copywriting frameworks, scroll-stopping hooks, and…
git:20260731.4cba6d1 · audit A · 9 stars
build-brain SKILL.md skill
endorphin-ai/hasbrains-agent-kit · context-engineering/skills/build-brain/SKILL.md · Turn a skill or raw data into an AI-optimized "second brain" skill — a lean SKILL.md map backed by atomized, tagged…
git:20260731.4cba6d1 · audit A · 9 stars
pipeline-state SKILL.md skill
endorphin-ai/hasbrains-agent-kit · context-engineering/skills/pipeline-state/SKILL.md · Durable, file-backed pipeline handoff BUS for a whole multi-agent run (the orchestrator + every worker agent). Persists…
git:20260731.4cba6d1 · audit A · 9 stars
prompt-expert SKILL.md skill
endorphin-ai/hasbrains-agent-kit · context-engineering/skills/prompt-expert/SKILL.md · Expert prompt engineer that interviews users and builds high-quality prompts for any AI (Claude, Gemini, Copilot…
git:20260731.4cba6d1 · audit A · 9 stars
setup SKILL.md skill
endorphin-ai/hasbrains-agent-kit · utils/statusline-kit/skills/setup/SKILL.md · Turn on the statusline-kit status line. Use when the user asks to set up, enable, switch on or fix the status line from…
git:20261007.40ca7c1 · audit A · 9 stars
designer-frontend-contract SKILL.md skill
endorphin-ai/hasbrains-agent-kit · web-dev/skills/designer-frontend-contract/SKILL.md · The universal, tech-agnostic DESIGNER ↔ FRONTEND contract — how the web designer and the frontend dev help each other…
git:20260731.4cba6d1 · audit A · 9 stars

Every file in endorphin-ai/hasbrains-agent-kit

Other files named system-architecture

system-architecture SKILL.md skill
projanvil/mindforge · skills/en/system-architecture/SKILL.md · System architecture design skill covering architecture patterns, distributed systems, technology selection, and…
git:20260305.a2f116c · audit A · 3 stars
system-architecture SKILL.md skill
projanvil/mindforge · plugins/mindforge-zh-cn/skills/system-architecture/SKILL.md · 系统架构设计技能,涵盖架构模式、分布式系统、技术选型和企业架构文档编写。使用此技能设计系统架构、评估技术栈、规划分布式系统,或创建架构决策记录和文档时使用。
git:20261016.6f8a292 · audit A · 3 stars
system-architecture SKILL.md skill
projanvil/mindforge · skills/zh-cn/system-architecture/SKILL.md · 系统架构设计技能,涵盖架构模式、分布式系统、技术选型和企业架构文档编写。使用此技能设计系统架构、评估技术栈、规划分布式系统,或创建架构决策记录和文档时使用。
git:20261009.b4230f2 · audit A · 3 stars
system-architecture SKILL.md skill
projanvil/mindforge · plugins/mindforge-en/skills/system-architecture/SKILL.md · System architecture design skill covering architecture patterns, distributed systems, technology selection, and…
git:20261016.6f8a292 · audit A · 3 stars

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