diff --git a/internal/agent/agent.go b/internal/agent/agent.go
index c0f612670e7b65b1fdf38d2107ad20b560315d0a..a71073caad0ace7a15ff697e0bc4ad086f6162fd 100644
--- a/internal/agent/agent.go
+++ b/internal/agent/agent.go
@@ -1,3 +1,10 @@
+// Package agent is the core orchestration layer for Crush AI agents.
+//
+// It provides session-based AI agent functionality for managing
+// conversations, tool execution, and message handling. It coordinates
+// interactions between language models, messages, sessions, and tools while
+// handling features like automatic summarization, queuing, and token
+// management.
 package agent
 
 import (