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
parent 5dfc382c55
commit 4184a6d0b5
65 changed files with 1642 additions and 582 deletions
@@ -0,0 +1,5 @@
+# 项目缘起
+
+> *（待写：由 Arch AI 在 PRD 完成后撰写）*
+>
+> 内容包括：为什么要做错题本、解决什么痛点、为什么选择这个技术方案、为什么用 AI 协作模式。
@@ -0,0 +1,8 @@
+# 框架设计思路
+
+> *（待写：信息架构重构稳定后撰写）*
+>
+> 内容包括：为什么传统的项目文档结构对 AI 不友好、分层信息架构的设计思考、token 预算的概念、"一鸡多吃"的分享层设计。
+>
+> 对应 ADR：ADR-007
+> 背景参考：`.ai/principles.md`
@@ -0,0 +1,41 @@
+# 分享内容
+
+这里记录 ErrLens 从零到一的完整开发过程。每一个决策、每一次踩坑、每一个阶段性成果，都会沉淀到这里。
+
+**目标读者**：对 AI 辅助编程感兴趣的人、想做类似项目的人、未来的自己。
+
+---
+
+## 内容目录
+
+| 文件 | 说明 | 状态 |
+|------|------|------|
+| [00_项目缘起.md](00_项目缘起.md) | 为什么要做这个项目 | 待写 |
+| [01_框架设计思路.md](01_框架设计思路.md) | 信息架构为什么这样设计 | 待写 |
+
+## 按阶段
+
+| 阶段 | 复盘 | 决策故事 | 状态 |
+|------|------|----------|------|
+| Phase 1: 基础搭建 | [阶段复盘](phase-01/阶段复盘_基础搭建.md) | [ADR-007 故事](phase-01/决策故事_ADR-007.md) | 待写 |
+| Phase 2: MVP | — | — | 未开始 |
+
+---
+
+## 分享原则
+
+1. **不是做完再写**：开发过程中自动积累，阶段结束时翻译为对外语言
+2. **去掉内部细节**：不暴露 API 密钥、服务器地址、个人信息
+3. **加上思考过程**：不只说"做了什么"，更要说"为什么这么选"
+4. **可独立阅读**：每篇文章自成一体，不需要读其他文章才能理解
+
+## 内容来源
+
+```
+开发过程中的产出          →    对外分享内容
+─────────────────────────────────────────────
+.ai/knowledge/decisions.md   →  决策故事（加背景、加思考）
+.ai/phases/*/completion.md   →  阶段复盘（扩展为文章）
+.ai/knowledge/lessons.md     →  踩坑记录（精选）
+.ai/knowledge/journal/       →  开发周记（合并精选）
+```
@@ -0,0 +1,5 @@
+# ADR-007 决策故事
+
+> 信息架构为什么从"单体文档"变成"分层设计"
+>
+> *（Phase 1 完成时撰写，基于 `.ai/knowledge/decisions.md` 中的 ADR-007 扩展）*
@@ -0,0 +1,3 @@
+# Phase 1: 基础搭建 — 阶段复盘
+
+> *（Phase 1 完成时由 Arch AI 撰写，基于 `.ai/phases/phase-01-foundation/completion.md` 扩展）*
@@ -0,0 +1,38 @@
+# 决策故事模板
+
+## 决策编号
+
+ADR-XXX
+
+## 标题
+
+用一句话描述这个决策（吸引人的标题）
+
+## 背景
+
+- 当时在做什么
+- 遇到了什么问题
+- 有哪些约束条件
+
+## 选项
+
+| 选项 | 优势 | 劣势 |
+|------|------|------|
+| A | ... | ... |
+| B | ... | ... |
+| C | ... | ... |
+
+## 思考过程
+
+- 为什么排除了某个选项
+- 最纠结的点是什么
+- 最终决策的关键因素
+
+## 结果
+
+- 决策带来的影响
+- 如果有机会重来，会改变什么
+
+## 一句话总结
+
+（可引用/可传播的一句话）
@@ -0,0 +1,35 @@
+# 阶段复盘模板
+
+## 阶段信息
+
+- 阶段编号：Phase N
+- 阶段名称：
+- 时间范围：
+- 参与角色：
+
+## 做了什么
+
+- （列表形式概述本阶段完成的主要工作）
+
+## 关键决策
+
+- （本阶段最重要的 3-5 个决策及背后的思考）
+
+## 踩过的坑
+
+- （本阶段遇到的主要问题及解决方案）
+
+## 学到的东西
+
+- （可复用的经验教训）
+
+## 数据
+
+- 新增代码行数：
+- 任务完成数：
+- Bug 修复数：
+- 测试覆盖率：
+
+## 下一阶段预告
+
+- （接下来要做什么）