diff --git a/packages/agent_dart_base/lib/agent/agent/api.dart b/packages/agent_dart_base/lib/agent/agent/api.dart
index b01d2eec..54f85546 100644
--- a/packages/agent_dart_base/lib/agent/agent/api.dart
+++ b/packages/agent_dart_base/lib/agent/agent/api.dart
@@ -1,3 +1,4 @@
+/// Documents packages/agent_dart_base/lib/agent/agent/api.dart module purpose, public surface, and usage context
 import 'package:meta/meta.dart';
 
 import '../../principal/principal.dart';