@wix/agent-skills 1.33.0 → 1.34.0

package/skills/wix-headless-replatform/references/safety.md

@@ -0,0 +1,19 @@
+# Safety
+
+Treat a request to recreate a branded public homepage with this skill as the operator's
+authorization assertion. Do not ask a separate authorization-confirmation question before
+extracting, rebuilding, or releasing that requested homepage.
+
+Do not help create phishing pages, credential-harvesting pages, deceptive impersonation, malware delivery, or sites intended to mislead users about ownership or affiliation.
+
+If the site contains login, checkout, payment, member, admin, or private areas:
+
+- Do not bypass authentication.
+- Do not scrape private data.
+- Preserve public links only unless the user provides legitimate authorized access and the task is clearly a migration.
+
+Respect robots, rate limits, and source server load. Keep crawling conservative and ask before broad discovery.
+
+The homepage authorization assertion does not permit authentication bypass, private-data
+extraction, credential handling, or recreation of restricted areas. When task context
+contradicts a legitimate migration, stop rather than creating a deceptive clone.

package/skills/wix-headless-replatform/references/ui-normalization-contract.md

@@ -0,0 +1,70 @@
+# Identity-Preserving UI Normalization Contract
+
+Use this contract after page sections and interaction scenes are extracted. It improves
+implementation quality inside the source design; it is not a redesign step.
+
+## Priority
+
+Identity locks always outrank best-practice rules. Preserve:
+
+- source content and section order;
+- section kind/variant and layout archetype;
+- source palette, typography, imagery, and media;
+- CTA hierarchy;
+- interaction primitive and state model.
+
+Allowed normalization includes local spacing/alignment, repeated-item consistency,
+responsive reflow inside the same archetype, subtle hover/focus feedback, eased state
+transitions, accessibility, and reduced motion.
+
+## Generated handoff
+
+`ui-normalization.json` is the machine-readable source of truth.
+`ui-normalization.md` is its compact implementation view. Load the neutral primitives once:
+
+```html
+<link rel="stylesheet" href="/site-clone/rp-ui-normalize.css">
+```
+
+Each section must use its exact `data-rp-section` and `data-rp-layout` markers. Repeated
+components use `data-rp-item`, `data-rp-media`, `data-rp-body`, and `data-rp-action` as
+declared. Use `data-rp-motion="micro"` for hover/focus feedback and
+`data-rp-motion="state"` for click/activation transitions.
+
+## Repeated cards
+
+When source evidence says peer cards share a height:
+
+- set `data-rp-equal-height="true"` on the collection;
+- set `--rp-item-block-size` to the extracted shared height;
+- allow active state to change inline size but not block size unless evidence says it does;
+- reserve a stable media region and let the body fill remaining space;
+- align equivalent actions to the same block edge;
+- keep rail overflow local to its viewport.
+
+Do not solve long content by hiding source text. Reflow or adjust internal regions while
+keeping peer geometry and content intact.
+
+## Motion hierarchy
+
+Hover and focus are micro-interactions. Prefer color, shadow, opacity, or a small transform;
+do not unexpectedly reflow siblings. Click and activation may expand a card, reveal a panel,
+or scroll only when the interaction contract requires it.
+
+Captured transition timing overrides defaults. Without captured timing, micro motion uses
+140–240ms and state motion uses 240–600ms with eased timing. Rapid actions may cancel an
+animation, but final semantic state, focus, and content must remain correct. A
+`prefers-reduced-motion` rule must expose that final state without non-essential interpolation.
+
+## Verification
+
+`verify-interactions.mjs` reads the normalization contract when present. Its report checks:
+
+- section markers;
+- page-level horizontal overflow;
+- reduced-motion CSS availability;
+- declared repeated-item height spread;
+- whether activation preserves block size.
+- whether hover preserves peer layout and marked motion uses non-zero easing.
+
+Fix every failed normalization check before reporting completion.

package/skills/wix-headless-replatform/references/workflow.md

