Title here
Summary here
This directory contains the Architecture Decision Records (ADRs) for this project.
Each ADR follows this structure:
# NNNN: Title
**Status**: Proposed | Accepted | Superseded | Deprecated
**Date**: YYYY-MM-DD
## Context — What is the issue motivating this decision?
## Candidates — Options considered with trade-offs
## Decision — What we chose and why
## Consequences — What becomes easier/harder
## Constitution Compliance — Mapping to project principlesADRs are numbered sequentially: 0001, 0002, etc.
Numbers are never reused. If a decision is reversed, the original ADR is marked “Superseded” and a new ADR is created with a reference.
| ADR | Title | Status |
|---|---|---|
| 0001 | Keep the Domain Behind Hexagonal Ports | Proposed |
| 0002 | Use Sled as the Persisted VFS Index Source | Proposed |
| 0003 | Use CAS-Guarded Shadow-File Mutations | Proposed |
| 0004 | Use One Shared Workspace Daemon for MCP Clients | Proposed |
| 0005 | Use Native Out-of-Process Sidecar Extensions | Proposed |
| 0006 | Keep Extension Registry Writes Out of MCP Serving Paths | Proposed |
| 0007 | Queue Inbound Sidecar Frames During HostCalls | Proposed |
| 0008 | Notify the Real Extension Host After MCP Mutations | Proposed |
| 0009 | Defer Extension Callbacks After Workspace Apply-Edits | Proposed |
| 0010 | Stage Daemon Startup and Capability Readiness | Proposed |
| 0011 | Use Host-Owned Namespaced Storage for Agent Memory | Proposed |
ls docs/ADR/ | grep -oP '^\d+' | sort -n | tail -1 + 1cp docs/ADR/.template.md docs/ADR/NNNN-short-name.mdBefore merging any new or modified ADR:
[ADR-NNNN] links resolve to existing filesSupersedes/Superseded by metadata