@wix/agent-skills 1.15.0 → 1.16.0

package/skills/wix-replatform/resources/rp-source-csv/source-schema.example.json

@@ -0,0 +1,196 @@
+{
+  "$comment": "TEMPLATE / EXAMPLE for migrations/<project>/source-schema.json when platform=csv. This is a shape to follow, NOT a strict schema to validate against. Both the producer (rp-discovery) and the consumer (rp-mapper) are LLMs, so structure is a convention that prevents drift, not a hard contract. Keep the agnostic core stable across platforms; push CSV quirks into the open `sourceMeta` blob. Synthesize it from data/csv-discovery/fileset.json.",
+
+  "platform": "csv",
+  "capturedAt": "2026-07-28T00:00:00.000Z",
+  "rawDiscovery": "data/csv-discovery/",
+
+  "sourceMeta": {
+    "$comment": "CSV specifics live here so the agnostic core stays identical to every other platform.",
+    "csvInputRoot": "inputs/",
+
+    "sourceFiles": [
+      {
+        "file": "products_export.csv",
+        "role": "product",
+        "vendor": "shopify",
+        "roleSource": "vendor-filename-hint",
+        "layout": { "pattern": "grouped-by-key", "groupKey": "Handle", "continuation": "blank-key" }
+      },
+      {
+        "file": "products_export-2.csv",
+        "role": "product",
+        "partOf": "products_export.csv",
+        "headerRelation": "identical",
+        "rowOffset": 5000,
+        "$comment": "Shape C: same role + same normalized column set = one logical stream. partOf keeps the provenance of each row set visible."
+      },
+      {
+        "file": "categories.csv",
+        "role": "category",
+        "vendor": "custom",
+        "layout": { "pattern": "flat" }
+      }
+    ],
+
+    "vendor": {
+      "$comment": "Per file when the set mixes vendors. Confidence and evidence are recorded so a low-confidence match is visible rather than silently chosen.",
+      "name": "shopify",
+      "confidence": 1,
+      "source": "fingerprint",
+      "profileVersion": "2026-07",
+      "evidence": "required 2/2; strong 5/5; score 1; runner-up woocommerce 0.04"
+    },
+
+    "dialect": {
+      "delimiter": ",",
+      "encoding": "utf8",
+      "bom": null,
+      "lineEnding": "\r\n",
+      "emptyPolicy": "always-empty",
+      "$comment": "emptyPolicy is DETECTED, not assumed: `present-if-quoted` only when the file contains both a quoted and an unquoted empty. Generated readers apply it through coerceEmpty so a required Wix field is never fed an empty string the source did not have."
+    },
+
+    "drift": {
+      "$comment": "The header read at discovery time is authoritative; the vendor profile is advisory. These two lists make profile drift visible to the mapper and the user instead of silent.",
+      "unmappedColumns": ["Metafield: custom.fit"],
+      "missingExpectedColumns": []
+    },
+
+    "mappingHints": [
+      {
+        "$comment": "ADVISORY pre-fill from the vendor overlay's columnMap. rp-mapper reviews and corrects these; it never accepts them unchecked, and every column not covered here still flows through the mapper and the user unchanged.",
+        "column": "Variant SKU",
+        "wixTarget": "variant.sku",
+        "matchedAlias": "Variant SKU"
+      }
+    ],
+
+    "quirks": [
+      "A row with a blank Handle continues the previous product.",
+      "The product CSV does NOT carry collection membership — Shopify collections need the Admin API or an app."
+    ],
+
+    "joins": [
+      {
+        "$comment": "v1.1. The schema is designed now; automatic detection lands with a real normalized bundle. v1 emits an empty array plus joinsDeferred=true.",
+        "from": "product.category_id",
+        "to": "category.id",
+        "confidence": 0.98,
+        "evidence": "value-overlap 4901/5000 sampled"
+      }
+    ],
+    "integrity": {
+      "$comment": "v1.1.",
+      "orphanRefs": [{ "join": "product.category_id", "missing": 12 }]
+    }
+  },
+
+  "entities": {
+    "product": {
+      "rawFile": "product--product.md",
+      "$comment": "origin.kind is the CSV addition to the agnostic core: an entity comes from one row, one row group, or the distinct values of a column. The reader needs it to know how to materialize the entity.",
+      "origin": {
+        "kind": "row-group",
+        "file": "products_export.csv",
+        "groupKey": "Handle",
+        "continuation": "blank-key"
+      },
+      "recordCount": 812,
+      "inUse": true,
+      "primaryKey": "Handle",
+
+      "fields": {
+        "Handle": { "type": "string", "required": true, "identifier": true, "example": "classic-tee" },
+        "Title": { "type": "string", "required": true, "example": "Classic Tee" },
+        "Body (HTML)": { "type": "string", "required": false, "richText": true },
+        "Vendor": { "type": "string", "required": false, "example": "Acme" }
+      },
+
+      "relations": [
+        { "field": "variants", "targetEntity": "variant", "cardinality": "one-to-many", "evidence": "layout.groupKey=Handle" },
+        { "field": "images", "targetEntity": "image", "cardinality": "one-to-many", "evidence": "layout.columnGroups[image]" },
+        { "field": "categories", "targetEntity": "category", "cardinality": "many-to-many", "evidence": "column:Product Category" },
+        { "field": "tags", "targetEntity": "tag", "cardinality": "many-to-many", "evidence": "column:Tags" }
+      ]
+    },
+
+    "variant": {
+      "rawFile": "product--variant.md",
+      "origin": {
+        "kind": "row-group",
+        "file": "products_export.csv",
+        "groupKey": "Handle",
+        "columnGroup": "variant",
+        "$comment": "Every row in the group carries a variant, INCLUDING the group head — a Shopify product's first variant lives on its head row."
+      },
+      "recordCount": 2310,
+      "inUse": true,
+      "fields": {
+        "Variant SKU": { "type": "string", "required": false, "identifier": true },
+        "Variant Price": { "type": "number", "required": true },
+        "Option1 Value": { "type": "string", "required": false }
+      }
+    },
+
+    "image": {
+      "rawFile": "product--image.md",
+      "origin": {
+        "kind": "row-group",
+        "file": "products_export.csv",
+        "groupKey": "Handle",
+        "columnGroup": "image",
+        "distinctBy": "Image Src",
+        "$comment": "A third collection inside the same row group. Only the vendor overlay's columnGroups can separate it from the variant columns — both vary within a product."
+      },
+      "recordCount": 1904,
+      "inUse": true
+    },
+
+    "category": {
+      "rawFile": "product--category.md",
+      "origin": {
+        "kind": "column-values",
+        "file": "products_export.csv",
+        "column": "Product Category",
+        "hierarchySeparator": ">",
+        "multiValueSeparator": null,
+        "linkPolicy": "leaf"
+      },
+      "$comment": "hierarchical=true MUST be set when the derived paths are nested. A hierarchical source taxonomy mapped to a flat Wix target triggers the mapper's mandatory faithfulness-ledger entry; without the flag the flatten happens silently. The reader emits one record per distinct path INCLUDING ancestors, depth-ascending, so the import creates a parent before its child.",
+      "hierarchical": true,
+      "recordCount": 46,
+      "inUse": true,
+      "fields": {
+        "id": { "type": "string", "required": true, "identifier": true, "example": "apparel-accessories/clothing/shirts" },
+        "name": { "type": "string", "required": true, "example": "Shirts" },
+        "path": { "type": "string", "required": true, "example": "Apparel & Accessories > Clothing > Shirts" },
+        "parentId": { "type": "string", "required": false, "example": "apparel-accessories/clothing" }
+      },
+      "relations": [
+        { "field": "parentId", "targetEntity": "category", "cardinality": "many-to-one", "evidence": "hierarchySeparator=> (self-reference)" }
+      ]
+    },
+
+    "tag": {
+      "rawFile": "product--tag.md",
+      "origin": {
+        "kind": "column-values",
+        "file": "products_export.csv",
+        "column": "Tags",
+        "multiValueSeparator": ",",
+        "linkPolicy": "leaf"
+      },
+      "recordCount": 128,
+      "inUse": true,
+      "$comment": "Wix Stores product tags are a native target that must be created before products and referenced by id — same create-then-link shape as categories."
+    }
+  },
+
+  "assumptions": [
+    "Record counts are exact when the file was scanned in full; when data/csv-discovery/raw-capture.json reports scan.truncated, they reflect the scanned prefix."
+  ],
+  "unknowns": [
+    "Metafield: custom.fit is present in the file but not covered by the shopify profile's columnMap."
+  ]
+}

