ajy/openspec/changes/project-init/design.md

设计方案：项目初始化

架构决策

1. Monorepo 结构

使用 pnpm workspace 管理前后端分离的应用：

ajy/
├── apps/
│   ├── web/          # React SPA
│   └── api/          # Express API
├── packages/
│   └── shared/       # 共享类型定义
└── openspec/         # 规范管理

决策理由:

• 代码复用（共享类型）
• 统一依赖管理
• 原子化提交

2. 技术选型

层级	技术	理由
前端框架	React 18	生态成熟，团队熟悉
构建工具	Vite	快速 HMR，配置简单
状态管理	Zustand	轻量，TypeScript 友好
UI 框架	Tailwind CSS	原子化样式，开发效率高
后端框架	Express	轻量，中间件生态丰富
ORM	Prisma	类型安全，迁移管理
数据库	SQLite → PostgreSQL	开发便捷，生产可扩展

3. OpenCode 铁三角集成

┌─────────────────────────────────────────┐
│           OpenCode IDE                  │
└─────────────────────────────────────────┘
                    │
    ┌───────────────┼───────────────┐
    │               │               │
    ▼               ▼               ▼
┌─────────┐   ┌──────────┐   ┌──────────┐
│OpenSpec │   │Superpowers│   │   OMO    │
│规范层   │   │  流程层   │   │ 执行层   │
└─────────┘   └──────────┘   └──────────┘
    │               │               │
    │  specs/       │ 技能强制      │ 多智能体
    │  changes/     │ TDD/审查      │ 并行执行
    │               │               │
    └───────────────┴───────────────┘
                    │
            ┌───────┴───────┐
            ▼               ▼
    ┌──────────────┐ ┌──────────────┐
    │   AGENTS.md  │ │   实际代码   │
    │  知识库指南   │ │  规范+灵活   │
    └──────────────┘ └──────────────┘

4. Superpowers 技能映射

开发阶段	触发技能	作用
需求澄清	brainstorming	苏格拉底式提问，明确需求
任务规划	writing-plans	拆解为 2-5 分钟小任务
代码隔离	using-git-worktrees	创建隔离工作空间
并行开发	subagent-driven-development	多子代理并行执行
测试驱动	test-driven-development	RED-GREEN-REFACTOR
代码审查	requesting-code-review	强制审查阻塞
分支完成	finishing-a-development-branch	合并选项

5. AGENTS.md 层级设计

ajy/AGENTS.md                    # 根级：全局约定
├── apps/web/AGENTS.md           # 前端：React/Vite 特定
├── apps/api/AGENTS.md           # 后端：Express/Prisma 特定
└── packages/shared/AGENTS.md    # 共享包：类型约定

评分标准：

• 根目录 (.)：必须创建（全局配置）
• 应用目录 (>15 分)：独立技术栈，需要 AGENTS.md
• 工具目录 (<8 分)：父级覆盖即可

实施步骤

Wave 1: 基础架构

1. 初始化 pnpm workspace
2. 配置 ESLint + Prettier
3. 创建 TypeScript 基础配置

Wave 2: 前端应用

1. 创建 Vite + React 项目
2. 配置 Tailwind CSS
3. 添加 Zustand 状态管理
4. 创建基础页面结构

Wave 3: 后端应用

1. 创建 Express 项目
2. 配置 Prisma ORM
3. 创建基础 API 路由
4. 添加错误处理中间件

Wave 4: 共享包

1. 创建 shared 包
2. 定义 API 类型
3. 定义数据库模型类型

Wave 5: 集成与测试

1. 配置开发脚本
2. 创建端到端测试
3. 验证完整工作流

回滚策略

每个 Wave 完成后提交 Git，可随时回退到上一稳定状态。