diff --git a/packages/core/src/repowise/core/analysis/health/complexity/walker.py b/packages/core/src/repowise/core/analysis/health/complexity/walker.py
index 7a889d6a..84631e86 100644
--- a/packages/core/src/repowise/core/analysis/health/complexity/walker.py
+++ b/packages/core/src/repowise/core/analysis/health/complexity/walker.py
@@ -29,6 +29,9 @@
 - ``error_handling`` — error-handling anti-patterns
 - ``perf_walk``      — the performance-risk pass
 - ``class_analysis`` — class-level LCOM4 / god-class metrics
+
+Each pass is independent and side-effect free, so ``walk_file`` can run them
+in any order over the single parsed tree.
 """
 
 from __future__ import annotations