Architecture Decision Records

ADRs capture significant design decisions and their rationale.

#	ADR	Status
0001	Architecture - Store, Registry, Backends	Accepted
0002	Configuration Resolution - No Merging	Accepted
0003	fsspec Is an Implementation Detail	Accepted
0004	Empty Path Semantics in Store	Accepted
0005	Bidirectional Path Resolution via to_key	Accepted
0006	Documentation Architecture - Source of Truth and Audiences	Accepted
0007	Three-Tier Documentation Architecture with docs-src/ and Literate Nav	Accepted
0008	Extension Namespace Contract (ext.*)	Accepted
0009	Glob - Three-Tier Design	Accepted
0010	Observe - Proxy Subclass Pattern	Accepted
0011	Retry - Per-Backend Native Configuration	Accepted
0012	Async Store / Backend API — Hybrid Model	Accepted
0013	Drop Optional-Extension Re-exports from __init__.py	Accepted
0014	Middleware Architecture — Path 1 (ProxyStore + Stream Wrappers)	Accepted
0015	Document ProxyStore in the Public API Reference	Accepted
0016	Seekable Read — Three-Tier Design	Accepted
0017	Seekable Read on Store API	Accepted
0018	SQLAlchemy Backend — Two-Class Architecture with Shared Base	Accepted
0019	Multi-Agent Orchestration Architecture	Accepted
0020	Orchestrate Iterative Convergence Model	Accepted
0021	Microsoft Graph SDK Choice — httpx + msal	Accepted
0022	Microsoft Graph Auth Model — Dual Flows Behind a Token-Provider Protocol	Accepted
0023	Async Monitor-URL Polling — Backend-Local in _graph	Accepted
0024	ResourceLocked Error Type	Accepted
0025	Async-to-Sync Backend Adapter (AsyncBackendSyncAdapter)	Accepted
0026	Strict-Gate Pattern for Optional Capability Kwargs	Accepted
0027	Single Bridge with Enforcement, Not Layered Mechanisms	Accepted
0028	Testing Architecture with Kind and Stage Axes and HTTP Replay Demotion	Accepted
0029	Offload Graph Transfer Spool I/O off the Event Loop	Accepted
0030	Azure HNS Is an Explicit Declaration, Not Auto-Detected	Accepted
0031	Expert Personas as Standalone Subagent Files	Accepted