1# Workflow Details
2 
3## Upgrade Workflow Phases
4 
5The azure-upgrade skill follows a structured workflow to ensure safe, repeatable upgrades.
6 
7## Phase Overview
8 
9```
10┌──────────┐    ┌──────────┐    ┌─────────────┐    ┌─────────┐    ┌──────────┐
11│ Identify │───▶│  Assess  │───▶│ Pre-migrate │───▶│ Upgrade │───▶│ Validate │
12└──────────┘    └──────────┘    └─────────────┘    └─────────┘    └──────────┘
13```
14 
15## Progress Tracking
16 
17Create and maintain `upgrade-status.md` in the workspace root:
18 
19```markdown
20# Upgrade Status
21 
22## Upgrade Details
23 
24| Property | Value |
25|----------|-------|
26| **Source App** | <app-name> |
27| **Source Plan** | <current-plan> |
28| **Target Plan** | <target-plan> |
29| **Resource Group** | <resource-group> |
30| **Region** | <region> |
31| **Started** | <date> |
32 
33## Phase Status
34 
35- [ ] Phase 1: Identify — Determine source/target plans
36- [ ] Phase 2: Assess — Check readiness and compatibility
37- [ ] Phase 3: Pre-migrate — Collect settings and configurations
38- [ ] Phase 4: Upgrade — Execute upgrade automation
39- [ ] Phase 5: Validate — Verify new app functionality
40 
41## Notes
42 
43<any issues, decisions, or observations during upgrade>
44```
45 
46## Error Handling
47 
48If any phase fails:
491. Log the error in `upgrade-status.md`
502. Do NOT proceed to the next phase
513. Inform the user of the failure and suggest remediation
524. Offer to retry the failed phase or rollback
53 
54## Hand-off
55 
56After successful validation:
57- Offer to hand off to `azure-validate` for deeper testing
58- Offer to hand off to `azure-deploy` for CI/CD pipeline setup
59- Ask if the user wants to clean up the original app
60