diff --git a/pkg/logger/handler.go b/pkg/logger/handler.go
index 30580e0..cf9a23c 100644
--- a/pkg/logger/handler.go
+++ b/pkg/logger/handler.go
@@ -47,6 +47,10 @@ type writeState struct {
 //	INFO:  message: k=v, …    full fields — debug mode dumps everything
 //	WARN:  warning: msg: k=v, …
 //	ERROR: error:   msg: k=v, …
+//
+// INFO fields are intentionally hidden in normal mode: they are context for a
+// debug session, not alerts for the operator. Put fields on WARN or ERROR when
+// the reader needs them immediately to understand a problem.
 type humanHandler struct {
 	w      io.Writer
 	level  slog.Level