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

provider/internal/resources_core/crud.go

@@ -1,4 +1,13 @@
-// ВНИМАНИЕ: НЕ ИЗМЕНЯТЬ НИЧЕГО В CRUD БЕЗ ПРЯМОГО РАЗРЕШЕНИЯ ОПЕРАТОРА.
+// Package resources_core — общая логика CRUD для сгенерированных ресурсов.
+//
+// Предоставляет функции, используемые всеми ресурсами из resources_gen:
+//   - Create/Read/Update/Delete — базовые CRUD-операции
+//   - State Refresh — обновление состояния из API
+//   - Param Mapping — маппинг параметров Terraform ↔ API
+//   - Validation — валидация обязательных полей и ref_svc
+//   - Plan Modifiers — UUID, JSON-нормализация
+//
+// ⛔ НЕ ИЗМЕНЯТЬ НИЧЕГО В CRUD БЕЗ ПРЯМОГО РАЗРЕШЕНИЯ ОПЕРАТОРА.
 package resources_core
 
 import (