diff --git a/.gitignore b/.gitignore
index a344195..e0921e3 100644
--- a/.gitignore
+++ b/.gitignore
@@ -14,5 +14,6 @@ my_skills
 
 .pytest_cache
 
+AGENTS.md
 .ejagent-sessions
 .simagentplg-sessions
diff --git a/src/ejagent/__init__.py b/src/ejagent/__init__.py
index 13b08b1..58711a9 100644
--- a/src/ejagent/__init__.py
+++ b/src/ejagent/__init__.py
@@ -1,4 +1,10 @@
-"""Composable stateful agents with tool handlers and MCP integration."""
+"""Composable stateful agents with tool handlers and MCP integration.
+
+.. note::
+
+    This package provides the core agent framework — see :class:`BaseAgent` for
+    the primary entry point.
+"""
 
 from ejagent.agent.base import BaseAgent
 from ejagent.agent.behavior import (