diff --git a/.buildkite/hooks/post-command b/.buildkite/hooks/post-command
index e5296665652..c2d49526bce 100644
--- a/.buildkite/hooks/post-command
+++ b/.buildkite/hooks/post-command
@@ -1,5 +1,8 @@
 #!/bin/bash
 
+# This script is executed automatically by the Buildkite agent after "command" step
+# https://buildkite.com/docs/agent/v3/hooks
+
 if [[ "$BUILDKITE_AGENT_NAME" =~ ^bk-agent ]]; then
   source .buildkite/scripts/lifecycle/post_command.sh
 else
diff --git a/.buildkite/hooks/pre-command b/.buildkite/hooks/pre-command
index aa709668253..6908a181ddf 100644
--- a/.buildkite/hooks/pre-command
+++ b/.buildkite/hooks/pre-command
@@ -1,5 +1,8 @@
 #!/bin/bash
 
+# This script is executed automatically by the Buildkite agent before "command" step
+# https://buildkite.com/docs/agent/v3/hooks
+
 if [[ "$BUILDKITE_AGENT_NAME" =~ ^bk-agent ]]; then
   source .buildkite/scripts/lifecycle/pre_command.sh
 else