diff --git a/pkg/agent/loop_media.go b/pkg/agent/loop_media.go
index 792919e42..28f512a17 100644
--- a/pkg/agent/loop_media.go
+++ b/pkg/agent/loop_media.go
@@ -544,8 +544,8 @@ func (al *AgentLoop) ocrPDF(
 		"cmd":   ocrCfg.Command,
 	})
 
-	if err := cmd.Start(); err != nil {
-		logger.WarnCF("agent", "Failed to start OCR command", map[string]any{"error": err.Error()})
+	if startErr := cmd.Start(); startErr != nil {
+		logger.WarnCF("agent", "Failed to start OCR command", map[string]any{"error": startErr.Error()})
 		return fmt.Sprintf("[file:%s]", pdfPath)
 	}
 
@@ -560,10 +560,10 @@ func (al *AgentLoop) ocrPDF(
 		}
 	}
 
-	if err := cmd.Wait(); err != nil {
+	if waitErr := cmd.Wait(); waitErr != nil {
 		logger.WarnCF("agent", "OCR command failed", map[string]any{
 			"path":  pdfPath,
-			"error": err.Error(),
+			"error": waitErr.Error(),
 		})
 		return fmt.Sprintf("[file:%s]", pdfPath)
 	}
diff --git a/pkg/config/config.go b/pkg/config/config.go
index f23b36f29..776e472b7 100644
--- a/pkg/config/config.go
+++ b/pkg/config/config.go
@@ -247,10 +247,10 @@ type AgentDefaults struct {
 
 // OCRConfig configures the external OCR command for PDF text extraction.
 type OCRConfig struct {
-	Command string            `json:"command"`            // path to OCR binary (e.g. "/path/to/.venv/bin/yomitoku")
-	Args    []string          `json:"args,omitempty"`     // static arguments (e.g. ["-f", "md", "--lite", ...])
-	Env     map[string]string `json:"env,omitempty"`      // extra environment variables (e.g. {"HF_HOME": "/tmp/hf-home"})
-	Timeout int               `json:"timeout,omitempty"`  // timeout in seconds (default: 600)
+	Command string            `json:"command"`
+	Args    []string          `json:"args,omitempty"`
+	Env     map[string]string `json:"env,omitempty"`
+	Timeout int               `json:"timeout,omitempty"`
 }
 
 // GetOCRTimeout returns the configured timeout or default (600s = 10min).
diff --git a/pkg/mediacache/cache.go b/pkg/mediacache/cache.go
index b49f06fcd..91439aedb 100644
--- a/pkg/mediacache/cache.go
+++ b/pkg/mediacache/cache.go
@@ -163,7 +163,10 @@ func (c *Cache) List(entryType string) ([]ListEntry, error) {
 	var entries []ListEntry
 	for rows.Next() {
 		var e ListEntry
-		if err := rows.Scan(&e.Hash, &e.Type, &e.Result, &e.FilePath, &e.Pages, &e.CreatedAt, &e.AccessedAt); err != nil {
+		if err := rows.Scan(
+			&e.Hash, &e.Type, &e.Result, &e.FilePath,
+			&e.Pages, &e.CreatedAt, &e.AccessedAt,
+		); err != nil {
 			return entries, err
 		}
 		entries = append(entries, e)