1# Assessment Phase
2 
3Generate a migration assessment report before any code changes.
4 
5## Prerequisites
6 
7- Workspace contains source platform project files (Procfile, app.yaml, .ebextensions, etc.)
8- Prompt user to upload relevant files if not present
9 
10## Assessment Steps
11 
121. **Identify Application** — Determine app type (web, API, worker), runtime, and framework
132. **Map Platform Services** — Map source services to Azure equivalents (see scenario-specific references)
143. **Map Properties** — Map compute config (instance size, scaling) to App Service Plan properties
154. **Check Dependencies** — List 3rd-party libraries and verify Azure compatibility
165. **Analyze Code** — Check for platform-specific APIs, SDKs, or patterns that need migration
176. **Map Data Services** — Identify database and storage migration paths
187. **Map Deployment** — Identify equivalent Azure deployment strategies (azd, GitHub Actions, Bicep)
198. **Review CI/CD** — Check pipeline compatibility with Azure DevOps or GitHub Actions
209. **Map Monitoring** — Map observability stack → Application Insights / Azure Monitor
21 
22## Code Preview
23 
24During assessment, show a **sneak peek** of key configuration changes:
25- Startup command / Dockerfile adjustments
26- App Settings mapping
27- Database connection string migration (to managed identity)
28 
29This helps the user understand the migration scope before committing.
30 
31## Architecture Diagrams
32 
33Generate two diagrams:
341. **Current State** — Source platform architecture with services and integrations
352. **Target State** — Azure architecture showing equivalent App Service structure
36 
37## Assessment Report Format
38 
39> ⚠️ **MANDATORY**: Use these exact section headings in every assessment report. Do NOT rename, reorder, or omit sections.
40 
41The report MUST be saved as `migration-assessment-report.md` inside the output directory (`<source-folder>-azure/`).
42 
43```markdown
44# Migration Assessment Report
45 
46## 1. Executive Summary
47 
48| Property | Value |
49|----------|-------|
50| **Application Name** | <name> |
51| **Application Type** | Web App / API / Worker |
52| **Source Platform** | <Heroku / Elastic Beanstalk / App Engine> |
53| **Source Runtime** | <runtime and version> |
54| **Target Platform** | Azure App Service |
55| **Target Runtime** | <runtime and version> |
56| **Migration Readiness** | <High / Medium / Low> |
57| **Estimated Effort** | <Low / Medium / High> |
58| **Assessment Date** | <date> |
59 
60## 2. Application Inventory
61 
62| # | Component | Runtime | Type | Instances | Description |
63|---|-----------|---------|------|-----------|-------------|
64| 1 | | | Web / Worker / Cron | | |
65 
66## 3. Service Mapping
67 
68| Source Service | Azure Equivalent | Migration Complexity | Notes |
69|----------------|------------------|----------------------|-------|
70| | | | |
71 
72## 4. Compute & Scaling Mapping
73 
74| # | Source Config | Value | Azure Equivalent | Azure Value | Notes |
75|---|-------------|-------|------------------|-------------|-------|
76| 1 | Instance type | | App Service Plan SKU | | |
77| 2 | Auto-scaling | | App Service Autoscale | | |
78| 3 | Health check | | Health Check feature | | |
79 
80## 5. Dependencies Analysis
81 
82| # | Package/Library | Version | Platform-Specific? | Azure Equivalent | Compatible? | Notes |
83|---|----------------|---------|---------------------|------------------|-------------|-------|
84| 1 | | | | | | |
85 
86## 6. Environment Variables & Configuration
87 
88| # | Source Variable | Purpose | Azure Equivalent | Auth Method | Notes |
89|---|---------------|---------|------------------|-------------|-------|
90| 1 | | | App Setting / Key Vault | Managed Identity / App Setting | |
91 
92## 7. Architecture Diagrams
93 
94### 7a. Current State (Source Platform)
95 
96<!-- Mermaid or ASCII diagram -->
97 
98### 7b. Target State (Azure)
99 
100<!-- Mermaid or ASCII diagram -->
101 
102## 8. Data Services Mapping
103 
104| Source Database/Storage | Azure Equivalent | Migration Path | Notes |
105|------------------------|------------------|----------------|-------|
106| | | | |
107 
108## 9. Networking & Security Mapping
109 
110| Source Feature | Azure Equivalent | Notes |
111|---------------|------------------|-------|
112| Custom domain | App Service Custom Domain | |
113| SSL/TLS | App Service Managed Certificate / BYO cert | |
114| VPN/VPC | VNet Integration | |
115 
116## 10. Monitoring & Observability Mapping
117 
118| Source Service | Azure Equivalent | Migration Notes |
119|---------------|------------------|-----------------|
120| | Application Insights | |
121| | Azure Monitor Metrics | |
122| | Azure Monitor Alerts | |
123 
124## 11. CI/CD & Deployment Mapping
125 
126| Source Tool | Azure Equivalent | Notes |
127|------------|------------------|-------|
128| | GitHub Actions / Azure DevOps | |
129| | Bicep / ARM Templates | |
130| | Deployment Slots | |
131 
132## 12. Recommendations
133 
1341. **Runtime**: <recommended App Service runtime stack and version>
1352. **App Service Plan**: <Free / Basic / Standard / Premium v3>
1363. **IaC Strategy**: <Bicep with azd / Terraform>
1374. **Auth Strategy**: <Managed Identity for all service-to-service>
1385. **Monitoring**: <Application Insights + Azure Monitor>
139 
140## 13. Next Steps
141 
142- [ ] Review and approve this assessment report
143- [ ] Proceed to code migration (azure-cloud-migrate Phase 2)
144- [ ] Hand off to azure-prepare for IaC generation
145```
146 
147> 💡 **Tip:** Use `mcp_azure_mcp_get_azure_bestpractices` tool to learn App Service best practices for the comparison.
148