refactor-module — Claude Code skill: split Terraform into modules

What refactor-module does

The skill reads your existing Terraform code and breaks it into modules following HashiCorp's design principles. It starts with analysis: resources get grouped by logical function, repeated patterns surface, dependencies get mapped, and the difficulty of moving state is assessed. Then comes interface design — input variables with validation, plus outputs.

After that the code is rewritten. Repeated resource blocks collapse into for_each and locals, and a root configuration calls the module through source. State migration is its own step: before writing moved blocks or state mv commands, the agent inspects current state with terraform state list and terraform show -json to match old resource addresses to new ones. That is where things break — if the addresses do not line up, terraform plan reports destroy-and-recreate instead of a move.

Inputs are the path to the configuration, the module name, and whether state compatibility must be preserved. Abstraction level is one of "simple", "intermediate" or "advanced", with intermediate as the default. You need access to state and a grasp of how your resources depend on each other; without that the migration cannot be planned.