terraform-test

The terraform-test skill is designed to provide a comprehensive framework for testing Terraform configurations, ensuring that infrastructure changes do not introduce breaking behavior. It allows users to write test files in `.tftest.hcl` or `.tftest.json` formats, define run blocks for individual test scenarios, and validate infrastructure behavior with assertions. By using temporary resources for tests, this skill protects existing infrastructure and state files from unintended modifications, making it safe to experiment and verify configurations in isolation.

Key features include the ability to define assertions that must hold true for tests to pass, mock providers to simulate infrastructure behavior without provisioning real resources, and test modes such as `apply` for real resource creation or `plan` for logic-only validation. Users can also control state isolation, override file-level variables, and reference specific modules. Additional capabilities include plan options to manage refresh, replacement, or targeted execution of resources, as well as support for parallel execution and expected failure conditions to handle known test exceptions.

This skill is particularly useful for DevOps engineers, Terraform developers, and infrastructure teams who want to ensure their modules, resources, and configurations work as expected before deployment. Common use cases include validating module outputs, checking conditional resource creation, testing different instance types or regions, integrating tests into CI/CD pipelines, and creating robust unit and integration test suites for both local and registry modules. It is aimed at users seeking reliable automated testing to improve confidence in infrastructure changes and maintain stability across environments.