tupingr
4184a6d0b5
新增四层信息架构： - 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>
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 上下文
|