diff --git a/.gitignore b/.gitignore
index 7752731..bfbc945 100644
--- a/.gitignore
+++ b/.gitignore
@@ -6,6 +6,9 @@
 .terraform.lock.hcl
 
 # === Generated files (NOT code — regenerate from API) ===
+# ВАЖНО: provider/internal/provider/operation_timeouts.json — НЕ артефакт.
+# Это дефолтный конфиг таймаутов для go build/go test (см. operation_timeouts_embed.go),
+# поэтому он намеренно отслеживается git. Профильные значения — в TOOLS/config/<profile>/.
 provider/resources_yaml/
 provider/internal/resources_gen/
 
diff --git a/provider/internal/provider/operation_timeouts_embed.go b/provider/internal/provider/operation_timeouts_embed.go
index 45e94b9..49e521a 100644
--- a/provider/internal/provider/operation_timeouts_embed.go
+++ b/provider/internal/provider/operation_timeouts_embed.go
@@ -2,5 +2,15 @@ package provider
 
 import _ "embed"
 
+// operation_timeouts.json — ДЕФОЛТНЫЙ конфиг таймаутов операций для сборки из
+// исходников (без него падает go build / go test в provider/).
+//
+// Это НЕ сгенерированный артефакт и он СОЗНАТЕЛЬНО лежит в git:
+// при релизе скрипт TOOLS/scripts/03_build_and_upload_provider.sh копирует
+// провайдер во временный каталог и ПОДМЕНЯЕТ там этот файл профильным
+// (TOOLS/config/<profile>/operation_timeouts.json) — рабочее дерево не меняется.
+//
+// Менять значения для релиза нужно в TOOLS/config/<profile>/, а не здесь.
+//
 //go:embed operation_timeouts.json
 var operationTimeoutsConfigEmbedded []byte