diff --git a/.github/workflows/build-all.yml b/.github/workflows/build-all.yml
index ca713df..9187dbc 100644
--- a/.github/workflows/build-all.yml
+++ b/.github/workflows/build-all.yml
@@ -799,6 +799,10 @@ jobs:
 
   trigger-tripi:
     name: Trigger TRI-PI ARM64 Build
+    # Only fire on tag-push events. To trigger a TRI-PI rebuild after a
+    # release is created via gh API (without re-pushing the tag), use:
+    #   curl -X POST .../repos/SamiAhmed7777/tri-pi/dispatches \
+    #     -d '{"event_type":"new-release","client_payload":{"version":"vX.Y.Z","source_repo":"SamiAhmed7777/triangles_v5"}}'
     if: startsWith(github.ref, 'refs/tags/v')
     needs: release
     runs-on: ubuntu-latest