# Migration Guides

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

## 📖 Available Guides

| Guide                                                     | Description                                                          |
| --------------------------------------------------------- | -------------------------------------------------------------------- |
| [Forge v1 to v2](forge-v1-to-v2.md)                       | Terraform modules, pipeline simplification, deployment slots         |
| [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  |
| [MCP-Assisted Migration to v3](mcp-assisted-migration.md) | AI-powered automated migration using the SAIF MCP server and Copilot |

## 🔗 Related Documentation

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