状态：重设计 baseline 已定。
docs/00-redesign-target.md到docs/10-rebuild-plan.md是新实现的唯一入口；旧 Phase 1/2 文档和旧代码只作历史参考，不能作为实现起点或补丁队列。
Agenteam 基于 @earendil-works/pi-coding-agent 作为内嵌 runtime kernel，但对外呈现为 Agenteam 自己的多 agent 编排系统。
核心原则：
- Pi 是内核，不外显为产品/架构层。
- Agenteam 负责 channels、agents、config、policy、observability、memory/wiki、cron/heartbeat。
- 配置真相源是
~/.agenteam/agenteam.json+ agent workspace 的可选agenteam.agent.json。 - 先写 Spec + fixtures，再 TDD 实现。
以下清单是 #128 rebuild 的唯一实现依据。实现 issue / PR 必须引用这里的具体章节；未列入本节的旧文档、旧 issue、旧 PR、旧代码只能用于风险排查和行为对照，不能覆盖 canonical spec。
| 文件 | 内容 | 当前用途 |
|---|---|---|
| 00-redesign-target.md | 重设计 baseline 全文 | 总入口 |
| 01-architecture.md | 目标架构、不变量、目录边界 | 实现前必读 |
| 02-config.md | 全局配置 + agent-local 配置 | config issue 来源 |
| 03-runtime.md | runtime 边界、mode、Pi 类型隔离 | runtime issue 来源 |
| 04-message-routing.md | account ownership、DM/group/proactive 场景表 | routing issue 来源 |
| 05-observability-debug.md | 日志、AI debug JSON、redaction、retention | observability issue 来源 |
| 06-cron-heartbeat-decision.md | cron、heartbeat、轻量决策引擎 | automation issue 来源 |
| 07-memory-wiki.md | 分层记忆、memory plugin、项目 wiki | memory/wiki issue 来源 |
| 08-ci-tdd-policy.md | CI、TDD、coverage、issue/PR 验收格式 | 所有实现 issue 适用 |
| 09-security-policy.md | sender gate、外部内容隔离、tool/exec approval、outbound guard、audit policy | security/policy issue 来源 |
| 10-rebuild-plan.md | 从 spec 重建的顺序、PR 切分、依赖关系、每步验收 | #128 / #129 后续执行计划 |
以下文档暂不删除，但全部冻结。它们只能作为历史参考、风险排查或迁移对照；不得作为新实现的起点，不得作为 #130-#140 的验收依据，也不得用来反驳 Canonical Docs：
- DECISIONS.md — legacy/frozen；不是当前“已锁定决策”来源。
- MILESTONES.md — legacy/frozen；旧 Phase 1/2 里程碑，不作为新实现计划。
- implementation-notes.md — legacy/frozen；旧实现记录，不作为新 baseline。
- 12-references.md — legacy/frozen；参考资料，不能覆盖 canonical Spec。
- appendix-A-tmux-jsonl-legacy.md — legacy/frozen；旧 tmux JSONL 方案已弃用。
- 02-session-model.md
- 03-runtime-adapters.md（将被
03-runtime.md替代；若存在说明还未清理） - 05-group-chat.md
- 06-mcp-tools.md
- 07-memory.md
- 08-cron-heartbeat.md
- 09-security.md — legacy/frozen；当前安全实现依据是
09-security-policy.md。 - 10-skill-system.md
- 11-session-startup.md
- 13-prompt-state-boundaries.md
- model-routing-config.md（将并入
02-config.md） - 14-redesign-gap-plan.md — historical transition plan；只用于理解 #125 扫描过的旧代码差距，不作为 #128 rebuild 实现依据。
- 每个实现 issue 必须先读 Canonical Docs 对应章节，禁止从旧 issue / 旧 PR / 旧实现推断需求。
- 每个实现 issue 必须先写失败测试，再实现。
- 每个 PR 必须跑
pnpm lint/pnpm build/pnpm test。 - 高风险边界必须有 focused tests，不用形式主义追 100%。
- 旧实现当前冻结，只能参考，不能作为新实现起点；#130 之前不得清空旧实现，#130 之后按 rebuild plan 小 PR 推进。