From 1f3b43853de5ebeca945b4c4c1cc9040f4f99249 Mon Sep 17 00:00:00 2001
From: Steve Yegge <steve.yegge@gmail.com>
Date: Sat, 20 Dec 2025 18:30:36 -0800
Subject: [PATCH] docs(scripts): add molecule workflow note to bump-version.sh
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Document that version bumps should be done via molecule bonding for
guided, resumable releases. The bd-6s61 template creates child beads
for each release step.

Until bd mol bond is implemented (bd-usro), use bd template instantiate.

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 scripts/bump-version.sh | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/scripts/bump-version.sh b/scripts/bump-version.sh
index f2ce1dbd..e37ca759 100755
--- a/scripts/bump-version.sh
+++ b/scripts/bump-version.sh
@@ -1,6 +1,29 @@
 #!/bin/bash
 set -e
 
+# =============================================================================
+# MOLECULE WORKFLOW (Recommended)
+# =============================================================================
+#
+# This script handles the mechanical version updates, but the full release
+# workflow is captured as a molecule. For guided, resumable releases:
+#
+#   bd template instantiate bd-6s61 --var version=X.Y.Z --assignee <identity>
+#
+# This creates child beads for each release step. The molecule survives
+# session restarts - any agent can pick up where another left off.
+#
+# The molecule (bd-6s61 "Version Bump: {{version}}") includes:
+#   1. Update CHANGELOG.md and info.go
+#   2. Run this script (bump-version.sh)
+#   3. Run tests and linting
+#   4. Commit, tag, push
+#   5. Update Homebrew formula
+#   6. Verify installation
+#
+# Until bd mol bond is implemented (bd-usro), use bd molecule instantiate.
+# =============================================================================
+
 # Colors for output
 RED='\033[0;31m'
 GREEN='\033[0;32m'