# Agent 上下文清单

[`agent-context.json`](agent-context.json) 用于按任务类型读取最小上下文，
[`agent-context.schema.json`](agent-context.schema.json) 约束其结构。

## 使用流程

```text
AGENTS.md
 -> agent-context.json
 -> bootstrap.always_read
 -> 当前任务文件
 -> 一个或多个 routes
 -> 代码发现、实现、验证
```

- 同一文件命中多个 route 时只读一次。
- 首次接入、清单缺失或校验失败时，按 `00-ai-start-here.md` 完整顺序读取。
- 仓库未启用 Git 时不能假装存在 `context_ref`；任务 frontmatter 保持 `null`。
- Git 启用后，领取时记录默认分支头 SHA；同一会话文件内容未变可复用。
- 当前代码和真实命令结果高于历史讨论、计划命令和旧截图。
- 远端协调不可用时可以继续已领取任务，但不领取新任务，也不猜测其他执行者状态。

## 权威来源

| 信息 | 权威来源 |
| --- | --- |
| 仓库硬规则 | 最近作用域的 `AGENTS.md` |
| 产品范围 | `02-requirements.md` |
| 架构和状态机 | `04-architecture.md` |
| API 字段 | `api.md` |
| 任务规格、状态和证据 | `docs/tasks/T-<编号>.md` |
| 当前现实 | `current-state.md`、代码和实际验证 |

修改清单引用的路径时，必须验证 JSON 可解析且所有仓库相对路径存在。