briefbound-router git:20260920.b6f2d18A

Immutable. This exact content is served forever at /api/v1/blob/ed0578a88eba17a0.

---
name: briefbound-router
description: "Use when Chinese-first active intent discovery, local context probing, user calibration before downstream skill selection, owner/workflow routing, continuation, permission inference, or multi-thread/conflict coordination is needed."
license: MIT
---

# Briefbound Router

## 目标

Briefbound 对齐意图、选择 owner 并推进验证。结果明确时直接完成；结果或边界会改变时主动商量。约束用于防错，不替代判断。

## 决策核心

- “修复/添加/优化/删除/调整”提供执行许可；目标、写入面和验收清楚且无自然闸门时直接推进。
- 下游继承许可，切换 owner 不重问；仅范围扩大、高风险或真实取舍需确认。
- `HIGH`：行动；`MEDIUM`：声明低风险假设后行动；`LOW`：probe/讨论；`BLOCKED`：只问不可约问题。
- 输出用 `SILENT / MICRO / ALIGN / FULL`，默认最短；不展示内部账本。
- “继续/确认/按建议/按推荐来”先做 `Continuation Health Check`，仅继承仍完整的契约；缺结果/surface/evidence 或新增可见分叉就 probe/对齐。
- 声称刷新 skill 前必须重读本机 `SKILL.md`。

## 讨论式意图收敛

开发、规划或高影响审查前以 `Alignment Value Gate / Alignment Completeness Gate` 检查 `Desired Result / Owning Surface / Acceptance Evidence / Highest-impact Fork`。前三项缺失为 `MISSING_CONTEXT`：一次窄范围只读 probe，不索取本地可发现信息。存在多个实质结果为 `PRODUCT_FORK`：执行 `One-Turn Alignment`；否则行动。低置信度不得带着未确认的高影响假设写入。

`PRODUCT_FORK` 进入 `ALIGNMENT_PENDING`：只读 probe/Briefbound Router 对齐，不加载开发/planning owner、不写入。用户“按推荐”或纠正后进入 `CALIBRATED`，更新契约并重选/读取 owner，不重问已确认项。

- agent 先给具体建议，不让用户重写需求；只提出答案会改变走向的问题，一轮集中提出，意图与范围已清楚时零提问。
- 主动暴露最可能造成误改的分叉；不得静默替用户决定产品行为，也不得询问本地证据已经回答的问题。
- 不强制套字段。对齐时用通俗话说明理解、依据、建议、替代结果和误解风险，末尾邀请回复“按建议”“按推荐”或直接纠错。
- 自然闸门：意图/范围变化、不可安全恢复的失败、高风险/破坏性/权限/迁移/发布、冲突或真实取舍。

开发中执行 `Unexpected Issue Gate`：新证据若改变契约行为、范围、数据/API、安全或验收，停止受影响写入，带证据/影响/推荐讨论，不得扩大范围或硬做；契约内可逆恢复则处理并简报，确认后更新再继续。

展示 `ALIGN/FULL` 或破坏性菜单时才读 `references/output-forms.md`。

## Owner 与组合

扫描最多 3 个候选，选能直接产生下一证据的最具体 owner。内部 `Route Contract`：`Owner / Mode / Next Output / Allowed Action / Success Evidence / Stop Condition`；动作分 `READ / WRITE / REMOTE_WRITE / DESTRUCTIVE`。

- 项目学习：`briefbound-project-dissection`；完整报告联动图解。
- bug/失败测试：`briefbound-bug-review`；PR/diff：`briefbound-pr-review`；整仓/架构：`briefbound-project-review`；部署/运行故障：`briefbound-runtime-operations`。
- UI/UX 与交互：`briefbound-ui-design`；品牌视觉：`briefbound-visual-design`；生产前端：`briefbound-frontend-engineering`；界面审查：`briefbound-ui-review`；token/主题/组件治理：`briefbound-design-system`。
- 前端写入且界面未获确认时，读 `references/ui-preview-approval.md` 判定 `PREVIEW_REQUIRED / PREVIEW_SKIPPED`；前者须先交付隔离网页并等 `APPROVED / REVISE / ABANDON`，批准前不得修改正式 UI owning surface。
- diff 过度设计：`briefbound-simplification-review`；整仓冗余治理：`briefbound-simplification-audit`，按请求限定范围。
- 多职责巨型文件或难导航/测试：`briefbound-code-structure-guard`；测试策略/补测：`briefbound-test-strategy`；行数本身不触发拆分。
- AI/ML 研究：`briefbound-ai-research-loop`；单条 metric lane：`briefbound-score-loop`；重要 claim：`briefbound-research-rigor-review`。
- 多会话协商：`briefbound-multi-agent-orchestration`；单次冲突：`briefbound-thread-coordination`；自动本地集成：`briefbound-autonomous-collaboration-loop`；残留：`briefbound-development-cleanup`。
- 真实设计分叉：`briefbound-planning`；无专项 owner 的评价按需读 `references/evaluation.md`。
- 专用工具、文件制品、结构化图解及复杂汇报配图按需读 `references/capability-routing.md`；技能包自身增删改：`briefbound-skill-authoring`。

无法仲裁才读 `references/routing-practice.md`。以本轮 Available skills 为准；未安装 skill 不能成为 owner。

仅独立交付物、owner 或验证边界使用 `Primary / Secondary / Deferred`；写入可分离且收益高于协调成本才并行。

### Collaboration Discovery

意图收敛后，仅独立 lane、可复用上下文或专项互补时读 `references/collaboration-discovery.md`；`FAST_PATH`、单 owner 更快或无 thread/list 能力时为 `NONE`。

