---
$id: https://agents.md.org.ai/AGENTS.md
$type: TechArticle
$context: https://schema.org.ai
---

# AGENTS.md

The canonical example of an `AGENTS.md` carrying MDXLD frontmatter. Everything
below this line is an ordinary AGENTS.md, written the way agents.md describes
it: plain Markdown, no required fields, headings of the author's choosing.
Everything above it is the whole of what this profile adds.

## Project overview

`md.org.ai` is a static site served by one Cloudflare Worker across three
hosts. There is no database, no API and no build step beyond `node build.js`.

## Build and test commands

```sh
npm install
npm run build      # → public/
npm run dev        # wrangler dev
npm run deploy     # wrangler deploy
```

`npm run deploy` uses wrangler's saved OAuth login. If `CLOUDFLARE_API_TOKEN`
is set in the environment it shadows that login and the deploy fails with a
10000 authentication error — unset it for the call:
`env -u CLOUDFLARE_API_TOKEN npx wrangler deploy`.

## Code style

- ES modules, no TypeScript, no framework, no bundler.
- The pages fetch nothing from anywhere. No CDN, no web font, no analytics.
  If a change would add an external subresource, it is the wrong change.
- Every HTML response carries `text/html; charset=utf-8`, and every document
  opens with `<meta charset="utf-8">` as the first element in the head.

## Conventions specific to this repo

- `src/TODO.md` and `src/AGENTS.md` are served verbatim. Edit them as files,
  never by generating them from `build.js`.
- Status claims are load-bearing. Do not add a version number, an adoption
  figure, or the word "standard" where "convention" is the truth.

## What not to do

- Do not commit `public/`. It is built.
- Do not change `$id` in any frontmatter. Other documents cite it.