# Agent 文档

这个目录专门放面向 AI / agent 的项目材料，不和内核设计文档混放。

根入口文档在仓库根目录的 `AGENTS.md`。

建议内容：

- `session-notes/`：实现日志和阶段结论。
- `tasks/`：适合 agent 执行的边界清晰任务。
- `prompts/`：可复用提示词和约束。
- `checklists/`：启动、验证、回归检查单。

正式架构决策仍然放在 `docs/`，然后在 agent 任务文档里引用它们。

当 agent 修改代码且影响下列内容时，应该同步更新这里或 `docs/`：

- 架构边界
- 目录结构
- 构建方式
- 阶段计划
- 协作约定