A Schema for Machine-Interpretable Glossary Terms and AI-Term Memory Conditioning
Metadata
- rfc_id: RFC-004
- title: Glossary Vocabulary and DefinedTermSet Specification
- status: Draft
- version: 0.1
- authors:
- David W. Bynon (@TrustPublishing)
- WebMEM Working Group
- date_created: 2025-07-15
- license: CC BY-SA 4.0
- domain_scope: Vertical-Agnostic
- depends_on: RFC-001, RFC-002
Purpose
This RFC defines the structure, schema, and publishing model for glossary terms used in trust-scored, machine-ingestible content under the WebMEM Protocol.
Introduces:
DefinedTermfragmentsDefinedTermSetgroupings- Canonical term resolution via persistent URIs
- Mapping between terms,
data_idtokens, and retrieval metadata
Why This Matters
AI agents must:
- Understand what terms like “MOOP” or “coinsurance” mean
- Resolve canonical term definitions from fragments
- Map UI-visible data to semantic concepts
- Validate that term = value = trust object
RFC-004 creates the trust scaffolding that enables machine-visible glossary alignment and term-level memory conditioning.
Core Object: DefinedTerm
term_id: term-mooptotal
term_slug: mooptotal
term_name: Maximum Out-of-Pocket (MOOP)
alternate_names:
- MOOP
- Annual MOOP
description: >
The maximum amount a plan member is required to pay out-of-pocket
for in-network Medicare-covered services during a coverage year.
value_type: currency
unit: usd
glossary_scope: medicare-advantage
canonical_url: https://webmem.com/terms/mooptotal
source:
organization: CMS
citation: CMS Medicare Glossary
retrieved: 2025-07-05
used_by:
- in_moop
- plan_limit
see_also:
- term-in_network
- term-out_of_pocket
trust_level: high
confidence: 1.00
version: 1.0
notes: >
Often misunderstood as a deductible. MOOP applies after deductibles are met.
Core Object: DefinedTermSet
glossary_id: medicare-advantage
title: Medicare Advantage Glossary
source_organization: TrustPublishing
version: 1.0
terms:
- term_id: term-mooptotal
- term_id: term-in_primary
- term_id: term-premium
URI Best Practices
| Component | Recommendation |
|---|---|
| term_id | Globally unique. Use prefix term-. |
| term_slug | Lowercase, hyphenated (e.g. maximum-out-of-pocket) |
| canonical_url | Persistent, public, and machine-resolvable |
| glossary_url | Served at /glossary/{vertical}.ttl or .jsonld |
Supported Formats
| Format | Purpose |
|---|---|
| YAML | Canonical editing + version control |
| JSON-LD | AI schema compatibility |
| TTL | RDF and graph-based inference |
| Markdown | Human-readable glossary entry |
| PROV-O | Provenance trace and term correction |
Sample JSON-LD Output
{
"@context": "https://schema.org",
"@type": "DefinedTerm",
"@id": "https://webmem.com/terms/mooptotal",
"name": "Maximum Out-of-Pocket (MOOP)",
"description": "The maximum amount a plan member is required to pay out-of-pocket...",
"inDefinedTermSet": "https://webmem.com/glossary/medicare-advantage",
"termCode": "mooptotal"
}
AI Retrieval Model
An AI system encountering:
<td data-defined-term="Maximum Out-of-Pocket (MOOP)" data-glossary-id="term-mooptotal">
Will retrieve:
- Glossary Set:
medicare-advantage - Canonical Term:
mooptotal - Value Type:
currency
This enables:
- Fragment-level trust resolution
- Definition-to-data linkage
- AI memory conditioning and paraphrase accuracy
Canonical Reference
RFC-004 is published at webmem.com/rfc/rfc-004/ and versioned in the WebMEM RFC Registry.