本目录是贡献者与维护者的工程文档;面向使用者的快速开始、概念、SDK、组件与 API 文档在
apps/storybook/content/docs。
architecture.md:进程、分层、依赖方向与数据流。repository-layout.md:源码与测试放置规则。interfaces.md:跨层接口与后端 op 对照表。protocol.md:SSE 帧、重连、去重、错误模型与确认令牌。validation.md:测试分层、门禁与真实 Cloud 规则。adr/:已接受的架构决策与背景。research/:Provider/SDK 公开合同与上游 API 证据。
- 新增后端操作同步
interfaces.md的 op 对照表;改协议同步protocol.md;改分层同步architecture.md与.dependency-cruiser.cjs。 - 长期上游证据放
research/;难以撤销的决策写成adr/NNNN-*.md。 - 验收证据放 PR 描述或 CI artifact,不提交逐次验收记录。
pnpm check:docs校验文档中的命令真实存在、每个包都有AGENTS.md。