package/skills/wix-replatform/resources/rp-source-csv/vendors/bigcommerce.json

@@ -0,0 +1,66 @@
+{
+  "vendor": "bigcommerce",
+  "profileVersion": "2026-07",
+  "sourceOfTruth": "https://support.bigcommerce.com/s/article/Importing-Exporting-Products",
+  "anchors": {
+    "required": ["Item Type", "Product Name"],
+    "strong": ["Product Code/SKU", "Product Description", "Product Visible?", "Track Inventory", "Category"],
+    "negative": ["Handle", "attribute_set_code", "Attribute 1 value(s)"]
+  },
+  "layout": {
+    "pattern": "sectioned",
+    "discriminatorColumn": "Item Type",
+    "childLevels": ["SKU"],
+    "parentRefColumn": null,
+    "parentEntity": "product",
+    "childEntity": "variant",
+    "columnGroups": [
+      {
+        "entity": "image",
+        "prefixes": ["Product Image "],
+        "columns": []
+      }
+    ]
+  },
+  "derived": [
+    {
+      "entity": "category",
+      "fromColumn": "Category",
+      "hierarchySeparator": "/",
+      "multiValueSeparator": ";",
+      "hierarchical": true,
+      "linkPolicy": "leaf",
+      "relation": { "fromEntity": "product", "field": "categories", "cardinality": "many-to-many" }
+    }
+  ],
+  "fileRoles": [
+    { "role": "product", "filenameHints": ["products", "product_export"] },
+    { "role": "customer", "filenameHints": ["customers"] },
+    { "role": "order", "filenameHints": ["orders"] }
+  ],
+  "columnMap": [
+    { "wixTarget": "product.name", "aliases": ["Product Name"] },
+    { "wixTarget": "product.description", "aliases": ["Product Description"] },
+    { "wixTarget": "product.brand", "aliases": ["Brand Name"] },
+    { "wixTarget": "product.sourceId", "aliases": ["Product ID"] },
+    { "wixTarget": "product.visible", "aliases": ["Product Visible?"] },
+    { "wixTarget": "product.seoTitle", "aliases": ["Page Title"] },
+    { "wixTarget": "variant.sku", "aliases": ["Product Code/SKU"] },
+    { "wixTarget": "variant.price", "aliases": ["Price"] },
+    { "wixTarget": "variant.cost", "aliases": ["Cost Price"] },
+    { "wixTarget": "variant.discountedPrice", "aliases": ["Sale Price"] },
+    { "wixTarget": "variant.weight", "aliases": ["Product Weight"] },
+    { "wixTarget": "variant.width", "aliases": ["Product Width"] },
+    { "wixTarget": "variant.height", "aliases": ["Product Height"] },
+    { "wixTarget": "variant.inventoryQuantity", "aliases": ["Current Stock Level"] },
+    { "wixTarget": "image.url", "aliases": ["Product Image File - 1", "Product Image File"] },
+    { "wixTarget": "image.altText", "aliases": ["Product Image Description - 1"] },
+    { "wixTarget": "category.path", "aliases": ["Category"] }
+  ],
+  "quirks": [
+    "Item Type is the row discriminator: 'Product' rows are products and 'SKU' rows are their variants; a SKU row belongs to the most recent Product row above it, since there is no parent-reference column.",
+    "Category packs multiple '/'-separated paths separated by ';'.",
+    "Image columns are numbered per image ('Product Image File - 1', '- 2', …), so the image set is a column family on a single row rather than extra rows.",
+    "'Product Visible?' and 'Allow Purchases?' are Y/N strings rather than TRUE/FALSE."
+  ]
+}