结果为 `NONE / PEER_CONTEXT_REVIEW / PEER_READ_ONLY / PEER_DISJOINT_WRITE / COORDINATE_OVERLAP`。单次协作交 `briefbound-thread-coordination`；持续互助为 `PEER_COLLABORATION_READY`，交 `briefbound-multi-agent-orchestration`；新会话收益明确为 `ASK_CREATE`。

发现不发消息、不暂停；无收益回原 owner。

非简单共同目标适合持续并行和本地集成时，询问一次是否开启自动化协作闭环；确认后路由 `briefbound-autonomous-collaboration-loop`，继承本地写入、提交、集成、验证和收尾许可；新会话和远程动作仍单独授权。

`MERGE_READY[_CONDITIONAL]` + dirty target：读取 `briefbound-thread-coordination` 的 integration ownership，查 `integration/<target>`；有许可且空缺即认领，已有 owner 只交证据，dirty main/baseline 不免责。同一 dirty-target blocker 第二次出现时，未启自动闭环也须读取，不累积新实现。

## 最小充分方案

按首个充分层级停止：`NO_BUILD -> PROJECT_REUSE -> STANDARD_NATIVE -> INSTALLED_DEPENDENCY -> MINIMAL_BUILD`。先查最窄本地复用；外部候选会改变路径、依赖、成本或风险时才用 `briefbound-feature-reuse-research`：

- 成熟引擎/标准类复杂能力、重要新依赖、跨模块子系统，或项目内无稳定模式；
- 用户明确要求外部复用，或 QUICK 搜索可显著避免高成本自研。

文件多不触发。普通 CRUD、样式、小 bug、机械改动和已有模式直接实施。

自动精简默认 `AUTO`：简单任务 `LITE`，非平凡实现 `FULL`，用户目标就是删减时 `ULTRA`。不得删除用户要求、信任边界、安全、数据保护、无障碍、兼容或迁移约束。

效率闸门为 `FAST / CHECK / PROFILE`：普通任务 `FAST`；已定位 N+1 等局部低效及批量修复/次数断言留给 owner `CHECK`，不转 bug/performance。仅故障、正确性回归或根因不明交 `briefbound-bug-review`；需 profiling 的目标/回归、热路径、规模、并发或资源风险才 `PROFILE`，交 `briefbound-performance-engineering`。不为每次开发建立 benchmark。

结构闸门为 `STAY / CHECK / SPLIT`：职责内聚即 `STAY`；新增独立职责或结构妨碍导航、测试和协作时 `CHECK`；只有职责/变化/测试边界可分时才加载 `briefbound-code-structure-guard` 执行 `SPLIT`。行数只是信号，生成/第三方代码、迁移、schema、fixture 和声明式数据不机械拆分。

## 流程重量

- `FAST_PATH`：一个低风险、可逆、可本地验证的单元；`FAST_PATH` 直接执行并最小验证，不 planning、拆分或 TDD。
- `COMPACT_FLOW`：多个相关单元可在一个上下文连续完成；只有拆分会改变依赖、owner、风险或验证时，才让 `briefbound-planning` 在同一方案内生成 `TASK_GRAPH`。
- `FULL_FLOW`：仍有真实设计分叉或状态/API/安全/数据/迁移/权限/发布风险；只生成解决这些风险所需的 artifact。

BDD/TDD 按子任务判断，只给确定性行为回归或重大契约风险；metric 未提升属于实验结果。

多会话 pause 会产生 `resumePendingAgentIds`；owner 只有在 coordination resolve 且恢复债务清零后结束，失活先路由 `briefbound-thread-coordination` 接管。

开放目标、长任务、恢复、正式交接或持久状态才读取 `references/runtime.md`；普通 `FAST_PATH/COMPACT_FLOW` 不加载。

## 能力感知与阶段折叠

高能力模型可内部完成局部规划、依赖排序和自审；同一 owner 且无自然闸门时可折叠对齐、实现和验证。

- **Skill Budget**：默认一个 primary owner；support skill 只有补充独有知识、工具或独立证据时才加载。
- artifact 只在后续会复用时生成；否则跳过。

Superpowers 默认不参与自动路由；显式恢复时也不继承其 brainstorming、planning、worktree、严格 TDD、子代理或收尾链。当前协作不创建子 Agent；只连接已有同项目平级会话。

## 执行与收口

写入前内部建立：`Target / Desired Outcome / Allowed Actions / Out of Scope / Success Evidence / Recovery Signal`。

Wrong-Edit Guard：定位 owning surface、预计文件、相关测试和已有用户/Agent 改动；只改完成契约所需范围。验证失败先区分 implementation、test intent、environment、requirement mismatch，不为过测试削弱行为。

首次写入、scope 扩大或合并前运行 `preflight --write-kind`；规划文档属于 development 写入，须先隔离。无 registry 仍检查 Git。根 `main/master` 的 `development` 收到 `ISOLATION_REQUIRED` 后转 task worktree；`mechanical` 显式声明；`integration` 需有效 claim 且 clean。`OVERLAP` 进入 Silent Conflict Triage，仅不可拆且立即覆盖/回归时暂停。

跨阶段恢复、正式交接或 Deferred 风险按 `references/runtime.md` 收口；已知残留才 cleanup。同一任务 PR 后按 `PR_OPEN / PR_MERGED / PR_CLOSED_UNMERGED` 路由 `briefbound-development-cleanup`；仅验证 base 吸收 published head 后收尾本地资源，远程分支删除仍单独授权。

用户可见内容默认中文：先说结果和必要依据；内部路由、枚举和账本不直接展示。复杂概念会改变用户判断或操作时，首次出现用一句话解释；技术字面量保持原样。checkpoint 要短；存在自然闸门时，末行（Next Action）给一条明确的下一步建议；否则声明继续推进已授权工作，不交回可自行完成的建议。