INFRASTRUCTURE DEVELOPMENT / HashiCorp
Provider framework migration
Starts by asking whether to migrate at all, then muxes the provider and verifies before claiming the port is done.
“Migrate Terraform provider resources and data sources from Plugin SDKv2 to the Plugin Framework: muxing both plugins in one provider (terraform-plugin-mux, tf5to6server), per-resource migration workflow, SDKv2-to-Framework schema mapping (ForceNew, ValidateFunc, DiffSuppressFunc, Default, Timeouts, blocks), null-vs-zero-value behavioral traps, and state-compatibility verification. Use when converting or translating SDKv2 resources to the Framework, setting up a muxed provider server, deciding whether a resource should be migrated at all, or debugging plan diffs and state errors that appeared after a migration.”
01 / THE REASONING
Why this made the selection.
- The first heading is Decide Whether to Migrate at All.
- Later steps require a baseline before any port and a verify step after registration moves.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- plugins/terraform/skills/provider-framework-migration/SKILL.md
- README.md
- LICENSE
Our findings
- Headings include Step 1: Mux the Provider and Step 5: Verify.
- The skill tells the reader to baseline before touching anything.
- Mux requirements include identical provider-level schemas and no duplicate resource/data-source registration.
- The migration guidance preserves id on migrated resources even where a net-new Framework resource would omit a redundant id.
- State written by SDKv2 must round-trip, and a redundant id on an old resource must be kept even though a new Framework resource would not need one.
- Mux registration must move a resource from SDKv2 to Framework in the same change because duplicate registration is rejected.
Not established by this review
- The skill was not executed inside a host agent.
- Not executed: it was not installed or run.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Add a skill to your workflow.
DOCUMENTED COMMAND
npx skills add hashicorp/agent-skills/plugins/terraform/skills/provider-framework-migration --skill provider-framework-migrationRun in your terminal to choose your AI tools, project or global scope, and installation method. This short command follows the current upstream version; the review covers the revision shown above.
Optional: install the reviewed revision
Keeps the original source and installer version where recorded, while leaving your AI tools and installation scope for you to choose.
npx skills@1.7.1 add https://github.com/hashicorp/agent-skills/tree/f706481af9b8fedb66de909f6243ad29601afa0c/plugins/terraform/skills/provider-framework-migration --skill provider-framework-migration- Choose your AI tools and project or global installation scope in Skills CLI. The review applies to the source revision shown on this page.
- Retain all supporting files; separately configure companion skills, runtimes and service credentials named in the definition.
- Review the resulting diff and use an isolated target before any migration, deployment, load test or warehouse operation.
Before you start
- Go, Terraform, both relevant SDKs/mux libraries and isolated acceptance-test infrastructure.
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
- Skill definition ↗Checked
https://github.com/hashicorp/agent-skills/blob/f706481af9b8fedb66de909f6243ad29601afa0c/plugins/terraform/skills/provider-framework-migration/SKILL.md
Supports: Workflow and stated scope
- Repository licence ↗Checked
https://github.com/hashicorp/agent-skills/blob/f706481af9b8fedb66de909f6243ad29601afa0c/LICENSE
Supports: Redistribution terms
- Install instructions ↗Checked
https://github.com/hashicorp/agent-skills/blob/f706481af9b8fedb66de909f6243ad29601afa0c/README.md
Supports: Documented install path
https://raw.githubusercontent.com/hashicorp/agent-skills/f706481af9b8fedb66de909f6243ad29601afa0c/plugins/terraform/skills/provider-framework-migration/SKILL.md
Supports: review.findings, bestFor