SKILL PROCESS

Terraform Atomic Commit

Terraform-focused pre-commit + atomic-commit Skill for IaC repos (fmt/validate/tflint/terraform-docs) with strict atomicity and no AI commit signatures.

Overview

Terraform-focused pre-commit + atomic-commit Skill for IaC repos (fmt/validate/tflint/terraform-docs) with strict atomicity and no AI commit signatures.

This skill ships inside the Terraform Workflows plugin and can be installed through the Claude Code marketplace or directly in Codex from its skill path.

Parent Surface

Parent docs: Terraform Workflows

Related wrapper commands from the parent plugin:

/terraform:pre-commit/terraform:atomic-commit

When to Use This Skill

Use this Skill in Terraform / Terragrunt repos (for example terraform-modules/ and infrastructure/) when you want:

  • /terraform:pre-commit – to actively fix formatting + lint issues and get the working tree into a clean, reviewable state.
  • /terraform:atomic-commit – to enforce atomicity of the staged diff, run the repo’s quality gates, and propose a commit message (no AI signatures).

Example Prompts

  • “Run /terraform:pre-commit and fix all issues in the files shown by git status (fmt, validate, docs).”
  • “Use /terraform:atomic-commit to confirm the staged diff is atomic and ready; propose a commit message.”
  • “We’re in a Terragrunt repo: enforce formatting, skip any apply, and run read-only validation checks where possible.”

Modes

This Skill behaves differently based on how it is invoked:

  • pre-commit mode:
  • Actively applies changes to make the working tree/staged files conform to repo standards.
  • Runs auto-fixers and focused validation.
  • Does not propose or drive a commit.
  • atomic-commit mode:
  • Runs everything from pre-commit mode.
  • Enforces atomicity of staged changes.
  • Requires all gates to be green.
  • Proposes a commit message without any AI signatures.

Severity Tags

  • [BLOCKING] – must fix before merge/commit (broken fmt/validate, dangerous workflow, non-atomic diff).
  • [SHOULD_FIX] – strongly recommended before merge (lint warnings, missing docs update, missing pins).
  • [NIT] – minor polish.

Resources

Declared allowed tools:

BashReadEditGlobGrep

Installation

Switch between Claude Code and Codex, then copy the install command for the runtime you use.

claude plugin marketplace add DiversioTeam/agent-skills-marketplace
claude plugin install terraform@diversiotech

Invocation:

/terraform:pre-commit
/terraform:atomic-commit