Skip to main content
subagent CX Codex

terragrunt-expert · voltagent/awesome-codex-subagents — Codex subagent: orchestrate modules and environments

terragrunt-expert — a subagent for Terragrunt work: organizes modules across environments, validates dependency chains between stacks, ensures remote state and locking are safe for concurrent runs, and detects hidden configuration drift.

MIT ★ 6,505 updated 2026-10-05

Install into Codex · Manually: put the files in place All methods and platforms ↓
.codex/agents/terragrunt-expert.toml
Open on GitHub

What terragrunt-expert does

This subagent handles Terragrunt-specific analysis: maps repository structure, checks include, locals, and dependency wiring across stacks, confirms remote state configuration and locking are sound for parallel execution.

Before each recommendation, it identifies operational boundaries (control plane, data plane, dependency edges), separates confirmed facts from assumptions, and proposes the smallest change that restores safety without widening blast radius. It verifies stacks execute in deterministic order, ensures inherited config does not accidentally override security-critical settings, and flags which checks require live backend access.

Best for projects with many stacks spread across environments and accounts: catches drift risks between shared modules and environment overrides, plans promotion paths across prod and stage without surprises.

What it helps with

  • organize Terragrunt stacks so configs do not repeat across environments
  • detect circular dependencies or execution order breaks between stacks
  • set up remote state and locking safe for parallel run-all workflows
  • find hidden coupling: inherited locals that accidentally override critical values
  • plan safe module upgrades or account migrations with a clear rollback path

Example prompts for the agent

  • Check why run-all in staging overwrites security tags inherited from prod modules
  • Scan my environments/*/region/*/terragrunt.hcl layout for circular dependencies
  • Design a stack structure for three accounts and five regions so module changes do not break rollback

How to install terragrunt-expert

Manually: put the files in place

.codex/agents/terragrunt-expert.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/

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about terragrunt-expert

How do I install terragrunt-expert in Codex?

Create or edit .codex/agents/terragrunt-expert.toml in your project root, enable it in your Codex config, and the subagent will be available when you run Terragrunt-related tasks.

What does terragrunt-expert do?

It analyzes your Terragrunt repository layout, validates includes, locals, and dependency chains, checks remote state safety, detects config drift risk, and suggests the smallest steps to restore reliability.

When should I use it?

Use it for module orchestration, multi-layer environment and account structures, remote state locking safety, detecting hidden config coupling, and planning upgrades or migrations across environments.

Source text

terragrunt-expert.toml · MIT
# terragrunt-expert

Use when a task needs Terragrunt-specific help for module orchestration, environment layering, dependency wiring, or DRY infrastructure structure.

Own Terragrunt orchestration 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:
- live repository layout and environment/account layering clarity
- `include`, `locals`, and dependency wiring correctness across stacks
- remote state backend configuration consistency and locking safety
- dependency-order execution behavior in run-all workflows
- input propagation and DRY patterns that avoid hidden coupling
- drift risk between shared modules and environment overrides
- safe promotion paths across environments with minimal surprise

Quality checks:
- verify Terragrunt recommendations preserve deterministic stack ordering
- confirm remote-state assumptions are explicit and environment-safe
- check dependency graphs for circular or brittle coupling
- ensure inherited config does not accidentally override security-critical settings
- call out run-time validations requiring live backend/state access

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 prescribe full repository relayout or wholesale module strategy replacement unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

Similar subagents

All subagents for DevOps and infrastructure →

terragrunt-expert by other authors comes first.

terragrunt-expert VoltAgent Community The terragrunt-expert subagent helps structure Terragrunt stacks, manage dependencies, and deploy across environments. Use it for OpenTofu or Terraform infrastructure projects. CX Codex 174installs terragrunt-generator akin-ozer terragrunt-generator generates modern Terragrunt HCL files, root configurations, and multi-environment layouts. Helpful when organizing dev, staging, and prod infrastructure. CX Codex +1 1,300installs terraform-expert PCL Team terraform-expert — a skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode that gives the agent deep Terraform knowledge: modules, remote state, and resource lifecycle. CX Codex +1 190installs huawei-cloud-terraform-generator huaweicloud The huawei-cloud-terraform-generator Claude Code skill builds Terraform configurations for Huawei Cloud infrastructure. It turns a deployment goal into a resource plan and applies it only after you approve. CX Codex +1 18,400installs terraform-helper rohitg00 terraform-helper — a Claude Code plugin that streamlines Terraform module creation and infrastructure planning. Generates configurations and module structures from architecture descriptions, cutting down template work. ★ 2,858repo stars InsideOut (Riley) luthersystems InsideOut (Riley) is an MCP server for Claude Code and Codex that proposes AWS or GCP architecture from a description, estimates cost and deploys it. The backend is ready in hours. CX Codex +1 terraform-skill daymade terraform-skill is a Claude Code skill for reviewing Terraform releases and provisioner workflows. It activates for plan/apply wrappers, staging-to-production differences, and infrastructure incidents. CX Codex +1 775installs

From the same set176

The whole set →
ai-writing-auditor ai-writing-auditor is a subagent that checks prose for AI-writing signals, rewrites flagged passages, and explains edits. It reviews posts, technical docs, and emails. CX Codex ★ 6,505repo stars ad-security-reviewer ad-security-reviewer reviews Active Directory security: trust boundaries, delegation, GPO exposure, Kerberos and LDAP posture. Useful before a hardening pass on the directory. CX Codex ★ 6,505repo stars accessibility-tester accessibility-tester audits UI changes, keyboard navigation, and ARIA markup for accessibility. Useful for catching usability barriers in components and interaction flows before release. CX Codex ★ 6,505repo stars windows-infra-admin The windows-infra-admin subagent handles Windows infrastructure work across Active Directory, DNS, DHCP, GPO, and PowerShell automation. Use it when a change needs safety checks. CX Codex ★ 6,505repo stars terraform-engineer terraform-engineer reviews Terraform plans, audits state changes, and designs modules with small blast radiuses and clear rollbacks. CX Codex ★ 6,505repo stars sre-engineer The sre-engineer subagent handles SLOs, alerting, resilience, and operational risk. Use it when a change needs clear safety checks and rollback paths. CX Codex ★ 6,505repo stars security-engineer Subagent for infrastructure security engineering: IAM design, secrets lifecycle, network segmentation, and workload hardening. Delivers concrete fixes that preserve operability and rollback paths. CX Codex ★ 6,505repo stars platform-engineer platform-engineer designs internal developer platforms, self-service infrastructure boundaries, and golden paths focused on production reliability. CX Codex ★ 6,505repo stars

Project sponsors

Companies that keep this analytics open