diff --git a/internal/models/base.go b/internal/models/base.go
index 292e1dd..46bd547 100644
--- a/internal/models/base.go
+++ b/internal/models/base.go
@@ -1,3 +1,5 @@
+// Package models provides data models for the Yandex Music API.
+// All models implement the Model interface with DeJSON/DeList deserialization methods.
 package models
 
 import (
diff --git a/internal/utils/schema.go b/internal/utils/schema.go
index d4deb4e..adeec71 100644
--- a/internal/utils/schema.go
+++ b/internal/utils/schema.go
@@ -1,3 +1,5 @@
+// Package utils provides utility functions for the Yandex Music API client,
+// including JSON handling, request signing, schema mismatch tracking, and error types.
 package utils
 
 import (
diff --git a/internal/ynison/client.go b/internal/ynison/client.go
index b0382ad..55702a7 100644
--- a/internal/ynison/client.go
+++ b/internal/ynison/client.go
@@ -1,3 +1,5 @@
+// Package ynison provides a WebSocket client for the Yandex Music Ynison protocol,
+// enabling real-time player synchronization across devices.
 package ynison
 
 import (