End-to-End Migration Project Example
See how one migration governance model connects baseline, project tasks, risks, validation, redirects, decisions, Full Migration gates, launch approval, and stabilization across the workbook.
End-to-End Migration Project Example
Section titled “End-to-End Migration Project Example”A useful Toolkit is not six completed tabs. It is a connected project-control system where each task, risk, validation result, redirect, and decision answers a different question while still pointing back to the same project outcome.
This worked example follows one illustrative replatforming project from preparation through launch planning. The values are examples, not product defaults. For a live project, confirm the actual migration path, purchased service, Entity Points Plan, Add-ons, Customization, service expiry, and supported data from the Next-Cart account and the relevant Documentation.
Download the Next-Cart Migration Project Toolkit Example Use-case (.xlsx)
Example project at a glance
Section titled “Example project at a glance”The scenario is a retail replatforming project moving from Magento 2 to Shopify under Custom Service. The project uses Data Filter and Advanced Data Mapping and includes approved non-standard handling for legacy loyalty identifiers.
The non-standard loyalty-identifier handling belongs to approved Custom Service scope. Purchased Add-ons and Customization are planned for paid migration; neither operates inside the Demo.
At the example review point, the project is in Demo validation. Preparation, scope, acceptance criteria, configuration, and the Demo run are complete. Validation is still open because one URL test failed and a separate mapping approval is still pending.
| Project control | Example value | Why it matters |
|---|---|---|
| Project | Example Retail Replatforming | Gives the workbook one identifiable project boundary. |
| Migration Path | Magento 2 -> Shopify | Anchors connection, supported-data, configuration, and validation decisions to one direction. |
| Migration Service | Custom Service | Establishes the purchased execution model for the example. |
| Purchased Add-ons | Data Filter; Advanced Data Mapping | Identifies configuration capabilities that must appear in scope, review, and validation planning. |
| Approved Customization | Non-standard handling for legacy loyalty identifiers | Keeps approved custom scope visible before configuration and acceptance decisions are made. |
| Project Owner | Customer Project Lead | Owns coordination and project decisions. |
| Launch Approver | Executive Sponsor | Owns final authorization where the project requires executive approval. |
| Evidence Repository | Secure project workspace | Keeps detailed evidence outside the workbook while preserving controlled references. |
| As of Date | August 10, 2026 | Makes overdue-task and readiness calculations meaningful for the review. |
| Project Status | Demo validation | Tells reviewers which project stage the evidence represents. |
Use Migrations to confirm the live purchased-service details before filling Project Overview. Use Supported Data Types and Processing Order when the project needs a supported-data reference for the exact migration path.
1. Establish the project baseline before creating tasks
Section titled “1. Establish the project baseline before creating tasks”Start in Project Overview. The baseline should answer three questions before the team starts adding work:
- Which purchased migration is this workbook controlling?
- Who owns execution, review, and launch authorization?
- Which dates and evidence locations define the project state?
In this example, the migration path, service, Add-ons, Customization, owners, milestone dates, As of Date, and project status are established first. That baseline prevents later task and validation rows from drifting into a different environment or commercial scope.
Two fields deserve special discipline in a live project:
- Supported Data Reference should point to the approved migration-path reference rather than a guessed URL.
- Service Expiry should be copied from the purchased migration details rather than inferred from a planning date.
If either value is not confirmed, leave it unresolved and obtain the correct evidence before using the Overview as the authoritative project summary.
2. Turn the migration lifecycle into accountable Project Plan outcomes
Section titled “2. Turn the migration lifecycle into accountable Project Plan outcomes”The example Project Plan does not list generic activities such as “check migration.” Each row describes an outcome, an acceptance condition, an owner, an approver, a gate, dependencies, and evidence.
| Task ID | Project outcome | Gate | Example state | Key relationships |
|---|---|---|---|---|
PREP-01 | Confirm Source Platform and Target Platform access | Access ready | Completed | Risk R-004 |
SCOPE-01 | Approve migration scope and intentional exclusions | Scope approval | Completed | PREP-01, R-003, VAL-001, VAL-002 |
AC-01 | Approve acceptance criteria and risk-based validation samples | Acceptance criteria approved | Completed | SCOPE-01, R-001, R-002, VAL-001 to VAL-003 |
CFG-01 | Configure the supported Demo data, reduced Additional Options, and displayed Attribute Mapping | Demo configuration ready | Completed | AC-01, R-001, R-003, VAL-001, VAL-002 |
DEMO-01 | Run Demo Migration | Demo results available | Completed | CFG-01, Demo risks and validation items |
VALGATE-01 | Validate Demo Migration results | Demo validation decision | In progress, blocking | DEMO-01, R-001 to R-003, VAL-001 to VAL-004 |
DEC-01 | Approve the separate paid configuration, including applicable purchased Add-ons and approved Customization | Full Migration configuration approval | Not started, blocking | VALGATE-01, R-001, R-002, VAL-002, VAL-004 |
FULL-01 | Run Full Migration using the approved configuration | Full Migration complete | Not started | DEC-01, R-005, later Full Migration validation |
FULLVAL-01 | Validate Full Migration results | Full Migration sign-off | Not started | FULL-01, data and launch risks, Full Migration validation |
LAUNCH-01 | Complete launch-readiness and redirect checks | Launch readiness decision | Not started | FULLVAL-01, R-002, R-004, redirect and launch validation |
GO-01 | Record the go-live decision | Go-live | Not started | LAUNCH-01, launch risks and validation |
MON-01 | Monitor target-store behavior after launch | Post-launch closure | Not started | GO-01, post-launch risks and validation |
This sequence creates a practical control chain:
access -> scope -> acceptance criteria -> Demo configuration -> Demo -> Demo validation -> paid configuration approval -> Full Migration -> Full validation -> launch readiness -> go-live -> monitoring
The operational procedures still live in the Documentation. For example, use Demo Migration walkthrough to perform the Demo and Run a Full Migration to execute the Full Migration. The Project Plan records whether the project-specific outcome has been met and what evidence proves it.
3. Record uncertainty before it becomes a defect
Section titled “3. Record uncertainty before it becomes a defect”The Risk Register turns future uncertainty into an owned control. The example contains five risks that cover different parts of the migration rather than treating every problem as a data defect.
| Risk | Concern | Inherent exposure | Main control | Residual exposure | Connected work |
|---|---|---|---|---|---|
R-001 | Complex Product variants could map into incorrect purchasable combinations | 4 x 5 = 20, Critical | Put the highest-complexity Products into Demo validation | 2 x 4 = 8, Moderate | VALGATE-01, Product validation |
R-002 | Priority source URLs may not reach approved target destinations | 3 x 5 = 15, High | Build and test a priority redirect plan before go-live | 2 x 5 = 10, High | LAUNCH-01, VAL-004, redirect work |
R-003 | Business-critical source data may sit outside standard supported fields | 3 x 4 = 12, High | Define the field, dependencies, target use, and required Custom Service assessment | 2 x 3 = 6, Moderate | SCOPE-01, Customization and validation |
R-004 | Checkout, tax, payment, fulfillment, or target configuration may fail even when migrated data is correct | 2 x 5 = 10, High | Complete target-store launch checks and a smoke test | 1 x 5 = 5, Moderate | LAUNCH-01, GO-01 |
R-005 | A fresh migration decision could conflict with protected target records | 2 x 5 = 10, High | Inventory protected target data before destructive or fresh-result actions | 1 x 5 = 5, Moderate | FULL-01 |
The important relationship is not the score alone. Each material risk points to a task or validation activity that can prove whether the control works. Once an uncertainty becomes an observed failure, manage the actual finding in the appropriate task, Validation row, Redirect row, or decision instead of rewriting the risk statement as a defect log.
Use Risk Register for the scoring and treatment rules.
4. Create validation rows before the project reaches the gate
Section titled “4. Create validation rows before the project reaches the gate”The example demonstrates why validation planning should happen before execution. By the time Demo results arrive, the team already knows which records matter, what a pass condition means, who will validate them, and which risks the checks address.
| Validation ID | Activity / area | Example result at the review point | What happens next |
|---|---|---|---|
VAL-001 | Demo Migration / Products | Pass | Keep evidence; no corrective decision is required for the observed result. |
VAL-002 | Demo Migration / Categories | Pass with accepted limitations | Link decision DEC-001 because the target structure differs from the source but preserves approved business meaning. |
VAL-003 | Demo Migration / Customers | Pass | Keep masked evidence and proceed. |
VAL-004 | Demo Migration / URLs and redirects | Fail, High, blocking | Assign corrective ownership, connect RED-001, keep DEC-004 open, and retest before launch approval. |
VAL-005 | Full Migration / Orders | Not tested | Keep the row planned for the Full Migration validation gate. |
VAL-006 | Launch readiness / Checkout | Not tested | Keep the row planned for the launch smoke test. |
The Project Plan also anticipates later validation IDs for Full Migration, launch readiness, and post-launch monitoring. A reliable production practice is to create the Validation row as soon as an ID is referenced by another sheet, even when the activity is still future work. Set the result to Not tested and record the objective, owner, and planned date. This prevents a project dependency from pointing to an undefined ID.
IDs create human traceability. The workbook does not automatically prove that every referenced ID exists, so the project review should include a quick cross-sheet ID check.
Use Define Acceptance Criteria to establish the sample and pass conditions, then use Validation evidence to manage the project record.
5. Use different downstream paths for Pass, accepted limitation, and Fail
Section titled “5. Use different downstream paths for Pass, accepted limitation, and Fail”The example contains three different Demo outcomes. Treating them differently is one of the most important uses of the Toolkit.
Pass: VAL-001
Section titled “Pass: VAL-001”The Product sample confirms the approved option labels, purchasable combinations, price, SKU, and media associations. The row records Pass, the evidence location, and no retest requirement.
A Pass closes the validation item when the evidence is complete. It does not need a separate decision simply to restate that the check succeeded.
Pass with accepted limitations: VAL-002 -> DEC-001
Section titled “Pass with accepted limitations: VAL-002 -> DEC-001”The Categories sample is flatter in the target platform than in the source hierarchy, but approved Product membership, navigation, and discoverability are preserved. The validation row records Pass with accepted limitations and links to DEC-001.
DEC-001 then records:
- what difference is being accepted;
- why it is acceptable;
- the approving authority;
- the evidence location;
- the monitoring condition after launch;
- that the limitation does not block launch.
This keeps the validation finding and business authorization separate without losing the connection between them.
Fail: VAL-004 -> RED-001 -> DEC-004
Section titled “Fail: VAL-004 -> RED-001 -> DEC-004”The priority source path /old-running-shoes is expected to reach /collections/running-shoes, but the target staging environment returns 404.
The validation row therefore records Fail, High severity, Blocking? = Yes, corrective ownership, retest requirement, and the related decision.
The URL-specific implementation evidence then moves to RED-001, while the project authorization remains in DEC-004. Risk R-002 stays visible because the business exposure has not yet been reduced to an acceptable state.
Use Review Demo Results for the immediate post-Demo decision and Validate Demo Results for the detailed validation procedure.
6. Use Redirects for URL-level evidence, not general issue tracking
Section titled “6. Use Redirects for URL-level evidence, not general issue tracking”The Redirects sheet in the example demonstrates four different URL outcomes.
| Redirect ID | Pattern | Test evidence | Readiness meaning |
|---|---|---|---|
RED-001 | Required redirect is not implemented and the source path returns 404 | Test Result = Fail | Blocked until corrected and retested. |
RED-002 | Product URL is preserved | HTTP 200, final destination is the intended Product path | Ready because no redirect is required and the path is usable. |
RED-003 | Source blog path moves to a target Page | HTTP 301, correct final destination, no chain or loop | Ready after implementation and test pass. |
RED-004 | Obsolete campaign URL is intentionally retired | No redirect, accepted retirement linked to DEC-003 | Not required because the no-redirect outcome is deliberate and authorized. |
The four rows show why “redirect present” is not the acceptance criterion. The project needs the intended URL behavior to be explicit and tested. A preserved URL can be correct, a 301 can be correct, and an intentionally retired URL can be correct when the decision is authorized and documented.
For a material URL, keep the relationship bidirectional when practical. Once a Decision ID exists, add it to the Redirect row as well as linking the Redirect ID from the decision. This allows either register to reconstruct the same approval chain.
Use Redirects and URL Continuity for the workbook fields and Validate Content, URLs, and Redirects for the validation procedure.
7. Use Decisions & Sign-off only when authorization is required
Section titled “7. Use Decisions & Sign-off only when authorization is required”The Decisions & Sign-off sheet does not duplicate Project Plan status. It records who authorized a scope choice, accepted limitation, exclusion, mapping decision, launch condition, or other project decision.
| Decision ID | Decision | Outcome | Launch blocking? | Why the record exists |
|---|---|---|---|---|
DEC-001 | Accept flatter target collection structure | Approved with limitations | No | Preserves an accepted target-model difference and its monitoring condition. |
DEC-002 | Approve corrected Product option and variant mapping for Full Migration | Pending | Yes | Prevents Full Migration approval from moving forward before the required mapping evidence is complete. |
DEC-003 | Retire an obsolete campaign URL without redirect | Approved | No | Makes the intentional exclusion auditable instead of leaving an unexplained 404. |
DEC-004 | Approve or defer go-live after the priority redirect defect is retested | Pending | Yes | Keeps launch authorization blocked until the priority URL has acceptable evidence. |
A decision row should answer who authorized what, based on which evidence, under which conditions, and whether the project may proceed. That is different from the task row, which answers who must complete the work and whether the work is finished.
Use Decisions and Sign-off together with Define Sign-off Criteria.
8. Read the Overview as a calculated investigation map
Section titled “8. Read the Overview as a calculated investigation map”At the example review point on August 10, 2026, the underlying rows produce the following project picture:
| Overview indicator | Example state | Interpretation |
|---|---|---|
| Task completion | 5 of 12, 41.7% | Preparation through the Demo run is complete; later gates remain open. |
| Open task blockers | 2 | Demo validation and the configuration-approval task are explicitly blocking progression. |
| Residual High / Critical risks | 1 | R-002 remains High after mitigation. |
| Validation failures | 1 | VAL-004 is the open failed validation item. |
| Redirect blockers | 1 | RED-001 is blocked. |
| Open launch decisions | 2 | DEC-002 and DEC-004 are launch-blocking and not yet approved. |
| Validation completion | 4 of 6, 66.7% | Four entered validation rows have terminal results; two remain Not tested. |
| Overall readiness | Not ready | At least one readiness-blocking signal remains. |
The value of this summary is diagnostic. A reviewer can move from the red signal to the exact working record instead of debating a generic percentage.
For example:
- Validation failures = 1 leads to
VAL-004. VAL-004points toR-002,RED-001, andDEC-004.- Open launch decisions = 2 leads to
DEC-002andDEC-004. DEC-002points back to Product mapping evidence and the Full Migration approval gate.
The Overview does not resolve those items. It tells the team where to investigate next.
9. Run an efficient project review in one direction
Section titled “9. Run an efficient project review in one direction”A weekly or gate review becomes much faster when the team follows the same sequence every time.
- Update Project Overview. Set the As of Date and Project Status.
- Read the readiness signals. Identify non-zero blockers, failures, and open decisions.
- Open Project Plan at the next decision gate. Filter to the work that must close before the next transition.
- Review only the related material risks. Check the mitigation, trigger, owner, review date, and residual exposure.
- Review validation evidence. Separate Pass, accepted limitation, Fail, and Not tested instead of treating every row as equivalent.
- Open Redirects only for URL continuity work. Confirm implementation and retest evidence for priority routes.
- Resolve required decisions. Do not close a task by changing its status while the approval record is still Pending.
- Return to Project Overview. Confirm that the summary changed because the underlying evidence changed, not because a blocker was manually hidden.
This order keeps the review outcome-focused: summary -> gate -> risk -> evidence -> specialist register -> authorization -> summary.
10. Carry the same control model into Full Migration and launch
Section titled “10. Carry the same control model into Full Migration and launch”The example Project Plan already contains the later project gates even though the project has not reached them yet:
FULL-01for Full Migration execution;FULLVAL-01for Full Migration validation;LAUNCH-01for launch readiness;GO-01for the go-live decision;MON-01for post-launch monitoring and closure.
Before each gate begins, create the corresponding validation rows and confirm the related risks and decision criteria. Do not invent the later results in advance. Keep planned validation items at Not tested until evidence exists.
Use the Documentation in this sequence:
- Review Migration Configuration before
FULL-01. - Run a Full Migration to perform
FULL-01. - Validate Full Migration Results to populate the Full Migration validation evidence.
- Define Sign-off Criteria to close the migration-result approval gate.
- Launch Readiness Checklist to evaluate
LAUNCH-01and the final Go or No-go decision. - Post-Launch Monitoring Checklist to manage
MON-01and stabilization closure.
This keeps the Toolkit synchronized with the operational workflow without turning the workbook into a duplicate instruction manual.
11. Keep one concern connected without copying it everywhere
Section titled “11. Keep one concern connected without copying it everywhere”The priority URL issue demonstrates the complete relationship model:
LAUNCH-01 task -> R-002 risk -> VAL-004 failed validation -> RED-001 URL evidence -> DEC-004 launch decision -> Project Overview blocker signals
The accepted target-model difference demonstrates a different model:
VAL-002 accepted limitation -> DEC-001 authorization -> monitoring condition -> later post-launch review
The same principle applies to Custom Service, protected target data, launch operations, and other material project concerns: put each type of information in the sheet designed to manage it, then connect the records with stable IDs.
Do not copy the complete risk statement into Validation, the complete validation finding into Decisions, or the full decision rationale into Project Plan. Shared IDs preserve traceability while each sheet keeps one clear job.
12. Apply these practices to a real project
Section titled “12. Apply these practices to a real project”For efficient day-to-day use:
- create a row as soon as its ID is referenced elsewhere;
- keep IDs stable after other records link to them;
- use Status for progress and Blocking? for decision impact;
- keep evidence in a secure repository and use controlled links in the workbook;
- update residual risk after mitigation or context changes;
- preserve the original failed validation finding and record retest separately;
- link accepted limitations to an explicit decision rather than hiding them in Notes;
- use Redirects only for URL continuity evidence;
- keep launch authorization in Decisions & Sign-off rather than treating Overview readiness as approval;
- review the workbook by the next project gate, not by trying to complete every cell on every sheet.
Next Steps
Section titled “Next Steps”Return to Migration Project Toolkit and download the blank workbook when you are ready to start a real project. Use the example workbook as a relationship model, then establish the real project baseline in Project Overview and readiness and replace every illustrative path, owner, date, scope item, and acceptance condition with verified project information.