ai_soc_sw/.ai/knowledge/journal/2026-05-25.md

# 2026-05-25 — 信息架构重构 + 模板化

## 做了什么

### 1. 信息架构重构（Arch AI 角色）
将项目从"人类导向单体文档"重构为"AI 优先分层架构"：

**新增四层信息架构：**
- Layer 0: 角色工作台 `.ai/roles/{arch,dev,qa}/` — 每个 AI 每天只读 card.md + today.md（< 2K tokens）
- Layer 1: 路线图看板 `ROADMAP.md` — 人+AI 共享进度
- Layer 2: 阶段上下文 `.ai/phases/phase-NN/` — 按需加载（< 5K tokens）
- Layer 3: 知识沉淀 `.ai/knowledge/` — 自动积累决策/模式/教训

**新增关键文件：**
- `DASHBOARD.md` — 人类仪表盘（根目录，30 秒可读）
- `ROADMAP.md` — 阶段进度 + 任务看板 + 阻塞项
- `docs/使用手册.md` — 人+AI 完整使用手册
- `.ai/principles.md` — 信息架构设计原则
- `.ai/prompts/architecture/` — 补充缺失的架构提示词模板

**压缩改写：**
- AGENTS.md: 239行 → 117行
- README.md: 167行 → 88行
- PROJECT_CONTEXT.md: 117行 → 52行

**一鸡多吃分享层：**
- `docs/share/` — 阶段复盘模板、决策故事模板

### 2. 项目模板化（ai_project 分支）
将 ErrLens 框架去敏化为通用 AI 协作项目模板：

- 创建 `TEMPLATE.yaml` — 14 个模板变量定义
- 创建 `init.sh` — 一键初始化新项目的脚本
- 创建 `sync-template.sh` — 从 main 同步框架层到模板分支
- 创建 `SYNC.md` — 框架层/项目层边界定义
- 98 处 {{变量}} 覆盖所有关键位置
- 双分支策略：main（具体项目） + ai_project（通用模板）

### 3. 知识沉淀
- ADR-007: 分层信息架构 + Token 预算
- ADR-008: 框架/项目双分支 + 同步机制
- P-001: AI 任务交接模式
- P-002: 角色工作台模式
- P-003: 模板同步模式
- L-001: 单体 AGENTS.md 浪费 AI 上下文

## 当前状态

- 分支: main（ErrLens 开发）
- 阶段: Phase 1 基础搭建，进度 ~40%
- 信息架构重构: ✅ 完成
- 模板化: ✅ 完成（在 ai_project 分支）
- 所有代码已推送远程

## 下一步（明天继续）

Arch AI 下一步:
1. 编写 `docs/01_产品需求/PRD.md` — 错题本产品需求文档
2. 设计 `docs/02_系统架构/` — 系统架构文档
3. 将 P01 项目文档从"代码检测"改写为"错题本"

## Git 提交记录
- 4184a6d: 信息架构重构（main）
- 0df22a2: 去敏化为模板（ai_project）
- 05b87a9: 模板同步机制（ai_project）
- 46af1f8: ADR-008 + P-003（ai_project）

## 注意
- ai_project 分支上还有 ADR-008 和 P-003，main 上尚未同步（本次会补上）
- 如果明天接不上，读 DASHBOARD.md + .ai/roles/arch/card.md + .ai/roles/arch/today.md 即可