briefbound-planning

Briefbound 实施规划

目标

把已对齐需求整理成最小可实施方案。规划/任务图只防具体风险；可直接验证的任务留给 owner。

Briefbound task contract

• Context Boundary: 已确认意图、相关代码/文档/测试、owning surface、保护边界、已有决策和会改变方案的外部证据。
• Output Contract: 推荐实施路径、影响面、顺序、风险决策、验证策略，以及必要时同一方案内的最小任务图。
• Allowed Action: 只读分析与方案编写；不修改业务代码，不扩大用户范围，不替专项 owner 执行。
• Success Evidence: 方案能映射到具体文件、行为、依赖和验证，且下一执行者无需重新猜测关键取舍。
• Stop Condition: 需求仍有高影响分叉、owning surface 不清、关键证据缺失、高风险动作未确认或方案不能安全实施。
• Route Out: 当前 owner 或专项 owner 直接实施、briefbound-router 或 BLOCKED。

统一调用契约

• 只处理 Briefbound task contract 范围；不匹配时回 briefbound-router 或更具体 owner，复合任务不吞其他 owner。
• 用户可见内容默认中文，完成只报状态、产出、证据和剩余风险；代码、命令、路径、错误原文、API/协议、skill 名和枚举保留原样；Route Out 仅以 Briefbound task contract 为准，末行写 下一步建议: <一个具体动作>。

进入闸门

只在规划 artifact 会被审阅、复用、交接或防止具体错误时进入本 skill，例如：

• 存在会改变行为、架构、兼容性或成本的真实设计选择；
• 涉及跨模块契约、状态迁移、数据、权限、安全、发布或回滚顺序；
• 需要多个 owner、多人/agent 或跨会话协作；
• 用户明确要求先看方案。

以下情况不进入：明确机械修改、单一 owning surface、低风险可逆修复、当前 owner 已能直接实施和验证。文件多不等于需要规划。

规划方法

1. 继承 Briefbound Router 的可观察结果、非目标、约束和成功证据，不重新发明需求。
2. 只读检查会改变方案的文件、接口、状态、测试、日志和项目规则。
3. 先考虑项目内复用和平台原生能力；只有外部候选会实质改变架构、依赖或成本时才进入 briefbound-feature-reuse-research。
4. 选择最小充分路径，说明影响文件、关键行为/数据流、实施顺序、保护边界和验证方式。
5. 只有 Briefbound Router 判为 PROFILE 才携带主指标、负载、baseline/测量和停止目标；FAST/CHECK 不增加性能章节。
6. 只有真实取舍才给 2-3 个方案；否则给一个推荐路径。
7. 内部从 1-3 个最相关视角检查需求覆盖、实施可行性、验证和风险。没有 finding 不输出矩阵；发现缺口直接修订方案。
8. 根据剩余工作选择 DIRECT_IMPLEMENTATION、COMPACT_PLAN、TASK_GRAPH 或 BLOCKED；不要再增加一个仅重复拆分判定的流程阶段。

路由判定

默认 DIRECT_IMPLEMENTATION；需要持久方案但无需真实拆分时使用 COMPACT_PLAN。满足以下条件即可由当前 owner 连续实施和验证：

• 一个主题、一个主要 owner，能放入同一推理上下文；
• 顺序可以在内部维护，不需要独立交付或逐项用户验收；
• 风险和验证可以由同一执行契约覆盖。

只有任一条件成立才在当前方案内使用 TASK_GRAPH：

• 存在多个独立交付物或 owner；
• 有真实先后依赖，后续任务必须消费前一任务的 artifact；
• 某个高风险步骤需要独立验收、回滚或权限闸门；
• 需要并行、分 PR、跨会话交接，或不同任务需要不同验证契约；
• 用户明确要求拆分。

多个文件、较长描述、同机制机械替换、需要测试或普通跨模块修改，本身不触发拆分。NO_SPLIT 是 Briefbound Router/Planning 的内部结论，不需要独立 skill 来证明无需拆分。

TASK_GRAPH 模式

任务图与实施方案一次完成：

• 一个任务只对应一个独立交付物、owner、依赖 artifact、风险闸门或验证契约；测试、文档和配置并入所属功能任务。
• 共享写入面、顺序依赖或共享验证保持串行；只有范围和证据真正独立才并行。
• Critical Path 只保留完成目标必需的任务；可选优化进入 Deferred，不生成当前任务卡。
• 每个任务自行选择 SIMPLE 或 BDD_TDD。只有确定性行为存在重大回归、状态、数据、权限、迁移或公共契约风险时才使用 briefbound-bdd-tdd-development。
• 实验 metric lane 路由 briefbound-score-loop；metric 未提升不等于 TDD RED。
• 默认连续执行 Critical Path，已有执行许可时不逐任务询问。