Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.modelcode.ai/llms.txt

Use this file to discover all available pages before exploring further.

The roadmap is your migration plan, laid out visually. Instead of one massive code change, your migration is split into ordered milestones. Each milestone handles a logical chunk of work, produces a pull request, and waits for your approval before anything is merged. Within each milestone, the agent breaks the work into tasks and executes them automatically. This means:
  • Changes are progressive. Each milestone builds on the previous one. You catch issues early, before they compound, and the codebase stays working after each step.
  • You stay in control. Every milestone produces a PR. You review it, run your own tests, and merge when satisfied. Nothing is merged without your approval.
  • Grouping is logical. Milestones aren’t random file splits. Related files are migrated together, dependencies are respected, and each milestone makes sense as a standalone change.

​
What You See

When you open a project, the roadmap shows a vertical list of milestone cards: Roadmap overview Each card shows:
  • Milestone number and title (e.g., “M1: Project Foundation & Static Files”)
  • Progress bar showing how many tasks are complete out of the total. As tasks finish, the bar fills in and the percentage updates so you can tell at a glance how far along each milestone is.
  • Status badge indicating where the milestone is in its lifecycle (Not Started, In Progress, Pending Review, Merged, etc.)
  • Test summary (after execution) — Per-repo functional test results showing passed/total counts for backend tests and test counts for frontend tests, with comparison indicators when origin data is available
Progress at 33% Milestones are listed in order, starting with Milestone 1 at the top. They must be completed sequentially because each one builds on the code produced by the previous milestone. Click any milestone card to expand it and see its details, tasks, and available actions. The roadmap sidebar also provides access to the Lifecycle Setup drawer, where you can view and edit the lifecycle configuration for the origin and target sides of your migration.

​
The Milestone Cycle

Every milestone follows the same pattern:
  1. Review the milestone plan. Check the relevant files, test files, and description. Edit anything that doesn’t look right.
  2. Approve & Start to kick off the agent. It plans the tasks, executes them one by one, and commits code after each.
  3. Review the Pull Request when the agent finishes. Morph creates a PR automatically.
  4. Merge when you’re satisfied with the changes.
Once merged, the milestone is marked complete and the next one is ready. The full walkthrough with screenshots and details on every status is in the Milestones guide.

Milestones

The full walkthrough: the milestone lifecycle, statuses, task dependencies, and tips

Milestones

The milestone lifecycle, statuses, and task dependencies

Reviewing Pull Requests

Best practices for PR review

Editing Milestones

Adjust plans before approving

Functional Testing

Verify behavior with auto-generated tests

Creating Rules

Encode preferences for better results

Lifecycle Setup

Configure how your project builds and runs