Agent-System/.doc/README.md

项目文档总地图

Agent 协作纪律见仓库根 AGENTS.md。
当前焦点见 ops/CURRENT.md。

---

文档 taxonomy（禁止随意新建路径）

.doc/
  README.md              ← 本文件（总地图）
  status/                ← 模块/功能完成度 SSOT
  audit/                 ← 问题发现与分析
  remediation/           ← 整改方案与发布缺口
  archive/               ← 历史（只增不删）
  ops/                   ← 活协作（任务、交接、调研）
  system-design/         ← 模块架构深读
  adr/                   ← 架构决策
  backlog/               ← 产品 backlog（非阻塞）
  test-reports/          ← 验收报告（+ assets/ 附件）
  test-fixtures/         ← 测试拓扑说明

仓库根（入口，非内容库）
  AGENTS.md | PROJECT.md | CLAUDE.md | CODEX.md | GEMINI.md | ANTIGRAVITY.md | KIMI.md

红线：不得在 .doc/ 根目录新建大包 Markdown；不得在 docs/ 随意新建子目录。新文档必须落入上表之一。

---

快速入口

我要…	读这里
创建任务、集成、部署、清理	worktree 工作规范
当前在做什么	ops/CURRENT.md
模块完成度	status/FEATURE-MATRIX.md
发布 blocker	remediation/gap-matrix.md
审计/问题分析	audit/INDEX.md
整改方案	remediation/INDEX.md
历史归档	archive/README.md
架构设计	system-design/README.md
测试报告	test-reports/
历史功能设计	archive/design/superpowers/
Herdr 角色、审批与备援	ops/2026-09-13-herdr-agent-roster.md

---

backlog 分工

路径	用途
backlog/	产品侧非阻塞 backlog
ops/long-term/	Agent/工程技术债 backlog

---

文档生命周期

audit（问题）→ remediation（方案）→ ops/short-term（任务）
  → test-reports（验收）→ archive（关闭证据）

状态字段：planned | in_progress | blocked | done | cancelled