Architecture Decision Records (ADRs)
Architecture Decision Records capture the key technical decisions made during the development of vrOS. Each ADR documents:
- Context: The situation that necessitated a decision
- Decision: What was decided
- Consequences: The implications of the decision
- Status: Whether the decision is still in effect
Key Decisions
Performance & Architecture
- ADR-001: Lock-Free IPC - Achieving sub-25μs IPC latency
- ADR-022: VROS Architecture - Overall system design
Graphics & Rendering
- ADR-003: Custom DX12 Renderer - DirectX 12 implementation
Security & Isolation
- ADR-004: Overlay Process Isolation - Security through sandboxing
ADR Format
Each ADR follows a consistent format:
# ADR-XXX: Title
## Status
[Accepted/Deprecated/Superseded]
## Context
What is the issue that we're seeing that is motivating this decision?
## Decision
What is the change that we're proposing and/or doing?
## Consequences
What becomes easier or more difficult to do because of this change?
Contributing
When proposing significant architectural changes, please create a new ADR following our template. This helps maintain a clear record of our technical evolution.