diff --git a/packages/agent_dart_base/lib/agent/actor.dart b/packages/agent_dart_base/lib/agent/actor.dart
index e072626b..69b2ffed 100644
--- a/packages/agent_dart_base/lib/agent/actor.dart
+++ b/packages/agent_dart_base/lib/agent/actor.dart
@@ -1,3 +1,4 @@
+/// Documents packages/agent_dart_base/lib/agent/actor.dart module purpose, public surface, and usage context
 import 'dart:convert';
 import 'dart:typed_data';