docs: adopt harness coding workflow

docs/README.md

@@ -0,0 +1,54 @@
+# YoVision 文档导航
+
+YoVision 当前目标是完成默认 16 路的智能视频事件闭环，同时从数据模型、分片、接口和 UI 操作上兼容单站点 128 路横向扩展。
+
+## Agent 入口
+
+- [`../AGENTS.md`](../AGENTS.md)：仓库级规则与唯一工作入口。
+- [AI 开发入口](00-ai-start-here.md)：固定开工、领取、验证与收尾流程。
+- [Agent 上下文清单](agent-context.md) / [`agent-context.json`](agent-context.json) / [`Schema`](agent-context.schema.json)：按任务类型读取最小上下文。
+- [当前实现状态](current-state.md)：代码现实、可运行命令、blocker。
+- [编码规则](05-coding-rules.md)：写代码前必须遵守的硬约束。
+
+## 产品与架构
+
+- [项目愿景](01-vision.md)：为什么做、为谁做、产品原则与非目标。
+- [需求](02-requirements.md)：MVP、P0、容量和验收。
+- [技术栈](03-tech-stack.md)：既定组件、待定项、运行与验证矩阵。
+- [架构设计](04-architecture.md)：Sense/Brain/Bell 边界、数据流与扩展约束。
+- [任务路线图](06-tasks.md)：M0–M6 阶段和建议任务；不维护实时状态。
+- [用户故事](07-user-stories.md)：业务目标、价值、验收场景。
+- [交互清单](08-interaction-checklist.md)：Web/App/值班台的状态、反馈和无障碍门禁。
+- [API 合约](api.md)：已冻结事件契约和待冻结内部/外部接口。
+- [路由与页面](routes.md)：页面职责和导航边界。
+- [设计原型约定](design/README.md)：P0 UI 开工前的 HTML 原型输入。
+
+## 任务与协作
+
+- [任务文件](tasks/README.md)：`docs/tasks/T-<编号>.md` 保存规格与长期证据；实时状态在 Gitea Issue。
+- [Gitea MCP](gitea-mcp.md)：本机私有配置、工具审批和断连降级。
+- [Gitea 协作协议](gitea-collaboration.md)：Issue、claim、工作分支、PR 和写路径防撞。
+- [收尾清单](clean-state-checklist.md)：保证下一轮可恢复。
+- [方法对照表](method-map.md)：失败模式到首要治理工件。
+- [评审评分表](evaluator-rubric.md)：单次交付质量评审。
+- [质量文档](quality-document.md)：长期健康度追踪。
+
+## 原始与追溯资料
+
+- [`raw/01-需求收集.md`](raw/01-需求收集.md)：完整需求条目与待确认问题。
+- [`raw/02-需求分析.md`](raw/02-需求分析.md)：分层、领域模型、状态机、容量与风险推导。
+- [`raw/03-通用场景应用方案.md`](raw/03-通用场景应用方案.md)：组件选型、NVR 决策、部署与演进方案。
+- [`raw/08-三系统职责划分.md`](raw/08-三系统职责划分.md)：Sense/Brain/Bell 的详细目录和七条边界。
+- [`raw/contracts/README.md`](raw/contracts/README.md)：事件契约 v0.1 的冻结说明与代码级断言。
+
+`raw/04` 至 `raw/06` 是目标客户方案，`raw/07` 是 silver_pose 契约比对。`其他项目的文档/` 只作历史参考，不是当前实现依据。
+
+## 权威性
+
+- 实现入口：本文列出的 harness 文档。
+- 决策追溯：`docs/raw/`。
+- 事件字段与语义：`docs/raw/contracts/`。
+- 实时任务状态：Gitea Issue。
+- 任务规格与证据：`docs/tasks/T-<编号>.md`。
+
+发现冲突时先修正文档和任务，不得靠聊天记忆继续实现。