docs: establish project harness baseline

2026-07-25 16:59:06 +08:00
commit 50a6d8ee5b
30 changed files with 2742 additions and 0 deletions
@@ -0,0 +1,35 @@
+# 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 可解析且所有仓库相对路径存在。