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.
Ruby b2b-commercee-commerceecommerceecommerce-apiecommerce-frameworkecommerce-platformheadlessheadless-commerceheadless-ecommercemarketplacemulti-tenantmulti-vendormulti-vendor-ecommerceopen-sourcespree-commerce
---
title: "Agentic Development"
sidebarTitle: Overview
description: "Build, customize, and upgrade Spree stores with AI coding agents using installable agent skills, a documentation MCP server, and LLM-ready docs."
---
Spree ships first-class tooling for agentic development, where coding agents do most of the work. Whether you use Claude Code, Cursor, Codex, Copilot, or any other coding agent, your agent can learn Spree's conventions, read the right docs at the right time, and run the project safely.
## Why Spree works well with AI agents
- **Strong conventions** — everything is namespaced under `Spree`, models follow predictable patterns (prefixed IDs, `Spree.base_class`, service objects, events), and the v3 REST API uses simple response/request shapes. Conventions are what agents are best at following.
- **Fully Typed APIs** — both Store API and Admin API have OpenAPI specs and official TypeScript SDKs, so agents can generate code with confidence instead of guessing from training data.
- **Docs designed for machine consumption** — the full documentation is available as [llms.txt, per-page Markdown, and a local npm package](/developer/agentic/llm-docs), so agents read authoritative content instead of guessing from training data.
- **A guided project workflow** — [create-spree-app](/developer/create-spree-app/quickstart) scaffolds projects with a generated `AGENTS.md` and `CLAUDE.md`, local docs, and the [Spree CLI](/developer/cli/quickstart), so an agent can boot, migrate, generate code, and run tests without bespoke setup.
## The toolbox
<CardGroup cols={2}>
<Card title="Agent Skills" icon="graduation-cap" href="/developer/agentic/agent-skills">
Skills teaching agents Spree's conventions, customization patterns, and upgrade flows — installable into 60+ agent tools, plus a Claude Code plugin with slash commands and safety hooks.
</Card>
<Card title="Docs MCP Server" icon="plug" href="/developer/agentic/docs-mcp">
Connect your agent to the Spree documentation MCP server to search and read the latest docs while building.
</Card>
<Card title="Admin MCP Server" icon="store" href="/developer/mcp/overview">
Let an agent run your store — merchandise the catalog, answer reporting questions, manage orders and setup — under the same permissions as the Admin API.
</Card>
<Card title="LLM-Ready Docs" icon="file-text" href="/developer/agentic/llm-docs">
llms.txt, per-page Markdown, and the `@spree/docs` npm package for fast local reads.
</Card>
<Card title="Spree CLI" icon="square-terminal" href="/developer/cli/quickstart">
A predictable command surface (`spree dev`, `spree generate`, `spree migrate`) plus `spree api` — call the Admin API directly to inspect and drive the store, with zero-config credentials in local dev. Agents debug and act end-to-end.
</Card>
</CardGroup>
## A typical agentic workflow
1. **Scaffold** a project with `npx create-spree-app@latest my-store` — it generates an `AGENTS.md`, installs `@spree/docs` for local reference, and wires up the CLI.
2. **Say yes to "Set up AI coding agents?"** — the scaffold installs the agent skills, so your agent knows the decision tree for customizations (subscriber vs decorator vs dependency injection vs generator) before it writes a line of code, and connects it to the docs MCP server, so questions the skills don't cover get answered from the live documentation. In an existing project, run `spree add ai` to get both.
3. **Commit the agent files** (`.agents/skills/`, `.mcp.json`, `.cursor/mcp.json`, `.vscode/mcp.json`) so everyone on the team works with the same setup.
4. **Let the agent work** — generate an API resource (`spree generate api_resource Brand name:string`), customize checkout, integrate a payment provider, or run an upgrade with `spree upgrade`.
<Tip>
Skills, local docs, and MCP are complementary: skills encode *how to do things the Spree way*, local docs give *fast authoritative lookups*, and MCP covers *the latest published documentation*. Most teams use all three.
</Tip>