migration-assistant — Claude Code command: migration and setup
Plan a migration, run it, verify the result, and prepare a rollback with this Claude Code command. It works with GitHub CLI and Linear MCP.
npx claude-code-templates@latest --command team/migration-assistantWhat migration-assistant does
The command checks GitHub CLI authentication and Linear MCP access, then helps assess data volume, dependencies, and migration complexity. It uses Read, Write, Edit, and Bash for its operations.
Its workflow covers migration planning, risk assessment, progress checks, and validation of data and user workflows. GitHub CLI authentication, Linear MCP connectivity, and available backup storage are prerequisites; without them, the prerequisite checks cannot pass.
After the migration, it can report validation results and rollback readiness. Choose an action with --plan, --analyze, --migrate, --verify, or --rollback.
What it helps with
- estimate migration scope and complexity
- map dependencies before moving data
- validate data integrity after a migration
- plan a rollback and restore the prior state
Example prompts for the agent
- Use
--planto outline the migration and its dependencies. - Analyze migration risks and data volume with
--analyze. - Run the migration with
--migrate, then validate the result using--verify.
How to install migration-assistant
1claude-code-templates
npx claude-code-templates@latest --command team/migration-assistant2Manually: put the files in place
.claude/commands/migration-assistant.mdCall it with /migration-assistant. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/migration-assistant.mdCall it with /prompts:migration-assistant. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/migration-assistant.prompt.mdManually: put the files in place
.gemini/commands/migration-assistant.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about migration-assistant
How do I install migration-assistant in Claude Code?
Run npx claude-code-templates@latest --command team/migration-assistant. The command is installed at .claude/commands/migration-assistant.md.
What does migration-assistant do?
It helps plan and run a migration, validate the transferred data, and prepare rollback steps.
What does migration-assistant need to run?
It checks GitHub CLI authentication, Linear MCP connectivity and permissions, and available backup storage.
Source text
migration-assistant.md · MIT
--- allowed-tools: Read, Write, Edit, Bash argument-hint: "[action] | --plan | --analyze | --migrate | --verify | --rollback" description: Comprehensive system migration assistance with planning, analysis, execution, and rollback capabilities --- # Migration Assistant Execute comprehensive system migrations with planning, verification, and rollback capabilities: **$ARGUMENTS** ## Current Migration Context - Source systems: GitHub CLI authentication and API access status - Target systems: Linear MCP server connectivity and permissions - Backup storage: Available storage space and backup verification - Migration scope: Data volume estimation and complexity assessment ## Task Execute systematic migration process with comprehensive safety measures and validation: **Migration Action**: Use $ARGUMENTS to specify migration planning, analysis, execution, verification, or rollback operations **Migration Framework**: 1. **Prerequisites Validation** - Verify GitHub CLI authentication, confirm Linear MCP connectivity, validate permissions, ensure backup storage 2. **Migration Planning** - Assess data volume and complexity, design migration strategy, identify dependencies, create rollback plan 3. **Risk Analysis** - Evaluate potential failure points, assess data integrity risks, identify system dependencies, plan contingency measures 4. **Execution Management** - Implement migration phases, monitor progress and health, handle errors gracefully, maintain audit trails 5. **Verification Process** - Validate data integrity, confirm system functionality, test user workflows, verify performance metrics 6. **Rollback Procedures** - Implement safe rollback mechanisms, restore system state, validate recovery, communicate status updates **Advanced Features**: Incremental migration support, real-time progress monitoring, automated health checks, comprehensive logging, emergency stop mechanisms. **Safety Measures**: Multi-point backups, integrity validation, rollback testing, system health monitoring, stakeholder communication. **Output**: Complete migration execution with progress tracking, validation reports, rollback readiness, and post-migration optimization recommendations.
© davila7 · MIT · davila7/claude-code-templates