- 0
- ybf
- 查看 12
你是一名资深的软件架构师、AI工程顾问和产品架构设计专家。
我准备开发一个「某某类型的 App 或网站」,但不会手动从零编程,而是计划利用 Harness Engineering 或类似 AI 工程平台来生成和协助构建系统。
目前我已经准备了一套 AI工程文档结构,用于指导系统设计与开发,例如:
AGENTS.md
ARCHITECTURE.md
docs/
├── design-docs/
├── exec-plans/
├── generated/
├── product-specs/
├── references/
├── DESIGN.md
├── FRONTEND.md
├── PLANS.md
├── PRODUCT_SENSE.md
├── QUALITY_SCORE.md
├── RELIABILITY.md
└── SECURITY.md
请从“AI工程驱动开发(AI-driven engineering)”的角度,分析在这样的项目结构下,如果我要开发某个 App 或网站,应该在这些文档中补充哪些关键内容,以便:
- AI系统能够理解产品目标
- AI能够生成合理的架构和代码
- 项目能够稳定迭代
- 团队或AI Agent可以协同开发
请重点分析以下内容:
1. 产品信息需要写在哪些文档中
例如:
- 产品定位
- 用户场景
- 核心功能
2. 技术架构应该如何写入 ARCHITECTURE.md
例如:
- 系统模块
- 服务结构
- 数据流
- API结构
3. product-specs 目录中应该如何组织功能说明
例如:
- 每个功能模块如何写
- 如何让 AI 能够理解并生成对应代码
4. design-docs 中应该包含哪些设计原则
例如:
- 设计理念
- UI/UX原则
- 交互规范
5. exec-plans 中如何设计开发执行计划
例如:
- MVP阶段
- 功能开发顺序
- 技术债务管理
6. generated 目录如何用于自动生成内容
例如:
- 数据库 schema
- API文档
- 自动生成配置
7. references 目录如何为 AI 提供参考知识
例如:
- 框架文档
- 设计系统
- 技术规范
8. 还应该补充哪些关键文档
例如:
- API.md
- DATA_MODEL.md
- USER_FLOW.md
- SYSTEM_OVERVIEW.md
请输出:
【推荐的完整 AI工程文档结构】
【每个文档应该包含的关键内容】
【AI如何利用这些文档生成系统】
【开发某个 App / 网站时应该优先补充哪些文档】
【建议的 AI工程工作流程(AI-driven workflow)】




