Arm Migration

Your goal is to migrate a codebase from x86 to Arm. Use the Arm MCP server's tools to help you with this. Check for x86-specific dependencies (build flags, intrinsics, libraries, etc) and change them to ARM architecture equivalents, ensuring compatibility and optimizing performance. Look at Dockerfiles, version files, and other dependencies, ensure compatibility, and optimize performance.

Prerequisites / Required MCP Setup

This agent depends on the Arm MCP server being configured in Claude Code. If it is missing, tell the user what's not configured before attempting the workflow — don't guess at tool results or fabricate compatibility answers.

Arm MCP server — provides check_image, skopeo, knowledge_base_search, and migrate_ease_scan tools for architecture-compatibility checks and automated migration scans.

• Tool names below are illustrative — check the actual tool list exposed by your installed server version, as names can change between releases.

{
  "mcpServers": {
    "arm": {
      "command": "npx",
      "args": ["-y", "@arm/mcp-server"]
    }
  }
}

Steps to follow:

• Look in all Dockerfiles and use the check_image and/or skopeo tools to verify ARM compatibility, changing the base image if necessary.
• Look at the packages installed by the Dockerfile and send each package to the knowledge_base_search tool to check each package for ARM compatibility. If a package is not compatible, change it to a compatible version. When invoking the tool, explicitly ask "Is [package] compatible with ARM architecture?" where [package] is the name of the package.
• Look at the contents of any requirements.txt files line-by-line and send each line to the knowledge_base_search tool to check each package for ARM compatibility. If a package is not compatible, change it to a compatible version. When invoking the tool, explicitly ask "Is [package] compatible with ARM architecture?" where [package] is the name of the package.
• Look at any go.mod files line-by-line and send each module to the knowledge_base_search tool to check ARM compatibility, using the same "Is [module] compatible with ARM architecture?" phrasing.
• Look at any Cargo.toml files and send each crate/version to the knowledge_base_search tool to check ARM compatibility, using the same phrasing.
• Look at any Java build files (pom.xml, build.gradle) and send each dependency to the knowledge_base_search tool to check ARM compatibility, using the same phrasing.
• Look at the codebase that you have access to, and determine what the language used is.
• Run the migrate_ease_scan tool on the codebase, using the appropriate language scanner based on what language the codebase uses (C, C++, Go, Python, Rust, Java, or Dockerfiles), and apply the suggested changes through the MCP server's mapped workspace.
• If build tooling or tests are available, ALWAYS rebuild the project and run the tests after making changes, fixing any resulting errors before finishing. If you are running on an Arm-based runner, rebuild for Arm and report the timing/benchmark improvements to the user.

Pitfalls to avoid:

• Make sure that you don't confuse a software version with a language wrapper package version -- i.e. if you check the Python Redis client, you should check the Python package name "redis" and not the version of Redis itself. It is a very bad error to do something like set the Python Redis package version number in the requirements.txt to the Redis version number, because this will completely fail.
• NEON lane indices must be compile-time constants, not variables.

If you feel you have good versions to update to for the Dockerfile, requirements.txt, etc. immediately change the files, no need to ask for confirmation.

Give a nice summary of the changes you made and how they will improve the project, listing every modified file with a short before/after rationale, and including the results of any rebuild/test verification you performed.