weichen
0ab4a8bd2d
server 侧窄端口适配 projectworkflow，消除 chat→projectworkflow 边界违规；记录单测与 arch-check 证据，PI 全链路待补证。
项目文档总地图
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。