[nathanclevenger]

The ratified frame: MDX is an open standard authored by others (the MDX community, mdxjs.com). MDXLD is ours — an extension/superset of MDX, plus a superset of YAML-LD in the frontmatter, with $context always https://schema.org.ai, unversioned.

Good news first: this repo had no versioned $context URLs, and its two MDXLD references were already correctly attributed outward rather than claimed as ours. The problem here is not false claims — it is silence.

What the audit found

Zero occurrences, repo-wide, of every one of these:

Domain	Occurrences in site/ or content/
mdxjs.com	0 — MDX is used and named but never credited to upstream
foundation.org.ai	0
schema.org.ai	0 — despite CLAUDE.md:75 declaring it the canonical type-URI namespace
mdx.org.ai	0 in the site (one mention in an ASCII diagram in docs/plans/)

There is no footer. site/lib/layout.shared.tsx sets nav.title and githubUrl and nothing else. No licence, no copyright, no attribution, no link to any sibling property. The single clickable outbound link in the entire site chrome was the GitHub icon.

MDXLD and MDXUI — two of the ratified eleven primitives — were absent from the site entirely. MDXLD appeared only as two inline links in content/domain.mdx; MDXUI has zero occurrences in content/ or site/.

Governed-vocabulary misuse in deployed copy: content/index.mdx:9 — "From functions to businesses, every layer is designed for the age of AI." layer means the .org.ai / .do / .studio strata and nothing else.

Self-contradiction: content/domain.mdx:17 says "every domain defines a JSON-LD @context" and then shows $context: in the very next code block.

Changes

1. content/index.mdx — new "How it is written down" section naming MDXLD and MDXUI, per the ratified rule that this site is the definitional index of the primitives with one card per primitive, each linking to that primitive's home. It states MDX is theirs (linked), MDXLD is ours and a superset of both MDX and YAML-LD, and $context is https://schema.org.ai unversioned. Also fixes the layer misuse.
2. content/domain.mdx — @context/$context contradiction resolved; MDXLD named and linked to mdx.org.ai.
3. site/app/layout.tsx — adds alternates.canonical (there were no canonical tags anywhere) and a real footer linking The Org.AI Foundation and crediting MDX upstream.
4. site/lib/layout.shared.tsx — nav links to MDXLD, schema.org.ai, the Foundation.
5. site/app/llms.txt/route.ts — see below.

MDXUI is named but not linked, because ui.org.ai does not resolve (curl returns 000). An honest blank beats a dead link. Same reasoning kept docs.org.ai out of these pages — it fails the TLS handshake outright.

Canonical arrangement

primitives.org.ai self-canonicalises. It is the definitional index; it links MDXLD to mdx.org.ai rather than restating the format, so the two properties never serve the same referent. The hierarchy names docs.org.ai/mdxld as MDXLD's canonical entry, but that host does not serve — see mdx.org.ai#2 for the full reasoning and the ruling requested.

Deliberately NOT decided here — needs your ruling

The site states its primitive count three different, mutually contradictory ways:

Surface	Count	Contents
content/index.mdx:11-39 home cards	9	Function, Database, Workflow, Task, Agent, Human, Product, Service, Business
site/app/llms.txt/route.ts:17	"seven core primitives"	drops Task and Human
site/app/layout.tsx meta description	7	matched llms.txt
content/meta.json sidebar	22	adds Domain, Noun, Verb, Thing, Action, Event, Experiment, Goal, Plan, Project, Tool, Types…

None of the four is the ratified eleven (Business-as-Code, Services-as-Software, Digital Workers, Digital Tools, Autonomous Agents, Human-in-the-Loop, AI Functions, AI Workflows, AI Database, MDXLD, MDXUI). The nav names Business where the ratified list says Business-as-Code, Agent where it says Autonomous Agents, Human where it says Human-in-the-Loop; and it files Digital Workers and Digital Tools under "Infrastructure" rather than as primitives.

Reconciling that is a real content restructure with naming consequences, not a copy edit. This PR does not pick a number — it removes the false "seven" assertion and adds MDXLD/MDXUI to both the page and llms.txt, leaving the reconciliation to your ruling.

Two hazards found, not fixed here

1. ai/primitives/ is a self-referential git submodule — this repo mounted inside itself, pinned at 8bf06bc (2026-01-13, 387 commits behind). Its ai/primitives/site/wrangler.jsonc is byte-identical to site/wrangler.jsonc: same worker name primitives-org-ai, same route primitives.org.ai/*. Anyone running pnpm deploy from inside it overwrites production with the January snapshot. CI materialises it on every run (submodules: recursive). Recommend deleting it in a separate PR.
2. CI's pnpm test:unit is undefined at the root (package.json and turbo.json define no such task), so the test step errors out. main has no branch protection (gh api …/branches/main/protection → 404), so nothing gates merges regardless.

Also: /og-image.png is referenced twice in site/app/layout.tsx but does not exist in site/public/, and README.md:94-95's two documentation links 404 (the site serves docs at root, not /docs).

Process note

CONTRIBUTING.md:108-136 requires branch + PR; AGENTS.md:24-39 mandates direct git push. I followed CONTRIBUTING. Committed with --no-verify only because this worktree has no node_modules for the husky hook; Prettier was run manually against .prettierrc.json on the three .ts/.tsx files (the hook covers *.{ts,tsx} only, so the .mdx edits were never in its scope).

🤖 Generated with Claude Code