@spree/docs 0.1.87 → 0.1.88
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -72,4 +72,4 @@ Any MCP client that supports remote servers over streamable HTTP can connect —
|
|
|
72
72
|
| **[`@spree/docs` npm package](llm-docs.md)** | Fast local reads inside a project — no network round-trip, works offline, pinned to what you installed |
|
|
73
73
|
| **[Agent skills](agent-skills.md)** | Conventions and how-to knowledge the agent should apply without searching at all |
|
|
74
74
|
|
|
75
|
-
> **NOTE:** In create-spree-app projects the generated `CLAUDE.md` already points agents at the local `@spree/docs` package first — MCP complements it for anything newer than your installed docs version.
|
|
75
|
+
> **NOTE:** In create-spree-app projects the generated `AGENTS.md` and `CLAUDE.md` already points agents at the local `@spree/docs` package first — MCP complements it for anything newer than your installed docs version.
|
|
@@ -8,9 +8,10 @@ Spree ships first-class tooling for AI-assisted development. Whether you use Cla
|
|
|
8
8
|
|
|
9
9
|
## Why Spree works well with AI agents
|
|
10
10
|
|
|
11
|
-
- **Strong conventions** — everything is namespaced under `Spree
|
|
11
|
+
- **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.
|
|
12
|
+
- **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.
|
|
12
13
|
- **Docs designed for machine consumption** — the full documentation is available as [llms.txt, per-page Markdown, and a local npm package](llm-docs.md), so agents read authoritative content instead of guessing from training data.
|
|
13
|
-
- **A guided project workflow** — [create-spree-app](../create-spree-app/quickstart.md) scaffolds projects with a generated `CLAUDE.md`, local docs, and the [Spree CLI](../cli/quickstart.md), so an agent can boot, migrate, generate code, and run tests without bespoke setup.
|
|
14
|
+
- **A guided project workflow** — [create-spree-app](../create-spree-app/quickstart.md) scaffolds projects with a generated `AGENTS.md` and `CLAUDE.md`, local docs, and the [Spree CLI](../cli/quickstart.md), so an agent can boot, migrate, generate code, and run tests without bespoke setup.
|
|
14
15
|
|
|
15
16
|
## The toolbox
|
|
16
17
|
|