diff --git a/internal/anime/service.go b/internal/anime/service.go
index 1358baa..d6fb36e 100644
--- a/internal/anime/service.go
+++ b/internal/anime/service.go
@@ -1,3 +1,4 @@
+// Package anime provides anime catalog, discovery, search, and details services.
 package anime
 
 import (
diff --git a/internal/episodes/module.go b/internal/episodes/module.go
index 30d1673..5f63a3b 100644
--- a/internal/episodes/module.go
+++ b/internal/episodes/module.go
@@ -1,3 +1,4 @@
+// Package episodes manages episode availability checking and refresh scheduling.
 package episodes
 
 import (
diff --git a/internal/episodes/service/service.go b/internal/episodes/service/service.go
index 460bee4..67704ed 100644
--- a/internal/episodes/service/service.go
+++ b/internal/episodes/service/service.go
@@ -1,3 +1,4 @@
+// Package service provides episode availability checking logic.
 package service
 
 import (