Agent-System/.doc/README.md

项目文档总地图

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

---

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

.doc/
  README.md              ← 本文件（总地图）
  status/                ← 模块/功能完成度 SSOT
  audit/                 ← 问题发现与分析、ISSUES.md 问题/修复台账
  remediation/           ← 整改方案与发布缺口
  archive/               ← 历史（只增不删）
  ops/                   ← 活协作（任务、交接、调研；lessons/ 开发经验）
  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/ 随意新建子目录。新文档必须落入上表之一。

---

快速入口

我要…	读这里
Subagent 模型配置 / 流程	可调整模型配置 · PI 执行器 · 流程草案 · 研究依据
规则来源/生效版本	规范登记
选择测试/报告范围	验证契约
任务模板与会话收口	任务模板 · 收口清单
创建任务、集成、部署、清理	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

---

文档生命周期

按 AGENTS 任务分级 选择最小产物。下图是可选信息流，不要求每任务创建所有文件；小任务/有价值的只读审查可由一个主文档承载范围、结论、验证与交接。主文档先明确 task_id、owner、授权来源、状态和证据；跨阶段信息确需独立时才拆分并回链。

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

任务状态字段：planned | in_progress | blocked | done | cancelled。问题以 issue_state、经验以 lesson_state 独立记录，取值与转换见 闭环规范；研究任务完成不关闭待修问题。

会话结束不等于任务完成；只有 done/cancelled 任务归档。CURRENT 保留最多 3 项焦点及活跃/阻塞/待集成/待清理事项，完成认领和长证据迁入 历史快照。移动文档同步修复相对链接，保留证据与来源。规范生命周期另用 proposed/approved/active/deprecated；工具能力另用 manual/enforced。