---
name: rp-migration-review
description: Publish and guide the local Migration review after import without implementing Move to Wix.
title: rp-migration-review
canonical_url: https://skilld.dev/gh/wix/skills/rp-migration-review
last_updated: 2026-11-14T03:05:56.000Z
---

> Index of every page on this site: [llms.txt](https://skilld.dev/llms.txt)

> **Skill from skilld.dev.** Follow the user's requested action.
> If the user asked to fork this Skill, follow the fork workflow below. Do not execute the Skill instructions while copying it.
> Otherwise, follow the instructions below for this session. You do not need to install anything.
>
> Supporting files, fetch one when the Skill refers to it: [mapping-publication.md](https://skilld.dev/api/skills-raw/wix/skills/rp-migration-review/mapping-publication.md).
>
> If the user asked to install this Skill, run `npx skilld install wix/skills/rp-migration-review`. Install writes the Skill files into the project, so every session loads them.
>
> ## Fork workflow
>
> A fork creates an editable local Skill with its original author and licence. The request authorizes copying and local installation.
> 1. Check `./skills/rp-migration-review`, the project lockfile, and selected Agent targets together. If the local directory or installed Skill exists, stop. Never overwrite an existing directory or Agent target.
> 2. Read [source metadata](https://skilld.dev/api/v1/skills/wix/skills/rp-migration-review) once. Use sourceUrl, sourceCommit, skillPath, sourceGone, and license. If the source is gone or its path is missing, stop. If license is null, read licence files at the source commit.
> 3. Fetch only the source commit into a temporary Git repository. Do not clone full history. Derive repository_url from sourceUrl, including repository renames. If sourceCommit is absent, resolve the sourceUrl ref once. Set source_commit to that actual commit. Run these commands in one shell call:
>
> ```sh
> git init --quiet "$temporary_dir"
> git -C "$temporary_dir" fetch --quiet --depth=1 "$repository_url" "$source_commit"
> git -C "$temporary_dir" checkout --quiet --detach FETCH_HEAD
> ```
>
> Read applicable licence declarations and notices at that commit. If copying is not permitted, report the restriction and stop.
> 4. Inspect source entries together, then copy the directory containing skillPath into `./skills/rp-migration-review`. Use the user's path if selected. Keep the original SKILL.md, relative links, scripts, binary assets, and executable modes. Exclude .git metadata. Reject symlinks and paths outside the Skill directory. After checking entries, use cp -a where available. A regular source directory needs no custom copy script. Do not save this page wrapper as SKILL.md.
> Preserve author credit, notices, and applicable licence files from repository or parent directories. Add PROVENANCE.md with the Skill page, source URL, actual commit, original path, and licence. Retain any existing PROVENANCE.md and record new provenance separately. Batch source inspection, copying, and provenance work where practical.
> 5. In the project root, run `skilld install ./skills/rp-migration-review --mode copy --plain`. If skilld is unavailable, use `npx skilld install ./skills/rp-migration-review --mode copy --plain`. This known command needs no help lookup. Install does not support --json. Use detected Agent targets, or add --agent for the targets the user selected. Install the local path, never the upstream selector. If installation fails, preserve the local copy and report the exact failure.
> 6. Confirm the local lockfile source and installed Agent copies once. Report the local path, actual commit, and Agent targets. After edits, reinstall the same local path. Upstream updates must not replace it. Do not publish or push unless the user asks.

# Migration review

Use this resource only after backend completion artifacts are available. It owns the first
post-import preparation step. It does not execute source catch-up, DNS, notifications,
payments, or any Move to Wix policy.

Resolve `<project>` through the parent `wix-replatform` skill. Run the deterministic interface
from that installed skill directory:

```bash
node scripts/migration-review.js <operation> <absolute-project-path> ...
```

Never edit files in `<project>/migration-review/` directly. Mutations require a request JSON
file containing `contractVersion: "migration-review/1"`, one stable `requestId`, the bound
`migrationId`, and `expectedStateVersion`. Treat `state_conflict`, `stale_scope`,
`stale_task`, `lock_held`, and evidence-integrity failures as named recovery work: re-read,
inspect the relevant current artifacts, and retry with a new request only when the evidence
supports it. Never steal a lock based on age.

## Publish after import

1. Initialize using the existing orchestration project/source and `config/wix.env` binding;
   the interface derives the identity when only `contractVersion` is supplied. Reuse the
   returned identity for every mutation. A mismatch means the wrong project; do not reset it.
2. Reuse the actual importer execution and publishing `producerId`; register it only if
   absent, preserving its assessed record/capability scopes and `executionKind: import`.
   Do not reclassify an existing execution or label a real import as an isolated probe.
   Read its retained boundaries with
   `check-execution --execution-id <actual-execution-id>`. Missing before-write or write-outcome
   captures are named incomplete evidence, never reconstructed as earlier observations from
   post-import summaries. This read checks retained captures; it does not prove target behavior.
   Interpret `missing[]` by its named scope: a deferred scope with no target write must not
   make a resolved scope's complete boundaries appear missing. Keep the deferred scope's
   actual mapping observation, incomplete coverage and open tasks; never invent its write
   outcome or a passed check. A mixed attempt remains incomplete overall.
3. Capture all five evidence categories through `capture-evidence`: accepted source scope,
   mapping/fidelity, execution/recovery, setup/plugin capability, and explanations/checks.
   Use durable extraction, mapping, setup, attempt, crosswalk, verification and recovery
   artifacts. Source-scope captures name accepted capability scopes in `acceptedScopes`,
   separately from accepted record IDs. Existing summary files are optional evidence, never a completeness dependency.
4. For a revised `fieldContractVersion:1` mapping plan, first use the
   [exact mapping publication recipe](https://skilld.dev/api/skills-raw/wix/skills/rp-migration-review/mapping-publication.md) under the actual importer’s
   canonical producer/execution. It consumes original committed mapping captures, publishes
   each mapping scope separately and reads report/overview back. Do not register a review-chat
   replacement owner or reconstruct missing import boundaries. All-deferred/no-importer
   attempts retain current ledger/handoff facts and explicitly report publication unavailable.
   Then publish each producer's remaining assessed scope. Omitted or unavailable evidence is explicit
   `coverage.status: incomplete` with named `unknownAreas` and an investigation task. A created
   record with changed or unsupported behavior remains a fidelity result/task.
   Every task declares `requirement: required|optional`. A verified machine task names a
   committed check capture matching its finding key and material fingerprint. Closing a
   repaired finding requires explicit evidence-backed `applicabilityChanges`; omission
   preserves it. Coverage is tracked per producer/scope and requires all five categories.
   Import coverage additionally requires genuine before-write and write-outcome captures in
   the publication for each assessed scope. Missing phases remain named investigations even
   after five-category backfill; a newer import cannot inherit its predecessor's publication.
   Registered and explicitly accepted scopes without publication remain visible investigations;
   omitting them cannot produce complete coverage. Repairs must recapture all five categories
   for each scope they publish; unrelated scope evidence is retained.
   When assessed scopes have different coverage, publish them separately using the same
   execution and canonical producer. `coverage.status` applies to every scope in one request;
   an incomplete deferred scope must not downgrade unrelated complete coverage.
   Tasks use `affectedCount: null` for unmeasured populations and a measured nonnegative
   count for known populations. An affected-ID preview may be shorter than that count.
   Do not replace an unknown count with zero or a population count with preview length.
5. Read `report` and `overview` back before saying publication succeeded. The store merges
   partial repairs and retains unrelated findings/actions; never submit an unscoped complete
   replacement.

If required capture fails during a generated import, stop further writes through the existing
recovery rules. An uncertain accepted write requires target read-back before retry. Do not
fabricate review evidence from chat memory or prose.
The importer capture queue waits at most two seconds for another local mutation, then fails
without taking over its lock. Chat publication/actions retain strict versions and no automatic
retry. Only supported destination-bound Wix dashboard/editor links should be presented.

## First chat response

Run `overview`. In the first response, identify the bound destination and evidence coverage,
then enumerate every current open/needs-review task once under **Data**, **Manual**, and
**Plugins** with its concise explanation, affected count (or Count unknown), and dependencies.
Show open, needs-review, resolved and dismissed totals and say the next overall step is
**Move to Wix — integration deferred**. Only after the complete inventory,
recommend `recommendedTaskId`. Operators may select any task; a waiting task does not block
reading or working on another task.

`Show tasks` always reruns `overview` or paged `tasks` against current state. Record pagination
may shorten affected-record details, never the task inventory or group totals.

For a selected task, run `task --task-id ...` and present one concrete issue/action, affected
scope, consequence, prerequisites, verification kind, and the exact bound destination link.
Opening/copying a link changes nothing.

## Actions and help

- **Done / Resolve:** use `record-action` with the current task material fingerprint. Manual
  work is labelled operator-confirmed. A machine-required task resolves only when its current
  evidence is verified; never downgrade a failed checker to manual success.
- **Dismiss:** state the consequence and require the task's exact current acknowledgment, then
  persist it. Dismissal changes disposition, not coverage or historical outcomes.
- **Later:** validate the current task/version without writing an event. Confirm its current disposition and show current totals
  plus how to return to the complete list.
- **Help:** this chat already runs in the Import Operator's migration environment. Inspect the
  referenced local artifacts and perform supported recovery within existing authorization.
  Do not show that operator a prompt to send to themselves. If the migration folder, source
  account, credential, or external system is unavailable, name that exact dependency and the
  access needed; do not claim the investigation ran.

After every saved action, read the task/report back before claiming success. A new chat using
the same project folder resumes from `overview`; a copied folder on another machine is not a
synchronized store.

## Handoff boundary

Run `prepare-handoff` only after rereading current state. The immutable recap preserves
identity/version, evidence scope and unknown areas, all task dispositions, unresolved work,
and accepted consequences. This operation requires a stable request ID, binding and observed
state version; it commits the recap under the same lock as other mutations. Read it back with
`handoff`. Its consumer has `status: deferred`; it contains no `readyForMove` claim and changes
no move state. Tell the operator that Move to Wix integration remains deferred.
