terraform-stacks

Create, validate, and troubleshoot Terraform Stacks configurations across multi-region deployments.

4|1|Updated Oct 26, 2025
One-click install
npx skills add https://github.com/hashi-demo-lab/claude-skill-hcp-terraform --skill terraform-stacks-hashi-demo-lab
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: terraform-stacks
Source: https://github.com/hashi-demo-lab/claude-skill-hcp-terraform/tree/main/terraform-stacks
Command: npx skills add https://github.com/hashi-demo-lab/claude-skill-hcp-terraform --skill terraform-stacks-hashi-demo-lab

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Terraform Stacks provide a structured approach to defining, validating, and troubleshooting Terraform configurations across environments and regions. This Skill offers comprehensive guidance for creating Stack configurations (.tfcomponent.hcl, .tfdeploy.hcl), managing components and deployments from local modules, public registries, or private registries.

Core Features & Use Cases

  • Structured guidance on Stack concepts (Stack, Component, Deployment, Stack Language) and file organization
  • Syntax & references for component and deployment blocks with practical examples
  • Best practices for multi-region and multi-environment deployments, cross-stack references, and safe changes
  • Troubleshooting patterns and common pitfalls to avoid

Quick Start

Define a minimal Stack with a single component and one deployment, following the examples in SKILL.md to get up and running.

Frequently Asked Questions about terraform-stacks

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure Terraform stacks for multi-environment deployments?

To configure Terraform stacks for multi-environment deployments, define deployment blocks in .tfdeploy.hcl files and reference components from .tfcomponent.hcl files, applying best practices for safe cross-region changes.

What is the difference between .tfcomponent.hcl and .tfdeploy.hcl in Terraform Stacks?

In Terraform Stacks, .tfcomponent.hcl defines individual infrastructure components using local or registry modules, while .tfdeploy.hcl manages deployment groups, provider configurations, and target environments.

How do I set up cross-stack references in Terraform?

To set up cross-stack references in Terraform, use Stack Language conventions within deployment configurations to securely link component outputs to inputs across different deployment groups and environments.

Can I use private registry modules when defining a Terraform Stack component?

Yes, you can use private registry modules when defining a Terraform Stack component. The Stack configuration supports sourcing infrastructure components from local modules, public registries, and private registries.

Why are my Terraform Stacks deployments failing validation across multiple regions?

Terraform Stacks deployments fail validation across multiple regions if .tfdeploy.hcl syntax violates Stack Language conventions or if provider configurations and deployment groups are incorrectly structured for target environments.