Architecture Decision Records

Architecture Decision Records (ADRs) capture significant architectural decisions with context, options considered, rationale, and consequences.

ADR-001 Accepted 2026-02-11

Codex Institutional Memory System

Established the hierarchical Codex structure (architecture/, operations/, context/, decisions/, playbooks/, templates/) to organize 74+ scattered markdown files. Created INDEX.md, START_HERE.md, and CHANGELOG.md for discoverability.

AI-712 AI-714 AI-741
ADR-002 Proposed 2026-02-12

Autonomous GitHub Agent Code Execution

Multi-tier autonomous agent system for reading, analyzing, and executing code from GitHub repositories. Sandboxed execution with resource constraints (2 cores, 1GB RAM, 30s timeout). Decision Engine → Security Validator → Validation Sandbox → Execution Layer → Rollback System.

Autonomous Code Execution Security
ADR-003 Implemented 2026-02-25

Operation Cost Purge — Model Routing Architecture

Migrated from Claude Opus 4.6 as default to a hybrid multi-model architecture. Gemini 3.1 Pro for reasoning ($2/$12 per 1M), DeepSeek Chat for casual ($0.14/$0.28), Claude Sonnet for tool-calling. 80-95% reduction in Anthropic spend. Personality preserved through ARIA_SOUL.md, DeepSoul, and Style Lock.

AI-1447 Cost Optimization Model Routing
ADR-004 Accepted 2026-02-25

Aria Life OS & Ventures Architecture

Expanded Aria into two unified domains: Aria Life OS (unified home/vehicle/health/family management) and Aria Ventures (autonomous business entity with 4 ventures). Both unified by cross-domain Anticipatory Intelligence Engine. Projected $274K MRR by Month 6.

Life OS Ventures Strategy

ADR source files: codex/decisions/ADR-*.md in the repository. Each ADR follows the template at codex/templates/adr-template.md.