---
name: core-shopify-audit
description: Audit fifteen public-browser Checks across Shopify homepage, collection and product browsing, or a focused selection. Find evidence-backed improvements in discovery, product decisions, accessibility, metadata and reliability. Read-only; stop before add-to-cart submission.
---

# Instructions

Audit fifteen public-browser Checks across the homepage, a populated collection and a representative product page, or an explicitly focused selection. Stop before add-to-cart submission. Full/comprehensive/all-checks requests belong to installed `$comprehensive-shopify-audit`; if unavailable, explain the access gap and offer Core coverage without claiming completeness. Never select Comprehensive solely because it is installed.

Provide one HTTP(S) live storefront URL. Repository, GitHub, Shopify and Google Analytics evidence is optional; bind each available source to the store and block only decisions that require missing evidence. Keep the declared integration boundary.

## Run the audit

Read the [operating contract](references/core/operating-contract.md), [reporting contract](references/core/reporting-contract.md) and [Check evaluation workflow](references/workflows/check-evaluation.md). Evaluate each selected Check in bounded batches with direct evidence and one terminal outcome. Record `Coverage: Basic` or `Coverage: Basic, focused` and selected IDs in permitted details. Core needs no analytics, account login, cart mutation or checkout submission.

Load supporting procedures only as needed:

- [Browser testing](references/workflows/browser-testing.md), [shopping journeys](references/workflows/commerce-journeys/) and [debugging](references/workflows/debugging.md) for shared evidence and source attribution.
- [Repository discovery](references/tools/repository-discovery.md), [tool routing](references/tools/mcp-routing.md) and [connected data](references/tools/integrations.md) for available evidence capabilities.
- [Competitor comparison](references/workflows/competitor-analysis.md) and [customer research](references/workflows/customer-research.md) for relevant supporting context.

- [PIE prioritization](references/core/prioritization.md) for supported opportunities.

Reuse compatible supplied reports. Standalone metrics belong to `$report-shopify-performance`; funnel trends and experiment readouts belong to `$report-shopify-funnel`. Use those skills only when separately requested and installed; otherwise explain the access gap. Do not run them automatically or import their catalogs. Core does not replace those reports.

Use host capabilities permitted for the task. Consume an already prepared preview; `$preview-shopify-theme` handles setup and its `references/tools/local-storefront.md#evidence-and-report-use` defines simulation limits. Do not install packages or start servers during evaluation. Keep the audit read-only. Do not submit cart/checkout actions, edit, upload, publish, purchase, message or change store data.

## Return results

Return action-only Issues, comparable Changes when supported, every selected Check and shared Limitations. Keep Findings empty. Each Issue and its failed Checks share one canonical category: Experience, Accessibility, Discoverability or Technical. Match category IDs to Check metadata/folders; surface and subcategory labels are not report categories.

Follow [Glue JSON output](references/core/glue-output.md): save, validate and read back the complete `report.json`. After every local audit, follow [local audit results](references/workflows/local-results.md) to open the bundled localhost viewer, then link its URL and JSON artifact with a readable summary of every Issue. Presentation needs Python 3.9+, command execution and a persistent process; unavailable capabilities leave the saved report usable and do not change Check outcomes. Use the bundled schema unless the host supplies one. In Glue, return the bare object through its runtime; Glue handles storage and rendering without starting this viewer.

## Host integration

```glue-review-setup
{
  "schemaVersion": 2,
  "goal": "Identify actionable homepage, collection and product-page improvements through fifteen public-browser Core Checks.",
  "context": [
    {
      "id": "target_repository",
      "label": "Repository",
      "type": "repository",
      "required": false
    },
    {
      "id": "target_url",
      "label": "Storefront URL",
      "type": "url",
      "required": true
    }
  ],
  "integrations": [
    {
      "toolkit": "github",
      "label": "GitHub",
      "required": false
    },
    {
      "toolkit": "shopify",
      "label": "Shopify",
      "required": false
    },
    {
      "toolkit": "google_analytics",
      "label": "Google Analytics",
      "required": false
    }
  ],
  "categories": [
    {
      "id": "experience",
      "label": "Experience",
      "subcategories": [
        {
          "id": "collection",
          "label": "Collection"
        },
        {
          "id": "homepage",
          "label": "Homepage"
        },
        {
          "id": "navigation",
          "label": "Navigation"
        },
        {
          "id": "product-page",
          "label": "Product page"
        }
      ]
    },
    {
      "id": "accessibility",
      "label": "Accessibility",
      "subcategories": [
        {
          "id": "cross-surface",
          "label": "Cross-surface"
        }
      ]
    },
    {
      "id": "discoverability",
      "label": "Discoverability",
      "subcategories": [
        {
          "id": "cross-surface",
          "label": "Cross-surface"
        }
      ]
    },
    {
      "id": "technical",
      "label": "Technical",
      "subcategories": [
        {
          "id": "reliability",
          "label": "Reliability"
        }
      ]
    }
  ],
  "batches": [
    {
      "id": "experience",
      "label": "Experience checks",
      "categoryIds": [
        "experience"
      ]
    },
    {
      "id": "accessibility",
      "label": "Accessibility checks",
      "categoryIds": [
        "accessibility"
      ]
    },
    {
      "id": "discoverability",
      "label": "Discoverability checks",
      "categoryIds": [
        "discoverability"
      ]
    },
    {
      "id": "technical",
      "label": "Technical checks",
      "categoryIds": [
        "technical"
      ]
    }
  ],
  "reporting": {
    "allowedResultTypes": [
      "issue",
      "change"
    ],
    "data": []
  },
  "completionRules": [
    "Every selected active Check reaches exactly one terminal outcome.",
    "Every failed check references exactly one same-category Issue.",
    "Default runs close every active Check in this fifteen-Check browse catalog; focused runs close every selected ID. Cart/checkout and comprehensive coverage require comprehensive-shopify-audit."
  ],
  "safetyRules": [
    "Keep Core read-only on public homepage, collection and product pages; do not submit add-to-cart, cart edits, checkout, login or account forms.",
    "Never enter payment, activate a wallet, place an order, edit, upload, publish, message or change store data."
  ]
}
```