Skip to main content
command

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.

Install into Claude Code · claude-code-templates All methods and platforms ↓
npx claude-code-templates@latest --command team/migration-assistant
Open on GitHub

What 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 --plan to 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-assistant

2Manually: put the files in place

.claude/commands/migration-assistant.md

Call it with /migration-assistant. For all projects use ~/.claude/commands/

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

Similar slash commands

All slash commands for DevOps and infrastructure →

From the same set804

The whole set →

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor