# 🧠 UHX Glossary *A semantic system architecture using 32-bit trait encodings and hex-based relationship modeling for universal system understanding* --- ## 🔷 UHX – Universal Hex > The umbrella framework that unifies four layers of semantic modeling: - **UHT** – Universal Hex Traits (entity encoding) - **UHR** – Universal Hex Relationships (link encoding) - **UHD** – Universal Hex Diagrams (visual/topological representations) - **SDR** – Self-Describing Requirements (requirements enriched with semantic metadata) --- ## 🔸 UHT – Universal Hex Traits > A **32-bit semantic fingerprint** that encodes the essence of any entity using binary traits. ### ✅ Structure: - 4 semantic layers, 8 traits each: - **Physical** (bits 1–8) - **Functional** (bits 9–16) - **Abstract** (bits 17–24) - **Social** (bits 25–32) ### ✅ Purpose: - Compress and encode *what something is* - Enable filtering, clustering, reasoning, and explainability - Bit-addressable semantic identity ### ✅ Example: ```text UHT: 00700300 → Traits: Purposeful, Emits output, Processes logic, Transforms state, Symbolic, Logical → Meaning: Autonomous feedback logic controller ``` --- ## 🔸 UHR – Universal Hex Relationships **Definition:** An 8-bit code that expresses _how entities are related_. Each bit describes a specific semantic property of the link. ### 🔹 UHR Traits |Bit|Trait|Meaning| |---|---|---| |1|Directional|A → B| |2|Causal / Influential|A causes or influences B| |3|Hierarchical / Containment|A contains or governs B| |4|Symbolic / Representational|A represents or encodes B| |5|Governed / Constrained|Defined by rules or contracts| |6|Temporal / Sequence-bound|Depends on time/order| |7|Context-sensitive|Only valid in some conditions| |8|Non-reciprocal|Not bidirectional| **Example:** ```text UHR: 0xD0 Traits: Directional + Causal + Symbolic Means: A fulfills B as a causal symbolic implementation ``` --- ## 🔸 UHD – Universal Hex Diagrams **Definition:** Visual representations of semantically encoded systems using UHT and UHR. ### 🔹 Features - Nodes = Entities (UHT) - Edges = Relationships (UHR) - Layer color-coding (Physical, Functional, Abstract, Social) - Can be exported as Mermaid, Graphviz, or Obsidian Canvas **Example (Mermaid):** ```mermaid graph TD REQ["REQ-T01 <br> UHT: 00008800"] COMP["CTRL-01 <br> UHT: 00700300"] REQ -->|SATISFIES <br> UHR: D0| COMP ``` --- ## 🔸 SDR – Self-Describing Requirement **Definition:** A structured requirement enriched with its own semantic encoding via UHT and related traceability via UHR. ### 🔹 Components ```yaml id: REQ-T01 uht: 00008800 traits: [symbolic, behavior-guiding, regulated] natural_language: - The system shall maintain a defined room temperature range. satisfied_by: [CTRL-01] verified_by: [TEST-01] ``` ### 🔹 Benefits - Machine-readable - Traceable through lifecycle - AI- and LLM-compatible - Explainable and auditable --- ## How UHX Works as a System |Component|What it Defines|Format|Key Use| |---|---|---|---| |`UHT`|What an entity _is_|32-bit hex|Compression, search, clustering| |`UHR`|How things _relate_|8-bit hex|Explainable graph edges| |`UHD`|What it _looks like_|Diagram|Visual modeling| |`SDR`|What it _means_|YAML/JSON|Requirements management & traceability| --- ## 🧰 Additional Concepts ### 🧩 Trait Density - Refers to how many layers (P, F, A, S) are active in an entity - Helps assess complexity, abstraction, or implementation status ### 🧮 Semantic Delta - Measures difference between two UHT or UHR codes - Useful for change detection, diffing, or traceability gaps ### 📐 Trait Clusters - Logical groupings of frequently co-occurring traits - Can be labeled as semantic archetypes (e.g. Interface, Agent, Standard) --- _This glossary is intended as a live reference for UHX modeling, systems engineering, LLM integration, and knowledge architecture._ www.universalhex.org