docs: clarify HWLAB session resume boundaries

docs/reference/architecture.md

@@ -26,6 +26,12 @@ UniDesk 与 HWLAB 是 tenant/client。UniDesk 负责平台入口、provider 清
 - `executionPolicy`，包含 sandbox、approval、timeout、network 和 secret scope；
 - `traceSink`，说明标准化 event 镜像到哪里。
 
+HWLAB 接入时必须显式分离业务 identity 和执行 identity：HWLAB `conversationId` / `sessionId` / `threadId` 是业务会话，AgentRun `runId` / `commandId` / `runnerJobId` 是执行尝试，AgentRun `SessionRef` / PVC 是 backend profile 续接状态。HWLAB Workbench 的 project/workspace 字段只能作为 HWLAB metadata 或 `workspaceRef` 子字段，不得写入 AgentRun `projectId`；AgentRun `projectId` 仍固定表达 tenant policy 边界，例如 `pikasTech/HWLAB`。
+
+架构混乱的临时处理原则：发现 HWLAB provider/session/project/workspace 与 AgentRun tenant/project/run/job 字段混用时，不放宽 manager tenant policy、不改成 fallback backend、不靠 prompt 历史模拟续接。先在目标 runtime 用最小真实请求核对 run payload、runner job env、`SessionRef`、PVC phase、lease 和 command events；必要时热补丁只用于证明单变量修复，随后必须回到源码、CI/CD 和原入口复测。
+
+长期收敛建议：跨仓库 API/schema 应使用不同字段名表达不同层级，例如 `hwlabProjectId` / `agentRunProjectId`、`hwlabSessionId` / `agentRunSessionId`、`providerProfile` / `backendProfile`、`runId` / `sessionId`。客户端和 Web 应同时展示业务 session/thread/provider 与执行 run/job/command，避免 operator 把 replacement runner 当作新业务 session 或把业务 workspace project 当作 AgentRun tenant policy。
+
 ## 服务形态
 
 AgentRun 应构建为小型服务族：