diff --git a/.env.example b/.env.example
index 3e857247..28cd555b 100644
--- a/.env.example
+++ b/.env.example
@@ -17,10 +17,10 @@
 # Google Gemini
 # GOOGLE_GENERATIVE_AI_API_KEY=
 
-# ── OpenAI-compatible endpoints (provider: "other") ───────────────────────────
-# Set a base URL in your opfor config instead of here. API key goes below
-# if the endpoint requires one.
-# CUSTOM_LLM_API_KEY=
+# ── OpenAI-compatible endpoints (provider: "openai-compatible") ───────────────
+# LiteLLM, OpenRouter, Azure, Ollama, etc. Set the base URL in your opfor config;
+# put the API key here if the endpoint requires one.
+# OPFOR_API_KEY=
 
 # ── Telemetry enrichment (optional) ──────────────────────────────────────────
 
diff --git a/.github/workflows/secret-scan.yml b/.github/workflows/secret-scan.yml
new file mode 100644
index 00000000..5d2ce21b
--- /dev/null
+++ b/.github/workflows/secret-scan.yml
@@ -0,0 +1,21 @@
+name: Secret Scan
+
+on:
+  pull_request:
+    branches: [master, main]
+  push:
+    branches: [master, main]
+
+jobs:
+  gitleaks:
+    name: gitleaks
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+      - uses: gitleaks/gitleaks-action@v2
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITLEAKS_LICENSE: ${{ secrets.GITLEAKS_LICENSE }}