AGENTS.mdA

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

Install it, pinned
mdr add pragmatic-design/pragmatic.design/AGENTS.md@git:20261016.82b976f

Pins git:20261016.82b976f in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
pragmatic-design/pragmatic.design
Path
AGENTS.md
Versions recorded
5
Latest version
git:20261016.82b976f, committed Oct 16, 2026
First version recorded
Oct 3, 2026
Size
10,014 bytes
Repository stars
15
License
a license file GitHub does not identify

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

# AGENTS.md

Entry point for coding agents. Humans should start at [README.md](README.md) and
[CONTRIBUTING.md](CONTRIBUTING.md); everything here is also true for them.

## What this is

A .NET 10 framework built as a monorepo of independent modules, held together by one source
generator. Roughly 350 projects, 158 of which ship as packages (what `scripts/publish-local.mjs`
pushes to the feed). Solutions use the `.slnx` format, not `.sln`.

## Build and test

One script defines both, and CI runs the same one:

```bash
node scripts/check.mjs --tier fast                    # changed modules only, while you work
node scripts/check.mjs --tier full                    # the gate for a change: clean build, every ratchet, every hermetic suite
node scripts/check.mjs --tier docker --only <Suite>   # a container suite your change touches
node scripts/check.mjs --tier all                     # everything, container suites included: before a release
```

⚠️ `--tier full` does not run the suites that need Docker. If your change adds or touches a test that
lives in one of them (the reference applications, `Pragmatic.Messaging.Tests`, the EF Core suites),
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add pragmatic-design/pragmatic.design/AGENTS.md@sha256:12435cdff492c718

