Index: CLAUDE.md
===================================================================
--- CLAUDE.md	(revision 5b22ea955edb2b215cc7921bb29423646f3cdfd9)
+++ CLAUDE.md	(revision 21522aeeeadc321d1358c416b7223a6300a03996)
@@ -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 -->
+