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>
1.6 KiB
1.6 KiB
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 字段
关键决策
- 分层信息架构：工作台 → 路线图 → 阶段上下文 → 知识沉淀
- Token 预算制度：每个文件标注预算上限
- "一鸡多吃"：开发过程自动沉淀为可分享内容
- 角色工作台代替全局 AGENTS.md 作为 AI 入口
经验教训
见 lessons.md L-001: 单体 AGENTS.md 浪费 AI 上下文