# TOOLS — Генераторы Terraform-провайдера Nubes

Каждый инструмент — независимый Go-модуль.

## yaml-generator

API Nubes → `resources_yaml/*.yaml`

```bash
cd yaml-generator && go build -o ../bin/yaml-generator .
./bin/yaml-generator
```

Структура: `main.go` + `internal/{client,config,normalize,spec,types}`.

## resource-generator

`resources_yaml/*.yaml` → `internal/resources_gen/*.go` + `registry.go`

```bash
cd resource-generator && go build -o ../bin/resource-generator .
./bin/resource-generator
```

Структура: `main.go` + `internal/{helpers,loader,params,templates,types,writers}`.

## docs-generator

`resources_yaml/*.yaml` → Markdown-документация в `docs/30_registry/resources/`

```bash
cd docs-generator && go build -o ../bin/docs-generator .

# Документация ресурсов
./bin/docs-generator

# Operations-документация  
./bin/docs-generator --ops
```

Структура: `main.go` + `internal/{types,writers,ops}`.