🎨 Palette: Documentation UX & Accessibility improvements

README.md

@@ -1,21 +1,52 @@
 # ⚖️ arbiter
 
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-![Status: Experimental](https://img.shields.io/badge/Status-Experimental-orange)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg "License: MIT - Open source software license")](https://opensource.org/licenses/MIT)
+![Status: Experimental](https://img.shields.io/badge/Status-Experimental-orange "Project Status: Experimental - Not recommended for production use")
+
+> [!CAUTION]
+> This project is currently **Experimental**. It is not recommended for production use as it involves low-level hardware orchestration and quantum-accelerated algorithms that are still undergoing active development.
 
 Dual nature—combining bare-metal virtualized hardware management (aSHARD VRAM pinning) with quantum-accelerated Kubernetes scheduling.
 
 ## 📖 Overview
 
 `arbiter` is a specialized orchestration layer designed for high-performance computing environments. It bridges the gap between low-level hardware management and cloud-native scheduling, providing a unified interface for managing virtualized resources with precision.
 
+## 🗺️ Architecture
+
+```mermaid
+graph TD
+    subgraph Cloud_Native [Cloud Native Layer]
+        K8S[Kubernetes Cluster]
+    end
+
+    subgraph Orchestration [Orchestration Layer]
+        Arbiter((Arbiter Core))
+    end
+
+    subgraph Infrastructure [Infrastructure Layer]
+        BM[Bare-Metal Hardware]
+        AS[aSHARD VRAM Pinning]
+    end
+
+    K8S <--> Arbiter
+    Arbiter <--> BM
+    Arbiter <--> AS
+
+    style Arbiter fill:#f96,stroke-width:4px
+```
+
 ## 🚀 Key Features
 
 - 🏗️ **Infrastructure Awareness**: Directly manages bare-metal resources for maximum performance.
 - 📍 **VRAM Optimization**: Uses aSHARD pinning to eliminate GPU memory fragmentation.
 - ⚛️ **Next-Gen Scheduling**: Leverages quantum-accelerated algorithms for complex Kubernetes workloads.
 - ⚖️ **Unified Orchestration**: A single control plane for both hardware and cluster-level operations.
 
+## 📜 Context
+
+`arbiter` was created by **Igor Holt** (AI Architect) as a core component of the **Genesis Conductor Engine**. It serves as the resource orchestration layer for AI workloads, bridging high-level scheduling with specialized hardware constraints.
+
 ## ⚖️ License
 
 This project is licensed under the [MIT License](LICENSE).