AI 辅助开发

starter 仓库 有意让编码 Agent 保持 on-system。

先读

在 store-cay-starter 中：

路径	用途
CLAUDE.md	Claude 等 Agent 入口说明
.agents/rules/architecture.md	渲染模型、路由、Tailwind、边缘约束
.agents/rules/astro-conventions.md	Island 水合与状态
.agents/skills/building-storefronts/	前台 SDK / API 模式
.agents/skills/storefront-best-practices/	UI/UX 与布局参考

Agent 应使用的命令

npm run dev
npm run build

包管理器是 npm。Lint：ESLint v9 flat；格式化：Prettier（含 prettier-plugin-astro）。

硬约束（摘要）

• 单 Worker：前台 + /api/* + /admin — 无第二套 Node 后端
• 数据在 D1（Drizzle）；图片在 R2 STORAGE
• 仅在需要交互处使用 React islands
• 密钥走 Wrangler / .env，绝不进 store.config.ts
• 仅游客结账 — 当前模版无顾客账号

扩展店铺时，优先复用 src/modules 与 src/pages/api，避免再引入一套运行时。