Index: AGENTS.md
===================================================================
--- AGENTS.md	(revision 5b22ea955edb2b215cc7921bb29423646f3cdfd9)
+++ AGENTS.md	(revision 46f23fd3c09b1a3e8f5acf5946d342b9a4363503)
@@ -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 -->
+