From 6e2fbc6710e8e071b7866e39f290ecfca60ffdbd Mon Sep 17 00:00:00 2001
From: Brian Madison <brianmadison@Brians-MacBook-Pro.local>
Date: Sat, 16 Aug 2025 22:03:19 -0500
Subject: [PATCH] docs: add sync-version.sh script to troubleshooting section

---
 docs/versioning-and-releases.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/versioning-and-releases.md b/docs/versioning-and-releases.md
index 282115bb..6be45746 100644
--- a/docs/versioning-and-releases.md
+++ b/docs/versioning-and-releases.md
@@ -139,6 +139,14 @@ gh release view --web
 npm view bmad-method versions --json
 ```
 
+### If Version Sync Needed
+
+If your local files don't match the published version after a release:
+
+```bash
+./sync-version.sh    # Automatically syncs local files with npm latest
+```
+
 ### If Release Fails
 
 - Check GitHub Actions logs: `gh run view <run-id> --log-failed`