software-architecture SKILL.md skillA

software-architecture from magnus919/agent-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add magnus919/agent-skills/software-architecture@git:20260821.00e611a

Pins git:20260821.00e611a in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
magnus919/agent-skills
Path
software-architecture/SKILL.md
Versions recorded
2
Latest version
git:20260821.00e611a, committed Aug 21, 2026
First version recorded
Aug 21, 2026
Size
7,608 bytes
Repository stars
166
License
MIT

Design and review software architectures from business drivers through system boundaries, tradeoffs, runtime behavior, evolution, and architecture practice. Use when choosing a greenfield or target architecture, comparing modular-monolith and service shapes, designing distributed consistency, replication, partitioning, coordination, ordering, transaction isolation, or failure behavior, defining architecture fitness evidence, or facilitating a consequential architecture review. Do not use for…

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

# Software Architecture

Use this skill to make system-level design decisions and leave an inspectable path from drivers to evidence. It owns the architecture decision workflow, not the implementation of any subsystem.

## Workflow

1. **Frame the decision.** Establish the desired outcome, stakeholders, constraints, decision horizon, reversibility, affected systems, and evidence gaps. Do not invent scale, regulatory, latency, or ownership facts.
2. **Turn qualities into scenarios.** Name the architecture characteristics that matter, express each as an observable scenario, prioritize them, and expose conflicts. Load `references/architecture-characteristics-and-tradeoffs.md`.
3. **Choose boundaries and shape.** Compare styles, topology, and deployment granularity against the scenarios and team operating capacity. Load `references/styles-topologies-and-granularity.md`.
4. **Test ownership and coupling.** Identify policy, data, change, runtime, and team boundaries. Treat a service split as a hypothesis, not a default. Load `references/coupling-modularity-and-data-ownership.md`.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add magnus919/agent-skills/software-architecture@sha256:a38b4b7996b99a72

The line at the top of this page pins the label git:20260821.00e611a, 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_4p6yobezt7w5fgmh.svg)](https://markdownregistry.com/a/art_4p6yobezt7w5fgmh)

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

Versions

The registry has recorded 2 versions of this file, all committed on Aug 21, 2026.

versioncommittedcommitsizeaudit
git:20260821.00e611a latest2026-08-21 00e611a 7,608 BA view · diff
git:20260821.73a42502026-08-21 73a4250 6,577 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 (7608 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

magnus919/agent-skills · 166 stars · license MIT · pushed 2026-11-04 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_4p6yobezt7w5fgmh
GET https://markdownregistry.com/api/v1/resolve?ref=magnus919/agent-skills/software-architecture
GET https://markdownregistry.com/api/v1/blob/a38b4b7996b99a7283aff4bc9312f12a026588c70a5d0682b0f79bb12f19d688

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 magnus919/agent-skills

AGENTS.md AGENTS.md file
magnus919/agent-skills · AGENTS.md
git:20261010.bfe1eb1 · audit A · 166 stars
actuarial-risk-modeling SKILL.md skill
magnus919/agent-skills · actuarial-risk-modeling/SKILL.md · Use when analyzing, selecting, validating, or communicating models for insurance, actuarial, financial-risk, or other…
git:20260823.077c5d0 · audit A · 166 stars
adr-authoring SKILL.md skill
magnus919/agent-skills · adr-authoring/SKILL.md · Write, review, and maintain architecture decision records with clear context, alternatives, consequences, confirmation…
git:20260906.d8f3554 · audit A · 166 stars
agent-council SKILL.md skill
magnus919/agent-skills · agent-council/SKILL.md · Run a structured multi-agent debate by spawning a panel of expert agents on any question, with convergence-aware…
git:20260823.6efee5c · audit A · 166 stars
agent-evals-and-observability SKILL.md skill
magnus919/agent-skills · agent-evals-and-observability/SKILL.md · Design, run, review, or release framework- and vendor-neutral evaluations and observability for AI agents. Use when…
git:20261103.c336267 · audit A · 166 stars
AGENTS.md@agent-production-operations AGENTS.md file
magnus919/agent-skills · agent-production-operations/AGENTS.md
git:20260814.c0c7690 · audit A · 166 stars
agent-production-operations SKILL.md skill
magnus919/agent-skills · agent-production-operations/SKILL.md · Operate an evaluated agent with tools and authority in production through a runtime control plane covering versioning…
git:20261103.c336267 · audit A · 166 stars
agent-skills SKILL.md skill
magnus919/agent-skills · agent-skills/SKILL.md · Use this skill when creating, reviewing, or editing Agent Skills-format skills, or when implementing skill discovery…
git:20261102.915225c · audit B · 166 stars
ai-governance SKILL.md skill
magnus919/agent-skills · ai-governance/SKILL.md · Design and operate AI governance: principles, decision rights, risk tiers, lifecycle gates, fairness, transparency…
git:20261101.83d2784 · audit A · 166 stars
ai-operating-economics SKILL.md skill
magnus919/agent-skills · ai-operating-economics/SKILL.md · Use when deciding whether an AI-enabled workflow should be adopted, scaled, constrained, redesigned, or retired, and…
git:20260821.1291f95 · audit A · 166 stars
amazon-memo SKILL.md skill
magnus919/agent-skills · amazon-memo/SKILL.md · Create, adapt, or revise Amazon-style narrative decision memos, six-pagers, PR/FAQs, and short decision briefs…
git:20261019.89945ee · audit A · 166 stars
analog-occultism SKILL.md skill
magnus919/agent-skills · analog-occultism/SKILL.md · Use this skill to create subject-neutral images and videos in an analog occultism / industrial CRT noir aesthetic…
git:20260905.3d54d7b · audit A · 166 stars

Every file in magnus919/agent-skills

Other files named software-architecture

software-architecture SKILL.md skill
foreturn/product-studio · skills/software-architecture/SKILL.md · 用于系统上下文划分、模块与服务边界职责、跨边界交互契约、数据主权、韧性恢复与架构演进裁决。
git:20261014.9089425 · audit A · 3 stars

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