Architecture Decision Records (ADRs)

Overview

This directory contains Architecture Decision Records (ADRs) that document significant architectural decisions, their context, rationale, and consequences.

Total ADRs: 58 records (000-057)

Recent ADRs

• ADR-057: CommandRegistry - Unified Command Discovery (Jan 2026) - Central registry for command parity across interfaces (#551)
• ADR-056: Consciousness Expression Patterns (Jan 2026) - Template-based personality consistency
• ADR-055: Object Model Implementation (Jan 2026) - Domain model dataclass patterns
• ADR-054: Cross-Session Memory Architecture (Jan 2026) - Three-layer context persistence from PDR-002
• ADR-053: Trust Computation Architecture (Jan 2026) - Trust gradient model from PDR-002
• ADR-052: Tool-Based MCP Standardization (Oct 2025, updated Jan 2026) - MCP implementation pattern standardization
• ADR-051: Unified User Session Context (Jan 2026) - User context unification
• ADR-050: Conversation-as-Graph Model (Jan 2026) - Multi-party conversation modeling
• ADR-049: Conversational State and Hierarchical Intent (Jan 2026) - Multi-turn conversation architecture
• ADR-048: ServiceContainer Lifecycle Management (Jan 2026) - Service container singleton pattern
• ADR-047: Async Event Loop Awareness (Dec 2025) - Database connection event loop handling
• ADR-046: Moment.type Agent Architecture (Nov 2025) - Typed input decomposition and specialized agent routing

ADR Categories

ADRs are organized by decision domain:

• Platform & Integration (MCP, Claude Code, spatial intelligence)
• Infrastructure (staging, monitoring, configuration)
• Security & Auth (JWT, authentication patterns)
• Development Process (testing, session management)
• Product Strategy (mobile, features, prioritization)

Creating New ADRs

See adr-000-meta-platform.md for the standard ADR template and decision-making framework.

Navigation

• ← Back to Current
• 📚 Documentation Home
• Pattern Index - Related architectural patterns

---

Last Updated: January 22, 2026 Maintained By: Documentation Team Purpose: Directory navigation and content overview