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, reporting contract and Check evaluation workflow. 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, shopping journeys and debugging for shared evidence and source attribution.
-
Repository discovery, tool routing and connected data for available evidence capabilities.
-
Competitor comparison and customer research for relevant supporting context.
-
PIE prioritization 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: save, validate and read back the complete report.json. After every local audit, follow local audit results 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
{
"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."
]
}