The line at the top of this page pins the label git:20261016.82b976f, 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_zmkms2mtvawbeem6.svg)](https://markdownregistry.com/a/art_zmkms2mtvawbeem6)

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

Versions

The registry has recorded 5 versions of this file, between Oct 3, 2026 and Oct 16, 2026, about one every 3 days.

versioncommittedcommitsizeaudit
git:20261016.82b976f latest2026-10-16 82b976f 10,014 BA view · diff
git:20261012.8e161cb2026-10-12 8e161cb 9,908 BA view · diff
git:20261011.5fe1c362026-10-11 5fe1c36 9,622 BA view · diff
git:20261007.8d7faf02026-10-07 8d7faf0 9,304 BA view · diff
git:20261003.75f383a2026-10-03 75f383a 9,116 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 (10014 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

pragmatic-design/pragmatic.design · 15 stars · license a license file GitHub does not identify · pushed 2026-11-07 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_zmkms2mtvawbeem6
GET https://markdownregistry.com/api/v1/resolve?ref=pragmatic-design/pragmatic.design/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/12435cdff492c71828bb2daead1d59091a162ad38a9b12178e22ceb06344a70c

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 pragmatic-design/pragmatic.design

CLAUDE.md CLAUDE.md file
pragmatic-design/pragmatic.design · CLAUDE.md
git:20261002.ccb0d57 · audit A · 15 stars
pragmatic-architecture SKILL.md skill
pragmatic-design/pragmatic.design · marketplace/plugins/pragmatic-design/skills/pragmatic-architecture/SKILL.md · Use when setting up a new Pragmatic.Design project, splitting it into libraries, modules and databases, or weighing a…
git:20261004.0320b67 · audit A · 15 stars
pragmatic-choose-modules SKILL.md skill
pragmatic-design/pragmatic.design · marketplace/plugins/pragmatic-design/skills/pragmatic-choose-modules/SKILL.md · Use when the user describes a feature to build and needs the Pragmatic.Design NuGet packages and public patterns chosen…
git:20261004.0320b67 · audit A · 15 stars
pragmatic-ecosystem SKILL.md skill
pragmatic-design/pragmatic.design · marketplace/plugins/pragmatic-design/skills/pragmatic-ecosystem/SKILL.md · Use when working on an app that consumes Pragmatic.Design without its source; the reference hub for NuGet packages from…
git:20261004.0320b67 · audit A · 15 stars
pragmatic-new-app SKILL.md skill
pragmatic-design/pragmatic.design · marketplace/plugins/pragmatic-design/skills/pragmatic-new-app/SKILL.md · Use when the user asks to create or scaffold a new app from the Pragmatic.Design packages (nuget.org, or a local…
git:20261013.a554f86 · audit A · 15 stars
pragmatic-nuget-feed SKILL.md skill
pragmatic-design/pragmatic.design · marketplace/plugins/pragmatic-design/skills/pragmatic-nuget-feed/SKILL.md · Use when a restore or build fails with NU#### or feed and source errors, or when consuming Pragmatic.Design builds that…
git:20261017.dc88d60 · audit A · 15 stars
pragmatic-use-actions-endpoints SKILL.md skill
pragmatic-design/pragmatic.design · marketplace/plugins/pragmatic-design/skills/pragmatic-use-actions-endpoints/SKILL.md · Use when implementing a CRUD or business operation or exposing it over HTTP (Mutation, DomainAction, [Endpoint]…
git:20261017.dc88d60 · audit A · 15 stars
pragmatic-use-audit SKILL.md skill
pragmatic-design/pragmatic.design · marketplace/plugins/pragmatic-design/skills/pragmatic-use-audit/SKILL.md · Use when the app must prove who changed or accessed something, answer an auditor, verify the trail or choose…
git:20261031.7fecbf3 · audit A · 15 stars
pragmatic-use-authorization SKILL.md skill
pragmatic-design/pragmatic.design · marketplace/plugins/pragmatic-design/skills/pragmatic-use-authorization/SKILL.md · Use when adding authentication, permissions, roles, JWT, ICurrentUser or per-record access (OwnedEntity, ScopedEntity…
git:20261104.c2da844 · audit A · 15 stars
pragmatic-use-caching SKILL.md skill
pragmatic-design/pragmatic.design · marketplace/plugins/pragmatic-design/skills/pragmatic-use-caching/SKILL.md · Use when adding caching or invalidation to a query or mutation, or the user mentions cache keys, stampede, tags or a…
git:20261017.dc88d60 · audit A · 15 stars
pragmatic-use-client SKILL.md skill
pragmatic-design/pragmatic.design · marketplace/plugins/pragmatic-design/skills/pragmatic-use-client/SKILL.md · Use when a front end or another service calls a Pragmatic API, hand-written HttpClient code appears, or PRAG2300-2304…
git:20261017.dc88d60 · audit A · 15 stars
pragmatic-use-composition SKILL.md skill
pragmatic-design/pragmatic.design · marketplace/plugins/pragmatic-design/skills/pragmatic-use-composition/SKILL.md · Use when wiring the host, DI, modules, startup steps or the module-to-database topology (Pragmatic.Composition…
git:20261017.dc88d60 · audit A · 15 stars

Every file in pragmatic-design/pragmatic.design

Other files named AGENTS.md

AGENTS.md AGENTS.md file
morluto/rea · AGENTS.md
git:20261102.920d634 · audit A · 433,876 stars
AGENTS.md AGENTS.md file
obra/superpowers · AGENTS.md
git:20261020.b739a8a · audit A · 314,583 stars
AGENTS.md AGENTS.md file
affaan-m/ecc · AGENTS.md
git:20261030.f29e332 · audit A · 299,696 stars
AGENTS.md AGENTS.md file
firecrawl/firecrawl · AGENTS.md
git:20261008.5a75dca · audit A · 199,595 stars
AGENTS.md AGENTS.md file
dietrichgebert/ponytail · AGENTS.md
git:20261008.2a1fe84 · audit A · 185,249 stars
AGENTS.md AGENTS.md file
graphify-labs/graphify · AGENTS.md
git:20260926.98d73fe · audit A · 144,492 stars
AGENTS.md AGENTS.md file
garrytan/gstack · AGENTS.md
git:20261107.ef99eb5 · audit A · 140,694 stars
AGENTS.md AGENTS.md file
juliusbrussee/caveman · AGENTS.md
git:20261106.e45976c · audit A · 118,366 stars

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