docs: add detailed package-level comments to all TOOLS/ and provider/

TOOLS:
- yaml-generator: types (API↔YAML), client (proxy/REST + retry)
- resource-generator: types (3 resource kinds), loader (pipeline),
  writers (generated files), params (merge/CreateOnly/ForceNew)
- docs-generator, ops-generator — already documented

provider:
- main.go: entrypoint + build instructions
- core: API client (GetInstance, RunOperation, GetInstanceState)
- provider: provider registration (New, Resources, Schema)
- resources_core: shared CRUD, state refresh, params, validation

TOOLS/resource-generator/internal/loader/loader.go

@@ -1,4 +1,13 @@
-// Package loader — загрузка YAML-спеков и построение ресурсов.
+// Package loader — загрузка YAML-спеков и построение GenResource/GenSubresource/GenAction.
+//
+// LoadSpecs — главная функция. Для каждого YAML:
+//  1. Парсит операции (create/modify/delete/suspend/resume/...)
+//  2. Классифицирует их на instance/subresource/action
+//  3. Сливает параметры, вычисляет CreateOnly и ForceNew
+//  4. Строит GenResource/GenSubresource/GenAction
+//  5. Сортирует результат по имени сервиса
+//
+// ValidateSpec — fail-fast валидация (паника при неизвестном Kind).
 package loader
 
 import (