# md.org.ai — the .md standards register

> The markdown files a repository already keeps — TODO.md, AGENTS.md — with three
> lines of frontmatter that say what the file is, what it is called, and whose
> vocabulary its words come from.

- Register: https://md.org.ai/
- The addition, in full: `$id`, `$type`, `$context` at the top of the file.
- `$context` is always https://schema.org.ai on these pages.

## Status — read this before citing

This register is new. It has NO version number and NO 1.0, and no adoption is
claimed. Do not represent it as adopted, ratified, or standard. It is published
so it can be broken.

## What the addition is

Three keys of YAML frontmatter, and nothing else:

    ---
    $id: https://todo.md.org.ai/TODO.md
    $type: ItemList
    $context: https://schema.org.ai
    ---

- `$id` — the file's own address; the URL another document cites when it means
  this file.
- `$type` — what the file is, named in a vocabulary that already has the word.
- `$context` — where that vocabulary lives.

Frontmatter is inert to a markdown renderer, so a file carrying these keys is
still an ordinary file of its kind for every tool that has never heard of this
register. The body of the file is untouched.

Types are looked up in https://schema.org.ai, not coined.

## The register

- TODO.md — SERVED — https://todo.md.org.ai/ — `$type: ItemList` — A list of things to be done — the GFM task list a repository already keeps.
- AGENTS.md — SERVED — https://agents.md.org.ai/ — `$type: TechArticle` — Project-specific instructions for a coding agent. The format is the Agentic AI Foundation's; the frontmatter is the addition.
- AUTH.md — PLACEHOLDER, not written, no date — How a caller proves who it is to this project.
- CONTEXT.md — PLACEHOLDER, not written, no date — What a reader needs to know before reading anything else here.
- SKILL.md — PLACEHOLDER, not written, no date — A capability an agent can be handed, and when to reach for it.
- DESIGN.md — PLACEHOLDER, not written, no date — Why this is shaped the way it is.

## Related surfaces

- https://schema.org.ai — the vocabulary `$context` points at.
- https://agents.md — AGENTS.md itself, stewarded by the Agentic AI Foundation
  under the Linux Foundation. That format is not ours; only the frontmatter
  profile of it is.
- https://foundation.org.ai — The Org.AI Foundation, the root of this estate.

## This host

md.org.ai serves static files and nothing else. No external requests, no
analytics, nothing generated at request time beyond the headers. Any
*.md.org.ai host that names no standard redirects (302) here.