arm-migration — субагент для Claude Code: перенос кода на ARM
Субагент проверяет репозиторий на x86-зависимости и помогает перевести сборку и образы на ARM64. Нужен при переезде на Arm-инфраструктуру.
npx claude-code-templates@latest --agent devops-infrastructure/arm-migrationЧто делает arm-migration
Субагент проходит по Dockerfile, requirements.txt, go.mod, Cargo.toml и файлам сборки Java, находит привязки к x86 и подбирает замены под ARM. Для проверки совместимости он обращается к базе знаний Arm через MCP: прогоняет базовые образы, пакеты, модули и крэйты, а затем запускает сканер migrate_ease_scan под нужный язык и вносит правки в рабочей области сервера.
Без настроенного Arm MCP-сервера ничего не выйдет. Агент берёт оттуда инструменты check_image, skopeo, knowledge_base_search и migrate_ease_scan, поэтому сначала подключите сервер через npx -y @arm/mcp-server в конфиге MCP. Если сервер не поднят, субагент обязан сказать об этом и не строить догадок о совместимости.
После правок проект пересобирается и тесты прогоняются — ошибки он чинит до того, как отчитаться. Отчёт перечисляет каждый изменённый файл с пояснением, что было и что стало. Отдельно в инструкции предупреждение: не путайте версию софта с версией обёртки в пакетном менеджере, иначе в requirements.txt уедет версия самого Redis вместо клиентской библиотеки.
Какие задачи решает
- найти x86-специфичные флаги сборки и интринсики в коде
- проверить базовые образы Docker на совместимость с ARM
- подобрать ARM-совместимые версии пакетов и модулей
- перевести сборку на мультиархитектурные образы
- прогнать тесты после миграции и убедиться, что ничего не сломалось
Примеры запросов агенту
- Проверь Dockerfile и переведи базовый образ на ARM
- Прогони миграцию этого Go-проекта на ARM и пересобери
- Проверь пакеты из
requirements.txtна совместимость с ARM
Как установить arm-migration
1Через claude-code-templates
npx claude-code-templates@latest --agent devops-infrastructure/arm-migration2Вручную: положить файлы
.claude/agents/arm-migration.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/arm-migration.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/arm-migration.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о arm-migration
Как установить arm-migration в Claude Code?
Через шаблоны: выполните npx claude-code-templates@latest --agent devops-infrastructure/arm-migration, файл агента появится по пути .claude/agents/arm-migration.md.
Что делает arm-migration?
Сканирует репозиторий на привязки к x86, проверяет образы и зависимости через Arm MCP-сервер, вносит ARM-совместимые правки и пересобирает проект с тестами.
Что нужно для работы субагента?
Настроенный Arm MCP-сервер с инструментами проверки образов и сканирования. Его подключают командой npx -y @arm/mcp-server в конфигурации MCP.
