diff --git a/internal/database/database.go b/internal/database/database.go
index c6e180e..28b9756 100644
--- a/internal/database/database.go
+++ b/internal/database/database.go
@@ -1,3 +1,4 @@
+// Package database manages database schema migrations and fixes.
 package database
 
 import (
diff --git a/internal/database/fixes/registry.go b/internal/database/fixes/registry.go
index 68936b5..ceeca05 100644
--- a/internal/database/fixes/registry.go
+++ b/internal/database/fixes/registry.go
@@ -1,3 +1,4 @@
+// Package fixes implements one-off database migration fixes.
 package fixes
 
 import (
diff --git a/internal/db/helpers.go b/internal/db/helpers.go
index 138cf50..4086b25 100644
--- a/internal/db/helpers.go
+++ b/internal/db/helpers.go
@@ -1,3 +1,4 @@
+// Package db provides database access via sqlc-generated queries and helper functions.
 package db
 
 import "database/sql"
diff --git a/internal/domain/anime.go b/internal/domain/anime.go
index 639ab44..6e35eb6 100644
--- a/internal/domain/anime.go
+++ b/internal/domain/anime.go
@@ -1,3 +1,4 @@
+// Package domain defines the core domain types and interfaces used across the application.
 package domain
 
 import (