UAIF / L1 / L1-F01

Root Cause Primary Domain

Objective

Capture and validate the root cause primary domain element within the Causal Separation Chain layer.

UAIF requirement

The incident record should implement the canonical root_cause_primary_domain field using the defined UAIF data type, validation constraints, and conditional rules.

Business impact

Supports defensible separation of initiating cause from observed manifestation and records uncertainty in causal attribution.

Validation approach

Validate root_cause_primary_domain for required in the Core profile, controlled vocabulary membership. Then review semantic consistency against the source incident evidence and the selected conformance profile.

Expected evidence

Retain the source record or analyst input for root_cause_primary_domain, schema-validation output, transformation history, selected profile, schema version and reviewer rationale where judgement is involved.

Mapping and source

UAIF Schema Specification; UAIF Technical Specification; JSON pointer /properties/root_cause_primary_domain.

Implementation guidance

Populate root_cause_primary_domain from an identified source or documented analyst decision. Enforce the schema constraints at record creation and update, preserve the original value and provenance, and surface validation failures without silently coercing data.

Assessment considerations

Sample records across normal, boundary and invalid conditions. Confirm that root_cause_primary_domain is populated only when applicable, conditional rules are enforced, provenance is retained and downstream systems do not change its meaning or precision.

Canonical schema definition

JSON propertyroot_cause_primary_domain
Required in core profileYes
Type"string"
Allowed valuesHuman, System, Data, External

Source: UAIF Schema Specification and UAIF Core JSON Schema.