# 从点子到产品工作流

## 唯一事实来源

- `docs/REQUIREMENTS.md` 是当前版本产品范围的唯一来源。
- `docs/IMPLEMENTATION.md` 保存已经确认的技术实施方案。
- `.ai-project/state.yaml` 记录当前阶段和人工确认结果。
- `docs/FEATURES.md` 记录纵向功能切片进度。
- `docs/ACCEPTANCE.md` 记录验收证据。

## 人工确认门

- 完成需求草案后停止，等待明确人工确认。
- 完成实施方案后停止，等待明确人工确认。
- 生成并验证项目骨架后停止，等待明确人工确认。
- 三个阶段门全部通过前，不得开始纵向功能开发。
- 完成功能验收后停止，等待明确人工确认。

## 开发规则

- 默认项目已经立项，不进行市场、竞品、需求价值或商业价值分析。
- 不得扩大已经冻结的当前版本范围。
- 新想法记录到后续版本。
- 每次只开发一个完整的纵向功能切片。
- 每个纵向功能切片完成并验证后必须暂停，通知用户查看；只有用户明确确认当前切片后，才能把下一切片标记为“进行中”或开始实现。
- 每个切片覆盖所有适用的界面、接口或服务、数据持久化、权限、校验、异常状态、日志和测试。
- 修改前先检查现有代码。
- 实际运行项目规定的格式或静态检查、类型检查、测试和生产构建。
- 不得通过删除或跳过测试获得通过结果。
- 绝不提交真实密钥。
- 保留与当前任务无关的用户修改。

## 项目专项规则

- 保持 `local file -> agent core -> web serve -> web` 的依赖方向。
- Agent Core 不得依赖 Web 层，为后续 `local file -> agent core -> cli` 保留扩展边界。
- 避免大文件；模块按单一职责拆分。出现同时承担协议、业务和存储职责的文件时必须拆分。
- Web 组件私有样式与对应组件文件放在同一目录，例如 `sidebar.ts` 对应 `sidebar.css`；`styles/` 只保存设计令牌、全局 reset 和确实跨组件的基础样式，不创建与功能目录重复的样式镜像树。
- 当前版本为单人使用，不引入多租户、多用户或分布式并发设计。
- 访问保护由部署环境中的外部反向代理承担；应用内不得实现登录页面、身份校验中间件、用户会话或访问凭据配置。