# 经验教训

## 目的

记录开发过程中学到的东西。每条记录包含：
- 上下文（我们在做什么）
- 问题（出了什么问题/什么让我们意外）
- 教训（学到了什么）
- 行动（因此改变了什么）

---

## L-001: 单体 AGENTS.md 浪费 AI 上下文

**日期**: 2026-05-25
**上下文**: 项目启动阶段，每次 AI 会话都需要读 AGENTS.md 来了解角色和权限
**问题**: AGENTS.md 239 行，约 80% 内容与当前 AI 角色无关。AI 有效上下文被大量无关信息占据
**教训**: 为人类设计的文档结构不适用于 AI 的信息获取模式。AI 需要"最少必要信息"，而不是"全局完整视图"
**行动**: 重构为分层信息架构：角色工作台 → 阶段上下文 → 知识沉淀。AI 只需读 2 个小文件即可开工

---

## L-002

*（待项目推进中记录）*