package/skills/wix-replatform/resources/rp-source-csv/vendors/magento.json

@@ -0,0 +1,60 @@
+{
+  "vendor": "magento",
+  "profileVersion": "2026-07",
+  "sourceOfTruth": "https://experienceleague.adobe.com/docs/commerce-admin/systems/data-transfer/import/product-import.html",
+  "anchors": {
+    "required": ["sku", "product_type"],
+    "strong": ["attribute_set_code", "categories", "product_websites", "url_key", "base_image"],
+    "negative": ["Handle", "Item Type", "Attribute 1 value(s)"]
+  },
+  "layout": {
+    "pattern": "flat",
+    "parentEntity": "product",
+    "columnGroups": [
+      {
+        "entity": "image",
+        "prefixes": [],
+        "columns": ["base_image", "small_image", "thumbnail_image", "additional_images"]
+      }
+    ]
+  },
+  "derived": [
+    {
+      "entity": "category",
+      "fromColumn": "categories",
+      "hierarchySeparator": "/",
+      "multiValueSeparator": ",",
+      "hierarchical": true,
+      "linkPolicy": "leaf",
+      "relation": { "fromEntity": "product", "field": "categories", "cardinality": "many-to-many" }
+    }
+  ],
+  "fileRoles": [
+    { "role": "product", "filenameHints": ["catalog_product", "products"] },
+    { "role": "customer", "filenameHints": ["customer", "customers"] }
+  ],
+  "columnMap": [
+    { "wixTarget": "product.name", "aliases": ["name"] },
+    { "wixTarget": "product.description", "aliases": ["description"] },
+    { "wixTarget": "product.shortDescription", "aliases": ["short_description"] },
+    { "wixTarget": "product.slug", "aliases": ["url_key"] },
+    { "wixTarget": "product.visible", "aliases": ["product_online", "visibility"] },
+    { "wixTarget": "product.seoTitle", "aliases": ["meta_title"] },
+    { "wixTarget": "product.seoDescription", "aliases": ["meta_description"] },
+    { "wixTarget": "variant.sku", "aliases": ["sku"] },
+    { "wixTarget": "variant.price", "aliases": ["price"] },
+    { "wixTarget": "variant.discountedPrice", "aliases": ["special_price"] },
+    { "wixTarget": "variant.weight", "aliases": ["weight"] },
+    { "wixTarget": "variant.inventoryQuantity", "aliases": ["qty"] },
+    { "wixTarget": "image.url", "aliases": ["base_image", "additional_images"] },
+    { "wixTarget": "image.altText", "aliases": ["base_image_label"] },
+    { "wixTarget": "category.path", "aliases": ["categories"] }
+  ],
+  "quirks": [
+    "The export is flat — one row per SKU. Configurable products and their simple children are separate rows tied together by the configurable_variations column, not by row grouping.",
+    "configurable_variations packs the parent→variant links as 'sku=X,size=M|sku=Y,size=L'. v1 records this column rather than parsing it; the mapper decides how variants are reconstructed.",
+    "additional_attributes packs arbitrary key=value pairs into one cell.",
+    "categories paths are '/'-separated and usually start with the store root ('Default Category/...'), which normally should not become a Wix category.",
+    "Exports are commonly quote-all, so an empty cell is a quoted empty string rather than an absent value — the detected emptyPolicy handles this."
+  ]
+}

