diff --git a/src/ZB.MOM.WW.ScadaBridge.CLI/AlarmTriggerConfigJson.cs b/src/ZB.MOM.WW.ScadaBridge.CLI/AlarmTriggerConfigJson.cs
index f451a42f..8fa6eca3 100644
--- a/src/ZB.MOM.WW.ScadaBridge.CLI/AlarmTriggerConfigJson.cs
+++ b/src/ZB.MOM.WW.ScadaBridge.CLI/AlarmTriggerConfigJson.cs
@@ -56,6 +56,9 @@ internal static class AlarmTriggerConfigJson
                     w.WriteString("direction", NormalizeDirection(direction));
                     break;
                 case "hilo":
+                    // Only the four setpoints are exposed as flags. The codec also accepts
+                    // per-setpoint priorities/deadbands/messages — intentionally omitted here;
+                    // use raw --trigger-config for those (see the YAGNI scope guard in the plan).
                     if (loLo.HasValue) w.WriteNumber("loLo", loLo.Value);
                     if (lo.HasValue) w.WriteNumber("lo", lo.Value);
                     if (hi.HasValue) w.WriteNumber("hi", hi.Value);