Home / baristaze / swe_guidelines · AGENTS.md · GitHub

AGENTS.md agentsA

AGENTS.md is agent-read markdown (agents) from baristaze/swe_guidelines.

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

# Working in this repository

This repository holds one guideline (`architecture.md`), a lens
catalog derived from it (`lenses/`), Claude Code skills that apply the
lenses (`skills/`), and the checkers that keep the three consistent
(`scripts/`, `Makefile`).

## Layout

- `architecture.md` is the source of truth. Every rule in a lens or a
  skill restates a sentence in it; nothing adds a rule the guideline
  does not state.
- `lenses/<group>.md` holds one group of lenses in the format
  `lenses/README.md` defines. Ids are `<PREFIX>-NN`; every lens cites
  `Section title` or `Section title, Subsection`, by title and never
  by number.
- `skills/arch-review-<group>/SKILL.md` is generated from
  `skills/_template/review.SKILL.md`; edit the template and run
  `make gen-skills`. The other skills are hand-written. The six
  scaffold skills share `skills/_shared/scaffold-conventions.md`; the
  other hand-written skills do not. `skills/_shared/ops-skills/` holds
  the nine project-local operational skills as flat templates, one
  file each, with `acme` for the product; `arch-scaffold-new` copies
  them into a new tree, and `make leaks`, `make links`, and `make lint`
…

Read the whole file at its exact version.

How to install

Latest version
mdr add baristaze/swe_guidelines/AGENTS.md@git:20260922.a3c1e91
Exact content
mdr add baristaze/swe_guidelines/AGENTS.md@sha256:ccb8b4819448741e

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

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260922.a3c1e91 latest2026-09-22 a3c1e91 11,287 BA view · diff
git:20260922.8dfb3a72026-09-22 8dfb3a7 10,704 BA view · diff
git:20260922.81ce1ea2026-09-22 81ce1ea 9,868 BA view · diff
git:20260922.073d7082026-09-22 073d708 9,431 BA view · diff
git:20260921.f72eecd2026-09-21 f72eecd 9,118 BA view · diff
git:20260921.93b5e1e2026-09-21 93b5e1e 8,910 BA view · diff
git:20260921.5c2df162026-09-21 5c2df16 8,702 BA view · diff
git:20260921.1a7971d2026-09-21 1a7971d 8,079 BA view · diff
git:20260921.62c12182026-09-21 62c1218 7,696 BA view

Audit of the latest version

A  14 of 14 checks passed. Deterministic, no model, same answer every run.
  • pass: Size between 200 bytes and 200 KB (11287 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_doblfqqdzeh7vbze
GET https://markdownregistry.com/api/v1/resolve?ref=baristaze/swe_guidelines/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/ccb8b4819448741e013d6cbc99245e136afcac8376a9103f1beb7f1ac2348307

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

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

Other files named AGENTS.md

AGENTS.md agents
obra/superpowers · AGENTS.md
git:20260919.5bf4e78 · audit A · 291,204 stars
AGENTS.md agents
affaan-m/ecc · AGENTS.md
git:20260919.91ba9b4 · audit A · 266,832 stars
AGENTS.md agents
firecrawl/firecrawl · AGENTS.md
git:20260613.d9a35c0 · audit A · 184,144 stars
AGENTS.md agents
dietrichgebert/ponytail · AGENTS.md
git:20260710.b6c0448 · audit A · 144,862 stars
AGENTS.md agents
garrytan/gstack · AGENTS.md
git:20260914.4a3c6a8 · audit A · 134,082 stars
AGENTS.md agents
graphify-labs/graphify · AGENTS.md
git:20260414.7ec92ec · audit A · 121,202 stars
AGENTS.md agents
juliusbrussee/caveman · AGENTS.md
git:20260902.d9faebc · audit A · 107,708 stars
AGENTS.md agents
addyosmani/agent-skills · AGENTS.md
git:20260709.b665c5c · audit A · 98,554 stars

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