Index: .beads/hooks/post-checkout
===================================================================
--- .beads/hooks/post-checkout	(revision 8681239c58e5a6f4b403f6d90aa3c3ef9c99c5da)
+++ .beads/hooks/post-checkout	(revision 76e9cfd1b3959f1e140695d2cc641616781861c4)
@@ -1,4 +1,4 @@
 #!/usr/bin/env sh
-# --- BEGIN BEADS INTEGRATION v1.0.3 ---
+# --- BEGIN BEADS INTEGRATION v1.0.4 ---
 # This section is managed by beads. Do not remove these markers.
 if command -v bd >/dev/null 2>&1; then
@@ -22,3 +22,3 @@
   if [ $_bd_exit -ne 0 ]; then exit $_bd_exit; fi
 fi
-# --- END BEADS INTEGRATION v1.0.3 ---
+# --- END BEADS INTEGRATION v1.0.4 ---
Index: .beads/hooks/post-merge
===================================================================
--- .beads/hooks/post-merge	(revision 8681239c58e5a6f4b403f6d90aa3c3ef9c99c5da)
+++ .beads/hooks/post-merge	(revision 76e9cfd1b3959f1e140695d2cc641616781861c4)
@@ -1,4 +1,4 @@
 #!/usr/bin/env sh
-# --- BEGIN BEADS INTEGRATION v1.0.3 ---
+# --- BEGIN BEADS INTEGRATION v1.0.4 ---
 # This section is managed by beads. Do not remove these markers.
 if command -v bd >/dev/null 2>&1; then
@@ -22,3 +22,3 @@
   if [ $_bd_exit -ne 0 ]; then exit $_bd_exit; fi
 fi
-# --- END BEADS INTEGRATION v1.0.3 ---
+# --- END BEADS INTEGRATION v1.0.4 ---
Index: .beads/hooks/pre-commit
===================================================================
--- .beads/hooks/pre-commit	(revision 8681239c58e5a6f4b403f6d90aa3c3ef9c99c5da)
+++ .beads/hooks/pre-commit	(revision 76e9cfd1b3959f1e140695d2cc641616781861c4)
@@ -1,4 +1,4 @@
 #!/usr/bin/env sh
-# --- BEGIN BEADS INTEGRATION v1.0.3 ---
+# --- BEGIN BEADS INTEGRATION v1.0.4 ---
 # This section is managed by beads. Do not remove these markers.
 if command -v bd >/dev/null 2>&1; then
@@ -22,3 +22,3 @@
   if [ $_bd_exit -ne 0 ]; then exit $_bd_exit; fi
 fi
-# --- END BEADS INTEGRATION v1.0.3 ---
+# --- END BEADS INTEGRATION v1.0.4 ---
Index: .beads/hooks/pre-push
===================================================================
--- .beads/hooks/pre-push	(revision 8681239c58e5a6f4b403f6d90aa3c3ef9c99c5da)
+++ .beads/hooks/pre-push	(revision 76e9cfd1b3959f1e140695d2cc641616781861c4)
@@ -1,4 +1,4 @@
 #!/usr/bin/env sh
-# --- BEGIN BEADS INTEGRATION v1.0.3 ---
+# --- BEGIN BEADS INTEGRATION v1.0.4 ---
 # This section is managed by beads. Do not remove these markers.
 if command -v bd >/dev/null 2>&1; then
@@ -22,3 +22,3 @@
   if [ $_bd_exit -ne 0 ]; then exit $_bd_exit; fi
 fi
-# --- END BEADS INTEGRATION v1.0.3 ---
+# --- END BEADS INTEGRATION v1.0.4 ---
Index: .beads/hooks/prepare-commit-msg
===================================================================
--- .beads/hooks/prepare-commit-msg	(revision 8681239c58e5a6f4b403f6d90aa3c3ef9c99c5da)
+++ .beads/hooks/prepare-commit-msg	(revision 76e9cfd1b3959f1e140695d2cc641616781861c4)
@@ -1,4 +1,4 @@
 #!/usr/bin/env sh
-# --- BEGIN BEADS INTEGRATION v1.0.3 ---
+# --- BEGIN BEADS INTEGRATION v1.0.4 ---
 # This section is managed by beads. Do not remove these markers.
 if command -v bd >/dev/null 2>&1; then
@@ -22,3 +22,3 @@
   if [ $_bd_exit -ne 0 ]; then exit $_bd_exit; fi
 fi
-# --- END BEADS INTEGRATION v1.0.3 ---
+# --- END BEADS INTEGRATION v1.0.4 ---
Index: AGENTS.md
===================================================================
--- AGENTS.md	(revision 8681239c58e5a6f4b403f6d90aa3c3ef9c99c5da)
+++ AGENTS.md	(revision 76e9cfd1b3959f1e140695d2cc641616781861c4)
@@ -37,5 +37,5 @@
 - `brew` - use `HOMEBREW_NO_AUTO_UPDATE=1` env var
 
-<!-- BEGIN BEADS INTEGRATION v:1 profile:minimal hash:ca08a54f -->
+<!-- BEGIN BEADS INTEGRATION v:1 profile:minimal hash:7510c1e2 -->
 ## Beads Issue Tracker
 
@@ -57,4 +57,6 @@
 - Use `bd remember` for persistent knowledge — do NOT use MEMORY.md files
 
+**Architecture in one line:** issues live in a local Dolt DB; sync uses `refs/dolt/data` on your git remote; `.beads/issues.jsonl` is a passive export. See https://github.com/gastownhall/beads/blob/main/docs/SYNC_CONCEPTS.md for details and anti-patterns.
+
 ## Session Completion
 
@@ -69,5 +71,4 @@
    ```bash
    git pull --rebase
-   bd dolt push
    git push
    git status  # MUST show "up to date with origin"
@@ -83,2 +84,3 @@
 - If push fails, resolve and retry until it succeeds
 <!-- END BEADS INTEGRATION -->
+
Index: CLAUDE.md
===================================================================
--- CLAUDE.md	(revision 8681239c58e5a6f4b403f6d90aa3c3ef9c99c5da)
+++ CLAUDE.md	(revision 76e9cfd1b3959f1e140695d2cc641616781861c4)
@@ -3,5 +3,5 @@
 This file provides instructions and context for AI coding agents working on this project.
 
-<!-- BEGIN BEADS INTEGRATION v:1 profile:minimal hash:ca08a54f -->
+<!-- BEGIN BEADS INTEGRATION v:1 profile:minimal hash:7510c1e2 -->
 ## Beads Issue Tracker
 
@@ -23,4 +23,6 @@
 - Use `bd remember` for persistent knowledge — do NOT use MEMORY.md files
 
+**Architecture in one line:** issues live in a local Dolt DB; sync uses `refs/dolt/data` on your git remote; `.beads/issues.jsonl` is a passive export. See https://github.com/gastownhall/beads/blob/main/docs/SYNC_CONCEPTS.md for details and anti-patterns.
+
 ## Session Completion
 
@@ -35,5 +37,4 @@
    ```bash
    git pull --rebase
-   bd dolt push
    git push
    git status  # MUST show "up to date with origin"
@@ -49,4 +50,5 @@
 - If push fails, resolve and retry until it succeeds
 <!-- END BEADS INTEGRATION -->
+