From a8739f554831641850c8a3adb184a12f541ccee1 Mon Sep 17 00:00:00 2001
From: Steve Yegge <steve.yegge@gmail.com>
Date: Tue, 23 Dec 2025 21:49:48 -0800
Subject: [PATCH] fix: remove bd sync from polecat startup sequence (gt-aobh)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Polecats share the same beads database at the rig level. The refinery
and witness manage syncing beads. Running bd sync on polecat startup
causes contention when multiple polecats spawn simultaneously and
creates potential race conditions.

This change removes bd sync --from-main from:
- prompts/roles/polecat.md On Startup section
- internal/beads/molecules_session.go orient step
- internal/beads/molecules_work.go orient step
- docs/polecat-wisp-architecture.md load context section

Troubleshooting sections that recommend bd sync --from-main for
recovery scenarios are preserved.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 docs/polecat-wisp-architecture.md   | 1 -
 internal/beads/molecules_session.go | 1 -
 internal/beads/molecules_work.go    | 1 -
 prompts/roles/polecat.md            | 3 +--
 4 files changed, 1 insertion(+), 5 deletions(-)

diff --git a/docs/polecat-wisp-architecture.md b/docs/polecat-wisp-architecture.md
index e381a1a5..d041e968 100644
--- a/docs/polecat-wisp-architecture.md
+++ b/docs/polecat-wisp-architecture.md
@@ -146,7 +146,6 @@ Read polecat.md protocol. Understand:
 
 Load context:
 - gt prime
-- bd sync --from-main
 - gt mail inbox
 
 ## Step: handoff-read
diff --git a/internal/beads/molecules_session.go b/internal/beads/molecules_session.go
index 0261b5c5..e8dace95 100644
--- a/internal/beads/molecules_session.go
+++ b/internal/beads/molecules_session.go
@@ -456,7 +456,6 @@ Read polecat.md protocol and initialize context.
 
 ` + "```" + `bash
 gt prime               # Load Gas Town context
-bd sync --from-main    # Fresh beads state
 gt mail inbox          # Check for work assignment
 ` + "```" + `
 
diff --git a/internal/beads/molecules_work.go b/internal/beads/molecules_work.go
index 7a6eb4e6..18afe8b8 100644
--- a/internal/beads/molecules_work.go
+++ b/internal/beads/molecules_work.go
@@ -287,7 +287,6 @@ Load context and check for interrupts.
 
 ` + "```" + `bash
 gt prime                    # Load Gas Town context
-bd sync --from-main         # Fresh beads state
 ` + "```" + `
 
 Check for:
diff --git a/prompts/roles/polecat.md b/prompts/roles/polecat.md
index c0a4414e..248f249a 100644
--- a/prompts/roles/polecat.md
+++ b/prompts/roles/polecat.md
@@ -144,8 +144,7 @@ Gas Town has TWO beads databases:
 
 ### On Startup
 ```bash
-bd sync --from-main    # Pull latest beads state
-bd show <your-issue>   # Verify your assignment
+bd show <your-issue>   # Verify your assignment (beads synced by refinery/witness)
 ```
 
 ### During Work