diff --git a/docs/README.md b/docs/README.md
index e07dfba9b..c4401019f 100755
--- a/docs/README.md
+++ b/docs/README.md
@@ -35,4 +35,6 @@
 
 Need more? The full documentation tree – ADRs, per‑module operations, schemas, developer references – stays untouched under the existing directories (`modules/`, `api/`, `dev/`, `ops/`), ready when you are.
 
+> **Configuration note:** Feature exposure stays governed by `StellaOps.Scanner.WebService` (`scanner.*` / `SCANNER__*`) settings. See [modules/scanner/architecture.md](modules/scanner/architecture.md) and [modules/scanner/design/surface-env.md](modules/scanner/design/surface-env.md) for the authoritative schema; the docs remain pristine while configuration decides what surfaces for each deployment.
+
 © 2025 Stella Ops contributors – AGPL‑3.0‑or‑later