From 76cad49518f7e3e0efbb2696653f26808da5023d Mon Sep 17 00:00:00 2001
From: Graeme Foster <80714+GraemeF@users.noreply.github.com>
Date: Tue, 29 Sep 2026 17:46:04 +0100
Subject: [PATCH] chore: ignore the private tracker and say where work is
 tracked

---
 .gitignore | 9 ++++++++-
 CLAUDE.md  | 7 +++++++
 2 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/.gitignore b/.gitignore
index 1c921bb6..5fdd8626 100644
--- a/.gitignore
+++ b/.gitignore
@@ -56,4 +56,11 @@ tmp/
 temp/
 worktrees/
 
-*.local.*
\ No newline at end of file
+*.local.*
+
+# The maintainers' beads tracker is not part of this repository
+/.beads/
+/.beads.gate.lock
+.beads-credential-key
+.dolt/
+CLAUDE.local.md
diff --git a/CLAUDE.md b/CLAUDE.md
index 985c8f7a..7a0a68a6 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -40,6 +40,13 @@ eventsourcing/            <- Repo root (main branch checkout)
 - Verify you're in correct worktree with `pwd` and `git branch`
 - Each worktree is a complete working copy with its own node_modules and mise config
 
+## The tracker
+
+The maintainers track work in a [bd (beads)](https://github.com/gastownhall/beads)
+tracker that is not part of this repository. External contributors don't need it
+and should use GitHub issues instead. `.beads/` is gitignored, and nothing
+tracked here names a bead.
+
 ## Releasing
 
 - Start each new piece of work in a new branch from the latest origin/main. Changes are always submitted via a PR.