# AGENTS.md — инструкция по каталогу tf_examples

Для ИИ-агента в IDE. Этот каталог — готовые примеры использования провайдера Nubes.

## Структура примера

```
tf_examples/<name>/
  main.tf                  # ресурсы
  variables.tf             # объявления переменных
  terraform.tfvars.example # ПАРАМЕТРЫ (этот файл — то, что правят/проверяют)
  README.md                # что делает пример
```

## Как работать с примером

1. Не выдумывать поля: сверять `terraform.tfvars.example` со спекой ресурса.
   Источники схемы: страница ресурса на сайте доков
   (`https://tf-docs.nodejsk8s.dev.nubes.ru/<stand>/<service>/`) либо машиночитаемая
   схема `https://tf-docs.nodejsk8s.dev.nubes.ru/<stand>/schema/<service>.json`;
   если этот репозиторий склонирован внутри провайдера — ещё `../provider/resources_yaml/*.yaml`.
2. Секреты — только в `secrets.auto.tfvars` (в `.gitignore`), НЕ в tfvars.
3. `terraform plan`/`apply` запускает пользователь.

## Маппинг «пример → ресурсы»

| Пример | Ресурсы (обычно) |
|---|---|
| `CRUD/` | nubes_postgres, nubes_s3_bucket, nubes_kafka, nubes_nodejs/flask/lucee |
| `Maria_CRUD/` | nubes_mariadb |
| `SHTURVAL_MGMT/` | nubes_k8s_* (Штурвал) |
| `fullpipe_chain/`, `iot-rmq-demo/` | nubes_rabbitmq + IoT-приложения |

Для точных полей всегда открывать спеку конкретного ресурса, а не доверять памяти.