Skip to content

Migration Plan: {title}

Source: migration-plan.md

markdown
# Migration Plan: {title}

> **Refactor ID:** REF-{NNN}
> **Status:** Planning
> **Date:** {date}
> **Author:** Migration Architect
> **Based on:** `docs/refactors/REF-{NNN}/scope.md`

## Migration Strategy
<!-- sniper:managed:strategy:start -->
<!-- Big-bang vs incremental vs strangler fig, with justification -->
<!-- sniper:managed:strategy:end -->

## Step-by-Step Approach
<!-- sniper:managed:steps:start -->

### Step 1: {description}
- **What changes:**
- **Why this order:**
- **Verification:**

### Step 2: {description}
- **What changes:**
- **Why this order:**
- **Verification:**

<!-- sniper:managed:steps:end -->

## Coexistence Plan
<!-- sniper:managed:coexistence:start -->
<!-- How old and new patterns coexist during migration -->
<!-- sniper:managed:coexistence:end -->

## Compatibility Layer
<!-- sniper:managed:compatibility:start -->
<!-- Adapter patterns, deprecation warnings, backward-compatible wrappers -->
<!-- sniper:managed:compatibility:end -->

## Verification Strategy
<!-- sniper:managed:verification:start -->
<!-- How to verify each step worked: tests, canary, metrics -->
<!-- sniper:managed:verification:end -->

## Rollback Plan
<!-- sniper:managed:rollback:start -->
<!-- How to undo each step if something goes wrong -->
<!-- sniper:managed:rollback:end -->