# arm-migration

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.

- subagent · `type=agent` · Claude Code · 169 installs
- Author: davila7
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/devops-infrastructure/arm-migration.md
- Updated: 2026-10-25
- HTML: https://affpapa.org/en/nevibecode/agents/arm-migration

## What it 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.

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

1. **claude-code-templates**
```bash
npx claude-code-templates@latest --agent devops-infrastructure/arm-migration
```

2. **Manually: put the files in place**
- File: `.claude/agents/arm-migration.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.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/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/arm-migration.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/devops-infrastructure/arm-migration.md

## When to use it
- 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
- 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

## Similar
- [security-auditor](https://affpapa.org/en/nevibecode/agents/voltagent-community-security-auditor.md) — subagent · 10718 installs
- [error-detective](https://affpapa.org/en/nevibecode/agents/error-detective.md) — subagent · 7557 installs
- [devops-engineer](https://affpapa.org/en/nevibecode/agents/devops-engineer.md) — subagent · 7392 installs
- [deployment-engineer](https://affpapa.org/en/nevibecode/agents/deployment-engineer.md) — subagent · 6079 installs
- [security-engineer](https://affpapa.org/en/nevibecode/agents/security-engineer.md) — subagent · 3243 installs
- [data-engineer](https://affpapa.org/en/nevibecode/agents/voltagent-community-data-engineer.md) — subagent · 3194 installs

From the same set: [davila7/claude-code-templates](https://affpapa.org/en/nevibecode/by/davila7/claude-code-templates.md) — 495 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md