@@ -0,0 +1,157 @@
+# Home-page reconstruction workflow
+
+## Modes and scope
+
+The skill runs as a standalone clone or a migration phase selected explicitly by
+`--handoff <website/handoff.json>`. Migration mode reuses the migration-owned Wix
+site/project and binding intent. Standalone mode provisions one real Wix CLI
+Headless Astro project.
+
+The implemented extraction/build scope is one home page. `--scope` must be `home`
+and `--urls` is not accepted. A later approved workflow must define resolution,
+evidence conflicts, and shared ownership for additional pages.
+
+When a migration handoff allows only `plan`, complete project context plus frozen
+extraction/build planning and stop resumably. When it allows `build`, continue
+through implementation and verification on the migration-owned project.
+
+## Browser preflight
+
+Before browser capture run:
+
+```bash
+node scripts/browser-extraction-preflight.mjs --project-root <project-root>
+```
+
+Use `--fix` for supported remediation. In this repository, align to the documented
+NVM/Yarn toolchain first. For a sandboxed browser/network failure, request the required escalation and retry
+before it becomes a global blocker.
+
+## Stage order
+
+1. Provision or verify the Wix project boundary when build mode requires it.
+2. Resolve the requested URL to one public home page and destination `/` route.
+3. Capture browser observations at desktop/tablet/mobile with normalization audit and
+   persist typed, sanitized, hash-bound replay packets.
+4. Run the independent semantic, structural, behavior, and visual detector ensemble;
+   segment visible regions and assign ownership.
+5. Plan recursive jobs and extract foundation, metadata, shared chrome, sections, and
+   arbitrarily nested components deepest-first.
+6. Classify and recover gaps within the bounded local budget.
+7. Enforce the rendered-content boundary, then validate/harden hashes and freeze accepted or provisional specs. Content extraction must use browser-rendered text and exclude `script`, `style`, `noscript`, and `template` descendants. Preserve visible `pre`/`code` content with explicit provenance. If source-code contamination is still detected, omit only the affected strings, create an owned local gap, and continue unrelated units.
+8. Derive the build plan and component-selection evidence from the manifest. If
+   an approved registry item is selected, expose only its resolved binding and
+   `contractRef` to the builder.
+9. Build foundation, metadata, chrome, recursive children, then ordered sections.
+10. Build and run unit/page browser QA; revise only affected owners.
+11. Produce the final gap report and, when applicable, the migration receipt, plus the
+    final route manifest for old-link preservation (see `output-contract.md`).
+
+For a migration with `state/url-preservation/link-audit.json`, frontend
+creation is followed by a separate routing and link verification step against the Wix
+deployment origin and mount path. Read generated entity URLs, run the audit's read-only
+calibration/budget gate, then check a few real entities per configured page family before
+the stored destinations. A successful WordPress response on the production domain, a
+successful HTTP status alone, or a saved backend mapping is not served-route evidence.
+Keep missing/incompatible writer integrations and unsupported families pending in the
+audit and handoff. The later cutover workflow checks public-host routes after DNS; this
+workflow does not move DNS.
+
+Resolution/extraction may create observations and specs, but never destination UI.
+Building consumes only frozen specs, generated selection evidence, and any
+selected component's compact agent contract. It may not browse the source, scan
+the registry, read candidate/review material, or read raw observations. A
+missing builder fact returns through an owned extraction-gap request.
+
+## Page resolution
+
+Normalize the input, remove fragments/query discovery noise, follow redirects with a
+read-only request, preserve an applicable locale home prefix, inspect canonical URL,
+and record requested/candidate/resolved/canonical URLs. Ambiguous home identity is a
+global blocker with an exact user action; do not guess a route or build the supplied
+non-home page as home.
+
+## Capture and safe probing
+
+Capture the clean page after stable settling, controlled scrolling, lazy-content
+discovery, and consent/obstruction normalization. Retain raw and normalized evidence
+plus every normalization action.
+
+Probe only public unauthenticated presentation state. Allow scroll, hover, focus,
+keyboard navigation, resize, bounded wait, tabs, disclosures, menus, and confirmed
+carousel controls. Block navigation, mutating requests, forms, auth, cart/checkout,
+purchase/booking, uploads, account/admin state, destructive actions, and unclassified
+clicks. Reset state between branches and retain an audit of blocked requests/actions.
+
+## Freeze and anti-stuck behavior
+
+Every visible concern has one owner, explicit ignore, or owned gap. High-confidence
+detector results that meet calibrated precision may freeze automatically. Medium
+results become typed decisions for the orchestrating agent. Low/invalid/abstained
+results become gaps.
+
+Local gaps never block unrelated work. Try at most two distinct targeted tactics. If
+the fact remains unavailable, freeze/build the reliable contract provisionally and
+propagate provisional status only through declared dependencies. The agent may make a
+conservative evidence-backed layout/semantic choice, but cannot invent copy, assets,
+links, business actions, or behavior.
+
+Only unresolved home identity, page-wide unusable capture, corrupt artifact integrity,
+unisolatable safety failure, or inability to assemble/build/serve any viable shell stops
+the run globally.
+
+Replay a retained immutable capture without reopening the source with:
+
+```bash
+node scripts/replay-extraction.mjs --out <project> [--capture <capture-id>]
+```
+
+Replay first verifies spec, dependency, manifest, and observation-packet hashes. A
+changed detector/projection or typed patch creates a new capture and report; the source
+capture remains untouched.
+
+## Build order and registry
+
+Verify `extraction/latest.json` and its manifest before creating UI. The build ledger
+is keyed to manifest/spec hashes; a changed hash invalidates the affected downstream
+entries.
+
+Install the foundation once, apply metadata, then build shared chrome, recursive child
+components, and top-level sections in dependency/source order. Use Astro for static UI
+and React only for useful islands. Preserve exact content/assets, layers, geometry,
+responsive behavior, accessibility, and observed end states.
+
+Filter the local shadcn-format registry by contract, its approved hash-pinned capability
+manifest, framework/runtime, license, accessibility, responsive, SSR, RTL, reduced-motion,
+dependency, and human-approval requirements. Resolve only declared axes, slots, states,
+and compositions, and record selection/rejection evidence. An eligible selection is copied
+from its pinned local source only after its exact source hash is verified; exact
+dependency versions, required Astro integration configuration, and
+`build/registry-installation.json` record the installation. The builder consumes the
+resolved selection and only the selected item's hash-pinned `contract.md`; registry
+internals and candidate material are not agent context.
+Use a bounded custom builder when no item qualifies and emit a source-neutral
+`qa/registry-opportunities.json`; never fetch a floating live-registry component.
+
+## Verification and completion
+
+Verify each unit at its required viewports against frozen acceptance fields, then verify
+the assembled home page. `qa/visual-qa.json` contains `unitAcceptance` results for every
+frozen required criterion and `pageAcceptance` results for page checks; pending browser
+evidence is reported as pending, never silently passed. Findings return to their smallest
+owner. Do not use unrelated global CSS or another section to hide a gap.
+
+Generate `final-report.json` and `.md`. For every unresolved/user-accepted gap state what
+could not be imported reliably and why, evidence/confidence/attempts, provisional output,
+assumptions/omissions, affected checks/dependencies, and choices to accept, retry/fix,
+provide material, replace, omit, or leave unresolved.
+
+Record a post-assembly decision with:
+
+```bash
+node scripts/record-gap-decision.mjs --out <project> --gap <gap-id> --decision <choice>
+```
+
+No remaining gap plus complete browser verification may become done. Remaining local
+gaps become `done_with_gaps`; only a global blocker is blocked. In one-click mode do not
+pause before assembly for local gaps.

