architect-doc

name	architect-doc
description	维护 .ai_state/architecture/ 长效档案 (项目现状档). Refactor/System 路径完成后强制更新 ARCHITECTURE.md 总入口 + {type}-{slug}.md 子系统档. 注: 不同于 cx 端的 architect.toml subagent (后者是 design stage 工作者).
effort	medium

/architect-doc — 架构现状档维护 (v9.6.4 Sprint D 新)

触发时机

时机	强制度	责任
System 路径 ship 完成	强制	主 agent
Refactor 路径改动 ≥ 5 文件	强制	主 agent
用户显式 /architect-doc update {type}-{slug}	触发	主 agent
Feature 路径完成 (新增 endpoint / 新数据模型)	可选	主 agent 判断
athena-init 首次	创建 ARCHITECTURE.md 初版	athena-init

delivery-gate 联动

Refactor / System (≥ 5 文件) + stage=ship 时, delivery-gate hook 检查:

1. 读 _index.path 和本 sprint 改动文件数 (从 evidence.yaml)
2. 若满足强制条件:
   • 检查 architecture/ARCHITECTURE.md mtime ≥ 本 sprint 开始时间
   • 检查改动涉及的子系统对应 {type}-{slug}.md mtime ≥ 本 sprint 开始时间
3. 不满足 → block + 提示 /architect-doc update

工作流

创建初始档 (athena-init 顺带)

athena-init 时, 主 agent:

1. 检测项目是否已有 README.md / docs/architecture/ /