diff --git a/gitea/client.go b/gitea/client.go
index 9653a18..73a4abf 100644
--- a/gitea/client.go
+++ b/gitea/client.go
@@ -1,3 +1,6 @@
+// Package gitea provides a client for the Gitea API.
+// It supports pull request operations, file content retrieval,
+// and review submission.
 package gitea
 
 import (
diff --git a/llm/client.go b/llm/client.go
index c66ae89..41c1154 100644
--- a/llm/client.go
+++ b/llm/client.go
@@ -1,3 +1,4 @@
+// Package llm provides a client for OpenAI-compatible chat completion APIs.
 package llm
 
 import (
diff --git a/review/prompt.go b/review/prompt.go
index 1011906..a4072a9 100644
--- a/review/prompt.go
+++ b/review/prompt.go
@@ -1,3 +1,5 @@
+// Package review builds prompts for AI code review and parses LLM responses
+// into structured review results.
 package review
 
 import (