Schema by default
The data layer of a CTXR site is Schema.org. Not as an option or an export format: every entity is a Schema.org record, and everything else — templates, machine views, the MCP, the agent’s understanding — turns around that. It is the one choice in CTXR that is not yours to change.
The choice
Most content systems invent a model of their own, understood by nobody outside them. CTXR borrows the vocabulary the scope already agrees on: an article is an Article with a headline and an author; a business is an Organization with an address; an event is an Event with a startDate. Search engines, browsers, language models and any developer who has written structured data know those words already.
What CTXR adds is mechanics, not vocabulary:
| Mechanic | Rule |
|---|---|
| Identity | an entity has an identifier |
| References | stubs between entities, resolved on read |
| Pages | an entity with a slug is a page (a list never is — it is curation) |
| Required fields | a handful per type |
The engine guards those mechanics — a reference to a missing file, a page without its required fields, JSON that does not parse — and never polices meaning. It will not tell you that your Service should really be a Product.
What it buys
A machine reading the site needs no documentation about it; the machine views work without a mapping step — the index at /data.json is a Schema.org DataCatalog of Datasets, and every entity file under it is a Schema.org record as stored. Your agent knows what an Event has without being told, and the type shell knows the same words. And the data stays honest: the fields that render the page are the fields that feed the structured data, so the machine view can only claim what the page shows. See AI and search.
What it costs
Familiarity is not always fit: Schema.org has awkward words for some things. The rule is to keep the public term where mechanics do not care, and to add a small render-only field where the page needs something the vocabulary lacks — stripped from the machine view so the claim stays true. A moment of thought per type, against a private language that would cost every reader, human or machine, forever.