Files
ai_soc_sw/.ai/phases/phase-01-foundation/decisions.md
T
tupingr 4184a6d0b5 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>
2026-05-25 16:49:36 +08:00

1.0 KiB

Phase 1: 基础搭建 — 阶段决策

本文件记录在 Phase 1 执行过程中产生的决策(区别于全局 ADR)。

D-001: 信息架构分层设计

  • 日期: 2026-05-25
  • 状态: 已采纳
  • 决策: 采用 token 预算的分层架构(工作台 → 阶段 → 知识 → 分享)
  • 理由: AI 上下文窗口有限,旧 AGENTS.md 单体文件浪费 token
  • 影响: 所有 AI 从 .ai/roles/{role}/ 启动,不再从 AGENTS.md 启动

D-002: 阶段化上下文加载

  • 日期: 2026-05-25
  • 状态: 已采纳
  • 决策: AI 只加载当前 Phase 的上下文,不加载所有历史
  • 理由: 未来阶段技术栈和侧重点可能不同,历史信息反而干扰
  • 影响: 阶段包必须自包含、可独立阅读

D-003: 角色工作台代替全局入口

  • 日期: 2026-05-25
  • 状态: 已采纳
  • 决策: 用 today.md + queue.md 替代从 AGENTS.md 找任务
  • 理由: AI 不需要理解整个项目结构,只需要知道自己该干什么
  • 影响: Arch AI 负责维护各角色的任务分配