diff --git a/packages/agent_dart_base/lib/agent/agent.dart b/packages/agent_dart_base/lib/agent/agent.dart
index c2de727a..582d167f 100644
--- a/packages/agent_dart_base/lib/agent/agent.dart
+++ b/packages/agent_dart_base/lib/agent/agent.dart
@@ -1,3 +1,4 @@
+/// Documents packages/agent_dart_base/lib/agent/agent.dart module purpose, public surface, and usage context
 export './agent/index.dart';
 export './canisters/index.dart';
 export './crypto/index.dart';