subagent

arm-migration — Claude Code subagent for x86 to Arm ports

Q: How do I install arm-migration in Claude Code?

Use the template command `npx claude-code-templates@latest --agent devops-infrastructure/arm-migration`; the agent file is written to `.claude/agents/arm-migration.md`.

A subagent that hunts x86 assumptions in your repo and helps move builds and container images to ARM64. Made for teams heading to Arm infrastructure.

Install into Claude Code · claude-code-templates All methods and platforms ↓

npx claude-code-templates@latest --agent devops-infrastructure/arm-migration

Open on GitHub

What arm-migration does

The agent walks Dockerfiles, requirements.txt, go.mod, Cargo.toml and Java build files, looking for x86 bindings and picking Arm replacements. Compatibility checks go through the Arm MCP server: base images, packages, modules and crates get queried against Arm's knowledge base, then the migrate_ease_scan scanner runs for the project's language and its suggestions land in the server's mapped workspace.

None of that works without the Arm MCP server configured. It supplies check_image, skopeo, knowledge_base_search and migrate_ease_scan, so wire it up first with npx -y @arm/mcp-server in your MCP config. Should the server be absent, the agent has to report the gap and skip guessing about compatibility.

Changes get verified: the project is rebuilt and tests run, with failures fixed before the final summary. That summary lists every touched file and explains the before and after. One trap the instructions call out: package versions in manifests are library versions, not the upstream software version. Pinning the Redis server release into a Python client entry in requirements.txt breaks the build outright.

What it helps with

locate x86 build flags and intrinsics in source code
verify Docker base images against Arm support
swap in Arm-compatible package and module versions
drive multi-arch container builds
rebuild and retest after the port

Example prompts for the agent

Check the Dockerfile and switch the base image to Arm
Run the Arm migration on this Go project and rebuild it
Check every line of requirements.txt for Arm support

How to install arm-migration

1claude-code-templates

npx claude-code-templates@latest --agent devops-infrastructure/arm-migration

2Manually: put the files in place

.claude/agents/arm-migration.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Manually: put the files in place

.codex/agents/arm-migration.toml

Codex 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/arm-migration.md

Cursor 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 arm-migration

How do I install arm-migration in Claude Code?

Use the template command npx claude-code-templates@latest --agent devops-infrastructure/arm-migration; the agent file is written to .claude/agents/arm-migration.md.

What does arm-migration do?

It scans a repo for x86 assumptions, checks images and dependencies through the Arm MCP server, applies Arm-compatible edits, then rebuilds and tests the project.

What does the subagent need to run?

A configured Arm MCP server exposing the image-check and scan tools. Add it with npx -y @arm/mcp-server in your MCP configuration.

Similar subagents

All subagents for DevOps and infrastructure →

security-auditor VoltAgent Community Audits security controls, vulnerabilities, risks, and compliance gaps across systems, infrastructure, and processes. Use it when you need documented findings. 10,718installs error-detective VoltAgent Community A Claude subagent that digs into failures: correlates errors across services, traces cascades and suggests how to prevent them. 7,557installs devops-engineer VoltAgent Community This subagent reviews infrastructure and helps with CI/CD, containers, and deployment workflows. Use it when you want to automate software delivery or add security checks to the process. 7,392installs deployment-engineer VoltAgent Community Designs and tunes CI/CD pipelines, automates rollback triggers, and sets up canary or blue-green releases. Helpful when manual deployment steps slow down your team. 6,079installs security-engineer VoltAgent Community Automates DevSecOps workflows, CIS benchmark checks, and vulnerability scanning. Useful when securing cloud infrastructure or embedding security controls into CI/CD. 3,243installs data-engineer VoltAgent Community Designs data pipelines, ETL/ELT workflows, and data infrastructure. Use it when a project needs pipeline orchestration, data quality checks, or processing cost analysis. 3,194installs

From the same set495

The whole set →

pac-configure Sets up a Product as Code structure: .pac/ directory, config, epic and ticket templates. Useful when product work lives in the same repo as code. 176installs jira This skill lets Claude Code work with Jira issues through the Jira CLI or Atlassian MCP. Use it to inspect tickets, check a sprint, or prepare an issue update. 175installs neon-instagres This skill creates a Neon PostgreSQL database and writes connection settings to an environment file. Use it when a project needs a development database. 173installs add-mutation-testing A slash command that sets up mutation testing in your project: picks a framework, wires quality thresholds and hooks the run into CI. 172installs voidbeast-gpt41enhanced An autonomous full-stack subagent that picks its own mode, digs through the codebase and keeps working until the problem is solved. 166installs backend-to-frontend-handoff-docs Turns finished backend work into a handoff document for frontend developers: endpoints, DTOs, validation and edge cases in one markdown file. 164installs aws-serverless This skill provides patterns for AWS Lambda apps, including API Gateway, DynamoDB, and SQS event processing. Use it when shaping serverless handlers and SAM deployment templates. 163installs change-logger This hook writes each file mutation to a CSV: timestamp, tool, path, action and details. Handy when you are prepping a demo and need to show what the agent touched. 163installs