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,35 @@
|
||||
# 2026-05-25 — 信息架构重构
|
||||
|
||||
## 做了什么
|
||||
|
||||
完成项目信息架构从"人类导向单体文档"到"AI 优先分层架构"的全面重构。
|
||||
|
||||
### 新增 (~35 个文件)
|
||||
|
||||
- **角色工作台** (`.ai/roles/`): 为 Arch/Dev/QA 三个 AI 角色各创建 card.md + today.md + queue.md,AI 每天只需读 2 个小文件即可开工
|
||||
- **阶段上下文** (`.ai/phases/`): Phase 1-4 的阶段目标、范围、架构决策文档。当前 Phase 1 已填充,Phase 2-4 为模板占位
|
||||
- **知识沉淀** (`.ai/knowledge/`): decisions.md(迁移 6 个旧 ADR + 新增 ADR-007)、patterns.md、lessons.md
|
||||
- **架构提示词** (`.ai/prompts/architecture/`): 补充之前缺失的架构设计和技术选型模板
|
||||
- **分享层** (`.ai/share/`): 阶段复盘模板、决策故事模板、项目缘起和框架设计思路占位
|
||||
- **人类仪表盘** (DASHBOARD.md): 根目录,30 秒可读
|
||||
- **路线图看板** (ROADMAP.md): 阶段进度 + 任务看板 + 阻塞项,人机共享
|
||||
- **任务索引** (review/active/INDEX.md): 所有活跃任务一览
|
||||
|
||||
### 修改 (6 个文件)
|
||||
|
||||
- AGENTS.md: 239 行 → ~120 行,顶部 AI 跳转
|
||||
- README.md: 精简,聚焦人类读者
|
||||
- docs/PROJECT_CONTEXT.md: 精简,加跳转链接
|
||||
- docs/DECISIONS.md: 替换为跳转存根
|
||||
- 5 个 task.md: 添加 phase 字段
|
||||
|
||||
## 关键决策
|
||||
|
||||
1. 分层信息架构:工作台 → 路线图 → 阶段上下文 → 知识沉淀
|
||||
2. Token 预算制度:每个文件标注预算上限
|
||||
3. "一鸡多吃":开发过程自动沉淀为可分享内容
|
||||
4. 角色工作台代替全局 AGENTS.md 作为 AI 入口
|
||||
|
||||
## 经验教训
|
||||
|
||||
见 lessons.md L-001: 单体 AGENTS.md 浪费 AI 上下文
|
||||
Reference in New Issue
Block a user