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

arch-deviate skillA

arch-deviate is agent-read markdown (skill) from baristaze/swe_guidelines: Record a deliberate deviation from the guideline as an ADR under docs/adr/: the rule quoted, the decision, the consequences. Use when a finding is accepted as intentional..

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-deviate

A project that follows the guideline may still need to diverge from a
rule. The divergence is recorded, not argued about in review threads:
one ADR quotes the rule, states the decision, and names what the
project accepts in exchange. A breach whose ADR is cited next to the
code is a documented exception. A review reports it on one line under
Deviations. It is not a finding, and it never lowers a severity.

## Input

`$ARGUMENTS` names the rule being deviated from, as a lens id
(`STO-02`), a section by title (`The Storage Layer, Storage
Principles`), or a sentence describing it, optionally followed by a
one-line reason. A technology substitution (an equivalent in place of
a technology the guideline names) is not a deviation and is recorded
in the project's technology-choices ADR instead, as the guideline's
"Technology Choices and How to Override Them" section states; when
`$ARGUMENTS` describes one, say so and stop. Ask in one
message for what is missing: the reason, the scope of the deviation
(which namespace, service, or table), and whether it is permanent or
has a condition for ending.

## Procedure
…

Read the whole file at its exact version.

How to install

Latest version
mdr add baristaze/swe_guidelines/arch-deviate@git:20260922.81ce1ea
Exact content
mdr add baristaze/swe_guidelines/arch-deviate@sha256:66ea80d840e3a1ea

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

2 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260922.81ce1ea latest2026-09-22 81ce1ea 4,696 BA view · diff
git:20260922.5fc1bb82026-09-22 5fc1bb8 4,532 BA view · diff
git:20260922.e4ae97c2026-09-22 e4ae97c 4,531 BA view · diff
git:20260921.f72eecd2026-09-21 f72eecd 4,683 BA view · diff
git:20260921.93b5e1e2026-09-21 93b5e1e 4,457 BA view · diff
git:20260920.3f0daa82026-09-20 3f0daa8 3,135 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 (4696 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_si7du5glp7t2npg6
GET https://markdownregistry.com/api/v1/resolve?ref=baristaze/swe_guidelines/arch-deviate
GET https://markdownregistry.com/api/v1/blob/66ea80d840e3a1ea0d991eeab74a3d2dd8212568cf43fd027387e8e195aa173c

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-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
arch-review-network skill
baristaze/swe_guidelines · skills/arch-review-network/SKILL.md · Architecture review through the Network lenses: topology, gateway, public types, clients, realtime, push-first. For a…
git:20260922.28cefc1 · audit A · 86 stars

Every file in baristaze/swe_guidelines

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