terraform-specialist — Claude Code subagent for Terraform

What terraform-specialist does

This subagent treats infrastructure as code: it designs modules with input variables, sets up a backend for remote state, and pins providers with version constraints. It also handles workspaces for multiple environments, imports existing resources and detects drift.

The agent follows a fixed set of habits. It keeps things DRY, treats state files as sacred and backs them up, reviews plan before apply, locks provider versions for reproducibility, and pulls values from data sources instead of hardcoding them. Output includes modules, backend configuration, provider requirements, Makefile or scripts for routine operations, and pre-commit hooks for validation. You also get .tfvars examples plus both plan and apply output.

Its toolset is small: Read, Write, Edit and Bash. So it edits your configuration directly and runs commands through the shell, which means it touches your working directory and your provider credentials. Have Terraform installed and backend access configured before the first run, or plan will not build. And if the project has a state file that people have edited by hand, back it up first: the agent reshapes configuration into modules, and any mismatch shows up on the very first plan.