web-platform-base

一个面向 AI 开发的前端 monorepo 模板，内置项目元信息、共享设计 token、统一工程配置和分层规则体系。

技术栈

• pnpm workspace
• turbo
• React
• TypeScript
• Vite
• Tailwind CSS
• ESLint
• Prettier
• Stylelint
• Husky
• lint-staged

目录结构

web-platform-base/
├── apps/
│   └── web
├── packages/
│   ├── design-tokens
│   ├── eslint-config
│   ├── tailwind-config
│   ├── tsconfig
│   ├── ui
│   └── utils
├── docs/
├── .github/
└── scripts/

快速开始

pnpm install
pnpm dev

常用命令

pnpm dev
pnpm build
pnpm lint
pnpm typecheck
pnpm test
pnpm validate:project
pnpm verify
pnpm format:write

规则入口

• 项目事实配置见 project.config.json
• 全局硬约束见 AGENTS.md
• 规则分层和新增规则位置见 docs/rule-system.md
• 开发执行手册见 docs/ai-handbook.md
• 任务输入模板见 docs/tasking.md

规则扩展约定

• 所有应用共享规则优先放在 apps/AGENTS.md
• 所有共享包通用规则优先放在 packages/AGENTS.md
• 单目录专属规则放在该目录自己的 AGENTS.md
• 修改项目元信息后先执行 pnpm validate:project
• 完成修改后统一执行 pnpm verify

标准使用路径

1. 提任务前先看 docs/tasking.md
2. 判断规则落点时先看 docs/rule-system.md
3. 开发时读取根目录和目标目录下的 AGENTS.md，必要时再看 docs/ai-handbook.md
4. 交付前统一执行 pnpm verify

工程补齐项

• PR 模板位于 .github/pull_request_template.md
• AI 任务 Issue 模板位于 .github/ISSUE_TEMPLATE/ai-task.md
• CI 校验工作流位于 .github/workflows/ci.yml

初始化 Git Hook

仓库初始化 Git 后执行一次：

pnpm install

prepare 脚本会在检测到 .git 目录后自动安装 husky。