CLAUDE.md Terraform Refactor Patterns: Enterprise-Grade IaC Improvement Playbook

Stop wrestling with broken Terraform. Start shipping secure, production‑ready infrastructure with confidence.

You open a Terraform repo and immediately feel the dread: inconsistent modules, tangled variables, state files that might be leaking secrets, and no clear plan to refactor any of it. Hours disappear while you chase down hidden dependencies and IAM misconfigurations. You know it shouldn’t be this painful.

This playbook gives you Claude‑audited refactor patterns used to clean up real enterprise Terraform codebases. You get copy‑ready modules, review prompts, and migration paths that turn a messy repo into a predictable, secure, maintainable system — usually in under 90 minutes.

What's Included:
- 14 Terraform refactor patterns covering modules, variables, backends, IAM, and networking
- 9 production‑grade module redesigns with before/after code
- 6 CI/CD hardening patterns for apply/plan reliability
- 5 state migration guides for remote backends, workspaces, and multi‑env splits
- 12 Claude‑optimized review prompts for Terraform code, modules, and pipelines
- 4 security fix patterns addressing state exposure, IAM overreach, and secret handling
- 3 scaling‑safety patterns to prevent resource churn, drift loops, and module explosion

Built from patterns used to stabilize large, multi‑team Terraform deployments supporting thousands of resources, including repos that suffered severe drift, broken pipelines, and multi‑region state fragmentation. Every pattern comes from real incidents, real fixes, and real production workloads.

Who This Is For:
- Engineers inheriting messy Terraform and needing to refactor fast without breaking environments
- Teams moving from ad‑hoc modules to consistent, reviewable IaC structures
- Senior engineers who want proven patterns to prevent scaling failures before they happen

Who This Is NOT For:
- Beginners who haven’t used Terraform in a collaborative repo yet
- Teams looking for a full consulting engagement rather than a focused refactor playbook

If this doesn’t save you at least 8 hours on your next Terraform refactor, reach out for a full refund.

What's Included (11 files)

• terraform-linting-and-static-analysis-configs.tf
• CLAUDE-REFACTOR-PRIMER.md
• claude-terraform-review-prompts.md
• terraform-production-scaling-patterns.md
• terraform-ci-cd-refactor-patterns.yml
• TROUBLESHOOTING.md
• terraform-refactor-patterns-core.md
• terraform-module-hardening-checklist.md
• terraform-secret-handling-best-practices.md
• SETUP-GUIDE.md
• terraform-state-refactor-migration-guide.md