# Proxmox Terraform scaffold

This directory is a **placeholder scaffold** for future Proxmox Terraform adoption.

## What this directory is for

- Prepare provider/version/variable structure now.
- Delay real Proxmox resource management until import strategy is validated.

## Initialize

From this directory:

```bash
terraform init
```

## Current status

- No live Proxmox resources are defined yet.
- Provider auth variables are placeholders only.
- Import IDs and resource schemas must be verified against provider docs before adding resources.

## Future safe workflow

1. Add one resource block for an existing VM/object.
2. Import it with the provider-specific ID format.
3. Inspect with `terraform state show`.
4. Reconcile `.tf` arguments until `terraform plan` is clean.
5. Repeat incrementally.

## Safety notes

- Do not commit real credentials in `.tf` files or tracked `.tfvars`.
- State files are ignored by the Terraform-level `.gitignore`.
- Do not run `terraform apply` until plan is intentionally no-op for existing resources.