chore: update README.md

Author: actions-user

README.md

@@ -2,8 +2,11 @@
 
 <!-- markdownlint-disable -->
 <a href="https://cpco.io/homepage"><img src="https://github.com/cloudposse/terraform-aws-lambda-elasticsearch-cleanup/blob/main/.github/banner.png?raw=true" alt="Project Banner"/></a><br/>
- <p align="right">
-<a href="https://github.com/cloudposse/terraform-aws-lambda-elasticsearch-cleanup/actions/workflows/lambda.yml"><img src="https://img.shields.io/github/actions/workflow/status/cloudposse/terraform-aws-lambda-elasticsearch-cleanup/lambda.yml?style=for-the-badge" alt="Tests"/></a><a href="https://github.com/cloudposse/terraform-aws-lambda-elasticsearch-cleanup/releases/latest"><img src="https://img.shields.io/github/release/cloudposse/terraform-aws-lambda-elasticsearch-cleanup.svg?style=for-the-badge" alt="Latest Release"/></a><a href="https://github.com/cloudposse/terraform-aws-lambda-elasticsearch-cleanup/commits"><img src="https://img.shields.io/github/last-commit/cloudposse/terraform-aws-lambda-elasticsearch-cleanup.svg?style=for-the-badge" alt="Last Updated"/></a><a href="https://cloudposse.com/slack"><img src="https://slack.cloudposse.com/for-the-badge.svg" alt="Slack Community"/></a><a href="https://github.com/cloudposse/terraform-aws-lambda-elasticsearch-cleanup/actions/workflows/lambda.yml"><img src="https://img.shields.io/github/actions/workflow/status/cloudposse/terraform-aws-lambda-elasticsearch-cleanup/lambda.yml?style=for-the-badge" alt="Tests"/></a></p>
+
+
+<p align="right"><a href="https://github.com/cloudposse/terraform-aws-lambda-elasticsearch-cleanup/actions/workflows/lambda.yml"><img src="https://img.shields.io/github/actions/workflow/status/cloudposse/terraform-aws-lambda-elasticsearch-cleanup/lambda.yml?style=for-the-badge" alt="Tests"/></a><a href="https://github.com/cloudposse/terraform-aws-lambda-elasticsearch-cleanup/releases/latest"><img src="https://img.shields.io/github/release/cloudposse/terraform-aws-lambda-elasticsearch-cleanup.svg?style=for-the-badge" alt="Latest Release"/></a><a href="https://github.com/cloudposse/terraform-aws-lambda-elasticsearch-cleanup/commits"><img src="https://img.shields.io/github/last-commit/cloudposse/terraform-aws-lambda-elasticsearch-cleanup.svg?style=for-the-badge" alt="Last Updated"/></a><a href="https://cloudposse.com/slack"><img src="https://slack.cloudposse.com/for-the-badge.svg" alt="Slack Community"/></a><a href="https://github.com/cloudposse/terraform-aws-lambda-elasticsearch-cleanup/actions/workflows/lambda.yml"><img src="https://img.shields.io/github/actions/workflow/status/cloudposse/terraform-aws-lambda-elasticsearch-cleanup/lambda.yml?style=for-the-badge" alt="Tests"/></a><a href="https://cloudposse.com/support/"><img src="https://img.shields.io/badge/Get_Support-success.svg?style=for-the-badge" alt="Get Support"/></a>
+
+</p>
 <!-- markdownlint-restore -->
 
 <!--
@@ -15,8 +18,8 @@
  **
  ** This file was automatically generated by the `cloudposse/build-harness`.
  ** 1) Make all changes to `README.yaml`
- ** 2) Run `make init` (you only need to do this once)
- ** 3) Run`make readme` to rebuild this file.
+ ** 2) Install [atmos](https://atmos.tools/install/) (you only need to do this once)
+ ** 3) Run`atmos readme` to rebuild this file.
  **
  ** (We maintain HUNDREDS of open source projects. This is how we maintain our sanity.)
  **
@@ -51,6 +54,7 @@ topic ARN is given. This module was largely inspired by
 
 ## Usage
 
+
 For a complete example, see [examples/complete](examples/complete).
 
 For automated tests of the complete example using [bats](https://github.com/bats-core/bats-core) and [Terratest](https://github.com/gruntwork-io/terratest) (which tests and deploys the example on AWS), see [test](test).
@@ -263,7 +267,8 @@ Check out these related projects.
 > - **Customer Workshops.** Engage with our team in weekly workshops, gaining insights and strategies to continuously improve and innovate.
 >
 > <a href="https://cpco.io/commercial-support?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/terraform-aws-lambda-elasticsearch-cleanup&utm_content=commercial_support"><img alt="Request Quote" src="https://img.shields.io/badge/request%20quote-success.svg?style=for-the-badge"/></a>
-> </details>
+> 
+</details>
 
 ## ✨ Contributing
 
@@ -289,6 +294,38 @@ In general, PRs are welcome. We follow the typical "fork-and-pull" Git workflow.
 
 **NOTE:** Be sure to merge the latest changes from "upstream" before making a pull request!
 
+
+## Running Terraform Tests
+
+We use [Atmos](https://atmos.tools) to streamline how Terraform tests are run. It centralizes configuration and wraps common test workflows with easy-to-use commands.
+
+All tests are located in the [`test/`](test) folder.
+
+Under the hood, tests are powered by Terratest together with our internal [Test Helpers](https://github.com/cloudposse/test-helpers) library, providing robust infrastructure validation.
+
+Setup dependencies:
+- Install Atmos ([installation guide](https://atmos.tools/install/))
+- Install Go [1.24+ or newer](https://go.dev/doc/install)
+- Install Terraform or OpenTofu
+
+To run tests:
+
+- Run all tests: 
+ ```sh
+ atmos test run
+ ```
+- Clean up test artifacts: 
+ ```sh
+ atmos test clean
+ ```
+- Explore additional test options: 
+ ```sh
+ atmos test --help
+ ```
+The configuration for test commands is centrally managed. To review what's being imported, see the [`atmos.yaml`](https://raw.githubusercontent.com/cloudposse/.github/refs/heads/main/.github/atmos/terraform-module.yaml) file.
+
+Learn more about our [automated testing in our documentation](https://docs.cloudposse.com/community/contribute/automated-testing/) or implementing [custom commands](https://atmos.tools/core-concepts/custom-commands/) with atmos.
+
 ### 🌎 Slack Community
 
 Join our [Open Source Community](https://cpco.io/slack?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/terraform-aws-lambda-elasticsearch-cleanup&utm_content=slack) on Slack. It's **FREE** for everyone! Our "SweetOps" community is where you get to talk with others who share a similar vision for how to rollout and manage infrastructure. This is the best place to talk shop, ask questions, solicit feedback, and work together as a community to build totally *sweet* infrastructure.