Prerequisites
- A GitHub account
- A repository you want to migrate
Step 1: Sign In
Go to modelcode.ai and sign in with:- GitHub (recommended if you’re migrating GitHub repositories)
Step 2: Connect GitHub
After signing in, connect your GitHub account to access your repositories:- Click Connect GitHub
- Authorize to access your repositories
- Select which repositories can access
Step 3: Create a Project
- Select the repository you want to migrate
- Enter a project name (defaults to your repository name)
- Click Create Project
Where Will the Code Go?
- Organization repositories: creates a new repository in your organization for the migrated code
- Personal repositories: The migrated code goes to a new branch named
{branch}-modelcode-ai
Step 4: Define Your Modernization Goal
This is where you tell what you want to achieve. In the text field, describe your goal in plain language: Examples:- “Translate the source code from Ada to C++”
- “Upgrade Python 2.7 to Python 3.12”
- “Migrate from AngularJS to React with TypeScript”
- “Upgrade Java Spring framework to the latest version”
Be specific about your target. Instead of “modernize the code,” say “migrate from Express.js to FastAPI” or “upgrade to React 18 with hooks.”
Advanced Options
Expand Advanced Options to access:| Option | When to Use |
|---|---|
| Additional Instructions | Specify libraries, frameworks, coding patterns, or testing requirements |
| Modernization Scope | Limit migration to specific parts of the repository. Leave empty to migrate everything |
Step 5: Wait for Analysis
now:- Generates Source Architecture — Analyzes your codebase and documents its structure
- Generates Instructions — Creates a detailed migration plan based on your goal
Step 6: Review and Approve Instructions
The generated instructions describe how your code will be migrated. Review them carefully:- Do they capture your intent?
- Are the target technologies correct?
- Is anything missing?
- Edit the instructions to add or change requirements
- Auto-review to have AI check your edits for issues
- Approve when you’re satisfied
Step 7: Generate Roadmap
After approval, generates:- Destination Architecture — The target structure of your migrated application
- Roadmap — A sequence of milestones that progressively migrate your code
Step 8: Execute Your First Milestone
- Open the first milestone
- Review what it will accomplish
- Click Generate Tasks to create the specific work items
- Click Execute Tasks to run the migration
What’s Next
- Define Modernization Goals — Learn how to write effective goals
- Modernization Instructions — Deep dive into the approval process
- Working with Milestones — Master the milestone workflow