package/skills/wix-headless-replatform/registry/README.md

@@ -0,0 +1,20 @@
+# Approved component registry
+
+This folder is the runtime registry shipped with the skill. It contains only
+human-approved immutable items. Candidate research, source snapshots, reviews,
+test reports, and pending approvals must never be placed here.
+
+## Agent read boundary
+
+Do not scan this folder while creating a site.
+
+1. Deterministic scripts read `registry.json`, approvals, capability manifests,
+   and source hashes to produce `docs/site-clone/build/component-selection.json`.
+2. The site-building agent reads that generated selection artifact.
+3. If an item was selected, the agent may read only that item's `contract.md`
+   for concise binding and adaptation guidance.
+4. The agent does not read approval records, licenses, component source,
+   capability JSON, or developer review/provenance material for reasoning.
+
+The installer reads source and metadata mechanically. When no approved item
+qualifies, the bounded custom path remains available.

package/skills/wix-headless-replatform/registry/approvals/button/shadcn-default-ac60ef5.json

@@ -0,0 +1,28 @@
+{
+  "registryItemName": "button",
+  "registryItemRevision": "shadcn-default-ac60ef5",
+  "decision": "approved",
+  "revoked": false,
+  "contractKind": "button",
+  "runtimeClass": "react-static",
+  "sourceHash": "b77b5c3f3f739353a51966400697dbc49dd6e15ea4f7c44cd0d4e8a9680c5b08",
+  "capabilitiesRef": "items/button/shadcn-default-ac60ef5/capabilities.json",
+  "capabilitiesHash": "f53c94e9f826d39b54a46d2ad4a2c99eeb833b72747cb62a6e5932189cd82e64",
+  "contractRef": "items/button/shadcn-default-ac60ef5/contract.md",
+  "contractHash": "bf3e6dc863a84dbbd86b0891b65dee83dd8bb5a75773f56ea97cc3f5a2936ccd",
+  "licenseRef": "licenses/shadcn-ui-ac60ef5-MIT.txt",
+  "approvalRef": "approvals/button/shadcn-default-ac60ef5.json",
+  "qualityGates": {
+    "license": true,
+    "accessibility": true,
+    "responsive": true,
+    "ssr": true,
+    "rtl": true,
+    "reducedMotion": true
+  },
+  "reviewer": {
+    "human": true,
+    "id": "danbs"
+  },
+  "reviewedAt": "2026-08-24T09:55:02+03:00"
+}

