Disciplines · Decisions (ADRs)

Decisions (ADRs)

The architecture decision register — context, decision, consequences.

99documents

99 documents, each at its one canonical home.

DecisionStatusDate
ADR-0001: Git Repository Consolidation StrategyAccepted2026-01-10
ADR-0002: Package Manager Unification with pnpmAccepted2026-01-10
ADR-0003: Unified Authentication and Identity StrategyAccepted2026-01-10
ADR-0004: Eventing Strategy - Event Broker and Contract PatternsAccepted2026-01-10
ADR-0005: API Contract Approach - OpenAPI and Protocol BuffersAccepted2026-01-10
ADR-0006: Versioning and Release StrategySuperseded2026-01-10
ADR-0007: OSHUN Shell Architecture and Domain Adapter PatternAccepted2026-02-16
ADR-0008: OSHUN Web Strategy - Single Website with Installable PWAAccepted2026-02-16
ADR-0009: Deep-Linking and Cross-Domain Routing ModelAccepted2026-02-16
ADR-0010: Shared Identity and Cross-Domain Session ModelAccepted2026-02-16
ADR-0011: Offline Caching and Sync StrategyAccepted2026-02-16
ADR-0012: Analytics Taxonomy and Event NamingAccepted2026-02-16
ADR-0013: OSHUN Studio Information Architecture and Capability Exposure ModelAccepted2026-02-23
ADR-0014: OSHUN Studio Design Language and Visual Identity GovernanceAccepted2026-02-23
ADR-0015: OSHUN Studio Typography System and Readability GovernanceAccepted2026-02-23
ADR-0016: OSHUN Studio Color System and Token GovernanceAccepted2026-02-23
ADR-0017: OSHUN Studio Spacing and Layout Grid GovernanceAccepted2026-02-23
ADR-0018: OSHUN Studio Component Primitives and Composition ContractsAccepted2026-02-23
ADR-0019: OSHUN Studio Complex Interaction Patterns and State OrchestrationAccepted2026-02-23
ADR-0020: OSHUN Studio Navigation and Command SurfacesAccepted2026-02-23
ADR-0021: OSHUN Studio Search and Global DiscoveryAccepted2026-02-23
ADR-0022: OSHUN Studio Cross-Domain Entity ModelAccepted2026-02-23
ADR-0023: OSHUN Studio Workspace Context SwitchingAccepted2026-02-23
ADR-0024: OSHUN Studio Multi-Project OperationsAccepted2026-02-23
ADR-0025: OSHUN Studio Authentication ArchitectureAccepted2026-02-23
ADR-0026: OSHUN Studio Session and Device ManagementAccepted2026-02-23
ADR-0027: OSHUN Studio RBAC and Permission Policy UXAccepted2026-02-23
ADR-0028: OSHUN Studio Enterprise Tenant IsolationAccepted2026-02-23
ADR-0029: OSHUN Studio Audit and Compliance SurfacesAccepted2026-02-23
ADR-0030: OSHUN Studio Notification CenterAccepted2026-02-23
ADR-0031: OSHUN Studio Activity and Change FeedsAccepted2026-02-23
ADR-0032: OSHUN Studio Real-Time Collaboration SubstrateAccepted2026-02-23
ADR-0033: OSHUN Studio Presence and Cursor SystemsAccepted2026-02-23
ADR-0034: OSHUN Studio Commenting and Annotation SystemAccepted2026-02-23
ADR-0035: OSHUN Studio Review and Approval WorkflowsAccepted2026-02-23
ADR-0036: OSHUN Studio File and Media IngestionAccepted2026-02-23
ADR-0037: OSHUN Studio Asset Preview PipelineAccepted2026-02-23
ADR-0038: OSHUN Studio Background Jobs and Progress UXAccepted2026-02-23
ADR-0039: OSHUN Studio Resilience and Error UXAccepted2026-02-23
ADR-0040: OSHUN Studio Metrics and Analytics InstrumentationAccepted2026-02-23
ADR-0041: OSHUN Studio Observability and Operational DashboardsAccepted2026-02-23
ADR-0042: OSHUN Studio Experimentation and Feature FlagsAccepted2026-02-23
ADR-0043: OSHUN Studio Performance BudgetsAccepted2026-02-23
ADR-0044: OSHUN Studio Accessibility GovernanceAccepted2026-02-23
ADR-0045: OSHUN Studio Internationalization and LocalizationAccepted2026-02-23
ADR-0046: OSHUN Studio API Gateway and BFF CompositionAccepted2026-02-23
ADR-0047: OSHUN Studio Webhooks and External AutomationAccepted2026-02-23
ADR-0048: OSHUN Studio SDK and Documentation IntegrationAccepted2026-02-23
ADR-0049: OSHUN Studio Security Hardening ProgramAccepted2026-02-23
ADR-0050: OSHUN Studio Data Retention and Lifecycle ControlsAccepted2026-02-23
ADR-0051: OSHUN Studio Backup and Disaster Recovery UXAccepted2026-02-23
ADR-0052: OSHUN Studio Launch Readiness GovernanceAccepted2026-02-23
ADR-0053: OSHUN Customer Information Architecture and Tara-Centered SpineAccepted2026-03-24
ADR-0054: OSHUN Nisaba as a First-Class Customer DomainAccepted2026-03-24
ADR-0055: OSHUN Web Shell Relationship ModelAccepted2026-03-24
ADR-0056: OSHUN Mobile Shell Relationship ModelAccepted2026-03-24
ADR-0057: OSHUN Customer/Admin Shell Relationship ModelAccepted2026-03-24
ADR-0058: OSHUN Daypart Cross-Domain Journey ModelAccepted2026-03-24
ADR-0059: OSHUN Research-to-Practice Journey ModelAccepted2026-03-24
ADR-0060: OSHUN Story-to-Source Journey ModelAccepted2026-03-24
ADR-0061: OSHUN Sky-to-Text Journey ModelAccepted2026-03-24
ADR-0062: OSHUN Assistant-Led Continuity Journey ModelAccepted2026-03-24
ADR-0063: OSHUN V1 Foundation Token System——
ADR-0064: OSHUN Shell Domain Accent Behavior——
ADR-0065: OSHUN Grounded Evidence UI Behavior——
ADR-0066: OSHUN Disclosure And Synthetic Indicator UI Behavior——
ADR-0067: OSHUN Trust, Confidence, And Provenance Badge UI Behavior——
ADR-0068: OSHUN Admin Severity And Queue State UI Behavior——
ADR-0069: OSHUN Assistant Persona Switching UI Behavior——
ADR-0070: OSHUN Avatar And Voice Identity Indicator UI Behavior——
ADR-0071: OSHUN Review And Approval State UI Behavior——
ADR-0072: OSHUN Customer Auth and Session ModelAccepted2026-03-27
ADR-0073: Nx Release Owns Versioning and PublishingAccepted2026-07-18
ADR-0074: Yemaya Study & Deconstruction Workspace ArchitectureAccepted2026-07-18
ADR-0075: Eve → Metis Workbench Read TransportProposed2026-09-01
ADR-0076: Eve governed goal-to-verified-delivery lifecycleProposed2026-09-02
ADR-0077: Eve browser and native computer-use ownershipProposed2026-09-08
ADR-0078: Computer-use fabrication boundary——
ADR-0079: Eve native desktop fixture boundary——
ADR-0080: Eve native desktop per-run execution controls——
ADR-0081: Eve watcher semantics before UI——
ADR-0082: Eve canonical skill reconciliation——
ADR-0083: Eve typed generative-UI confirmation——
ADR-0084: Eve governed asynchronous voice depth——
ADR-0085: Fail-closed governance for Eve evaluation data——
ADR-0086: Eve per-plane reliability objectives——
ADR-0087: Eve trace and correlation continuity——
ADR-0088: Eve operation-class reliability policy——
ADR-0089: Keep Eve turn events bespoke until a truthful AG-UI adapter exists——
ADR-0090: MCP transport authorization boundaries——
ADR-0091: Defer A2A until an independent agent boundary exists——
ADR-0092: Fail-closed external integration registry——
ADR-I1: Isis Aggregate Ownership and the Prohibition on Shadow Canonical TablesProposed2026-07-28
ADR-M0.5: Metis Persistence Ownership and Database BoundaryProposed2026-08-27
ADR-S1: Workbench-Kit Package Ownership and Dependency DirectionProposed2026-07-24
ADR-S2: Generic Parameters and Extension Points for @oshun/workbench-kitAdopted2026-07-24
ADR-S3: Event, Audit, Idempotency, and Transaction BoundariesAdopted2026-07-24
ADR-S4: UI Composition and ThemingAdopted2026-07-24
ADR-S5: Compatibility and Incremental MigrationAdopted2026-07-24