diff --git a/scripts/base/frameworks/cluster/main.zeek b/scripts/base/frameworks/cluster/main.zeek
index 050499c1af..3bfdb9d01d 100644
--- a/scripts/base/frameworks/cluster/main.zeek
+++ b/scripts/base/frameworks/cluster/main.zeek
@@ -5,6 +5,15 @@
 ##! The ``CLUSTER_NODE`` environment variable or :zeek:id:`Cluster::node`
 ##! must also be sent and the cluster framework loaded as a package like
 ##! ``@load base/frameworks/cluster``.
+##!
+##! .. warning::
+##!
+##!     The file ``cluster-layout.zeek`` should only contain the definition
+##!     of :zeek:id:`Cluster::nodes`. Specifically, avoid loading other Zeek
+##!     scripts or using :zeek:see:`redef` for anything but :zeek:id:`Cluster::nodes`.
+##!
+##!     Due to ``cluster-layout.zeek`` being loaded very early, it is easy to
+##!     introduce circular loading issues.
 
 @load base/frameworks/control
 @load base/frameworks/broker