{"schemaVersion":"1.0","title":"Agentic Commerce Field Guide","description":"Practical systems for agentic commerce: economics, product data, supervised operations, and measurable discovery.","homeUrl":"https://www.iamgeorgekelly.com/field-guide","author":{"name":"George Kelly","url":"https://www.iamgeorgekelly.com/about"},"editorialNote":"AI-assisted research and drafting. Provider-specific claims link to primary sources. Frameworks are editorial proposals; worked examples are illustrative and are not employer performance results.","items":[{"id":"https://www.iamgeorgekelly.com/field-guide/agentic-commerce","title":"Agentic commerce starts with an operating model.","description":"A practical framework for choosing agent-assisted commerce work, setting decision rights, and proving that the result is worth the cost.","category":"Strategy","published":"2026-09-05","updated":"2026-09-05","url":"https://www.iamgeorgekelly.com/field-guide/agentic-commerce","markdownUrl":"https://www.iamgeorgekelly.com/field-guide/agentic-commerce/index.md","jsonUrl":"https://www.iamgeorgekelly.com/field-guide/agentic-commerce/index.json","sources":[{"id":"anthropic","title":"Anthropic: Building effective agents","url":"https://www.anthropic.com/engineering/building-effective-agents","note":"Supports the workflow-versus-agent distinction. The commerce operating contract and examples here are original editorial frameworks.","checked":"2026-09-05"}],"downloads":[]},{"id":"https://www.iamgeorgekelly.com/field-guide/roas-poas-profit","title":"ROAS calculator: break-even and contribution","description":"Calculate ROAS, contribution after advertising, and the break-even return for your margin. Includes worked examples and a margin comparison.","category":"Economics","published":"2026-09-05","updated":"2026-09-06","url":"https://www.iamgeorgekelly.com/field-guide/roas-poas-profit","markdownUrl":"https://www.iamgeorgekelly.com/field-guide/roas-poas-profit/index.md","jsonUrl":"https://www.iamgeorgekelly.com/field-guide/roas-poas-profit/index.json","sources":[{"id":"google-values","title":"Google Ads: About conversion values","url":"https://support.google.com/google-ads/answer/13064207?hl=en","note":"Supports the distinction between revenue-based and profit-based conversion values. The calculator definitions and synthetic example are stated explicitly in this guide.","checked":"2026-09-06"}],"downloads":[]},{"id":"https://www.iamgeorgekelly.com/field-guide/product-data-for-agents","title":"Product data an agent can use without guessing.","description":"A practical product-data contract for variants, dimensions, availability, provenance, and unknown values, with a downloadable JSON example.","category":"Product data","published":"2026-09-05","updated":"2026-09-05","url":"https://www.iamgeorgekelly.com/field-guide/product-data-for-agents","markdownUrl":"https://www.iamgeorgekelly.com/field-guide/product-data-for-agents/index.md","jsonUrl":"https://www.iamgeorgekelly.com/field-guide/product-data-for-agents/index.json","sources":[{"id":"merchant","title":"Google Merchant Center: Product data specification","url":"https://support.google.com/merchants/answer/7052112?hl=en","note":"Supports stable identifiers, explicit variant attributes, and consistency between submitted data and the destination.","checked":"2026-09-05"},{"id":"variants","title":"Google Search: Product variant structured data","url":"https://developers.google.com/search/docs/appearance/structured-data/product-variants","note":"Supports explicit ProductGroup and Product relationships. The downloadable internal contract is illustrative, not Google feed syntax.","checked":"2026-09-05"}],"downloads":[{"title":"Download the example product-data contract","url":"https://www.iamgeorgekelly.com/downloads/product-data-contract.json"}]},{"id":"https://www.iamgeorgekelly.com/field-guide/supervised-commerce-workflows","title":"From request to release: a supervised commerce workflow.","description":"An original seven-stage operating checklist for turning agent-assisted commerce work into an inspectable, authorized, verified release.","category":"Operations","published":"2026-09-05","updated":"2026-09-05","url":"https://www.iamgeorgekelly.com/field-guide/supervised-commerce-workflows","markdownUrl":"https://www.iamgeorgekelly.com/field-guide/supervised-commerce-workflows/index.md","jsonUrl":"https://www.iamgeorgekelly.com/field-guide/supervised-commerce-workflows/index.json","sources":[{"id":"anthropic","title":"Anthropic: Building effective agents","url":"https://www.anthropic.com/engineering/building-effective-agents","note":"Supports evaluation and environment feedback as agent-design principles. The seven-stage commerce checklist is an original adaptation, not an Anthropic standard.","checked":"2026-09-05"}],"downloads":[{"title":"Download the release checklist","url":"https://www.iamgeorgekelly.com/downloads/commerce-release-checklist.csv"}]},{"id":"https://www.iamgeorgekelly.com/field-guide/ai-visibility-measurement","title":"Measure AI visibility without confusing it with traffic.","description":"A measurement framework that separates crawler access, answer citations, referral visits, and qualified commercial outcomes.","category":"Measurement","published":"2026-09-05","updated":"2026-09-06","url":"https://www.iamgeorgekelly.com/field-guide/ai-visibility-measurement","markdownUrl":"https://www.iamgeorgekelly.com/field-guide/ai-visibility-measurement/index.md","jsonUrl":"https://www.iamgeorgekelly.com/field-guide/ai-visibility-measurement/index.json","sources":[{"id":"bing","title":"Bing: Introducing AI Performance in Webmaster Tools","url":"https://blogs.bing.com/webmaster/February-2026/Introducing-AI-Performance-in-Bing-Webmaster-Tools-Public-Preview","note":"Documents citation-oriented reporting and its supported surfaces. It is distinct from website referral analytics.","checked":"2026-09-05"},{"id":"google","title":"Google Search: AI features and your website","url":"https://developers.google.com/search/docs/appearance/ai-features","note":"Documents inclusion requirements and the scope of Search Console reporting for AI features.","checked":"2026-09-05"},{"id":"ga-channels","title":"Google Analytics: Default channel group","url":"https://support.google.com/analytics/answer/9756891?hl=en","note":"Defines the AI Assistant channel and excludes Google AI Overviews and AI Mode. Channel membership is not proof of a unique human or citation.","checked":"2026-09-06"}],"downloads":[{"title":"Download the question bank and observation fields","url":"https://www.iamgeorgekelly.com/downloads/ai-visibility-question-bank.csv"}]},{"id":"https://www.iamgeorgekelly.com/field-guide/agent-discoverability","title":"Make a website easy for agents to find, read, and use.","description":"An evidence-based guide to crawler access, HTML, structured data, Markdown, llms.txt, feeds, and real tool descriptions.","category":"Discoverability","published":"2026-09-05","updated":"2026-09-05","url":"https://www.iamgeorgekelly.com/field-guide/agent-discoverability","markdownUrl":"https://www.iamgeorgekelly.com/field-guide/agent-discoverability/index.md","jsonUrl":"https://www.iamgeorgekelly.com/field-guide/agent-discoverability/index.json","sources":[{"id":"google","title":"Google Search: AI features and your website","url":"https://developers.google.com/search/docs/appearance/ai-features","note":"Supports baseline search requirements and the absence of a special AI file requirement.","checked":"2026-09-05"},{"id":"openai","title":"OpenAI: Overview of crawlers","url":"https://developers.openai.com/api/docs/bots","note":"Documents separate search, training, and user-initiated crawler purposes.","checked":"2026-09-05"},{"id":"anthropic","title":"Anthropic: Web crawler controls","url":"https://support.claude.com/en/articles/8896518-does-anthropic-crawl-data-from-the-web-and-how-can-site-owners-block-the-crawler","note":"Documents Anthropic crawler purposes and site-owner controls.","checked":"2026-09-05"},{"id":"perplexity","title":"Perplexity: Crawlers","url":"https://docs.perplexity.ai/docs/resources/perplexity-crawlers","note":"Documents search and user-initiated retrieval agents.","checked":"2026-09-05"},{"id":"llms","title":"The llms.txt proposal","url":"https://llmstxt.org/","note":"An emerging convention for a concise site index and alternate text representations.","checked":"2026-09-05"},{"id":"lighthouse","title":"Chrome Lighthouse: llms.txt audit","url":"https://developer.chrome.com/docs/lighthouse/agentic-browsing/llms-txt","note":"Documents optional llms.txt audit behavior; does not establish a ranking benefit.","checked":"2026-09-05"},{"id":"google-ai","title":"Google Search: Using generative AI content","url":"https://developers.google.com/search/docs/fundamentals/using-gen-ai-content","note":"Supports prioritizing added value over mass generation without value.","checked":"2026-09-05"}],"downloads":[]},{"id":"https://www.iamgeorgekelly.com/field-guide/ai-product-copy-evaluation","title":"How do you check AI product copy before publishing?","description":"A claim-by-claim review method, six failure cases, and a reusable evaluation brief for AI-assisted product descriptions.","category":"Operations","published":"2026-09-05","updated":"2026-09-05","url":"https://www.iamgeorgekelly.com/field-guide/ai-product-copy-evaluation","markdownUrl":"https://www.iamgeorgekelly.com/field-guide/ai-product-copy-evaluation/index.md","jsonUrl":"https://www.iamgeorgekelly.com/field-guide/ai-product-copy-evaluation/index.json","sources":[{"id":"shopify","title":"Shopify: Best practices for AI-powered tools","url":"https://help.shopify.com/en/manual/ai-powered-tools/best-practices","note":"Supports reviewing AI suggestions before applying changes. The shelf example is fictional and the scorecard is a proposed method.","checked":"2026-09-05"},{"id":"magic","title":"Shopify: Automatically generating product descriptions","url":"https://help.shopify.com/en/manual/products/details/product-descriptions/shopify-magic","note":"Documents description suggestions generated from supplied product details, not guaranteed factual accuracy.","checked":"2026-09-05"},{"id":"evals","title":"Anthropic: Demystifying evals for AI agents","url":"https://www.anthropic.com/engineering/demystifying-evals-for-ai-agents","note":"Supports task-specific evaluation, suitable graders, and inspecting outputs. The six cases, 18-run pilot, and release threshold are proposed choices, not a vendor standard.","checked":"2026-09-05"}],"downloads":[{"title":"Download the evaluation brief and scorecard","url":"https://www.iamgeorgekelly.com/downloads/product-copy-evaluation.md"}]},{"id":"https://www.iamgeorgekelly.com/field-guide/ga4-ai-referral-traffic","title":"How to read AI referral traffic in GA4","description":"Use GA4’s AI Assistant channel, check source/medium, and reconcile known QA visits. Includes a worked review and reusable worksheet.","category":"Measurement","published":"2026-09-06","updated":"2026-09-06","url":"https://www.iamgeorgekelly.com/field-guide/ga4-ai-referral-traffic","markdownUrl":"https://www.iamgeorgekelly.com/field-guide/ga4-ai-referral-traffic/index.md","jsonUrl":"https://www.iamgeorgekelly.com/field-guide/ga4-ai-referral-traffic/index.json","sources":[{"id":"ga-release","title":"Google Analytics: AI Assistant channel release","url":"https://support.google.com/analytics/answer/9164320?hl=en#05132026","note":"Documents the May 13, 2026 AI Assistant channel and automatic medium/campaign classification for recognized referrers.","checked":"2026-09-06"},{"id":"ga-channels","title":"Google Analytics: Default channel group","url":"https://support.google.com/analytics/answer/9756891?hl=en","note":"Defines the AI Assistant channel and excludes Google AI Overviews and AI Mode. Channel membership is not proof of a unique human or citation.","checked":"2026-09-06"},{"id":"ga-report","title":"Google Analytics: Traffic acquisition report","url":"https://support.google.com/analytics/answer/12923437?hl=en","note":"Documents session-scoped acquisition dimensions, report access, metrics, and secondary dimensions. The reconciliation method and all example counts are editorial illustrations.","checked":"2026-09-06"}],"downloads":[{"title":"Download the illustrative review worksheet (CSV)","url":"https://www.iamgeorgekelly.com/downloads/ai-referral-review.csv"},{"title":"Download the example, rules, and blank row (JSON)","url":"https://www.iamgeorgekelly.com/downloads/ai-referral-review.json"}]},{"id":"https://www.iamgeorgekelly.com/field-guide/inventory-aware-ad-spend","title":"Can your stock support more ad spend?","description":"An inventory and ad-spend calculator with daily stock checks, a delayed-delivery example, and a downloadable decision worksheet.","category":"Measurement","published":"2026-09-06","updated":"2026-09-06","url":"https://www.iamgeorgekelly.com/field-guide/inventory-aware-ad-spend","markdownUrl":"https://www.iamgeorgekelly.com/field-guide/inventory-aware-ad-spend/index.md","jsonUrl":"https://www.iamgeorgekelly.com/field-guide/inventory-aware-ad-spend/index.json","sources":[{"id":"shopify-inventory","title":"Shopify: Understanding inventory states","url":"https://help.shopify.com/en/manual/products/inventory/fundamentals/inventory-states","note":"Defines available, committed, unavailable, on-hand, and incoming stock. Does not prescribe this buffer, demand forecast, or spending rule.","checked":"2026-09-06"},{"id":"google-lift","title":"Google Ads: About Conversion Lift","url":"https://support.google.com/google-ads/answer/12003020?hl=en","note":"Explains exposed/control measurement of incremental impact. Does not establish the example’s assumed cost per additional unit or guarantee study access.","checked":"2026-09-06"},{"id":"google-budget","title":"Google Ads: Bidding and budget questions","url":"https://support.google.com/google-ads/faq/10286469?hl=en","note":"Documents daily spending limits for most campaigns and exceptions. The worksheet’s uniform actual spend is an assumption, not a Google Ads budget control.","checked":"2026-09-06"},{"id":"merchant-availability","title":"Google Merchant Center: Availability","url":"https://support.google.com/merchants/answer/6324448?hl=en","note":"Supports accurate availability across offer, landing page, and checkout, and separate controls for pausing promotion. The calculator does not change product feeds or campaigns.","checked":"2026-09-06"}],"downloads":[{"title":"Download the three worked scenarios and expected results (JSON)","url":"https://www.iamgeorgekelly.com/downloads/inventory-ad-spend-scenarios.json"},{"title":"Download the blank inventory and spend decision memo","url":"https://www.iamgeorgekelly.com/downloads/inventory-spend-decision.md"}]},{"id":"https://www.iamgeorgekelly.com/field-guide/product-data-ownership","title":"Product data ownership: resolve a price conflict","description":"A field-ownership register for PIM, ERP, storefront, and feed data, with a worked correction and explicit release checks.","category":"Product data","published":"2026-09-06","updated":"2026-09-06","url":"https://www.iamgeorgekelly.com/field-guide/product-data-ownership","markdownUrl":"https://www.iamgeorgekelly.com/field-guide/product-data-ownership/index.md","jsonUrl":"https://www.iamgeorgekelly.com/field-guide/product-data-ownership/index.json","sources":[{"id":"merchant-price","title":"Google Merchant Center: Price","url":"https://support.google.com/merchants/answer/6324371?hl=en","note":"Supports price/currency agreement and current price requirements. Does not prescribe ERP or PIM ownership, approval roles, or a five-minute tolerance.","checked":"2026-09-06"},{"id":"merchant-availability","title":"Google Merchant Center: Availability","url":"https://support.google.com/merchants/answer/6324448?hl=en","note":"Supports consistent availability across product data, landing page, and checkout. A data conflict is not evidence that stock is unavailable.","checked":"2026-09-06"},{"id":"google-variants","title":"Google Search: Product variant structured data","url":"https://developers.google.com/search/docs/appearance/structured-data/product-variants","note":"Supports direct variant selection with correct price and availability. The register and conflict are fictional editorial examples.","checked":"2026-09-06"}],"downloads":[{"title":"Download the fictional ownership register (CSV)","url":"https://www.iamgeorgekelly.com/downloads/product-data-ownership-register.csv"},{"title":"Download the register, conflict, and release checks (JSON)","url":"https://www.iamgeorgekelly.com/downloads/product-data-ownership-register.json"}]},{"id":"https://www.iamgeorgekelly.com/field-guide/product-variant-acceptance-test","title":"Does the product page match the variant you submitted?","description":"A six-case acceptance test for variant identity, price, availability, and missing facts, with reusable JSON fixtures.","category":"Product data","published":"2026-09-05","updated":"2026-09-05","url":"https://www.iamgeorgekelly.com/field-guide/product-variant-acceptance-test","markdownUrl":"https://www.iamgeorgekelly.com/field-guide/product-variant-acceptance-test/index.md","jsonUrl":"https://www.iamgeorgekelly.com/field-guide/product-variant-acceptance-test/index.json","sources":[{"id":"merchant","title":"Google Merchant Center: Product data specification","url":"https://support.google.com/merchants/answer/7052112?hl=en","note":"Supports matching submitted product facts with landing pages and structured data. The six-case test is an original editorial method.","checked":"2026-09-05"},{"id":"landing","title":"Google Merchant Center: Landing page requirements","url":"https://support.google.com/merchants/answer/4752265?hl=en","note":"Supports variant selection and consistent information during page load. This guide does not test or certify a real merchant account.","checked":"2026-09-05"},{"id":"variants","title":"Google Search: Product variant structured data","url":"https://developers.google.com/search/docs/appearance/structured-data/product-variants","note":"Documents ProductGroup and Product relationships. It does not establish installation compatibility.","checked":"2026-09-05"}],"downloads":[{"title":"Download the six test fixtures","url":"https://www.iamgeorgekelly.com/downloads/variant-acceptance-fixtures.json"}]},{"id":"https://www.iamgeorgekelly.com/field-guide/returns-adjusted-contribution","title":"Is the campaign still profitable after returns?","description":"A worked order-cohort reconciliation for refunds, recovered inventory, return costs, and ad spend, with a reusable review template.","category":"Economics","published":"2026-09-05","updated":"2026-09-05","url":"https://www.iamgeorgekelly.com/field-guide/returns-adjusted-contribution","markdownUrl":"https://www.iamgeorgekelly.com/field-guide/returns-adjusted-contribution/index.md","jsonUrl":"https://www.iamgeorgekelly.com/field-guide/returns-adjusted-contribution/index.json","sources":[{"id":"shopify","title":"Shopify: Sales reports","url":"https://help.shopify.com/en/manual/reports-and-analytics/shopify-reports/report-types/default-reports/sales-report","note":"Documents sales/reversal timing and the distinction from physical returns. Cohort reconciliation and the USD example are original management-analysis illustrations, not Shopify accounting output.","checked":"2026-09-05"},{"id":"adjustments","title":"Google Ads: How to adjust your conversions","url":"https://support.google.com/google-ads/answer/7686280?hl=en","note":"Documents conversion adjustments and their prerequisites. No conversion settings or bid changes are implied by this example.","checked":"2026-09-05"}],"downloads":[{"title":"Download the cohort review template","url":"https://www.iamgeorgekelly.com/downloads/returns-cohort-review.md"}]}]}