AGENTS.mdA

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

Install it, pinned
mdr add betterwright/betterwright/AGENTS.md@git:20260921.9c4d4bb

Pins git:20260921.9c4d4bb in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
betterwright/betterwright
Path
AGENTS.md
Versions recorded
6
Latest version
git:20260921.9c4d4bb, committed Sep 21, 2026
First version recorded
Jul 26, 2026
Size
5,339 bytes
Repository stars
347
License
MIT

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

# Working on BetterWright

Guidance for agents (and humans) changing this repo. CONTRIBUTING.md covers
the release process; this file lists the invariants that are easy to break
because they are enforced by code, not convention.

## Commands

- `bun run lint` — Biome and Oxlint rules. The formatter is off deliberately (see
  biome.jsonc); match the hand style recorded in .editorconfig.
- `bun run typecheck` — TypeScript 7 checks, without emitting, the runtime and
  CLI (`tsconfig.json`), the build tooling (`tsconfig.tools.json`), and the
  shipped examples (`tsconfig.examples.json`). The test and benchmark harness
  (`tsconfig.harness.json`) is checked by `bun run test:unit`, because it
  imports `dist/` and so cannot be checked before a build.
- **Development sources are TypeScript and compile in place.** There are four
  projects, split by what they can depend on:
  - `tsconfig.json` — `src/` and `bin/` → `dist/`.
  - `tsconfig.tools.json` (`bun run build:tools`) — the build and release
    scripts. These must never import `dist/`, because they are what produces it.
    `bun` runs the `.ts` scripts directly; this project is type-check only.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add betterwright/betterwright/AGENTS.md@sha256:817abf25ba4eb1aa

The line at the top of this page pins the label git:20260921.9c4d4bb, 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_yp7nfzkdvwfwhggz.svg)](https://markdownregistry.com/a/art_yp7nfzkdvwfwhggz)

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

Versions

The registry has recorded 6 versions of this file, between Jul 26, 2026 and Sep 21, 2026, about one every 11 days.

versioncommittedcommitsizeaudit
git:20260921.9c4d4bb latest2026-09-21 9c4d4bb 5,339 BA view · diff
git:20260910.24c7cd02026-09-10 24c7cd0 5,169 BA view · diff
git:20260903.b65ce1c2026-09-03 b65ce1c 4,921 BA view · diff
git:20260901.72a2ba92026-09-01 72a2ba9 4,975 BA view · diff
git:20260816.882612a2026-08-16 882612a 3,757 BA view · diff
git:20260726.19826da2026-07-26 19826da 3,772 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 (5339 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

betterwright/betterwright · 347 stars · license MIT · pushed 2026-10-19 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_yp7nfzkdvwfwhggz
GET https://markdownregistry.com/api/v1/resolve?ref=betterwright/betterwright/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/817abf25ba4eb1aa48a4555c5e9085959dc3b52e05797179930cef2a4fbe0d20

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

browser SKILL.md skill
betterwright/betterwright · SKILL.md · Drive a persistent, policy-guarded real web browser via the betterwright CLI. Use for any task that needs the live web…
git:20261019.11b0412 · audit A · 347 stars
1password SKILL.md skill
betterwright/betterwright · skills/1password/SKILL.md · Read this when the browser profile has the 1Password extension and a login, signup, or payment form should be filled…
git:20260718.fea579e · audit A · 347 stars
bitwarden SKILL.md skill
betterwright/betterwright · skills/bitwarden/SKILL.md · Read this when the browser profile has the Bitwarden extension and a login, signup, or payment form should be filled…
git:20260718.fea579e · audit A · 347 stars
browser-console SKILL.md skill
betterwright/betterwright · skills/browser-console/SKILL.md · Diagnose browser console errors and uncaught JavaScript exceptions without dumping routine logs.
git:20260909.86012ed · audit A · 347 stars
checkout-verification SKILL.md skill
betterwright/betterwright · skills/checkout-verification/SKILL.md · Verify cart quantities and a fresh checkout outcome without inventing display formats or reusing an earlier receipt.
git:20260909.86012ed · audit A · 347 stars
credential-manager SKILL.md skill
betterwright/betterwright · skills/credential-manager/SKILL.md · Read this before any login, signup, password change, or checkout so the right credential source is used in the right…
git:20260719.dbff053 · audit A · 347 stars
full-stack-e2e-review SKILL.md skill
betterwright/betterwright · skills/full-stack-e2e-review/SKILL.md · Run a rigorous end-to-end product or feature review across architecture, data, APIs, permissions, billing, tests, and…
git:20260817.2bb27d2 · audit A · 347 stars
github SKILL.md skill
betterwright/betterwright · skills/github/SKILL.md · GitHub navigation, review, and account-context guidance for working repos, issues, and pull requests in the browser.
git:20260718.fea579e · audit A · 347 stars

Every file in betterwright/betterwright

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.