OpenTofu Workspace Strategy Prompt
Decide when OpenTofu workspaces are the right tool versus directory-per-environment, and design a workspace layout that will not surprise you at apply time.
- Target user
- Teams choosing an environment isolation model in OpenTofu
- Difficulty
- Intermediate
- Tools
- Claude, ChatGPT
The prompt
You are a senior platform engineer with strong opinions about when OpenTofu CLI workspaces help and when they quietly cause outages. I will provide: - How many environments/tenants you need to isolate - How different those environments are (same shape vs different sizing/features) - Your backend and team structure Your job: 1. **Decide the model** — recommend workspaces, directory-per-environment, or a hybrid. Default to directory-per-environment for real prod isolation; reserve workspaces for many near-identical, low-risk instances (e.g. ephemeral PR envs). 2. **Explain the risk** — workspaces share the same backend config and code, so it is easy to apply to the wrong workspace; `terraform.workspace` sprinkled through code creates hidden coupling. 3. **Design the layout** — if workspaces, show the state-path suffixing and how to gate which workspace is selected in CI. If directories, show the folder structure and shared-module reuse. 4. **Guard against foot-guns** — recommend echoing the selected workspace before apply, and failing CI if the workspace does not match the branch/target. 5. **Per-workspace variance** — show how to vary sizing per workspace via `*.tfvars` or a workspace-keyed map, without branching logic everywhere. 6. **Migration** — if moving off workspaces, sequence the state moves safely. Output as: (a) a model recommendation with rationale, (b) the layout, (c) CI guardrails, (d) a per-workspace variance pattern. Workspaces share one backend and one codebase, so applying to the wrong workspace is a one-command mistake — always confirm the selected workspace in CI before apply.
Run this prompt with AI
Test it, get an AI-improved version, or compare models — live in the Prompt Workspace. No copy-paste.
Related prompts
-
OpenTofu Multi-Environment Layout Prompt
Design a repository and state layout for dev/staging/prod in OpenTofu that maximizes shared modules while keeping environments independently applied and blast-radius bounded.
-
OpenTofu CI/CD Pipeline Design Prompt
Design a safe OpenTofu CI/CD pipeline — fmt/validate, plan-on-PR with a saved plan artifact, gated apply-on-merge, locking, and least-privilege cloud auth.
-
OpenTofu Plan Review Prompt
Turn a `tofu plan` into a structured risk review that flags replacements, destroys, and sensitive changes before anyone approves an apply.
-
OpenTofu azurerm Backend Configuration Prompt
Configure a secure OpenTofu state backend on Azure Blob Storage with blob versioning, lease-based locking, and RBAC-scoped access.
More OpenTofu prompts & error guides
Browse every OpenTofu prompt and troubleshooting guide in one place.
Reading prompts? Get all 500 in one free PDF
500 battle-tested, copy-paste AI prompts engineered by a senior systems engineer — every one with fill-in placeholders and safety/back-out notes. Drop your email and it's yours.
- 500 prompts: Linux · Kubernetes · Terraform · OpenStack · GitLab · Docker · Monitoring · Incident Response
- Instant PDF download — yours free, forever
- Plus one practical AI-workflow email a week (no spam)
Single opt-in · unsubscribe anytime · no spam.