# AGENTS.md

## 目录作用

- 存放项目导航层和当前任务 / 计划上下文模板，对应安装后项目的 `docs/ai/*`。

## 结构索引

- `repo-map.md`：代码地图和规则索引。
- `architecture-brief.md`：架构摘要。
- `CURRENT_TASK.md`：当前任务最小事实。
- `PROJECT_CONTEXT.md` / `DECISIONS.md` / `KNOWN_ISSUES.md`：扩展上下文。
- `API_MAP.md` / `DB_SCHEMA.md`：接口与数据面索引。
- `dev-plan.md` / `feature-pack.md`：计划和跨会话语义包。

## 修改规则

- 保持“短事实、可导航、可续跑”，不要把长篇 PRD 或实现细节堆进 context 模板。
- 与 `docs/`、`product/`、`spec/`、`testing/` 的 truth source 分工必须清楚。
