Shopify Catalog Change-Contract Gate

Verify that an AI agent changed only what you allowed in your Shopify product CSV.

AI agents can update product data quickly — but when you ask an agent to change a specific set of fields, you may still want a deterministic way to verify that nothing else changed.

Shopify Catalog Change-Contract Gate compares the CSV before and after the edit against an explicit Change Contract.

If the agent changes something outside the approved scope, the gate rejects the result and reports what changed.

Example

You authorize an agent to update SEO fields for selected products.

The agent returns a modified Shopify product CSV.

The gate verifies that the approved SEO changes are the only permitted changes and protects everything else covered by the contract.

Unexpected changes such as protected field modifications, identity changes, unauthorized product changes, blanked values, or row structure changes can cause the result to be rejected.

How It Works

Provide:

• The original Shopify product CSV
• The modified Shopify product CSV
• A Change Contract defining the products and SEO fields that are allowed to change

The Skill compares the files deterministically and produces machine-readable JSON and human-readable Markdown evidence.

Results are reported as:

• PASS
• REJECT
• INVALID_INPUT

Built for Post-Agent Verification

This Skill is designed to sit after an AI or automation step:

Original CSV → Agent Edit → Modified CSV → Change-Contract Gate

Instead of asking another AI model to review the edit each time, you can apply the same explicit rules repeatedly and receive structured results.

This makes it useful for repeatable AI-assisted catalog workflows where exact field preservation matters.

Deterministic and Local

The core verification does not require:

• An AI or LLM API
• Shopify API access
• Store login credentials
• External web services
• A database
• A GPU

Supported inputs are checked locally using explicit rules.

Fail-Closed Validation

The gate does not silently guess when supported identity or input requirements are ambiguous.

Invalid or unsupported input is rejected rather than treated as a successful verification.

The Skill also protects against changes outside the declared contract, including supported cases involving:

• Unauthorized field changes
• Unauthorized product changes
• Protected identity changes
• Unexpected blanking
• Row additions or deletions
• Row reordering

Important: What PASS Means

PASS means the compared files comply with the declared Change Contract within the supported scope of this version.

It does NOT mean:

• The CSV is guaranteed to import successfully into Shopify
• Shopify will accept every value
• The product data is commercially correct
• The current Shopify store state matches the CSV
• Every Shopify CSV format or edge case is supported

This is a change-contract verification tool, not a Shopify import-safety guarantee.

Scope and Limits

Version 1.0.0 intentionally supports a bounded Shopify product CSV subset and a limited SEO-edit workflow.

It is not:

• A general Shopify CSV validator
• A Shopify catalog editor
• An automatic repair tool
• An SEO quality evaluator
• A Shopify API client
• A general-purpose CSV diff tool

Current input limits:

• Up to 10,000 rows per CSV
• Up to 2 MiB per CSV

Unsupported or ambiguous structures should be rejected rather than guessed.

Requirements

• Python
• A Skill-capable Agent environment

No external AI service, paid API, or Shopify credentials are required.

Version

1.0.0