Home / baristaze / swe_guidelines · skills/arch-review-ops/SKILL.md · GitHub

arch-review-ops skillA

arch-review-ops is agent-read markdown (skill) from baristaze/swe_guidelines: Architecture review through the Operations lenses: roles, credentials, ops skills, alarms, scale-out, cost, environments, traffic, READMEs. For a change in this area, or as one leg of arch-review-full..

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

# arch-review-ops

Judge the code from one perspective only: the lenses in
`${CLAUDE_SKILL_DIR}/../../lenses/ops.md`. Other perspectives have
their own skills; do not borrow their rules, and do not flag anything
a lens in this file does not name. The guideline itself is at
`${CLAUDE_SKILL_DIR}/../../architecture.md` when a lens needs its
source read in full. If either file is missing, stop and say the
installation is incomplete.

This pass covers Operations, Documentation as Code: roles, credentials, ops skills, alarms, scale-out, cost, environments, traffic, READMEs.

## Input

`$ARGUMENTS` names what to review. Read it as the first of these that
matches:

1. Empty: the current branch's change. The default branch is
   `origin/HEAD` when set, else `main`, else `master`. The scope is
   every file changed since the merge base of `HEAD` and the default
   branch (`git diff --name-only <base>`, committed and uncommitted
   alike), plus every untracked file git does not ignore
   (`git status --porcelain --untracked-files=all`). When there is no
   merge base (no default branch, a shallow clone, or unrelated
   histories), the scope is the uncommitted change against `HEAD` plus
…

Read the whole file at its exact version.

How to install

Latest version
mdr add baristaze/swe_guidelines/arch-review-ops@git:20260922.28cefc1
Exact content
mdr add baristaze/swe_guidelines/arch-review-ops@sha256:70151e05bf4b5025

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_burspgvezx2zrkhl.svg)](https://markdownregistry.com/a/art_burspgvezx2zrkhl)

2 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260922.28cefc1 latest2026-09-22 28cefc1 8,251 BA view · diff
git:20260922.81ce1ea2026-09-22 81ce1ea 6,973 BA view · diff
git:20260922.5fc1bb82026-09-22 5fc1bb8 6,330 BA view · diff
git:20260922.e4ae97c2026-09-22 e4ae97c 6,588 BA view · diff
git:20260921.f72eecd2026-09-21 f72eecd 6,428 BA view · diff
git:20260921.93b5e1e2026-09-21 93b5e1e 6,064 BA view · diff
git:20260921.5c2df162026-09-21 5c2df16 6,058 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 (8251 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

baristaze/swe_guidelines · 86 stars · license MIT · pushed 2026-09-22 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_burspgvezx2zrkhl
GET https://markdownregistry.com/api/v1/resolve?ref=baristaze/swe_guidelines/arch-review-ops
GET https://markdownregistry.com/api/v1/blob/70151e05bf4b502580fb2fdd7df8cf57e478e9d822b18ab7cb3494525f952d48

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 baristaze/swe_guidelines

AGENTS.md agents
baristaze/swe_guidelines · AGENTS.md
git:20260922.a3c1e91 · audit A · 86 stars
CLAUDE.md claude
baristaze/swe_guidelines · CLAUDE.md
git:20260915.6033a4d · audit B · 86 stars
arch-benchmark-browser skill
baristaze/swe_guidelines · skills/arch-benchmark-browser/SKILL.md · Run the benchmark prompt in the chatgpt.com, claude.ai, and gemini.google.com products, signed in, and save each answer…
git:20260922.28cefc1 · audit A · 86 stars
arch-benchmark skill
baristaze/swe_guidelines · skills/arch-benchmark/SKILL.md · Run a benchmark scenario (a skill, a command, or a question) in a declared runtime and have frontier models score it…
git:20260922.28cefc1 · audit A · 86 stars
arch-deviate skill
baristaze/swe_guidelines · skills/arch-deviate/SKILL.md · Record a deliberate deviation from the guideline as an ADR under docs/adr/: the rule quoted, the decision, the…
git:20260922.81ce1ea · audit A · 86 stars
arch-explain skill
baristaze/swe_guidelines · skills/arch-explain/SKILL.md · Explain how the guideline applies to a question, a file, or a change, citing the sections and lenses that govern it…
git:20260922.e4ae97c · audit A · 86 stars
arch-new-aspect skill
baristaze/swe_guidelines · skills/arch-new-aspect/SKILL.md · Incorporate a new aspect into the guideline and cascade it through the lenses, skills, docs, and README, naming the…
git:20260922.28cefc1 · audit A · 86 stars
arch-review-async skill
baristaze/swe_guidelines · skills/arch-review-async/SKILL.md · Architecture review through the Async lenses: infra, queues, workers, park vs fail. For a change in this area, or as…
git:20260922.28cefc1 · audit A · 86 stars
arch-review-context skill
baristaze/swe_guidelines · skills/arch-review-context/SKILL.md · Architecture review through the Context lenses: stages, scopes, OperatorContext, authorization, tenancy, provenance…
git:20260922.28cefc1 · audit A · 86 stars
arch-review-contracts skill
baristaze/swe_guidelines · skills/arch-review-contracts/SKILL.md · Architecture review through the Contracts lenses: interfaces, injection, wiring. For a change in this area, or as one…
git:20260922.28cefc1 · audit A · 86 stars
arch-review-delivery skill
baristaze/swe_guidelines · skills/arch-review-delivery/SKILL.md · Architecture review through the Delivery lenses: apps, deployment, repo layout, client architecture, logs and…
git:20260922.28cefc1 · audit A · 86 stars
arch-review-full skill
baristaze/swe_guidelines · skills/arch-review-full/SKILL.md · Full architecture review: the eight lens groups of the guideline run in parallel and merge into one report. Use before…
git:20260922.28cefc1 · audit A · 86 stars

Every file in baristaze/swe_guidelines

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