# 项目文档总地图

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

---

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

```text
.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/` 随意新建子目录。新文档必须落入上表之一。

---

## 快速入口

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

---

## backlog 分工

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

---

## 文档生命周期

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

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