diff --git a/.gitea/workflows/snapshot_admin.yml b/.gitea/workflows/snapshot_admin.yml
index 6eda4bb..93ac3e8 100644
--- a/.gitea/workflows/snapshot_admin.yml
+++ b/.gitea/workflows/snapshot_admin.yml
@@ -14,6 +14,7 @@ on:
       - "GatherTradingData.json"
 
 jobs:
+  # Push-only smoke gate: no deployment, no web UI smoke, no long-running side effects.
   validate-snapshot-admin-smoke:
     if: github.event_name == 'push'
     runs-on: self-hosted
@@ -45,6 +46,7 @@ jobs:
       - name: Validate Snapshot Admin Workflow
         run: python3 tools/validate_snapshot_admin_workflow_v1.py
 
+  # Manual dispatch gate: full workflow + web UI validation only.
   validate-snapshot-admin-full:
     if: github.event_name == 'workflow_dispatch'
     runs-on: self-hosted