diff --git a/README.md b/README.md
index 80d6c39..a598bec 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,10 @@
 # ⚖️ 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 "Status: Experimental - Not recommended for production use")
+
+> [!CAUTION]
+> This project is currently **experimental** and is not recommended for production use. The API and core orchestration features are subject to rapid change as we stabilize the system.
 
 Dual nature—combining bare-metal virtualized hardware management (aSHARD VRAM pinning) with quantum-accelerated Kubernetes scheduling.
 
@@ -9,12 +12,39 @@ Dual nature—combining bare-metal virtualized hardware management (aSHARD VRAM
 
 `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.
 
+```mermaid
+graph TD
+    subgraph "Cloud Native Layer"
+        K8S[Kubernetes Cluster]
+        APP[AI Workloads]
+    end
+
+    subgraph "Orchestration Layer"
+        Arbiter((Arbiter Core))
+        SCHED[Quantum-Accelerated Scheduler]
+    end
+
+    subgraph "Infrastructure Layer"
+        BM[Bare-Metal Hardware]
+        GPU[Virtualized GPU / VRAM]
+    end
+
+    APP --> K8S
+    K8S <--> Arbiter
+    Arbiter <--> SCHED
+    Arbiter <--> BM
+    BM --- GPU
+
+    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.
+- 🏗️ **Infrastructure Awareness**: Directly manages bare-metal resources to bypass virtualization overhead and maximize raw hardware performance.
+- 📍 **VRAM Optimization**: Implements aSHARD pinning for granular GPU memory allocation, effectively eliminating fragmentation in high-demand AI environments.
+- ⚛️ **Quantum-Accelerated Scheduling**: Leverages next-gen algorithms to optimize complex Kubernetes workload distribution across hybrid cloud/edge deployments.
+- ⚖️ **Unified Orchestration**: Provides a single, cohesive control plane for synchronizing low-level hardware state with high-level cluster requirements.
+- 🔌 **Cloud-Native Integration**: Seamlessly bridges the gap between traditional bare-metal management and modern container orchestration.
 
 ## ⚖️ License