Architecture

The canonical design lives in docs/adr/ in the bones repository — Architecture Decision Records, one per material design call. This page is the index, not a mirror; rendering ADRs here would drift from the repo source of truth.

Read them in repo for the latest text.

Foundational

• ADR 0001 — Public surface: why coord/ is the sole public package.
• ADR 0003 — Substrate hiding: how the substrate is hidden behind coord.
• ADR 0019 — CLI binaries (superseded): the unified bones binary; original three-binary split documented as historical context.

Coordination

• ADR 0004 — Conflict resolution: fossil fork + chat.
• ADR 0005 — Tasks in NATS KV
• ADR 0007 — Claim lifecycle: hold scope, claim CAS, reclaim.
• ADR 0008 — Chat substrate
• ADR 0014 — Typed edges
• ADR 0016 — Closed-task compaction

Code artifacts

• ADR 0010 — Fossil code artifacts: coord.Commit, OpenFile, Checkout, Diff, Merge.

Orchestration

• ADR 0023 — Hub-leaf orchestrator