backend-architecture SKILL.md skillA

backend-architecture from johnkozaris/jko-claude-plugins is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add johnkozaris/jko-claude-plugins/backend-architecture@git:20260725.6c1b23d

Pins git:20260725.6c1b23d in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
johnkozaris/jko-claude-plugins
Path
plugins/backend-architecture/skills/backend-architecture/SKILL.md
Versions recorded
1
Latest version
git:20260725.6c1b23d, committed Jul 25, 2026
Size
4,558 bytes
Repository stars
11
License
MIT

This skill should be used for consequential backend architecture decisions: module or service boundaries; modular monoliths versus independent services; service extraction and data migration; data ownership and consistency; synchronous, event-driven, actor/stateful, or pipeline designs; failure isolation, backpressure, deployment topology; or deciding where orchestration and invariants belong. Trigger on requests to review or design a backend, split a service, choose a queue or communication…

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

# Backend Architecture

Start from the system that exists, not from an architecture diagram you already
want to impose.

## Investigate before choosing

Inspect entry points, module boundaries, data stores, call paths, deployment
units, tests, and recent changes. Where available, inspect runtime signals,
incident and deployment history, data growth, and ownership or regulatory
constraints. Identify the constraint driving the decision:
independent deployment, failure isolation, data ownership, latency, throughput,
team ownership, regulatory separation, or simply code that is hard to change.

Separate evidence from assumptions and perform a blind-spot pass before
converging. Research what the repository, telemetry, and primary documentation
can answer; prioritize remaining user questions by how likely their answers are
to change the architecture. Do not use remembered version trivia as evidence.

## Production opinions

- **Default to a modular monolith.** A process boundary must earn its network,
  operational, consistency, and observability costs. Split a service when the
  system needs independent deployment, failure isolation, scaling, ownership,
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add johnkozaris/jko-claude-plugins/backend-architecture@sha256:c35f2474bda244b2

The line at the top of this page pins the label git:20260725.6c1b23d, 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_6odvc23kp2bh5ppf.svg)](https://markdownregistry.com/a/art_6odvc23kp2bh5ppf)

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

Versions

The registry has recorded 1 version of this file, committed on Jul 25, 2026.

versioncommittedcommitsizeaudit
git:20260725.6c1b23d latest2026-07-25 6c1b23d 4,558 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 (4558 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

johnkozaris/jko-claude-plugins · 11 stars · license MIT · pushed 2026-10-31 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_6odvc23kp2bh5ppf
GET https://markdownregistry.com/api/v1/resolve?ref=johnkozaris/jko-claude-plugins/backend-architecture
GET https://markdownregistry.com/api/v1/blob/c35f2474bda244b22609c7fb93b563979d9f3d26fac5f21a6a99eab9cf8e5131

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 johnkozaris/jko-claude-plugins

AGENTS.md AGENTS.md file
johnkozaris/jko-claude-plugins · AGENTS.md
git:20261031.af14d5b · audit B · 11 stars
CLAUDE.md CLAUDE.md file
johnkozaris/jko-claude-plugins · CLAUDE.md
git:20260823.7b6e838 · audit A · 11 stars
get-dev-token SKILL.md skill
johnkozaris/jko-claude-plugins · plugins/backend-validator/skills/get-dev-token/SKILL.md · Acquire a development OIDC access token through the project's token command or the bundled macOS PKCE script
git:20260823.7b6e838 · audit A · 11 stars
validate-api SKILL.md skill
johnkozaris/jko-claude-plugins · plugins/backend-validator/skills/validate-api/SKILL.md · Run the project's Hurl scenarios with an OIDC access token passed as a secret variable
git:20260823.7b6e838 · audit A · 11 stars
validate-ws SKILL.md skill
johnkozaris/jko-claude-plugins · plugins/backend-validator/skills/validate-ws/SKILL.md · Run a bounded, protocol-aware WebSocket probe with an OIDC bearer token
git:20260823.7b6e838 · audit A · 11 stars
code-cleanup SKILL.md skill
johnkozaris/jko-claude-plugins · plugins/code-cleanup/skills/code-cleanup/SKILL.md · This skill should be used when the user asks to clean up or simplify a codebase; find dead code, dead features…
git:20260823.7b6e838 · audit A · 11 stars
electron-playwright-validator SKILL.md skill
johnkozaris/jko-claude-plugins · plugins/electron-playwright-validator/skills/electron-playwright-validator/SKILL.md · This skill should be used when a user asks to launch, inspect, automate, test, validate, or debug an Electron desktop…
git:20260725.6c1b23d · audit A · 11 stars
esp32-expert SKILL.md skill
johnkozaris/jko-claude-plugins · plugins/esp32-cpp/skills/esp32-expert/SKILL.md · This skill should be used for ESP32-specific hardware and runtime work in ESP-IDF, Arduino-ESP32, or PlatformIO…
git:20260725.6c1b23d · audit A · 11 stars
mobile-flows-maestro SKILL.md skill
johnkozaris/jko-claude-plugins · plugins/maestro-mobile-validator/skills/mobile-flows-maestro/SKILL.md · This skill should be used when Maestro is explicitly requested or already present and the task is to author, run, or…
git:20260725.6c1b23d · audit A · 11 stars
validate-mobile SKILL.md skill
johnkozaris/jko-claude-plugins · plugins/maestro-mobile-validator/skills/validate-mobile/SKILL.md · Run a Maestro flow on an explicitly selected iOS or Android device and report behavioral evidence
git:20260823.7b6e838 · audit A · 11 stars
peekaboo SKILL.md skill
johnkozaris/jko-claude-plugins · plugins/peekaboo-macos-validator/skills/peekaboo/SKILL.md · Provides runtime observation and interaction for native macOS interfaces through accessibility state and screenshots…
git:20260823.7b6e838 · audit A · 11 stars
validate-macos-app SKILL.md skill
johnkozaris/jko-claude-plugins · plugins/peekaboo-macos-validator/skills/validate-macos-app/SKILL.md · Validate requested or discovered states in a native macOS app while preserving prior app state
git:20260823.7b6e838 · audit A · 11 stars

Every file in johnkozaris/jko-claude-plugins

Other files named backend-architecture

backend-architecture SKILL.md skill
byerlikaya/claude-starter-kit · plugin/skills/backend-architecture/SKILL.md · Decide, record and apply the backend stack and architecture pattern. Use when backend work starts with no recorded…
git:20260926.aaa5dbc · audit A · 26 stars
backend-architecture SKILL.md skill
byerlikaya/claude-starter-kit · kit/skills/backend-architecture/SKILL.md · Decide, record and apply the backend stack and architecture pattern. Use when backend work starts with no recorded…
git:20260926.aaa5dbc · audit A · 26 stars

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