# azure/migration architecture

> Architecture diagram of the GitHub repository azure/migration, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/azure/migration
- Repository: https://github.com/azure/migration

## Overview

The Migration Execution Guide is a set of Excel-based planning and execution artifacts, not a software service. Its principal workflow is for migration teams to review the lifecycle and workshop questions, discover and scope workloads, plan resources and migration waves, then use checklists and templates to guide migration-day work and manage change and risk. The README documents these capabilities and the artifact paths; source excerpts were unavailable, so the graph represents documented use rather than internal workbook links.

Main entry points: [`excel/MEG v0.97 - Framework.xlsx`](https://github.com/azure/migration/blob/main/excel/MEG%20v0.97%20-%20Framework.xlsx) (MEG framework)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_framework["Framework and planning"]
  node_framework_book["MEG framework"]
  node_lifecycle["Migration lifecycle"]
  node_workshops["Workshop questions"]
  node_resources["Roles and resources"]
  node_training["Training resources"]
  node_tooling["Migration tooling"]
  node_discovery["Estate discovery"]
  node_workload["Workload mapping"]
end

subgraph group_guidance["Checklist guidance"]
  node_checklist["Best-practice checklist"]
end

subgraph group_execution["Migration execution"]
  node_project_plan["Project plan"]
  node_wave_plan["Migration wave plan"]
  node_runbook["Migration runbook"]
  node_change["Change request"]
  node_risk["Risk register"]
end

node_team(("Migration team"))

node_team -->|"reviews"| node_framework_book
node_team -->|"reviews"| node_lifecycle
node_team -->|"uses"| node_workshops
node_team -->|"assigns"| node_resources
node_team -->|"reviews"| node_training
node_team -->|"compares"| node_tooling
node_team -->|"documents estate"| node_discovery
node_team -->|"maps attributes"| node_workload
node_team -->|"filters and follows"| node_checklist
node_team -->|"plans work"| node_project_plan
node_team -->|"groups workloads"| node_wave_plan
node_team -->|"prepares tasks"| node_runbook
node_team -->|"requests approval"| node_change
node_team -->|"evaluates risks"| node_risk

click node_framework_book "https://github.com/azure/migration/blob/main/excel/MEG%20v0.97%20-%20Framework.xlsx"
click node_lifecycle "https://github.com/azure/migration/blob/main/excel/MEG%20v0.97%20-%20Framework.xlsx"
click node_workshops "https://github.com/azure/migration/blob/main/excel/MEG%20v0.97%20-%20Framework.xlsx"
click node_resources "https://github.com/azure/migration/blob/main/excel/MEG%20v0.97%20-%20Framework.xlsx"
click node_training "https://github.com/azure/migration/blob/main/excel/MEG%20v0.97%20-%20Framework.xlsx"
click node_tooling "https://github.com/azure/migration/blob/main/excel/MEG%20v0.97%20-%20Framework.xlsx"
click node_discovery "https://github.com/azure/migration/blob/main/excel/MEG%20v0.97%20-%20Framework.xlsx"
click node_workload "https://github.com/azure/migration/blob/main/excel/MEG%20v0.97%20-%20Framework.xlsx"
click node_project_plan "https://github.com/azure/migration/blob/main/excel/MEG%20v0.97%20-%20Framework.xlsx"
click node_wave_plan "https://github.com/azure/migration/blob/main/excel/MEG%20v0.97%20-%20Framework.xlsx"
click node_runbook "https://github.com/azure/migration/blob/main/excel/MEG%20v0.97%20-%20Framework.xlsx"
click node_change "https://github.com/azure/migration/blob/main/excel/MEG%20v0.97%20-%20Framework.xlsx"
click node_risk "https://github.com/azure/migration/blob/main/excel/MEG%20v0.97%20-%20Framework.xlsx"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_framework_book,node_lifecycle,node_workshops,node_resources,node_training,node_tooling,node_discovery,node_workload toneBlue
class node_checklist toneAmber
class node_project_plan,node_wave_plan,node_runbook,node_change,node_risk toneMint
class node_team toneIndigo
```

## Components

### Framework and planning

- [MEG framework](https://github.com/azure/migration/blob/main/excel/MEG%20v0.97%20-%20Framework.xlsx): `excel/MEG v0.97 - Framework.xlsx`
- [Migration lifecycle](https://github.com/azure/migration/blob/main/excel/MEG%20v0.97%20-%20Framework.xlsx): `excel/MEG v0.97 - Framework.xlsx`
- [Workshop questions](https://github.com/azure/migration/blob/main/excel/MEG%20v0.97%20-%20Framework.xlsx): `excel/MEG v0.97 - Framework.xlsx`
- [Roles and resources](https://github.com/azure/migration/blob/main/excel/MEG%20v0.97%20-%20Framework.xlsx): `excel/MEG v0.97 - Framework.xlsx`
- [Training resources](https://github.com/azure/migration/blob/main/excel/MEG%20v0.97%20-%20Framework.xlsx): `excel/MEG v0.97 - Framework.xlsx`
- [Migration tooling](https://github.com/azure/migration/blob/main/excel/MEG%20v0.97%20-%20Framework.xlsx): `excel/MEG v0.97 - Framework.xlsx`
- [Estate discovery](https://github.com/azure/migration/blob/main/excel/MEG%20v0.97%20-%20Framework.xlsx): `excel/MEG v0.97 - Framework.xlsx`
- [Workload mapping](https://github.com/azure/migration/blob/main/excel/MEG%20v0.97%20-%20Framework.xlsx): `excel/MEG v0.97 - Framework.xlsx`

### Checklist guidance

- **Best-practice checklist**

### Migration execution

- [Project plan](https://github.com/azure/migration/blob/main/excel/MEG%20v0.97%20-%20Framework.xlsx): `excel/MEG v0.97 - Framework.xlsx`
- [Migration wave plan](https://github.com/azure/migration/blob/main/excel/MEG%20v0.97%20-%20Framework.xlsx): `excel/MEG v0.97 - Framework.xlsx`
- [Migration runbook](https://github.com/azure/migration/blob/main/excel/MEG%20v0.97%20-%20Framework.xlsx): `excel/MEG v0.97 - Framework.xlsx`
- [Change request](https://github.com/azure/migration/blob/main/excel/MEG%20v0.97%20-%20Framework.xlsx): `excel/MEG v0.97 - Framework.xlsx`
- [Risk register](https://github.com/azure/migration/blob/main/excel/MEG%20v0.97%20-%20Framework.xlsx): `excel/MEG v0.97 - Framework.xlsx`

### Other components

- **Migration team**

## Connections

- Migration team → MEG framework: reviews
- Migration team → Migration lifecycle: reviews
- Migration team → Workshop questions: uses
- Migration team → Roles and resources: assigns
- Migration team → Training resources: reviews
- Migration team → Migration tooling: compares
- Migration team → Estate discovery: documents estate
- Migration team → Workload mapping: maps attributes
- Migration team → Best-practice checklist: filters and follows
- Migration team → Project plan: plans work
- Migration team → Migration wave plan: groups workloads
- Migration team → Migration runbook: prepares tasks
- Migration team → Change request: requests approval
- Migration team → Risk register: evaluates risks