AGENTS.mdA

AGENTS.md from runxhq/runx is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add runxhq/runx/AGENTS.md@git:20261017.e17909c

Pins git:20261017.e17909c in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
runxhq/runx
Path
AGENTS.md
Versions recorded
10
Latest version
git:20261017.e17909c, committed Oct 17, 2026
First version recorded
Jul 23, 2026
Size
13,332 bytes
Repository stars
105
License
Apache-2.0

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

# scafld Agent Contract

## Default Agent Flow

Work with the host agent's normal planning, editing, and testing tools. When the work appears done, call `review`, then call `finalize`.

`review` is the independent provider gate. It records accepted review evidence and returns blockers or a passing review. `finalize` consumes that accepted review, records deterministic acceptance evidence, signs the receipt, and archives the spec. It never invokes a provider or model. The agent does not grade its own completion.

The receipt reports its independence level honestly. `cross_vendor` means multi-model review that can reduce correlated blind spots; it is still single-party local tooling unless a separate operator or CI trust domain verifies the receipt. `isolation_only` means the reviewer was isolated but cross-vendor separation was not proven.

## Merge Wall

CI runs `scafld verify <receipt> --target <commit-ish>` against the signed receipt. This is the hard wall for merging. The Claude Stop hook is only a local affordance; it can be bypassed in subagents, piped runs, Codex, Gemini, or other hosts.

## Human And CI Lifecycle
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add runxhq/runx/AGENTS.md@sha256:baea50ba021dc2a8

The line at the top of this page pins the label git:20261017.e17909c, 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_6ewpzbbzrsyvobji.svg)](https://markdownregistry.com/a/art_6ewpzbbzrsyvobji)

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

Versions

The registry has recorded 10 versions of this file, between Jul 23, 2026 and Oct 17, 2026, about one every 10 days.

versioncommittedcommitsizeaudit
git:20261017.e17909c latest2026-10-17 e17909c 13,332 BA view · diff
git:20261016.2c90f022026-10-16 2c90f02 12,819 BA view · diff
git:20261013.a7dee962026-10-13 a7dee96 12,802 BA view · diff
git:20261011.22b0cae2026-10-11 22b0cae 12,768 BA view · diff
git:20261008.1a28e752026-10-08 1a28e75 12,766 BA view · diff
git:20260908.0ff743d2026-09-08 0ff743d 12,764 BA view · diff
git:20260822.a6dcd1e2026-08-22 a6dcd1e 13,849 BA view · diff
git:20260803.0993e042026-08-03 0993e04 13,861 BA view · diff
git:20260723.7db515c2026-07-23 7db515c 13,823 BA view · diff
git:20260723.6e5370b2026-07-23 6e5370b 13,782 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (13332 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

runxhq/runx · 105 stars · license Apache-2.0 · pushed 2026-10-29 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_6ewpzbbzrsyvobji
GET https://markdownregistry.com/api/v1/resolve?ref=runxhq/runx/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/baea50ba021dc2a83db19ee1515651e1480d19286b57ef367810d49167a95b33

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: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.

More from runxhq/runx

CLAUDE.md CLAUDE.md file
runxhq/runx · CLAUDE.md
git:20260908.0ff743d · audit A · 105 stars
runx SKILL.md skill
runxhq/runx · SKILL.md · Governed runtime for agent skills: discover and install portable skills, run bounded skill graphs with explicit…
git:20261017.16ba3f9 · audit B · 105 stars
hello-world SKILL.md skill
runxhq/runx · examples/hello-world/SKILL.md · Echo a first runx message through a checked-in process tool script.
git:20261008.1a28e75 · audit B · 105 stars
loop-orchestration SKILL.md skill
runxhq/runx · examples/loop-orchestration/SKILL.md · Reference loop-orchestration example; a local loop host chains governed runx runs through receipts, budgets, context…
git:20261013.a7dee96 · audit A · 105 stars
loop-operator-context SKILL.md skill
runxhq/runx · examples/loop-orchestration/context/loop-operator/SKILL.md · Advisory operating context for the loop-orchestration example.
git:20261008.1a28e75 · audit A · 105 stars
managed-agent-intake SKILL.md skill
runxhq/runx · examples/managed-agent/SKILL.md · Managed-agent front example; a governed agent step that drafts a triage summary.
git:20261022.b44db26 · audit A · 105 stars
uncovered SKILL.md skill
runxhq/runx · fixtures/doctor/skill-fixture-missing/workspace/skills/uncovered/SKILL.md · Doctor fixture with an execution profile and no harness proof.
git:20260723.6e5370b · audit B · 105 stars
catalog-in-manual SKILL.md skill
runxhq/runx · fixtures/doctor/skill-frontmatter-invalid/workspace/skills/catalog-in-manual/SKILL.md · Doctor fixture whose frontmatter carries catalog metadata.
git:20261008.1a28e75 · audit A · 105 stars
original-name SKILL.md skill
runxhq/runx · fixtures/doctor/skill-frontmatter-invalid/workspace/skills/renamed-directory/SKILL.md · Doctor fixture whose name no longer matches its directory.
git:20261008.1a28e75 · audit B · 105 stars
records SKILL.md skill
runxhq/runx · fixtures/journeys/hosted-records/skills/records/SKILL.md · List the records a hosted fixture connector holds.
git:20261018.f7b2bbc · audit B · 105 stars
reviewer-boundary SKILL.md skill
runxhq/runx · fixtures/skills/agent-task/SKILL.md · Test-only explicit agent-task boundary fixture.
git:20260723.6e5370b · audit B · 105 stars
echo SKILL.md skill
runxhq/runx · fixtures/skills/echo/SKILL.md · Echo a message through a process tool.
git:20261008.1a28e75 · audit B · 105 stars

Every file in runxhq/runx

Other files named AGENTS.md

AGENTS.md AGENTS.md file
morluto/rea · AGENTS.md
git:20261101.d684125 · audit A · 417,919 stars
AGENTS.md AGENTS.md file
obra/superpowers · AGENTS.md
git:20261020.b739a8a · audit A · 309,852 stars
AGENTS.md AGENTS.md file
affaan-m/ecc · AGENTS.md
git:20261030.f29e332 · audit A · 293,827 stars
AGENTS.md AGENTS.md file
firecrawl/firecrawl · AGENTS.md
git:20261008.5a75dca · audit A · 198,353 stars
AGENTS.md AGENTS.md file
dietrichgebert/ponytail · AGENTS.md
git:20261008.2a1fe84 · audit A · 182,080 stars
AGENTS.md AGENTS.md file
graphify-labs/graphify · AGENTS.md
git:20260926.98d73fe · audit A · 139,879 stars
AGENTS.md AGENTS.md file
garrytan/gstack · AGENTS.md
git:20261027.a50cf58 · audit A · 138,879 stars
AGENTS.md AGENTS.md file
juliusbrussee/caveman · AGENTS.md
git:20260902.d9faebc · audit A · 116,476 stars

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