diff --git a/docs/tools/loop-detection.md b/docs/tools/loop-detection.md
index 97fee0ddbe4..56d843f1276 100644
--- a/docs/tools/loop-detection.md
+++ b/docs/tools/loop-detection.md
@@ -79,6 +79,7 @@ Per-agent override (optional):
 ## Recommended setup
 
 - Start with `enabled: true`, defaults unchanged.
+- Keep thresholds ordered as `warningThreshold < criticalThreshold < globalCircuitBreakerThreshold`.
 - If false positives occur:
   - raise `warningThreshold` and/or `criticalThreshold`
   - (optionally) raise `globalCircuitBreakerThreshold`