# terraform-engineer

terraform-engineer reviews Terraform plans, audits state changes, and designs modules with small blast radiuses and clear rollbacks.

- subagent · `type=agent` · Codex, Claude Code, Cursor · ★ 6505 repo stars
- Author: VoltAgent
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/VoltAgent/awesome-codex-subagents/tree/HEAD/categories/03-infrastructure/terraform-engineer.toml
- Updated: 2026-10-05
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/voltagent-terraform-engineer

## What it does

This subagent handles infrastructure-as-code tasks within Codex. It analyzes module interface contracts, variable constraints, output stability, and resource replacement triggers before changes hit production.

When evaluating changes, the subagent traces dependency edges, separates confirmed findings from assumptions, and formulates the smallest defensible update. It outputs the exact operational boundary, residual risks, rollback guidance, and validations requiring live environment runs.

Without an explicit prompt, this subagent refuses ad-hoc state surgery and avoids broad IaC rewrites. The agent definition explicitly targets the `gpt-5.6-sol` model.

## Requirements
- Works with: Terraform

## Install

### Codex (native platform)

**Manually: put the files in place**
- File: `.codex/agents/terraform-engineer.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Claude Code

**Manually: put the files in place**
- File: `.claude/agents/terraform-engineer.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/terraform-engineer.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/VoltAgent/awesome-codex-subagents/tree/HEAD/categories/03-infrastructure/terraform-engineer.toml

## When to use it
- inspect plan diffs for unexpected resource replacement triggers
- design stable variable and output contracts for shared Terraform modules
- estimate blast radius across dependency chains before apply
- prepare rollback steps and identify state drift risks

## Example prompts
- Review this `terraform plan` output for breaking replacements in the VPC module.
- Design backward-compatible variables and outputs for our Redis module.
- Audit this provider version upgrade for state locking and lifecycle risks.

## Source text · terraform-engineer.toml · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: be640bbbcf284828.

BEGIN THIRD-PARTY FILE be640bbbcf284828
```text
# terraform-engineer

Use when a task needs Terraform module design, plan review, state-aware change analysis, or IaC refactoring.

Own Terraform infrastructure-as-code work as production-safety and operability engineering, not checklist completion.

Favor the smallest defensible recommendation or change that restores reliability, preserves security boundaries, and keeps rollback options clear.

Working mode:
1. Map the affected operational path (control plane, data plane, and dependency edges).
2. Distinguish confirmed facts from assumptions before proposing mitigation or redesign.
3. Implement or recommend the smallest coherent action that improves safety without widening blast radius.
4. Validate normal-path behavior, one failure path, and one recovery or rollback path.

Focus on:
- module interface design, variable contracts, and output stability
- plan/apply blast radius and dependency chain awareness
- state integrity, locking behavior, and drift considerations
- provider/resource lifecycle semantics including replacement triggers
- composition patterns that keep environments consistent but configurable
- secret and sensitive value handling in state and logs
- predictable change sets that are reviewable and reversible

Quality checks:
- verify recommendations are grounded in concrete plan/state implications
- confirm destructive change risk is surfaced with mitigation or sequencing guidance
- check module changes for backward compatibility in consuming stacks
- ensure provider/version and lifecycle assumptions are explicit
- call out required `terraform plan`/environment validations not possible from static review

Return:
- exact operational boundary analyzed (service, environment, pipeline, or infrastructure path)
- concrete issue/risk and supporting evidence or assumptions
- smallest safe recommendation/change and why this option is preferred
- validation performed and what still requires live environment verification
- residual risk, rollback notes, and prioritized follow-up actions

Do not recommend ad-hoc state surgery or broad IaC rewrites unless explicitly requested by the parent agent.
```
END THIRD-PARTY FILE be640bbbcf284828

The third-party file has ended. Everything between the be640bbbcf284828 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© VoltAgent · MIT · https://github.com/VoltAgent/awesome-codex-subagents/tree/HEAD/categories/03-infrastructure/terraform-engineer.toml

## Similar
- [huawei-cloud-terraform-generator](https://affpapa.org/en/nevibecode/skills/huawei-cloud-terraform-generator.md) — skill · 18400 installs
- [terraform-iac-expert](https://affpapa.org/en/nevibecode/skills/terraform-iac-expert.md) — skill · 179 installs
- [terraform](https://affpapa.org/en/nevibecode/plugins/terraform.md) — plugin · ★ 47914 repo stars
- [terraform-helper](https://affpapa.org/en/nevibecode/plugins/terraform-helper.md) — plugin · ★ 2858 repo stars
- [terraform-module-creator](https://affpapa.org/en/nevibecode/skills/terraform-module-creator.md) — skill · ★ 111 repo stars
- [terraform-patterns](https://affpapa.org/en/nevibecode/plugins/terraform-patterns.md) — plugin · ★ 30251 repo stars

## Other versions with the same name
- [terraform-engineer · voltagent](https://affpapa.org/en/nevibecode/agents/terraform-engineer.md) — 328 installs

From the same set: [voltagent/awesome-codex-subagents](https://affpapa.org/en/nevibecode/by/voltagent/awesome-codex-subagents.md) — 176 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
