diff --git a/packages/agent_dart_base/lib/agent/agent/factory.dart b/packages/agent_dart_base/lib/agent/agent/factory.dart
index 9e893cb3..f21419e7 100644
--- a/packages/agent_dart_base/lib/agent/agent/factory.dart
+++ b/packages/agent_dart_base/lib/agent/agent/factory.dart
@@ -1,3 +1,4 @@
+/// Documents packages/agent_dart_base/lib/agent/agent/factory.dart module purpose, public surface, and usage context
 import '../../candid/idl.dart';
 import '../../principal/principal.dart';
 import '../agent.dart';