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 先给具体建议,不让用户重写需求;一次集中提出 2-4 个高影响问题,说明建议、替代结果和误解风险。
- 主动暴露最可能造成误改的分叉;不得静默替用户决定产品行为,也不得询问本地证据已经回答的问题。
- 不强制套字段。对齐时用通俗话说明理解、依据、建议、替代结果和误解风险,末尾邀请回复“按建议”“按推荐”或直接纠错。
- 自然闸门:意图/范围变化、不可安全恢复的失败、高风险/破坏性/权限/迁移/发布、冲突或真实取舍。
开发中执行 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。
- bug/失败测试:
briefbound-bug-review;PR/diff:briefbound-pr-review;整仓/架构:briefbound-project-review。 - 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。PREVIEW_REQUIRED必须先交付隔离网页并等待用户APPROVED / REVISE / ABANDON;批准前不得修改正式 UI owning surface。 - 当前 diff 过度设计:
briefbound-simplification-review;整仓冗余治理:briefbound-simplification-audit。 - 开发中出现多职责巨型文件、难导航/测试或反复结构冲突:
briefbound-code-structure-guard;行数本身不触发拆分。 - 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 的评价:briefbound-evaluation。 - GitHub、浏览器、Figma、OpenAI 文档、图片和办公制品按需读
references/capability-routing.md。
无法仲裁才读 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 接管。
长任务、恢复、跨阶段 handoff 或持久状态才读取 references/runtime.md;普通 FAST_PATH/COMPACT_FLOW 不加载。
能力感知与阶段折叠
高能力模型可内部完成局部规划、依赖排序和自审;同一 owner 且无自然闸门时可折叠对齐、实现和验证。
- Skill Budget:默认一个 primary owner;support skill 只有补充独有知识、工具或独立证据时才加载。
- artifact 仅在审阅、交接、恢复或高风险决策复用时生成;调用下游前说清其防止的错误和使用者,否则跳过。
- 内部从 1-3 个相关视角检查需求覆盖、误改范围和验证;没有 finding 不输出矩阵。
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 风险使用 briefbound-completion-summary;已知残留才 cleanup。同一任务 PR 后按 PR_OPEN / PR_MERGED / PR_CLOSED_UNMERGED 路由 briefbound-development-cleanup;仅验证 base 吸收 published head 后收尾本地资源,远程分支删除仍单独授权。
用户可见内容默认中文:先说结果和必要依据;内部路由、枚举和账本不直接展示。复杂概念会改变用户判断或操作时,首次出现用一句话解释;技术字面量保持原样。checkpoint 要短;正文末行(Next Action)写 下一步建议: <一个具体动作>,仅自然闸门给选项。