package/skills/wix-headless-replatform/registry/items/button/shadcn-default-ac60ef5/button.tsx

@@ -0,0 +1,54 @@
+import * as React from "react"
+import { Slot } from "@radix-ui/react-slot"
+import { cva, type VariantProps } from "class-variance-authority"
+
+const buttonVariants = cva(
+  "inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium ring-offset-background transition-colors focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-ring focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:size-4 [&_svg]:shrink-0",
+  {
+    variants: {
+      variant: {
+        default: "bg-primary text-primary-foreground hover:bg-primary/90",
+        destructive:
+          "bg-destructive text-destructive-foreground hover:bg-destructive/90",
+        outline:
+          "border border-input bg-background hover:bg-accent hover:text-accent-foreground",
+        secondary:
+          "bg-secondary text-secondary-foreground hover:bg-secondary/80",
+        ghost: "hover:bg-accent hover:text-accent-foreground",
+        link: "text-primary underline-offset-4 hover:underline",
+      },
+      size: {
+        default: "h-10 px-4 py-2",
+        sm: "h-9 rounded-md px-3",
+        lg: "h-11 rounded-md px-8",
+        icon: "h-10 w-10",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+      size: "default",
+    },
+  }
+)
+
+export interface ButtonProps
+  extends React.ButtonHTMLAttributes<HTMLButtonElement>,
+    VariantProps<typeof buttonVariants> {
+  asChild?: boolean
+}
+
+const Button = React.forwardRef<HTMLButtonElement, ButtonProps>(
+  ({ className, variant, size, asChild = false, ...props }, ref) => {
+    const Comp = asChild ? Slot : "button"
+    return (
+      <Comp
+        className={buttonVariants({ variant, size, className })}
+        ref={ref}
+        {...props}
+      />
+    )
+  }
+)
+Button.displayName = "Button"
+
+export { Button, buttonVariants }

package/skills/wix-headless-replatform/registry/items/button/shadcn-default-ac60ef5/capabilities.json

@@ -0,0 +1,60 @@
+{
+  "schemaVersion": "component-capabilities/1",
+  "component": {
+    "name": "button",
+    "revision": "shadcn-default-ac60ef5"
+  },
+  "contract": {
+    "name": "button",
+    "version": "button/v1"
+  },
+  "axes": [
+    {
+      "name": "variant",
+      "values": ["default", "destructive", "outline", "secondary", "ghost", "link"],
+      "default": "default",
+      "description": "Visual emphasis encoded by the component variant prop."
+    },
+    {
+      "name": "size",
+      "values": ["default", "sm", "lg", "icon"],
+      "default": "default",
+      "description": "Control dimensions encoded by the component size prop."
+    }
+  ],
+  "slots": [
+    { "name": "label", "kind": "text", "description": "Visible accessible button or link text." },
+    { "name": "icon", "kind": "icon", "description": "Optional source-backed or approved icon content." },
+    { "name": "accessibleName", "kind": "text", "description": "Accessible name required when visible text is absent." },
+    { "name": "href", "kind": "url", "description": "Preserved destination for the as-link composition." }
+  ],
+  "states": ["rest", "hover", "focus-visible", "disabled"],
+  "defaultComposition": "text",
+  "compositions": [
+    { "name": "text", "requiredSlots": ["label"], "description": "Text-only native button." },
+    { "name": "leading-icon", "requiredSlots": ["label", "icon"], "description": "Icon before visible text." },
+    { "name": "trailing-icon", "requiredSlots": ["label", "icon"], "description": "Icon after visible text." },
+    { "name": "icon-only", "requiredSlots": ["icon", "accessibleName"], "description": "Square icon button with a non-visible accessible name." },
+    { "name": "as-link", "requiredSlots": ["label", "href"], "description": "Native anchor rendered with button variants through Radix Slot." }
+  ],
+  "unsupportedCompositions": [
+    { "name": "loading-spinner", "reason": "Requires a separately approved spinner component and loading-state contract." },
+    { "name": "button-group", "reason": "Requires a separately approved group component and group semantics." },
+    { "name": "client-managed-toggle", "reason": "This revision is approved only as a statically rendered native control without hydrated state." }
+  ],
+  "constraints": [
+    {
+      "id": "icon-only-accessible-name",
+      "description": "An icon-only button must retain an evidence-backed accessible name.",
+      "appliesTo": ["composition:icon-only"],
+      "requires": ["slot:accessibleName"]
+    },
+    {
+      "id": "native-link-semantics",
+      "description": "A button-styled link must preserve its source href and native anchor semantics.",
+      "appliesTo": ["composition:as-link"],
+      "requires": ["slot:href", "slot:label"]
+    }
+  ],
+  "evidenceRefs": ["contract.md"]
+}

package/skills/wix-headless-replatform/registry/items/button/shadcn-default-ac60ef5/contract.md

@@ -0,0 +1,48 @@
+# Button contract
+
+Read this file only after `component-selection.json` selects
+`button@shadcn-default-ac60ef5`. The approved `capabilities.json` is the machine
+authority; this file explains how to bind and adapt those declared capabilities.
+Do not inspect candidate reviews, upstream snapshots, or live documentation
+while building a site.
+
+## Use when
+
+Use this primitive for a native button or anchor whose extracted contract can be
+represented by the selected `variant`, `size`, and composition. Preserve the
+source action, label, URL, icon, disabled state, and accessible name exactly.
+
+Do not use it for a toggle, disclosure, menu trigger with managed state, loading
+control, or grouped-control behavior unless separately approved components own
+those contracts.
+
+## Axes
+
+- `variant`: `default`, `destructive`, `outline`, `secondary`, `ghost`, `link`.
+- `size`: `default`, `sm`, `lg`, `icon`.
+
+Use the exact resolved values from `component-selection.json`. Do not infer a
+new value from current shadcn documentation or substitute the nearest variation.
+
+## Compositions
+
+- `text`: bind the exact visible label.
+- `leading-icon`: bind an approved/source-backed icon before the label.
+- `trailing-icon`: bind an approved/source-backed icon after the label.
+- `icon-only`: bind an icon and an evidence-backed accessible name; omit visible
+  label text only when the source is genuinely icon-only.
+- `as-link`: render a native anchor through `asChild` and preserve its exact
+  `href` and label. Do not turn navigation into a button action.
+
+## Adaptation boundary
+
+Foundation tokens may change colors, radius, typography, and spacing to match
+the frozen source spec. Local layout may position the control. Do not remove
+native semantics, disabled behavior, keyboard focus, the forced-colors outline,
+or the accessible name. Do not add hydration to this statically rendered item.
+
+## Unsupported
+
+The following require another approved primitive or the bounded custom path:
+loading spinners, button groups, client-managed toggles, and any axis value or
+composition absent from the approved capability manifest.

package/skills/wix-headless-replatform/registry/licenses/shadcn-ui-ac60ef5-MIT.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 shadcn
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/skills/wix-headless-replatform/registry/registry.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://ui.shadcn.com/schema/registry.json",
+  "name": "wix-headless-replatform",
+  "homepage": "https://github.com/wix/skills",
+  "items": [
+    {
+      "name": "button",
+      "type": "registry:ui",
+      "revision": "shadcn-default-ac60ef5",
+      "sourceHash": "b77b5c3f3f739353a51966400697dbc49dd6e15ea4f7c44cd0d4e8a9680c5b08",
+      "capabilitiesRef": "items/button/shadcn-default-ac60ef5/capabilities.json",
+      "capabilitiesHash": "f53c94e9f826d39b54a46d2ad4a2c99eeb833b72747cb62a6e5932189cd82e64",
+      "contractRef": "items/button/shadcn-default-ac60ef5/contract.md",
+      "contractHash": "bf3e6dc863a84dbbd86b0891b65dee83dd8bb5a75773f56ea97cc3f5a2936ccd",
+      "approvalRef": "approvals/button/shadcn-default-ac60ef5.json",
+      "licenseRef": "licenses/shadcn-ui-ac60ef5-MIT.txt",
+      "dependencies": {
+        "@astrojs/react": "6.0.2",
+        "@radix-ui/react-slot": "1.3.3",
+        "@tailwindcss/vite": "4.3.3",
+        "class-variance-authority": "0.7.1",
+        "react": "19.2.8",
+        "react-dom": "19.2.8",
+        "tailwindcss": "4.3.3"
+      },
+      "files": [
+        {
+          "path": "items/button/shadcn-default-ac60ef5/button.tsx",
+          "target": "src/components/ui/button.tsx",
+          "type": "registry:ui",
+          "sha256": "b77b5c3f3f739353a51966400697dbc49dd6e15ea4f7c44cd0d4e8a9680c5b08"
+        }
+      ]
+    }
+  ]
+}

