cmroubao/docs/agent-context.md

Agent 上下文清单

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

使用流程

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 可解析且所有仓库相对路径存在。