terraform

name	terraform
description	This skill should be used when writing or reviewing Terraform code, or when the project uses "Terraform", "HCL", "tfvars", "aws_iam_role", "data sources", or infrastructure-as-code patterns. Provides Terraform coding conventions, patterns, and best practices. Project-specific conventions always take priority.
version	0.1.0

Terraform Conventions

Coding conventions and best practices for Terraform projects. Project-specific conventions (CLAUDE.md, style guides) always take priority over this guidance.

General Conventions

• Prefer data sources over hardcoded values (e.g., data.aws_region.current, data.aws_caller_identity.current)
• Use locals for computed values and merging configuration
• Use jsonencode to compose JSON objects instead of raw string literals

Resource Naming

• Use snake_case for all resource names and variables, with exceptions:
  • Resource name in Terraform should match the actual resource name in the provider (e.g., when name = "FooBar", use resource "..." "FooBar")
• IAM role and policy names use PascalCase (e.g., Ec2Bastion, EcsApp)
• Use hyphenated lowercase for resource identifiers (e.g., ec2-default, dns-cache)

File Organization

Standard file structure per Terraform directory:

• aws.tf — AWS provider configuration with standard data sources (data.aws_region.current, , )