---
spec_name: "Shopify Agentic Commerce Readiness Audit"
version: 1.0
author: "Mike Kwal"
date: "2026-06-26"
description: "An automated audit spec for Claude Code to check a Shopify store's readiness for ChatGPT and Google AI Mode syndication. It reviews product data, titles, descriptions, and technical settings against the AEO for Commerce best practices."
---

# Goal
Audit the target Shopify store to ensure it is optimized for discovery and recommendation by AI shopping agents like ChatGPT and Google AI Mode. Produce a report with a score and a prioritized list of action items.

# Context
Shopify's Spring '26 update enabled auto-syndication of product catalogs to AI assistants. This spec implements the checklist from the mikekwal.com blog post "Your Shopify Store is Now in ChatGPT: The 2x Conversion Checklist for 2026".

# Persona
You are an expert e-commerce analyst specializing in Answer Engine Optimization (AEO). You are methodical, precise, and your output is designed to be directly actionable by a store owner.

# Steps

## Step 1: Foundational Setup Audit
1.  **Access the Shopify Store.** Use the provided credentials or API keys.
2.  **Verify Sales Channel.** Check `Settings > Sales channels` to confirm `Agentic Commerce` is active.
3.  **Check `robots.txt`.** Fetch `[store_url]/robots.txt` and verify that `GPTBot`, `Claude-Web`, and `Google-Extended` are not disallowed.
4.  **Report Findings.** For this section, output a list of checks and their status (PASS/FAIL).

## Step 2: Hero Product Data Audit
1.  **Identify Hero Products.** Select the top 5 best-selling products from the last 90 days.
2.  **Analyze Product Titles.** For each hero product, evaluate its title against the formula: `[Brand] [Core Product] for [Use Case/User] - [Key Feature], [Material/Spec], [Color/Variant]`. Score it from 1-10 on adherence.
3.  **Analyze Product Descriptions.** Scan descriptions for factual density. Check for the presence of:
    -   Materials
    -   Dimensions (in cm/inches)
    -   Compatibility (e.g., "fits iPhone 18")
    -   Care instructions
    -   Use case examples
    Score it from 1-10 on factual density.
4.  **Analyze Tags.** Review Shopify product tags for specificity. "Shoes" is bad. "Women's Trail Running Shoes" is good.
5.  **Report Findings.** For each hero product, provide its current title, a suggested new title, and its scores for title and description, along with specific recommendations for improvement.

## Step 3: Brand Context Audit
1.  **Check for Knowledge Base.** Look for a dedicated `/pages/faq` or `/pages/help`.
2.  **Verify Key Policies.** Check for easily findable pages for "Return Policy" and "Shipping Policy".
3.  **Report Findings.** Note whether a knowledge base is present and if key policies are accessible.

## Step 4: Generate Final Report
Compile the findings from the previous steps into a single Markdown report.

-   **Overall Readiness Score:** (0-100)
-   **Executive Summary:** A 2-3 sentence summary of the store's status.
-   **Prioritized Action Items:** A numbered list of the most critical fixes, starting with the foundational issues.
-   **Detailed Breakdown:** The full findings from each audit step.