diff --git a/.env.example b/.env.example
index c7e4911e4a..0a7eee9d91 100644
--- a/.env.example
+++ b/.env.example
@@ -1311,3 +1311,10 @@ APP_LOG_TO_FILE=true
 # ELECTRON_SMOKE_DATA_DIR=
 # ELECTRON_SMOKE_KEEP_DATA=0
 # ELECTRON_SMOKE_STREAM_LOGS=0
+
+# Quota Sharing (Group B — planos 16+22)
+QUOTA_STORE_DRIVER=sqlite                   # sqlite | redis
+# QUOTA_STORE_REDIS_URL=                    # ex.: redis://localhost:6379 (apenas quando driver=redis)
+# QUOTA_SATURATION_THRESHOLD=0.5            # 0..1; >= threshold ativa modo strict (sem empréstimo)
+# QUOTA_SOFT_DEPRIORITIZE_FACTOR=0.7        # 0..1; multiplicador do score quando soft policy ativa
+# QUOTA_CONSUMPTION_RETENTION_DAYS=14       # GC de buckets quota_consumption.updated_at antigos