cloud-migration-specialist — Claude Code subagent: setup and use
Subagent that maps application workloads to cloud platforms, plans cutover waves, and configures containers. Built for migrations to AWS, Azure, or GCP.
npx claude-code-templates@latest --agent modernization/cloud-migration-specialistWhat cloud-migration-specialist does
The subagent runs on Sonnet with standard Claude Code tools: Read, Write, Edit, Bash, Glob, and Grep. It evaluates workloads targeted for AWS, Azure, or GCP. Using the 7 Rs framework, it separates systems that need a direct rehost from those requiring a serverless refactor or full retirement. It also plans repatriation back to colocation when cloud bills climb too high.
For deployment, the agent writes Docker configurations and sets up Kubernetes runtimes. It manages waves and cutover runbooks. It does not work alone. Detailed Terraform templates, cluster tuning, and database migrations are passed off to terraform-specialist, kubernetes-specialist, and database-architect.
Autonomous discovery plans from vendor tools must be approved by an engineer before execution. The agent monitors expenses through FinOps practices, including spot instances and storage policies. Freshly moved workloads usually run over-provisioned. The agent runs its right-sizing assessment only 14 to 30 days after cutover once actual utilization data exists.
What it helps with
- Classify application workloads using the 7 Rs framework
- Structure phased migration waves with cutover runbooks
- Prepare Docker configurations and Kubernetes target runbooks
- Generate a right-sizing report 14 to 30 days post-cutover
Example prompts for the agent
- Review this service inventory and classify each component under the 7 Rs for an AWS migration
- Draft a container migration plan to move this backend service to Azure Container Apps
- Create a cutover runbook and post-migration right-sizing review schedule for GCP
How to install cloud-migration-specialist
1claude-code-templates
npx claude-code-templates@latest --agent modernization/cloud-migration-specialist2Manually: put the files in place
.claude/agents/cloud-migration-specialist.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/cloud-migration-specialist.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/cloud-migration-specialist.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about cloud-migration-specialist
How do you install cloud-migration-specialist in Claude Code?
Run npx claude-code-templates@latest --agent modernization/cloud-migration-specialist. The configuration file will be placed in .claude/agents/cloud-migration-specialist.md.
What is the main role of cloud-migration-specialist?
It oversees cloud assessments, transition wave sequencing, and containerization for deployments to AWS, Azure, or GCP. It also tracks cost optimization strategies and post-cutover sizing.
Which tasks are delegated to other subagents?
The agent manages migration strategy and runbooks, while passing cluster setup to kubernetes-specialist, Terraform code generation to terraform-specialist, and database engines to database-architect.
