From 27f749cc9394173558bdcca51cbb5be85cc82f25 Mon Sep 17 00:00:00 2001 From: Steve Yegge Date: Wed, 24 Dec 2025 22:08:53 -0800 Subject: [PATCH] docs: introduce CLAW acronym (Commits as Ledger of All Work) --- docs/architecture.md | 5 +++-- docs/beads-data-plane.md | 7 ++++++- 2 files changed, 9 insertions(+), 3 deletions(-) diff --git a/docs/architecture.md b/docs/architecture.md index d36a9bec..78eca0ee 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -212,9 +212,10 @@ sync-branch: beads-sync # Separate branch for beads commits **Why sync-branch?** When multiple agents share a beads database, using a dedicated sync branch prevents beads commits from interleaving with code commits on feature branches. -#### Beads as Data Plane +#### Beads as Data Plane (CLAW) -Gas Town uses Beads for persistence. We've combined the data plane and control plane: +Gas Town uses Beads for persistence - **C**ommits as **L**edger of **A**ll **W**ork. +We've combined the data plane and control plane: - Traditional systems separate "what's stored" from "what to do next" - We store both in beads, so agent state survives crashes diff --git a/docs/beads-data-plane.md b/docs/beads-data-plane.md index a7b79076..aafc2a14 100644 --- a/docs/beads-data-plane.md +++ b/docs/beads-data-plane.md @@ -1,4 +1,4 @@ -# Beads as Data Plane +# Beads as Data Plane (CLAW) > **Status**: Design documentation > **See also**: [pinned-beads-design.md](pinned-beads-design.md), [propulsion-principle.md](propulsion-principle.md) @@ -6,6 +6,11 @@ ## Overview Gas Town agents coordinate through **Beads** - a git-backed issue tracker. + +**CLAW**: **C**ommits as **L**edger of **A**ll **W**ork. Git commits are the persistence +mechanism. Every state change becomes a commit, giving us atomic updates, full history, +and distributed sync for free. + We store agent state (work assignments, mail, molecules, hooks) as beads issues. ## How We Use It