Architecture decision records

Download Markdown

One decision per record. A record states the context, the decision, and its consequences, and is not edited after the fact except to mark it superseded.

0001 - The local hub is the cloud
0002 - One storage engine everywhere
0003 - Wrap AgentFS per session
0004 - Manual pruning in v1
0005 - An installable PWA is the human surface
0006 - Search is engine-native
0007 - Asynchronous mailbox semantics
0008 - Lean by construction
0009 - Browser-side artifact encryption
0010 - One pinned engine version
0011 - MCP is primary, A2A is deferred
0012 - Agent identity and trust
0013 - Per-session serialization
0014 - Optional embedded tailnet
0015 - The human interface follows the design foundation
0016 - Push notifications are deferred beyond v1
0017 - The inbox caps open action items
0018 - The project knowledge base
0019 - The hub client is a proxy and a CLI
0020 - Sessions belong to their agent
0021 - The token is the identity
0022 - Search ranks in the hub, bounded by a fetch cap
0023 - Prove the interface with standard tools
0024 - Deliver notifications on the tool result, not by polling
0025 - A live artifact version is a pointer, not a draft
0026 - A contentless nudge to an operator-configured target (refines 0016)
0027 - An agent may put a deadline on the item it asks