From 627c68ef39fc116e857ffbfb37db22155b84486d Mon Sep 17 00:00:00 2001 From: Garry Tan Date: Sat, 30 May 2026 10:49:31 -0700 Subject: [PATCH] docs(sync-gbrain): warn against running during autopilot; prefer --path sources (#1734) Adds a Safety note to the /sync-gbrain guidance (template + regenerated SKILL.md + this repo's CLAUDE.md): don't run while autopilot is active, and prefer `gbrain sources add --path` over URL-managed sources, which can auto-reclone. Co-Authored-By: Claude Opus 4.8 (1M context) --- CLAUDE.md | 6 ++++++ sync-gbrain/SKILL.md | 6 ++++++ sync-gbrain/SKILL.md.tmpl | 6 ++++++ 3 files changed, 18 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index 2e08f1113..063681ee0 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -900,4 +900,10 @@ file globs. Run `/sync-gbrain` after meaningful code changes; for ongoing auto-sync across all worktrees, run `gbrain autopilot --install` once per machine — gbrain's daemon handles incremental refresh on a schedule. +Safety: don't run `/sync-gbrain` while `gbrain autopilot` is active — the +orchestrator refuses destructive source ops when it detects a running autopilot +to avoid racing it (#1734). Prefer registering user repos with `gbrain sources +add --path ` (no `--url`): URL-managed sources can auto-reclone, and the +sync code walk for them requires an explicit `--allow-reclone` opt-in. + diff --git a/sync-gbrain/SKILL.md b/sync-gbrain/SKILL.md index 0c21b8d5a..4a3a5bc1d 100644 --- a/sync-gbrain/SKILL.md +++ b/sync-gbrain/SKILL.md @@ -990,6 +990,12 @@ file globs. Run `/sync-gbrain` after meaningful code changes; for ongoing auto-sync across all worktrees, run `gbrain autopilot --install` once per machine — gbrain's daemon handles incremental refresh on a schedule. +Safety: don't run `/sync-gbrain` while `gbrain autopilot` is active — the +orchestrator refuses destructive source ops when it detects a running autopilot +to avoid racing it (#1734). Prefer registering user repos with `gbrain sources +add --path ` (no `--url`): URL-managed sources can auto-reclone, and the +sync code walk for them requires an explicit `--allow-reclone` opt-in. + ``` diff --git a/sync-gbrain/SKILL.md.tmpl b/sync-gbrain/SKILL.md.tmpl index 6d9700aac..6f9d47752 100644 --- a/sync-gbrain/SKILL.md.tmpl +++ b/sync-gbrain/SKILL.md.tmpl @@ -295,6 +295,12 @@ file globs. Run `/sync-gbrain` after meaningful code changes; for ongoing auto-sync across all worktrees, run `gbrain autopilot --install` once per machine — gbrain's daemon handles incremental refresh on a schedule. +Safety: don't run `/sync-gbrain` while `gbrain autopilot` is active — the +orchestrator refuses destructive source ops when it detects a running autopilot +to avoid racing it (#1734). Prefer registering user repos with `gbrain sources +add --path ` (no `--url`): URL-managed sources can auto-reclone, and the +sync code walk for them requires an explicit `--allow-reclone` opt-in. + ```