# atmos terraform lint

Run TFLint against Atmos Terraform components without repeating work for components used by multiple stacks.

## Usage

Run `atmos terraform lint [component] [flags]`.

## Examples

```shell
# Lint every Terraform component once (the default)
atmos terraform lint
atmos terraform lint --all

# Lint a component, selecting a stack automatically when it is used by more than one stack
atmos terraform lint vpc

# Lint the component instance selected by a stack
atmos terraform lint vpc --stack test

# Lint Terraform components affected by the current change
atmos terraform lint --affected
```

`--all` and the no-argument form select all Terraform components. Atmos selects
a deterministic stack context for each component so toolchain and stack-specific
settings can be resolved, but runs TFLint just once per component directory.

## TFLint configuration

Atmos detects TFLint configuration in this order:

1. An explicit `--config` argument configured on a TFLint hook or workflow step.
2. A `.tflint.hcl` file in the component directory.
3. A `.tflint.hcl` file in the Terraform components base path.
4. A `.tflint.hcl` file at the Git repository root.
5. The optional project-wide `components.terraform.lint.config` setting.

For example, configure a global fallback in `atmos.yaml`:

```yaml
components:
  terraform:
    lint:
      config: .tflint.hcl
```

The closest standard path wins: component directory, then components base path,
then repository root. The configured path may be absolute or relative to the
Atmos base path and is used only when none of those files exists.

## Flags

- **--all**
  Lint all Terraform components. This is the default when no component is provided.
- **--affected**
  Lint Terraform components selected by Atmos change detection.
- **--stack / -s**
  Limit selection to one stack, or choose the stack context for a named component.