Skip to content

Definition

Machine-first artifacts

Canonical definition of machine-first artifacts: Machine-first artifacts are public files, manifests, indexes, policies, and structured records designed to expose identity, scope, canon, exclusions, source hierarchy, and interpretation rules to machine readers.

CollectionDefinition
TypeDefinition
Version1.0
Stabilization2026-05-08
Published2026-05-08
Updated2026-05-08

Evidence layer

Probative surfaces brought into scope by this page

This page does more than point to governance files. It is also anchored to surfaces that make observation, traceability, fidelity, and audit more reconstructible. Their order below makes the minimal evidence chain explicit.

  1. 01
    Canon and scopeDefinitions canon
  2. 02
    Evidence artifactsite-context.md
  3. 03
    Evidence artifactai-manifest.json
  4. 04
    Evidence artifactai-governance.json
Canonical foundation#01

Definitions canon

/canon.md

Opposable base for identity, scope, roles, and negations that must survive synthesis.

Makes provable
The reference corpus against which fidelity can be evaluated.
Does not prove
Neither that a system already consults it nor that an observed response stays faithful to it.
Use when
Before any observation, test, audit, or correction.
Artifact#02

site-context.md

/site-context.md

Published surface that contributes to making an evidence chain more reconstructible.

Makes provable
Part of the observation, trace, audit, or fidelity chain.
Does not prove
Neither total proof, obedience guarantee, nor implicit certification.
Use when
When a page needs to make its evidence regime explicit.
Artifact#03

ai-manifest.json

/ai-manifest.json

Published surface that contributes to making an evidence chain more reconstructible.

Makes provable
Part of the observation, trace, audit, or fidelity chain.
Does not prove
Neither total proof, obedience guarantee, nor implicit certification.
Use when
When a page needs to make its evidence regime explicit.
Artifact#04

ai-governance.json

/.well-known/ai-governance.json

Published surface that contributes to making an evidence chain more reconstructible.

Makes provable
Part of the observation, trace, audit, or fidelity chain.
Does not prove
Neither total proof, obedience guarantee, nor implicit certification.
Use when
When a page needs to make its evidence regime explicit.
Complementary probative surfaces (2)

These artifacts extend the main chain. They help qualify an audit, an evidence level, a citation, or a version trajectory.

ArtifactEvidence artifact

entity-graph.jsonld

/entity-graph.jsonld

Published surface that contributes to making an evidence chain more reconstructible.

ArtifactEvidence artifact

llms.txt

/llms.txt

Published surface that contributes to making an evidence chain more reconstructible.

Machine-first artifacts

This page is the canonical definition of machine-first artifacts within the canon, corpus, and machine readability layer of interpretive governance.

Machine-first artifacts are public files, manifests, indexes, policies, and structured records designed to expose identity, scope, canon, exclusions, source hierarchy, and interpretation rules to machine readers.

Short definition

Machine-first artifacts are public files, manifests, indexes, policies, and structured records designed to expose identity, scope, canon, exclusions, source hierarchy, and interpretation rules to machine readers.

Why it matters

They extend the site into a machine-readable documentary architecture. Files such as llms.txt, canon.md, ai-manifest.json, ai-governance.json, entity-graph.jsonld, and response-legitimacy.md help systems route meaning before answering.

In AI search, retrieval-augmented generation, autonomous browsing, and agentic reading, a corpus is not interpreted only by its visible prose. It is interpreted through routes, files, metadata, exclusions, entity relations, sitemap placement, and internal links. Machine-first artifacts names one part of that documentary control layer.

The strategic function is therefore not cosmetic. The concept helps prevent systems from flattening doctrine, service language, proof artifacts, and observations into the same authority level. It also gives search engines a clearer canonical page to associate with the term rather than forcing them to choose between a hub, a category, a blog article, and a machine artifact.

What it is not

They are not magic ranking files, not compliance guarantees, not secret model instructions, and not a replacement for coherent pages and internal links.

This distinction matters because machine-readable governance can create false confidence. A structured file, a definition page, or a graph relation should never be treated as proof that external systems comply with the intended reading. It only makes the intended reading more explicit, testable, and auditable.

Common failure modes

  • artifacts are published but not linked from the human corpus;
  • artifacts name concepts that do not have canonical pages;
  • artifacts drift away from the sitemap and visible definitions;
  • external systems discover files but cannot resolve what has authority;

These failures are typical when the human corpus and the machine-first corpus evolve separately. They increase interpretive risk because models can still produce coherent answers while violating the source hierarchy or ignoring exclusions.

Governance implication

Each artifact should have a role, a stable URL, a corresponding human-facing explanation, and links to canonical definitions. Machine-first artifacts work only when they are part of a larger documentary architecture.

For SERP ownership, the same principle applies: the canonical page should receive descriptive links, appear in the definitions registry, be discoverable from the glossary, and be reinforced by machine-first artifacts without competing against them.

Supporting artifacts and surfaces