diff --git a/esphome/espidf/size_summary.py b/esphome/espidf/size_summary.py
index d5d345b7e6..15b0c9f2eb 100644
--- a/esphome/espidf/size_summary.py
+++ b/esphome/espidf/size_summary.py
@@ -108,7 +108,8 @@ def print_summary(size_json: Path, partitions_csv: Path, firmware_elf: Path) ->
     """Print PlatformIO-shaped RAM and Flash one-liners.
 
     Failures are non-fatal: the build has already succeeded, we just couldn't
-    summarize. Logs the cause at debug level.
+    summarize. Anomalies (missing region, unreadable ELF) warn; expected
+    optional inputs (no size json, no partitions.csv) log at debug.
     """
     if not size_json.is_file():
         _LOGGER.debug("Skipping size summary: %s not found", size_json)