diff --git a/.Jules/palette.md b/.Jules/palette.md index fecc08d..8c2739e 100644 --- a/.Jules/palette.md +++ b/.Jules/palette.md @@ -6,3 +6,8 @@ This journal contains critical UX/accessibility learnings discovered during the **Learning:** For infrastructure or backend projects without a functional frontend, the `README.md` serves as the primary User Experience (DX/UX). In these cases, micro-UX improvements shift from ARIA labels to scannability, clarity of project status, and informative (non-redundant) feature lists. **Action:** Treat the `README.md` as the landing page. Use visual status indicators (badges), scannable bullet points with representative emojis, and ensure that headers provide a clear path for the user to understand the project's utility and maturity. + +## 2026-05-20 - Standardized Visual Identity for Core Orchestration Components +**Learning:** In architecture diagrams for the `arbiter` ecosystem, users can more quickly identify the primary orchestration hub when it has a distinct visual style from its dependencies and consumers. + +**Action:** When representing the 'Arbiter Core' in Mermaid diagrams, use double-circle syntax `((Arbiter Core))` and apply a high-contrast style: `fill:#f96,stroke-width:4px`. diff --git a/README.md b/README.md index 80d6c39..48fd218 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 - Open source software license](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) +![Status: Experimental - Not recommended for production](https://img.shields.io/badge/Status-Experimental-orange) + +> [!CAUTION] +> This project is currently **Experimental**. It is not recommended for use in production environments. Dual nature—combining bare-metal virtualized hardware management (aSHARD VRAM pinning) with quantum-accelerated Kubernetes scheduling. @@ -9,6 +12,31 @@ 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. +## 🏗️ Architecture + +```mermaid +graph TD + subgraph CloudNative [Cloud Native Layer] + K8S[Kubernetes Workloads] + end + + subgraph Orchestration [Orchestration Layer] + Arbiter((Arbiter Core)) + style Arbiter fill:#f96,stroke-width:4px + QS[Quantum-Accelerated Scheduler] + end + + subgraph Infrastructure [Infrastructure Layer] + BM[Bare-Metal Virtualization] + ASHARD[aSHARD VRAM Pinning] + end + + K8S <--> QS + QS <--> Arbiter + Arbiter <--> ASHARD + ASHARD <--> BM +``` + ## 🚀 Key Features - 🏗️ **Infrastructure Awareness**: Directly manages bare-metal resources for maximum performance.