Skip to content

feat(skills): add Terramate migration reference to atmos-migration #2871

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Erik Osterman (Cloud Posse) (osterman) wants to merge 2 commits into
base: main
Choose a base branch
from
+450 −2
Open

feat(skills): add Terramate migration reference to atmos-migration #2871

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
9a2067e
feat(skills): add Terramate migration reference to atmos-migration
osterman Aug 5, 2026
605dba2
Merge remote-tracking branch 'origin/main' into osterman/terramate-mi…
osterman Aug 5, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion agent-skills/AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -141,7 +141,7 @@ When a task involves Atmos, activate the matching skill for detailed guidance.
| AWS ECR: registry login, ECR auth integrations, Docker credential writes | `atmos-aws-ecr` | `agent-skills/skills/atmos-aws-ecr/SKILL.md` |
| AWS compliance: Security Hub standards, compliance reports, CIS AWS, PCI DSS, SOC2, HIPAA, NIST | `atmos-aws-compliance` | `agent-skills/skills/atmos-aws-compliance/SKILL.md` |
| AWS security: analyze findings, map to components/stacks, structured remediation | `atmos-aws-security` | `agent-skills/skills/atmos-aws-security/SKILL.md` |
| Migrating to Atmos from native Terraform/OpenTofu or Terraform Workspaces: layout, workspace mapping, remote-state bridge | `atmos-migration` | `agent-skills/skills/atmos-migration/SKILL.md` |
| Migrating to Atmos from native Terraform/OpenTofu, Terraform Workspaces, or Terramate: layout, workspace mapping, remote-state bridge, generate_hcl/script decomposition | `atmos-migration` | `agent-skills/skills/atmos-migration/SKILL.md` |
| Atmos Modernization: replace deprecated patterns with current Atmos naming, CI, Pro, auth, secrets, and dependencies | `atmos-modernization` | `agent-skills/skills/atmos-modernization/SKILL.md` |

## Common Patterns
Expand Down
9 changes: 8 additions & 1 deletion agent-skills/skills/atmos-migration/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,13 +1,14 @@
---
name: atmos-migration
description: "Migrating to Atmos from existing IaC: techniques, tactics, and design patterns for native Terraform and Terraform Workspaces — minimum-disruption paths, file-layout options, workspace mapping, and the remote-state bridge for progressive migration"
description: "Migrating to Atmos from existing IaC: techniques, tactics, and design patterns for native Terraform, Terraform Workspaces, and Terramate — minimum-disruption paths, file-layout options, workspace mapping, tag/generate_hcl/script decomposition, and the remote-state bridge for progressive migration"
metadata:
copyright: Copyright Cloud Posse, LLC 2026
version: "1.0.0"
references:
- references/from-native-terraform.md
- references/from-terraform-workspaces.md
- references/remote-state-bridge.md
- references/from-terramate.md
- references/from-component-updater.md
---

Expand All @@ -25,6 +26,8 @@ For full prose tutorials aimed at end users, link to:
- [Migrating from Native Terraform](https://atmos.tools/migration/native-terraform)
- [Migrating from Terraform Workspaces](https://atmos.tools/migration/terraform-workspaces)
- [Migrating from Terragrunt](https://atmos.tools/migration/terragrunt) (not covered by this skill)
- Migrating from Terramate -- covered by this skill via
[references/from-terramate.md](references/from-terramate.md) (no atmos.tools tutorial yet)

## Terraform or OpenTofu

Expand Down Expand Up @@ -73,6 +76,7 @@ different reference:
| One TF root module, env config via `.tfvars` or env vars | [from-native-terraform.md](references/from-native-terraform.md) |
| Multiple TF root modules in scattered dirs | [from-native-terraform.md](references/from-native-terraform.md) |
| `terraform.workspace`-driven environments with shared state backend | [from-terraform-workspaces.md](references/from-terraform-workspaces.md) |
| `.tm.hcl` files, `stack.tm.hcl`, `generate_hcl` blocks (Terramate project) | [from-terramate.md](references/from-terramate.md) |
| Need to read outputs from un-migrated TF (legacy or another repo) | [remote-state-bridge.md](references/remote-state-bridge.md) |
| `cloudposse/github-action-atmos-component-updater` | [from-component-updater.md](references/from-component-updater.md) |

Expand Down Expand Up @@ -188,3 +192,6 @@ Things to push back on if a user (or another agent) proposes them during migrati
workspaces to stacks without losing state
- [References/remote-state-bridge.md](references/remote-state-bridge.md) -- the dummy-component
and abstract-component patterns for reading state from un-migrated or external Terraform
- [References/from-terramate.md](references/from-terramate.md) -- construct-by-construct mapping
from Terramate (`stack.tm.hcl`, globals, `generate_hcl`, `script{}`, tags/labels) to Atmos,
including the one remaining known gap (`.tmtriggers`)
Loading
Loading