Handoff-to-design map

Historical (marked 2026-10-21): the two handoffs this table maps, and the design pages it points to, are now historical or superseded; for the current design see the generic model.

The rules in the client API handoff and the case-execution handoff have been merged into the matching documents under docs/design; this table records where each passage went, for the later trimming of the two handoffs into change records. Passages marked “not moved” in the right column are implementation records, acceptance figures, or product connector contracts, which the design documents do not take. The canonical map is the Chinese version; the handoff headings below stay in Chinese because the handoffs are Chinese.

client-api-handoff.md

Handoff passage Merged into
Title and opening (protocol originals and versions) Implementation pointers, not moved
启动和登录 Identity and token rules → roles.md#sessions-and-tokens; the dev-stack and HTTPS startup details are an operations runbook, not moved
通用信封 circle-integration.md#the-common-shape-of-the-interface
普通用户只读接口 circle-integration.md#the-read-projections-of-tasks-and-approvals; the paging contract → vocabulary.md#the-contract-of-a-list-being-a-query
编译调用顺序 The call walkthrough is not moved; within it: idempotency and the admission transaction → circle-integration.md#the-common-shape-of-the-interface; SHA re-check on download → object-standard.md#4-bs-rules-for-originals-and-evidence
状态、事件和交付 Cursor discipline and cancel semantics → circle-integration.md#event-catch-up; reading result.status after delivered and never re-dispatching an unknown → approvals-and-enforcement.md#the-discipline-of-the-unknown
补充或更换输入 approvals-and-enforcement.md#only-one-approval-concept-the-change-set (the input-revision entry)
当前验收与下一次组合验收 Implementation record, not moved
第二阶段:工具目录 circle-integration.md#the-tool-catalog-and-calls; the failure-classification collapse → approvals-and-enforcement.md#the-classification-of-source-failures
脑图知识工具 The honesty rules of paging and coverage → vocabulary.md#the-contract-of-a-list-being-a-query; asynchronous knowledge indexing → object-standard.md#4-bs-rules-for-originals-and-evidence; the per-tool field tables are product connector contracts, not moved
第二阶段:技能包约定与 RPC 边界 The registration contract → product-line-pack.md#the-registration-contract-of-skill-packages-and-modules; the run boundary → harness-primitives.md#7-the-contract-of-each-primitive (the Skill execution entry); the run token → approvals-and-enforcement.md#credentials-and-resources
通用外部来源制品 object-standard.md#4-bs-rules-for-originals-and-evidence; pending-draft visibility → approvals-and-enforcement.md#only-one-approval-concept-the-change-set
通用 OAuth 凭据登记 approvals-and-enforcement.md#credentials-and-resources
第二阶段:触发、整理与 Circle 渠道 circle-integration.md#triggers-and-bots; atomic rollback of a refused report → object-standard.md#4-bs-rules-for-originals-and-evidence; the knowledge-consolidation skill contract is product content, not moved
第二阶段:工作列表过滤与续页 vocabulary.md#the-contract-of-a-list-being-a-query
产品线安装与工具别名 Alias resolution and hiding → circle-integration.md#the-tool-catalog-and-calls; the install JSON’s path convention is runtime configuration, not moved
修订 3:人的范围角色与审批资格 roles.md#role-registration-and-the-disclosure-of-eligibility
修订 3:变更集与依赖核验 approvals-and-enforcement.md#only-one-approval-concept-the-change-set; the digest formulas are implementation detail, not moved
修订 3:Skill、Tool、MCP server 与 Hook 的执行绑定 Hook subjects and the host policy → harness-primitives.md#7-the-contract-of-each-primitive; the single-consumption of an executionIsChange approval → approvals-and-enforcement.md#what-if-production-equipment-needs-the-two-person-rule; waiting-input and the build observation → approvals-and-enforcement.md#the-enforcement-chains-fixed-rules-on-device-execution
修订 3:开发会话寿命与吊销 roles.md#sessions-and-tokens
修订 3:凭据模式、隔离与明确的明文例外 approvals-and-enforcement.md#credentials-and-resources
读取超时与大原件回报 approvals-and-enforcement.md#read-timeouts; the report shape → object-standard.md#4-bs-rules-for-originals-and-evidence
审计补充:角色、Hook 形状与模型凭据 The role floor of a credentialed provider → roles.md#role-registration-and-the-disclosure-of-eligibility; the Hook shapes → harness-primitives.md#7-the-contract-of-each-primitive; the model proxy and output masking → approvals-and-enforcement.md#credentials-and-resources; the FAMX acceptance commit id is an implementation record, not moved
读结果与治理内容补充 Redaction with verifiable originals → object-standard.md#4-bs-rules-for-originals-and-evidence; the read-only view of a skill candidate → approvals-and-enforcement.md#only-one-approval-concept-the-change-set (pending-draft visibility); gateway.health/topology and the supervisor log lines are product contract and operations detail, not moved
修订 3 第 6 节:通知流与工作队列 circle-integration.md#the-notification-stream-and-the-work-queues
修订 3 第 8 节:列表即查询 vocabulary.md#the-contract-of-a-list-being-a-query
修订 3 第 9 节:中立原语与 MCP harness-primitives.md#3-adapters-import-and-export, #4-generic-transport-hub-itself-is-an-mcp-server; the migration-by-migration compensation history is an implementation record, not moved; worker draining → approvals-and-enforcement.md#credentials-and-resources; the worker-offline threshold → circle-integration.md#the-notification-stream-and-the-work-queues
派发前拒绝与两次环境观察 approvals-and-enforcement.md#pre-dispatch-refusals-and-the-remote-lease, #dispatch-and-the-two-environment-observations
权限导出 (the permission-export passage) The design document already exists: permission-export.md

case-execution-handoff.md

The trimmed document is organized into five sections; the left column links to its headings (in Chinese).

Handoff section Merged into
版本与验收记录 Version and acceptance records not moved; execution needs no approval by default → approvals-and-enforcement.md#what-if-production-equipment-needs-the-two-person-rule; re-registering an upgraded implementation → product-line-pack.md#the-registration-contract-of-skill-packages-and-modules
原生提交操作 The submission runbook stays in the handoff; the generic literal-gate rules → approvals-and-enforcement.md#verification; external-source binding and the declared-data boundary → object-standard.md#4-bs-rules-for-originals-and-evidence; the FAMX literal closed sets stay in the handoff (product contract) and move when the execution flow lands in products/famx
FAMX 字面契约与框架路由 The generic rules → approvals-and-enforcement.md#verification; the FAMX literal closed sets and the host-name closed set stay in the handoff (product contract) and move when the execution flow lands in products/famx
仓库外配置与身份更正 Credential, trust, and rotation rules → approvals-and-enforcement.md#credentials-and-resources; the issuer correction record is an implementation record, not moved
原生结果字段与设备归属记录 The generic attribution and verdict rules → approvals-and-enforcement.md#device-attribution-and-log-parsing; worker draining → approvals-and-enforcement.md#credentials-and-resources; the FAMX_n naming rule and the native field list stay in the handoff (product contract) and move when the execution flow lands in products/famx

This document is a circle-hub working note (the map for trimming the handoffs), not a design specification; it is licensed under the Apache License 2.0.