SkillVaultskills Browse all 1,000+ skills

Maintenance · Version 1.1.0 · Reviewed 2026-08-02

Terraform Migration Planning Specialist

Reduce change risk for terraform compatibility inventory and terraform incremental migration sequence with evidence, explicit trade-offs, and a verification plan.

4 method steps 6 documented failure modes 5 diagnostic checks 7 quality gates

Sequences compatibility, data, and rollout work into reversible migrations for Terraform using configuration, state, provider locks, modules, and saved plans and plan JSON, replacement actions, state drift, and provider diagnostics, with explicit attention to address or immutable-attribute change replacing stateful infrastructure unexpectedly.

₹199 one-time

Get this skill archive

Install in your AI coding tool

SkillVault packages this skill in the open Agent Skills format for five leading coding tools.

What this skill helps you do

  • Terraform compatibility inventory
  • Terraform incremental migration sequence
  • Terraform rollback rehearsal

How Terraform Migration Planning Specialist works

You provide

Current state, consumer inventory, and target state

It inspects

Coexistence and rollback viability for terraform compatibility inventory

It decides

A terraform incremental migration sequence sequence in reversible increments

You verify

Shadow comparison reports divergence rather than assuming zero

What it checks first

Terraform Migration Planning Specialist sequences compatibility, data, and rollout work into reversible migrations for Terraform using configuration, state, provider locks, modules, and saved plans and plan JSON, replacement actions, state drift, and provider diagnostics, with explicit attention to address or immutable-attribute change replacing stateful infrastructure unexpectedly. Use it when the work involves Terraform compatibility inventory, Terraform incremental migration sequence, Terraform rollback rehearsal.

  1. Every resource replacement in the plan, and whether that resource holds state that cannot be recreated.
  2. Address stability across refactors, since re-indexing destroys and recreates unrelated resources.
  3. Whether the executing principal has broader permissions than the change requires.
  4. Provider version pinning, because an unpinned upgrade introduces unrequested plan changes.
  5. Whether secrets appear in state, which is stored in plaintext regardless of the sensitive marker.

Failure modes it recognizes

  • An immutable attribute change silently forcing replacement of a database or stateful volume.
  • Moving resources between modules without move blocks, causing destroy-and-recreate.
  • A data source resolving at plan time to a value that changes before apply, producing inconsistency.
  • State lock held by a crashed run, blocking every subsequent apply until manually cleared.
  • A count-to-for_each conversion re-creating every resource because addresses changed.
  • Drift silenced with ignore_changes, which permanently disables reconciliation for that path.

Answers it will reject

  • Approving from the plan summary counts instead of reading every replacement line.
  • Using targeted applies to work around a broken dependency graph, leaving state partially applied.
  • Committing state files to version control, exposing secrets and creating infrastructure merge conflicts.
  • Granting the pipeline administrative rights so that any plan will succeed.

Decision rules it applies

  • Any replacement of a stateful resource requires a tested backup and restore path before approval.
  • Prefer move blocks over destroy-and-recreate for refactors; they preserve state and cost nothing.
  • Pin provider versions and upgrade deliberately so plan noise is attributable to intent.
  • If the plan cannot be explained line by line, it has not been reviewed.

Evidence it asks for

  • Export the plan as JSON and programmatically list every replace action.
  • Cross-check each replacement against an inventory of stateful resources.
  • Rehearse the change in a non-production environment carrying representative state.

The method inside

  1. Inventory dependencies, compatibility constraints, and current behavior affecting terraform compatibility inventory.
  2. Create reversible seams for terraform incremental migration sequence before changing the critical path.
  3. Sequence terraform rollback rehearsal into independently verifiable increments with explicit rollback points.
  4. Keep old and new paths observable until equivalence is proven; remove the fallback only after acceptance criteria pass.

Deliverables

  • Terraform compatibility inventory assessment
  • Terraform incremental migration sequence decision and action plan
  • Terraform rollback rehearsal verification checklist

Evidence requirements

  • Current and target versions
  • Dependency graph and changelogs
  • Tests, compatibility constraints, and rollout environment

Quality gates

  • Every material claim traces to supplied evidence or is labeled as a hypothesis.
  • The response follows the declared deliverable contract.
  • No execution, access, measurement, or verification is invented.
  • Secrets and personal data are redacted rather than repeated.
  • The user receives a concrete independent verification step.
  • The relevant failure modes in this domain were considered rather than only the reported symptom.
  • No listed anti-pattern was recommended as a solution.

Example task

Input

Apply the migration planning specialist to our Terraform system before the next production change. We can provide configuration, state, provider locks, modules, and saved plans; the main concern is address or immutable-attribute change replacing stateful infrastructure unexpectedly.

Expected output

Inventory consumers of configuration, state, provider locks, modules, and saved plans before selecting the cutover. The migration must explicitly contain address or immutable-attribute change replacing stateful infrastructure unexpectedly. Introduce a coexistence boundary, compare old and new behavior on the same workload, and rehearse rollback before removing the legacy path.

Boundaries and compatibility

Ideal for

  • Terraform compatibility inventory: produce a decision or artifact grounded in supplied evidence.
  • Terraform incremental migration sequence: produce a decision or artifact grounded in supplied evidence.
  • Terraform rollback rehearsal: produce a decision or artifact grounded in supplied evidence.

Out of scope

  • Blindly upgrading across multiple major versions
  • Assuming semantic versioning guarantees compatibility

Agent compatibility

  • GitHub Copilot Agent Skills
  • Cursor Agent Skills
  • Claude Code Skills
  • OpenAI Codex Skills
  • JetBrains Junie Skills

Tool policy: Advisory by default. No tools are assumed. If the host provides tools, use read-only evidence gathering unless the user explicitly approves a scoped write or execution action.