Architecture Decision Records

Decisions without recorded reasoning are decisions waiting to be repeated badly. Each ADR captures the context, constraints, and trade-offs behind a significant technical choice — so future-me (or anyone inheriting the system) knows why, not just what.

• ADR: Cilium CNI — Why Cilium with eBPF over Calico for the ARM64 cluster
• ADR: Longhorn Storage — Distributed block storage on commodity SBC hardware
• ADR: JSON-RPC Protocol — Why JSON-RPC 2.0 for inter-agent communication
• ADR: MCP over HTTP Transport — HTTP gateway over stdio for shared tool access
• ADR: LiteLLM Gateway — Centralized model abstraction with provider portability
• ADR: Vault + ESO — Encrypted secret management for GitOps workflows
• ADR: Hand-Crafted SVGs over Mermaid — Why hand-crafted SVGs replaced Mermaid.js diagrams