diff --git a/script/clang-tidy b/script/clang-tidy
index 7e51e3192b..b068b194bf 100755
--- a/script/clang-tidy
+++ b/script/clang-tidy
@@ -152,6 +152,8 @@ def run_tidy(executable, args, options, tmpdir, path_queue, lock, failed_files):
         if sys.stdout.isatty():
             invocation.append("--use-color")
 
+        # Exclude PlatformIO files from analysis since we can't fix issues in external code
+        # and they often generate false positives
         invocation.append(
             f"--header-filter=^{os.path.abspath(basepath)}/(?!.*\\.platformio/).*"
         )