package/skills/wix-headless-replatform/resources/rp-facelift/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: rp-facelift
+description: Apply an explicitly requested, identity-preserving UI/UX refinement after clone acceptance.
+---
+
+# Optional post-clone facelift
+
+Load this resource only when `docs/site-clone/frontend-automation-state.json` records
+`checkpoints.facelift.requested: true` and the migration website receipt is complete or
+`done_with_gaps`. A `done_with_gaps` receipt must reference a finalized visual review and
+the configured cycle cap. Never load it as part of ordinary cloning.
+
+Invoke the installed `ui-ux-pro-max` skill for this pass. If it is unavailable, record a
+specific `facelift` blocker with the required install/enable action; do not silently replace
+it with an unconstrained redesign or claim the selected deliverable is complete.
+
+Before changes, treat extracted brand colors/fonts/logos/assets, route plan, visible copy,
+section order, core interaction contract, SEO, and dynamic data bindings as identity locks.
+Preserve them. UI/UX Pro Max may improve hierarchy, spacing, responsive layout,
+accessibility, component/control states, and restrained purpose-driven motion/interactions.
+It must not change the brand, information architecture, page content, URLs, source assets,
+or required core behavior.
+
+Build and browser-test the changed site. Write `docs/site-clone/facelift-review.json` with
+the request, changed routes/components, evidence that all identity locks were retained,
+accessibility/interaction checks, before/after screenshot references, and an `accepted` or
+`blocked` decision. For `done_with_gaps`, include the completion receipt and residual-gap
+context; do not claim normal clone acceptance, visual parity, or resolution of those gaps.
+Update `frontend-automation-state.json` facelift checkpoint to
+`accepted` only after that review passes. Then return to the root supervisor so it can write
+the completion receipt. In one-click mode the stored request authorizes this stage after the
+gate; it does not waive the review.

