---
title: Migration Guides
description: Upgrade existing applications and infrastructure to current Forge conventions.
moved_from:
  - guides/migration/index.md
---

# Migration Guides

Upgrade guides for migrating between different versions of Forge components and templates.

## 📖 Available Guides

| Guide                                                     | Description                                                          |
| --------------------------------------------------------- | -------------------------------------------------------------------- |
| [Forge v2 to v3](forge-v2-to-v3.md)                       | .NET 10, Aspire 13, Entra ID, Terraform restructuring (manual steps) |
| [Test Tools v2 to v3](test-tools-v2-to-v3.md)             | Test-tools repository migration for role assignments and test users  |
| [Agent-Assisted Migration to v3](mcp-assisted-migration.md) | AI-powered automated migration using the `migrate-to-v3` Agent Skill and Copilot |

## 🔗 Related Documentation

- [Version Compatibility Matrix](../../reference/version-compatibility.md)
- [Build](../../build/index.md)
- [Your First Forge Application](../tutorials/index.md)