Boundary Disclosure Card¶
Core Idea¶
A small, schematized, standardized disclosure attached to an artifact at its reuse boundary, so that consuming the artifact and reading the card are the same event. It turns documentation-that-might-be-read into disclosure-that-cannot-be-missed.
How would you explain it like I'm…
The Stuck-On Label
Can't-Miss Label
Disclosure You Can't Miss
Broad Use¶
- Food: nutrition-facts labels, allergen disclosure, and dating marks printed on every package by regulation.
- Pharmaceuticals: package inserts carrying indications, dosage, and contraindications in every box.
- Electronics: datasheets shipping with every component, their industry-stable schema readable across vendors.
- Hazardous materials: safety data sheets travelling with each shipment under an internationally agreed sixteen-section schema.
- Software: API docs, machine-readable interface schemas, and dependency manifests shipped with the endpoint or package.
- Machine learning: data cards and model cards — explicitly borrowing the nutrition-label idea — travelling with datasets and models.
- Buildings & consumer goods: occupancy placards, capacity plaques, care labels, and energy-rating stickers affixed at the point of use.
Clarity¶
Separates documentation — which the consumer must seek out and may never read — from boundary disclosure, which cannot be encountered without also being seen, and distinguishes the shared schema from the per-instance card.
Manages Complexity¶
Collapses the consumer's decision from "understand the artifact" to "read the card and check intended use against declared limits," a far smaller task that scales across impersonal reuse.
Abstract Reasoning¶
The schema is the heavy coordination object, so agreeing it is the central design move; detachment of card from artifact is the characteristic interface failure, and a known harm with no slot in the schema is structurally invisible until a slot is added.
Knowledge Transfer¶
- Food → machine learning: food-labeling discipline was deliberately borrowed as data cards and "nutrition labels for ML."
- Electronics → software: component datasheets port to API contracts, with max ratings becoming rate limits and error codes.
- Pharmacology → AI: package inserts port to system cards, with indications becoming intended uses and contraindications out-of-scope uses.
- Hazmat → software: safety data sheets port to dependency manifests — the bill-of-materials that travels with every package.
Example¶
A hazardous-materials Safety Data Sheet projects a chemical onto exactly the facts governing safe handling, schematized against the Globally Harmonized System's sixteen numbered sections, so a handler in any country reads section 4 for first-aid; a shipment arriving without its sheet is an auditable interface failure, not a defect in the chemical.
Relationships to Other Abstractions¶
Current abstraction Boundary Disclosure Card Prime
Parents (2) — more general patterns this builds on
-
Boundary Disclosure Card presupposes, typical Interface Prime
A Boundary Disclosure Card typically presupposes the producer-consumer reuse interface at which its standardized facts must be encountered.
-
Boundary Disclosure Card is part of, conditional Provenance Prime
A Boundary Disclosure Card contains Provenance when its schema includes origin or lineage among the facts attached to the reusable artifact.
Condition / exception The shared disclosure schema selects origin, lineage, or custody as a load-bearing fact for safe reuse.
Hierarchy paths (5) — routes to 5 parentless roots
- Boundary Disclosure Card → Provenance → Attestation → Authentication
- Boundary Disclosure Card → Provenance → Traceability → Observability
- Boundary Disclosure Card → Provenance → Traceability → Transformation → Function (Mapping)
- Boundary Disclosure Card → Provenance → Custody Transfer → State and State Transition → Phase Space
Not to Be Confused With¶
- Boundary Disclosure Card is not Provenance because the card is the attached, schematized disclosure surface whereas provenance is the record of origin and chain of custody — one fact among the card's five.
- Boundary Disclosure Card is not an Interface because the card is disclosure attached at a reuse boundary whereas the interface is the operative contract governing interaction — a nutrition label says what is inside, not how the food plugs in.
- Boundary Disclosure Card is not Signaling because the card derives its force from standardization and attachment whereas a signal derives credibility from being costly to fake; the card discloses claims, leaving verification to a separate audit.