AI-assisted development

The starter repo is designed so coding agents stay on-system.

Read first

In store-cay-starter:

Path	Purpose
CLAUDE.md	Entry brief for Claude / similar agents
.agents/rules/architecture.md	Rendering model, routing, Tailwind, edge constraints
.agents/rules/astro-conventions.md	Island hydration and state
.agents/skills/building-storefronts/	Storefront SDK / API patterns
.agents/skills/storefront-best-practices/	UI/UX and layout references

Commands agents should use

npm run dev
npm run build

Package manager is npm. Lint with ESLint v9 flat config; format with Prettier (+ prettier-plugin-astro).

Hard constraints (summary)

• Single Worker: storefront + /api/* + /admin — no separate Node backend
• Data in D1 (Drizzle); images in R2 via STORAGE
• React only as islands where interaction needs it
• Secrets via Wrangler / .env, never in store.config.ts
• Guest checkout only — no customer accounts in the current template

When extending the shop, prefer existing modules under src/modules and Admin APIs under src/pages/api over introducing a second runtime.