From 449e088a5591193a4862fec39a42b9e46f6ac835 Mon Sep 17 00:00:00 2001
From: Donald Merand <donald.merand@shopify.com>
Date: Tue, 28 Jul 2026 19:59:40 -0400
Subject: [PATCH] Add AI Toolkit guidance to app template

Assisted-By: devx/81c48486-0c2e-4920-8cab-c56824ad636d
---
 AGENTS.md | 5 +++++
 CLAUDE.md | 1 +
 2 files changed, 6 insertions(+)
 create mode 100644 AGENTS.md
 create mode 120000 CLAUDE.md

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 00000000..77499be5
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,5 @@
+# Shopify app development
+
+This app is scaffolded from a Shopify app template. See the README for framework-specific details.
+
+Use the [Shopify AI Toolkit](https://shopify.dev/docs/apps/build/ai-toolkit) for all Shopify API and platform work. If missing, install it in the agent host per that page (or `npx skills add Shopify/shopify-ai-toolkit` for skill-compatible hosts) — do not add tooling to this repo.
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 120000
index 00000000..47dc3e3d
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1 @@
+AGENTS.md
\ No newline at end of file