package/skills/wix-replatform/resources/rp-source-csv/vendors/shopify.json

@@ -0,0 +1,95 @@
+{
+  "vendor": "shopify",
+  "profileVersion": "2026-07",
+  "sourceOfTruth": "https://help.shopify.com/en/manual/products/import-export/using-csv",
+  "anchors": {
+    "required": ["Handle", "Title"],
+    "strong": ["Body (HTML)", "Variant SKU", "Variant Price", "Option1 Name", "Vendor"],
+    "negative": ["Attribute 1 value(s)", "attribute_set_code", "Item Type"]
+  },
+  "layout": {
+    "pattern": "grouped-by-key",
+    "groupKey": "Handle",
+    "continuation": "blank-key",
+    "parentEntity": "product",
+    "childEntity": "variant",
+    "columnGroups": [
+      {
+        "entity": "variant",
+        "prefixes": ["Variant ", "Option1 ", "Option2 ", "Option3 "],
+        "columns": ["Cost per item"]
+      },
+      {
+        "entity": "image",
+        "prefixes": ["Image "],
+        "columns": []
+      }
+    ]
+  },
+  "derived": [
+    {
+      "entity": "category",
+      "fromColumn": "Product Category",
+      "hierarchySeparator": ">",
+      "hierarchical": true,
+      "linkPolicy": "leaf",
+      "relation": { "fromEntity": "product", "field": "categories", "cardinality": "many-to-many" }
+    },
+    {
+      "entity": "tag",
+      "fromColumn": "Tags",
+      "multiValueSeparator": ",",
+      "hierarchical": false,
+      "linkPolicy": "leaf",
+      "relation": { "fromEntity": "product", "field": "tags", "cardinality": "many-to-many" }
+    }
+  ],
+  "fileRoles": [
+    { "role": "product", "filenameHints": ["products_export", "products"] },
+    { "role": "customer", "filenameHints": ["customers_export", "customers"] },
+    { "role": "order", "filenameHints": ["orders_export", "orders"] }
+  ],
+  "columnMap": [
+    { "wixTarget": "product.name", "aliases": ["Title", "product_title"] },
+    { "wixTarget": "product.description", "aliases": ["Body (HTML)", "body_html", "Description"] },
+    { "wixTarget": "product.slug", "aliases": ["Handle"] },
+    { "wixTarget": "product.brand", "aliases": ["Vendor"] },
+    { "wixTarget": "product.visible", "aliases": ["Published", "Status"] },
+    { "wixTarget": "product.productType", "aliases": ["Type", "Product Type"] },
+    { "wixTarget": "product.seoTitle", "aliases": ["SEO Title"] },
+    { "wixTarget": "product.seoDescription", "aliases": ["SEO Description"] },
+    { "wixTarget": "variant.sku", "aliases": ["Variant SKU", "variant_sku"] },
+    { "wixTarget": "variant.price", "aliases": ["Variant Price", "variant_price"] },
+    { "wixTarget": "variant.compareAtPrice", "aliases": ["Variant Compare At Price"] },
+    { "wixTarget": "variant.cost", "aliases": ["Cost per item"] },
+    { "wixTarget": "variant.barcode", "aliases": ["Variant Barcode"] },
+    { "wixTarget": "variant.weight", "aliases": ["Variant Grams", "Variant Weight"] },
+    { "wixTarget": "variant.weightUnit", "aliases": ["Variant Weight Unit"] },
+    { "wixTarget": "variant.inventoryQuantity", "aliases": ["Variant Inventory Qty"] },
+    { "wixTarget": "variant.inventoryPolicy", "aliases": ["Variant Inventory Policy"] },
+    { "wixTarget": "variant.requiresShipping", "aliases": ["Variant Requires Shipping"] },
+    { "wixTarget": "variant.taxable", "aliases": ["Variant Taxable"] },
+    { "wixTarget": "variant.option1.name", "aliases": ["Option1 Name"] },
+    { "wixTarget": "variant.option1.value", "aliases": ["Option1 Value"] },
+    { "wixTarget": "variant.option2.name", "aliases": ["Option2 Name"] },
+    { "wixTarget": "variant.option2.value", "aliases": ["Option2 Value"] },
+    { "wixTarget": "variant.option3.name", "aliases": ["Option3 Name"] },
+    { "wixTarget": "variant.option3.value", "aliases": ["Option3 Value"] },
+    { "wixTarget": "variant.image", "aliases": ["Variant Image"] },
+    { "wixTarget": "image.url", "aliases": ["Image Src"] },
+    { "wixTarget": "image.altText", "aliases": ["Image Alt Text"] },
+    { "wixTarget": "image.position", "aliases": ["Image Position"] },
+    { "wixTarget": "category.path", "aliases": ["Product Category"] },
+    { "wixTarget": "tag.name", "aliases": ["Tags"] }
+  ],
+  "quirks": [
+    "A continuation row carries an additional variant, an additional image, or both, and is never its own product. Exports differ in how they mark one: most blank the Handle, but some repeat it on every row of the product. The pinned continuation mode is verified against the sampled rows and corrected when the file disagrees, so do not assume either shape.",
+    "A continuation row that carries only an extra image leaves every Variant column blank, so a product has fewer variants than rows.",
+    "The first row of a product already carries its first variant, so variant columns are populated on the group head — a variant column cannot be identified by 'blank on the head row'.",
+    "The product CSV does NOT carry collection membership. Shopify collections require the Admin API or an app; surface this at discovery so the user is not surprised at mapping time.",
+    "Prices (Variant Price, Variant Compare At Price, Cost per item) are plain decimal strings with no currency symbol; the currency is a store setting the CSV does not carry.",
+    "Variant Grams is an integer weight in grams regardless of Variant Weight Unit.",
+    "Tags is one cell holding a comma-separated list.",
+    "Published is TRUE/FALSE while Status is active/draft/archived; they are different columns and both may be present."
+  ]
+}

