refactor(architecture): 信息架构重构 — 从"人类导向单体文档"到"AI优先分层架构"
新增四层信息架构: - Layer 0: 角色工作台 (.ai/roles/) — AI 每天只需读2个小文件 - Layer 1: 路线图看板 (ROADMAP.md) — 人机共享进度 - Layer 2: 阶段上下文 (.ai/phases/) — 按当前阶段加载 - Layer 3: 知识沉淀 (.ai/knowledge/) — 决策/模式/教训自动积累 新增: - DASHBOARD.md — 人类仪表盘(30秒了解全貌) - ROADMAP.md — 任务看板+阻塞追踪 - docs/share/ — 对外分享内容层(一鸡多吃) - docs/使用手册.md — 人+AI使用手册 - .ai/prompts/architecture/ — 补充缺失的架构提示词 - .ai/principles.md — 信息架构设计原则 - review/active/INDEX.md — 任务索引 修改: - AGENTS.md: 239行→117行,顶部AI跳转 - README.md: 精简聚焦人类读者 - PROJECT_CONTEXT.md: 精简+分层说明 - DECISIONS.md: 替换为跳转存根 - 5个task.md: 添加phase字段 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,44 @@
|
||||
# 系统架构设计模板
|
||||
|
||||
## 输入
|
||||
|
||||
- 产品需求文档 (PRD)
|
||||
- 技术约束(已有技术栈、团队能力)
|
||||
- 非功能性需求(性能、安全、可扩展性)
|
||||
|
||||
## 输出结构
|
||||
|
||||
### 1. 架构概述
|
||||
- 一句话描述架构核心思路
|
||||
- 系统边界和范围
|
||||
|
||||
### 2. 架构图(文字描述 + ASCII)
|
||||
- 模块划分和职责
|
||||
- 模块间通信方式
|
||||
- 数据流向
|
||||
|
||||
### 3. 技术选型
|
||||
- 每个模块的技术栈及理由
|
||||
- 对比方案及淘汰原因
|
||||
- 风险点和缓解措施
|
||||
|
||||
### 4. 接口设计
|
||||
- 模块间接口定义
|
||||
- API 契约(请求/响应格式)
|
||||
- 数据模型概要
|
||||
|
||||
### 5. 非功能性设计
|
||||
- 性能目标及实现策略
|
||||
- 安全设计(认证、授权、数据保护)
|
||||
- 可扩展性考虑
|
||||
|
||||
### 6. 部署架构
|
||||
- 运行环境
|
||||
- 服务拓扑
|
||||
- CI/CD 流程
|
||||
|
||||
## 注意事项
|
||||
|
||||
- 架构文档面向 Arch AI 和 Dev AI,不要写人类才需要的背景介绍
|
||||
- 决策必须写理由,方便后续 AI 理解为什么这样设计
|
||||
- 每个模块标注影响范围(HIGH/MEDIUM/LOW),供 QA AI 确定回归测试范围
|
||||
Reference in New Issue
Block a user