package/skills/wix-headless-replatform/resources/rp-project-context/SKILL.md

@@ -0,0 +1,62 @@
+---
+name: rp-project-context
+description: Resolve headless mode, scope, Wix project validity, and browser execution readiness.
+---
+
+# Project context
+
+Load this resource only when the run's mode, source/scope, output project, approval state,
+or browser environment is unresolved. It owns setup decisions, not extraction or UI work.
+
+Read `references/safety.md` and the applicable mode/scope and preflight sections of
+`references/workflow.md`. Read `references/output-contract.md` only when validating the
+project or automation-state artifact.
+
+## Resolve mode and scope
+
+- Standalone uses the public source URL and requires `home` scope with no `--urls`.
+- Migration mode requires `--handoff`. Read its route families, public URL intent, Wix
+  bindings, slug policy, `websiteScope`, `automationMode`, and
+  `frontendPhase.allowedNow`. The handoff is authoritative.
+- If a handoff requests non-home or explicit-URL reconstruction, stop with the actionable
+  requirement for the future multi-page workflow. One-click mode does not expand scope.
+- In `plan` phase, write/refresh plan-eligible context and evidence only; do not require a
+  runnable frontend or attempt build/release. In `build`, validate the existing
+  migration-owned project before proceeding.
+
+## Provision or validate the project
+
+For standalone home cloning, provision or verify the exact final output directory before
+artifact generation or UI writes. It must be a real successful Wix CLI scaffold, not a
+manual fallback, and contain a valid Wix configuration plus `package.json` `dev` and
+`build` scripts. Create its empty `yarn.lock` project boundary up front. If the scaffold
+uses `@wix/astro-wix-hosting-adapter`, remove a direct standalone
+`@astrojs/cloudflare` dependency before install/build normalization.
+
+For migration mode, reuse the handoff-owned project/site only. If project identity or its
+runnable contract fails, record the precise failure and recover it; never create a sibling
+scaffold.
+
+Use `clear-wix-starter.mjs` after a valid template creates demo files, before clone UI
+work starts.
+
+## Browser preflight and recovery
+
+Before browser extraction run:
+
+```bash
+node scripts/browser-extraction-preflight.mjs --project-root <project-root>
+```
+
+If needed, first attempt `--fix`. The host must have normal `node_modules` resolution,
+required browser/design dependencies, and Chromium; Yarn Plug'n'Play is not sufficient.
+
+For this repository, run path-sensitive Wix/Yarn commands in interactive `zsh` with the
+repo-local NVM toolchain. In a one-click run, retry a shell/PATH mismatch once under that
+aligned shell. If browser launch or network access is sandbox-blocked, request the required
+escalation and retry. Only then record a blocker; a pending runtime approval is a real
+wait, not a reason to ask unrelated routine confirmations.
+
+Write/update `frontend-automation-state.json` whenever the mode, phase, effective scope,
+scope checkpoint, or auto-progress policy changes. Return to the root supervisor once the
+context is durable.