diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 935c0b431..311097a30 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -54,10 +54,15 @@ jobs:
         run: npm run build
 
       - name: Upload build artifacts
+        # NOTE: in a reusable workflow, github.event_name reflects the CALLER's
+        # event (here: 'push' of a v* tag from build-release.yml), NOT
+        # 'workflow_call'. Detect the workflow_call invocation via the tag-push
+        # context instead. PR runs (event_name == 'pull_request') correctly
+        # build-only because none of the three branches match.
         if: |
           github.event_name == 'workflow_dispatch' ||
           (github.event_name == 'release' && github.event.release.prerelease == false) ||
-          (github.event_name == 'workflow_call' && inputs.is_prerelease == false)
+          (github.event_name == 'push' && github.ref_type == 'tag' && inputs.is_prerelease == false)
         uses: actions/upload-pages-artifact@v3
         with:
           path: docs/dist
@@ -66,10 +71,12 @@ jobs:
     needs: build
     # Only stable releases (or manual dispatch) update the public docs site,
     # so prerelease tags (vX.Y.Z-rc1, etc.) don't clobber published docs.
+    # NOTE: in a reusable workflow, github.event_name reflects the CALLER's
+    # event ('push' of a v* tag from build-release.yml), NOT 'workflow_call'.
     if: |
       github.event_name == 'workflow_dispatch' ||
       (github.event_name == 'release' && github.event.release.prerelease == false) ||
-      (github.event_name == 'workflow_call' && inputs.is_prerelease == false)
+      (github.event_name == 'push' && github.ref_type == 'tag' && inputs.is_prerelease == false)
     runs-on: ubuntu-latest
     permissions:
       pages: write
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 1fc61e474..735a6556f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -8,6 +8,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Fixed
+
+- Docs site auto-deploys again after bot-cut releases by correctly detecting tag-push context in `docs.yml`. (#953)
+
 ## [0.9.4] - 2026-04-27
 
 ### Added