diff --git a/src/resources/extensions/sf/memory-sleeper.ts b/src/resources/extensions/sf/memory-sleeper.ts
index 03829e659..7735d4496 100644
--- a/src/resources/extensions/sf/memory-sleeper.ts
+++ b/src/resources/extensions/sf/memory-sleeper.ts
@@ -1,3 +1,12 @@
+// SF Memory Sleeper — runtime tool-output watchdog
+//
+// Despite the "memory" prefix, this module is unrelated to the
+// memory-store / memory-relations / memory-embeddings pipeline. It
+// observes tool-result events at runtime and emits a steer (info /
+// warning) when patterns like a repeated bash failure or a too-large
+// tool result indicate the agent is stuck. Naming is historical —
+// "sleeper" means a dormant watcher, not a stored memory.
+
 import type { ToolResultEvent } from "@singularity-forge/pi-coding-agent";
 
 export interface MemorySleeperSteer {