用途：Pair 让两个编码智能体在同一任务上持续配对协作。你担任 lead，partner 从 claude、codex、cursor、grok、opencode 中选一个。传输层要求使用不同的 CLI；无头 Codex 可用 --identity <name> 选择不同账号 home，但独立账号本身不保证推理独立，不同 harness 也可能共用同一底层模型或 provider。
主要能力：同一协议由两种后端承载。在 Herdr 内，partner 是用户可见、可插话的窗格；在 Herdr 外，partner 是持久无头会话。会话记录 partner、model、effort、identity 和 role，恢复时无需重问。一个 lead 可同时运行多对，需在每条命令中带上 sid。
角色与写租约：peer（默认）为对等协作，按范围拆分，每个范围一个写租约，互相评审 ready；executor 由 partner 持有写租约并实现，你负责计划与评审。每个任务仍可重新分配租约。
协议：消息以 [agent <from> -> <to> kind=<kind> sid=<sid>] 开头，Herdr 后端在其下加 [herdr-pair control seq=<n>: ...]。kind 包括 task、review、question、ready、accepted、blocked、stalemate、handoff。所有 partner 消息经后端 helper 发送，普通输出仅用于无 header 的用户交接。
选择流程：先查找已有 pair（本 Herdr 标签页记录的会话，或本仓库中的无头会话），运行 pool check 并按各状态规则处理；无 pair 可恢复时先运行 catalog check 再选 partner。用户或 orchestrate 单元已定的 partner、model、effort、identity、role 视为最终，不再询问。未指定时按 roster 与实时 pool check 填充：Peer 席位用于对等协作者，Executor 席位用于委派实现。
后端选择：HERDR_ENV=1 用 Herdr 后端，其前置条件包含 herdr CLI 检查，缺失即停止；否则用 Headless 后端。显式无头请求或记录为无头的 orchestrate 单元即使在 Herdr 内也用 Headless。
限制与规则：破坏性检出窗口需提前用 task 公告受影响路径与停止条件，恢复验证后发 ready，不必等 accepted；无法公告或超过几分钟的实验应放到独立 worktree。连续五轮无新代码、测试结果、决策或收窄选项需 handoff；同一判断重复两次无进展发 stalemate。两个 accepted 完成一个工作周期，之后双方可空闲，下一任务恢复同一 pair 与 sid。会话续期由用户决定；仅当用户明确要求结束 pair 时才结束会话。具体命令与后端细节以对应后端参考为准，资料未提供完整命令文本。