36 lines
1.6 KiB
Markdown
36 lines
1.6 KiB
Markdown
|
# 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 上下文
|