package/skills/wix-replatform/resources/rp-source-csv/vendors/woocommerce.json

@@ -0,0 +1,82 @@
+{
+  "vendor": "woocommerce",
+  "profileVersion": "2026-07",
+  "sourceOfTruth": "https://woocommerce.com/document/product-csv-importer-exporter/",
+  "anchors": {
+    "required": ["Type", "Name", "SKU"],
+    "strong": ["Regular price", "Is featured?", "Visibility in catalog", "In stock?", "Short description", "Attribute 1 name"],
+    "negative": ["Handle", "attribute_set_code", "Item Type"]
+  },
+  "layout": {
+    "pattern": "sectioned",
+    "discriminatorColumn": "Type",
+    "childLevels": ["variation"],
+    "parentRefColumn": "Parent",
+    "parentEntity": "product",
+    "childEntity": "variant",
+    "columnGroups": [
+      {
+        "entity": "image",
+        "prefixes": [],
+        "columns": ["Images"]
+      }
+    ]
+  },
+  "derived": [
+    {
+      "entity": "category",
+      "fromColumn": "Categories",
+      "hierarchySeparator": ">",
+      "multiValueSeparator": ",",
+      "hierarchical": true,
+      "linkPolicy": "leaf",
+      "relation": { "fromEntity": "product", "field": "categories", "cardinality": "many-to-many" }
+    },
+    {
+      "entity": "tag",
+      "fromColumn": "Tags",
+      "multiValueSeparator": ",",
+      "hierarchical": false,
+      "linkPolicy": "leaf",
+      "relation": { "fromEntity": "product", "field": "tags", "cardinality": "many-to-many" }
+    }
+  ],
+  "fileRoles": [
+    { "role": "product", "filenameHints": ["wc-product-export", "products"] },
+    { "role": "order", "filenameHints": ["wc-order-export", "orders"] },
+    { "role": "customer", "filenameHints": ["customers"] }
+  ],
+  "columnMap": [
+    { "wixTarget": "product.name", "aliases": ["Name", "post_title"] },
+    { "wixTarget": "product.description", "aliases": ["Description", "post_content"] },
+    { "wixTarget": "product.shortDescription", "aliases": ["Short description", "post_excerpt"] },
+    { "wixTarget": "product.sourceId", "aliases": ["ID", "id", "post_id"] },
+    { "wixTarget": "product.visible", "aliases": ["Published", "Visibility in catalog"] },
+    { "wixTarget": "product.ribbon", "aliases": ["Is featured?"] },
+    { "wixTarget": "variant.sku", "aliases": ["SKU", "sku"] },
+    { "wixTarget": "variant.price", "aliases": ["Regular price", "regular_price"] },
+    { "wixTarget": "variant.discountedPrice", "aliases": ["Sale price", "sale_price"] },
+    { "wixTarget": "variant.inventoryQuantity", "aliases": ["Stock", "stock_quantity"] },
+    { "wixTarget": "variant.inStock", "aliases": ["In stock?"] },
+    { "wixTarget": "variant.weight", "aliases": ["Weight (kg)", "weight"] },
+    { "wixTarget": "variant.length", "aliases": ["Length (cm)"] },
+    { "wixTarget": "variant.width", "aliases": ["Width (cm)"] },
+    { "wixTarget": "variant.height", "aliases": ["Height (cm)"] },
+    { "wixTarget": "variant.option1.name", "aliases": ["Attribute 1 name"] },
+    { "wixTarget": "variant.option1.value", "aliases": ["Attribute 1 value(s)"] },
+    { "wixTarget": "variant.option2.name", "aliases": ["Attribute 2 name"] },
+    { "wixTarget": "variant.option2.value", "aliases": ["Attribute 2 value(s)"] },
+    { "wixTarget": "variant.parentRef", "aliases": ["Parent", "parent_id"] },
+    { "wixTarget": "image.url", "aliases": ["Images"] },
+    { "wixTarget": "category.path", "aliases": ["Categories"] },
+    { "wixTarget": "tag.name", "aliases": ["Tags"] }
+  ],
+  "quirks": [
+    "Type is the row discriminator: simple/variable/grouped/external rows are products, variation rows are variants of the product named in Parent.",
+    "Parent on a variation row references the parent by id (id:123) or by SKU, not by row position — resolve it explicitly rather than assuming the variation follows its parent.",
+    "Categories packs hierarchy and multiplicity into one cell: 'Clothing > Shirts, Sale' is two categories, one of them nested. Split the multi-value separator first, then the hierarchy separator.",
+    "A category name containing a comma is quoted inside the cell, so the multi-value split must itself be RFC-4180 aware.",
+    "Images is a comma-separated list of URLs in one cell; the first is the featured image.",
+    "Attribute N value(s) may hold several pipe-separated values on a variable product row while a variation row holds exactly one."
+  ]
+}