diff --git a/internal/playback/handler/handler.go b/internal/playback/handler/handler.go
index 397e790..82e96db 100644
--- a/internal/playback/handler/handler.go
+++ b/internal/playback/handler/handler.go
@@ -1,3 +1,4 @@
+// Package handler provides the HTTP handler for playback endpoints.
 package handler
 
 import (
diff --git a/internal/playback/service.go b/internal/playback/service.go
index e4b2bf2..7d0cc28 100644
--- a/internal/playback/service.go
+++ b/internal/playback/service.go
@@ -1,3 +1,4 @@
+// Package playback manages video playback, including episode sources and subtitle management.
 package playback
 
 import (