UKS v3.0 Specification

The normative specification is maintained at spec/UKS-v3-specification.md in the GitHub repository.

Overview

A UKS packet is a JSON document conforming to application/uks+json (IANA pending). Every packet has a schema_version: "3.0" field and up to five layers:

Layer	Name	Required for
A	Data Contracts & Sources	L1, L2, L3
B	Scrape Targets	L2, L3
C	Extraction Rules	L2, L3
D	Directives	L3
E	Actions & Agent Instructions	L3

Minimum Valid Packet (L1)

{
  "packet_id": "uks-example-v1",
  "schema_version": "3.0",
  "conformance_level": "L1",
  "created_at": "2026-06-15T00:00:00Z",
  "topic": { "title": "Example Topic" },
  "sources": [
    {
      "id": "src_001",
      "title": "Example Source",
      "source_type": "research_paper",
      "credibility_score": 7,
      "evidence_grade": "moderate",
      "clinical_status": "informational"
    }
  ]
}

JSON Schema

The canonical JSON Schema (draft/2020-12) is at:

spec/schema/UKS.v3.schema.json

Validate any packet:

uks validate my-packet.uks.json

Or in TypeScript:

import { validate } from '@uks/sdk';
const result = validate(packet);

Standards Submissions

• IANA Registration Draft — application/uks+json
• W3C Community Group Charter — Universal Knowledge Schema CG
• Governance Policy — versioning, change process