Skip to content

armgit / spree

Public Imported from GitHub
0

Open Source Platform for DTC, B2B Commerce, Marketplaces & Omnichannel. REST APIs, TypeScript SDKs, and production-ready Next.js storefront. Self-host it. Own your data. No vendor lock-in. Zero platform fees.

advertise agent skills in docs

Damian Legawiecfcd354c6f65e
diff --git a/docs/developer/cli/quickstart.mdx b/docs/developer/cli/quickstart.mdx
index 3a0544b3cf..a906429419 100644
--- a/docs/developer/cli/quickstart.mdx
+++ b/docs/developer/cli/quickstart.mdx
@@ -283,3 +283,7 @@ spree task load_sample_data
spree task spree:price_history:seed
spree task spree:price_history:prune
```
+
+## Pair with AI agents
+
+The CLI's predictable command surface is what AI coding agents drive when working on Spree projects. The [Spree agent skills](/developer/agentic/agent-skills) teach agents these commands and conventions, and the Claude Code plugin adds `/spree:doctor` (stack diagnosis) and `/spree:audit-upgrade` (upgrade-readiness audit) on top. See [Agentic Development](/developer/agentic/overview).
diff --git a/docs/developer/getting-started/quickstart.mdx b/docs/developer/getting-started/quickstart.mdx
index f1ef96ac9c..d499affb69 100644
--- a/docs/developer/getting-started/quickstart.mdx
+++ b/docs/developer/getting-started/quickstart.mdx
@@ -77,6 +77,27 @@ Upon successful authentication, you should see the admin screen:
<img src="/images/spree_admin_dashboard.png" />
</Frame>
+## Next Steps
+
+<CardGroup cols={2}>
+ <Card title="Build with AI Agents" icon="bot" href="/developer/agentic/overview">
+ Install the Spree agent skills and connect the docs MCP server — Claude Code, Cursor, Copilot, and 60+ other tools learn Spree's conventions and build features with you.
+ </Card>
+ <Card title="Customization Tutorial" icon="graduation-cap" href="/developer/tutorial/introduction">
+ Build a complete custom feature — model, admin UI, API, and TypeScript SDK — step by step.
+ </Card>
+ <Card title="Core Concepts" icon="brain" href="/developer/core-concepts/architecture">
+ Understand how Spree models commerce — stores, products, orders, payments.
+ </Card>
+ <Card title="Next.js Storefront" icon="react" href="/developer/storefront/nextjs/quickstart">
+ Customize and extend the headless storefront.
+ </Card>
+</CardGroup>
+
+<Tip>
+ Using an AI coding agent? Run `npx skills add spree/agent-skills` in your new project — it teaches your agent the customization patterns before you write a line of code. See [Agentic Development](/developer/agentic/overview).
+</Tip>
+
---
Congrats! You've set up your Spree Commerce and it's looking amazing!
diff --git a/docs/developer/sdk/quickstart.mdx b/docs/developer/sdk/quickstart.mdx
index 3aa368c0c2..b6e41cf1cd 100644
--- a/docs/developer/sdk/quickstart.mdx
+++ b/docs/developer/sdk/quickstart.mdx
@@ -82,3 +82,7 @@ await client.customer.addresses.list({}, options);
await client.categories.products.list(categoryId, params, options);
await client.wishlists.items.create(wishlistId, params, options);
```
+
+## Pair with AI agents
+
+Building your storefront with an AI coding agent? The [Spree agent skills](/developer/agentic/agent-skills) include dedicated SDK and storefront skills (typed clients, Ransack filtering, error handling, custom endpoints), and the [docs MCP server](/developer/agentic/mcp) gives your agent the full SDK reference on demand. See [Agentic Development](/developer/agentic/overview).
diff --git a/docs/index.mdx b/docs/index.mdx
index cc50a7d7fb..70b9f56212 100644
--- a/docs/index.mdx
+++ b/docs/index.mdx
@@ -180,6 +180,19 @@ export const CopyCommand = ({ command }) => {
title="Evaluate Spree"
description="Architecture overview, use cases, and platform capabilities. Ideal for technical decision makers."
/>
+ <QuickStartCard
+ href="/developer/agentic/overview"
+ tag="New"
+ icon={<Icon><path d="M9.937 15.5A2 2 0 0 0 8.5 14.063l-6.135-1.582a.5.5 0 0 1 0-.962L8.5 9.936A2 2 0 0 0 9.937 8.5l1.582-6.135a.5.5 0 0 1 .963 0L14.063 8.5A2 2 0 0 0 15.5 9.937l6.135 1.581a.5.5 0 0 1 0 .964L15.5 14.063a2 2 0 0 0-1.437 1.437l-1.582 6.135a.5.5 0 0 1-.963 0z" /><path d="M20 3v4" /><path d="M22 5h-4" /><path d="M4 17v2" /><path d="M5 18H3" /></Icon>}
+ title="Build with AI Agents"
+ description="Agent skills, a docs MCP server, and LLM-ready documentation for Claude Code, Cursor, Copilot, and 60+ other tools."
+ />
+ <QuickStartCard
+ href="/developer/tutorial/api"
+ icon={<Icon><path d="M21 12V7H5a2 2 0 0 1 0-4h14v4" /><path d="M3 5v14a2 2 0 0 0 2 2h16v-5" /><path d="M18 12a2 2 0 0 0 0 4h4v-4z" /></Icon>}
+ title="Add Custom Resources"
+ description="Generate a complete model + Store and Admin API surface with one command."
+ />
</div>
</div>
@@ -338,6 +351,10 @@ export const CopyCommand = ({ command }) => {
icon={<SmallIcon><polyline points="4 17 10 11 4 5" /><line x1="12" x2="20" y1="19" y2="19" /></SmallIcon>}
title="Spree CLI"
description="Command-line tools for development" />
+ <ResourceLink href="/developer/agentic/overview"
+ icon={<SmallIcon><path d="M12 8V4H8" /><rect width="16" height="12" x="4" y="8" rx="2" /><path d="M2 14h2" /><path d="M20 14h2" /><path d="M15 13v2" /><path d="M9 13v2" /></SmallIcon>}
+ title="Agentic Development"
+ description="Agent skills, docs MCP server, LLM-ready docs" />
<ResourceLink href="/api-reference"
icon={<SmallIcon><path d="M21 12V7H5a2 2 0 0 1 0-4h14v4" /><path d="M3 5v14a2 2 0 0 0 2 2h16v-5" /><path d="M18 12a2 2 0 0 0 0 4h4v-4z" /></SmallIcon>}
title="API Reference"