# .agent 文档入口 / .agent documentation entrypoint

这个文件主要给在 `.agent/` 目录里浏览的人类读者看。
真正会被 Codex 自动发现的入口，应当放在仓库根目录的 `AGENTS.md`。
This file is mainly a convenience note for humans browsing inside `.agent/`.
The auto-discovery entrypoint for Codex should live at the repo-root `AGENTS.md`.

## 快速规则 / Quick rules

- 复杂任务请先读 `.agent/PLANS.md` 与相关活跃 ExecPlan。
  For complex work, read `.agent/PLANS.md` and the relevant active ExecPlan first.
- 如果计划已存在，直接从下一个未完成里程碑继续。
  If a plan already exists, continue from the next unfinished milestone.
- 还有未完成里程碑时，不要为了状态汇报停下。
  Do not stop for status updates while unfinished milestones remain.
- 停止前更新 `Status`、`Progress`、`Surprises & Discoveries`、`Decision Log`、`Outcomes & Retrospective`。
  Before stopping, update `Status`, `Progress`, `Surprises & Discoveries`, `Decision Log`, and `Outcomes & Retrospective`.