@givolt/i3-composer-agent 2.3.6 → 3.0.0

package/references/enterprise-sop-resources/brd/assets-manifest.json

@@ -0,0 +1,94 @@
+{
+  "schemaVersion": 1,
+  "resourceId": "i3-enterprise-sop-brd",
+  "resourceVersion": "0.2.3",
+  "status": "local-resources-only-not-released",
+  "stage": "brd",
+  "documentType": "BRD",
+  "source": {
+    "path": "references/i3-enterprise-sop/brd/templates/BRD.md",
+    "resourcePath": "templates/BRD.md",
+    "templateVersion": "v0.0.3",
+    "sha256": "2c9c4061e720877e984c6094232f797ebdf0380b8ff27693ac8d930fe648c47c",
+    "role": "complete-document-template",
+    "distributionRendering": "Existing brand-reference mapping and standard Chinese guide; source and distribution digests are distinct."
+  },
+  "prompts": {
+    "generate": "prompts/01-generate.md",
+    "review": "prompts/02-review.md",
+    "revise": "prompts/03-revise.md",
+    "recheck": "prompts/04-recheck.md"
+  },
+  "dependencies": [
+    {
+      "path": "../template-contracts.md",
+      "role": "shared-contract",
+      "resolutionBoundary": "selected-enterprise-sop-root"
+    },
+    {
+      "path": "../handoff-contract.md",
+      "role": "shared-handoff-contract",
+      "resolutionBoundary": "selected-enterprise-sop-root"
+    },
+    {
+      "path": "../lifecycle-contract.md",
+      "role": "shared-lifecycle-contract",
+      "resolutionBoundary": "selected-enterprise-sop-root"
+    }
+  ],
+  "files": [
+    {
+      "path": "README.md",
+      "sourceSha256": "86ff3b9dfb7b48ecf34dbbbd2f90ebf0293f99707003b81992f5adc7da7c67d8",
+      "sha256": "1e863739b002ea735a2934dea9d34db7a25383029342e3f23051ec437b40fd56",
+      "role": "stage-guidance"
+    },
+    {
+      "path": "prompts/01-generate.md",
+      "sourceSha256": "9f2035dddec57400dd19dd55d8fa3420fbeb6aa32908ac3b2403cd4ff5098a28",
+      "sha256": "2f731c621b42aae4b13d0ac60d2a177bc7f750d75bc0483c5a3a8e7e7a3194ad",
+      "role": "stage-action-guidance"
+    },
+    {
+      "path": "prompts/02-review.md",
+      "sourceSha256": "d93e6123e1149fad579dabf82de32bd4172a5fb1da19fb8ca4e6f3c791d0543e",
+      "sha256": "45971e0896c80253f92de03de1246cd2ee0edafbe411144e72be8665916b35d0",
+      "role": "stage-action-guidance"
+    },
+    {
+      "path": "prompts/03-revise.md",
+      "sourceSha256": "d7e43886e00308f7d2e88fb6e4d07d136cc6a9a21def398a58e0e8da9be4c83d",
+      "sha256": "cbc2f6b5ea5b36dc59f52a04b9548e7c10e9b7b39361f1679e6855ba81106d92",
+      "role": "stage-action-guidance"
+    },
+    {
+      "path": "prompts/04-recheck.md",
+      "sourceSha256": "573a81502f554a05c78c25e55385b67116c79d67914e4b235d766d4fe483881d",
+      "sha256": "422442b1491457e8e05d1b1ec3df240d835fdce817ac2fb8eb324d813f52d7bb",
+      "role": "stage-action-guidance"
+    },
+    {
+      "path": "templates/BRD.md",
+      "sourceSha256": "2c9c4061e720877e984c6094232f797ebdf0380b8ff27693ac8d930fe648c47c",
+      "sha256": "777f408fb596ec5f90ea8507d3b59974df11dde647df7edef070b30ee6f380af",
+      "role": "complete-document-template"
+    }
+  ],
+  "derivedFrom": {
+    "path": "docs/sop-design/templates/BRD.md",
+    "templateVersion": "v0.0.2",
+    "sha256": "f5d95a507aa595f3b8398ae03a7ffac6022ed7505130a650596641de22494292",
+    "included": false,
+    "role": "maintenance-provenance-only-not-runtime-dependency",
+    "changes": [
+      "distribution title",
+      "template version and status",
+      "package-contained shared-contract link"
+    ]
+  },
+  "projectDiscovery": {
+    "entryRelativeToReferences": "enterprise-sop-resources/README.md",
+    "stagesRelativeToEntry": "stages.json",
+    "ordinaryInstallEnablesEnterpriseWorkflow": false
+  }
+}

package/references/enterprise-sop-resources/brd/prompts/01-generate.md

@@ -0,0 +1,51 @@
+# BRD 候选生成任务
+
+<!-- i3:zh-guide:start -->
+## 中文使用说明
+
+按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
+
+默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
+<!-- i3:zh-guide:end -->
+
+原方法调用：本次起草必须先成功加载原 `i3-spec-driven-development` Skill；宿主支持Skill工具时取得成功回执，再按其外部格式／存储能力使用本模板和唯一目标。不是调用原/i3-spec包装后改写其根SPEC.md规则，也不让using把Spec变成可选。方法不可用或真实冲突时报告，不裸跑写稿；内容、认可、保存后停轮保留。
+
+目录与上下文：新项目无已采用输出约定时默认 `spec/{能力名称}/`，同PBC多主题PRD独立版本，AD／TestCase固定本次直接上游；已有位置不自动迁移。只读本主题完整来源及必要共享依赖，不全量载入候选／历史，摘要不替代正文。最后回读后原方法要求立即停轮时，报告候选实际路径和待登记事项，后续获准作业补JSON，不自动调用Plan／Build。
+
+
+
+仅在本轮明确企业作业或适用的真实项目选择下使用，标准流程优先保留。实际读项目规则、根README及引用的采用／输出约定，从本轮材料→项目采用副本→同宿主项目安装→可读全局安装定位。读取选定阶段清单、模板、作业提示词及共用合同，选定源失效不换新版／其他宿主。模型整理任务卡，用户不必逐项填路径；真实歧义、冲突或覆盖风险才问。
+
+内部任务卡包括实际项目根／宿主、阶段与动作、EBC或PBC／主题身份、精确业务来源／版本／条目、模板与提示词／本地修改、唯一展开目标／版本／现稿、允许写入及停点、假设／Q和影响范围。没有计算摘要如实写，不填假SHA，目录或作者摘要不证明已读。
+
+## 本阶段内容核对
+
+
+- 从真实背景、目标、角色、场景和BR核对范围，候选假设与已确认事实分开。EBC一份逻辑BRD有版本历史，不增MVP层。
+- 按目标、输入输出、对象／规则责任、依赖和独立演进边界提出PBC，不能按页面、部门、表或服务机械拆分。预给候选不能冒充任意业务自动识别成功。
+- BR到PBC分配、共享／未承接项、闭环、排除与收益验证可追溯；指标、权限、负责人或里程碑未知列Q，不编造。
+- 只交业务候选和PRD交接，不要求先有AD／TestCase，不宣称单份BRD满足六项或已获准编码。
+
+## 执行与结束
+
+1. 实际读选定来源和模板，写前列假设／推导／建议、准确来源与影响，未知列Q；保留原方法澄清、内容、边界认可和实际停轮，不虚构业务事实。
+2. 只写展开后的唯一目标。目标已存在先读，明确修订／新版本及旧稿保留，不覆盖人工内容，不改上游／模板／提示词／其他主题。入口真冲突报告受阻范围，不写影子SPEC绕过。
+3. 按完整模板写本次有效范围，保留来源、稳定需求／AC及受阻项，不把图／示例／候选写成已批准或已实现。
+4. 跨位置核权限／状态／字段、拒绝／失败／未知和副作用；最终新增要求逐条回源，全文表格逐行核列数和列义。最后Edit／Write后分段完整Read最终目标及相关引用，再改则重新完整回读。
+5. 汇报唯一输出、身份版本、实际读取、假设／Q、自查和未执行事项，交人工审阅后结束本轮。不自动审查／修订、下阶段、Plan、Build、实际测试或发布。
+
+## B05 生命周期与必要读取
+
+按选定资源索引实际读lifecycleContract及共用模板／交接合同；先列本次必读路径和用途，实际核所选正文及必要依赖，未读／失败／部分读照实。只加载本次generate动作，不加载其他动作或低优先级源兜底。
+
+业务目标／能力边界／跨PBC责任未变时复用原BRD；新增主题不补造业务批准，变化只改本次明确范围。
+
+只写本次明确文档目标，先读现稿与人工修改并保留历史；最后编辑后实际回读。JSON、Plan、任务、代码和生产不是本次写入范围；生成文档后展示路径并交审，不自动登记JSON；用户明确选用后才登记selected，原方法停轮仍保持。
+
+当前目标、任务与已实现事实分开；已完成任务保留，未实施取消不记完成，进行中保留真实工作，已实现退役通过新任务。原Plan／Build实际消费须按本轮证据核验，JSON最小辅助已提供但不在本次文稿写入权限内，不自动下阶段、工程、提交或发布。
+
+## B05-r2 最后修改后的全文回读
+
+全部Write／Edit结束后，必须使用读取工具分段完整覆盖最终目标正文，超出工具截断就续读剩余段。已全文读过但之后又Edit时，须再次完整覆盖最终稿，不能只回读改动行并声称“末次修改后全文已核”。本次必要输入清单中仍有未读／失败／部分读时，先报告准确缺口，不写成已全部读取；补读不是过去已读。
+
+未完成收尾就保留实际稿和未核范围，不删除稿件、不补造通过，不登记为已完成回读的完整候选。收尾不改写业务决定，不自动进入下一阶段；只读review／recheck依然零项目写入。

package/references/enterprise-sop-resources/brd/prompts/02-review.md

@@ -0,0 +1,47 @@
+# BRD 独立只读审查任务
+
+<!-- i3:zh-guide:start -->
+## 中文使用说明
+
+按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
+
+默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
+<!-- i3:zh-guide:end -->
+
+先完整读取[统一审查约定](../../review-handoff.md)、本阶段README、完整模板、本次唯一动作、当前业务稿及必要上游／实际采用约束。复查另完整读准确旧稿、原始报告、逐项回应或如实未处理状态。元数据由外层解析不冒充模型已读；自改或未知规则未能确认覆盖时完整读项目选定原件，不回退发行模板。
+
+
+仅在本轮明确企业作业或适用的真实项目选择下使用，标准流程优先保留。实际读项目规则、根README及引用的采用／输出约定，从本轮材料→项目采用副本→同宿主项目安装→可读全局安装定位。由外层解析阶段清单，模型完整读取阶段README、模板、唯一作业提示词及统一审查约定，选定源失效不换新版／其他宿主。模型整理任务卡，用户不必逐项填路径；真实歧义、冲突或覆盖风险才问。
+
+内部任务卡包括实际项目根／宿主、阶段与动作、EBC或PBC／主题身份、精确业务来源／版本／条目、模板与提示词／本地修改、唯一展开目标／版本／现稿、允许写入及停点、假设／Q和影响范围。没有计算摘要如实写，不填假SHA，目录或作者摘要不证明已读。
+
+真实独立新上下文执行，作者同会话自查不是独立证据。审查者全程只读会话输出，不写候选、项目、报告文件或采用记录；无隔离条件就提供新会话任务，不宣称已独立审查。报告由获准调用者另存。
+
+## 本阶段内容核对
+
+
+- 从真实背景、目标、角色、场景和BR核对范围，候选假设与已确认事实分开。EBC一份逻辑BRD有版本历史，不增MVP层。
+- 按目标、输入输出、对象／规则责任、依赖和独立演进边界提出PBC，不能按页面、部门、表或服务机械拆分。预给候选不能冒充任意业务自动识别成功。
+- BR到PBC分配、共享／未承接项、闭环、排除与收益验证可追溯；指标、权限、负责人或里程碑未知列Q，不编造。
+- 只交业务候选和PRD交接，不要求先有AD／TestCase，不宣称单份BRD满足六项或已获准编码。
+
+## 发现与结束
+
+1. 固定实际候选、来源、模板和本次允许证据，读真实正文而非作者摘要。对每条规范断言核来源、条件／例外／强度及本阶段落实；未提供工程／运行／读取证据明确未核实。
+2. 构造正常／拒绝／失败／未知／重复／恢复及跨主题反例，核权限、状态、字段、事务或用例条件全文一致；不能只核编号数量。逐表核列数和列义，列真实已读范围。
+3. 用稳定发现ID记录严重度、准确位置、来源位置、反例影响和最小建议，区分确定矛盾、缺证、设计候选和可选建议；无真问题如实零项，不替业务回答Q，不触发自动修订。
+4. 输出可交人工审阅／需修订／无法判断、发现／建议／Q及未执行事项后结束。原评级并列保留，不自称业务批准、六项齐备、测试通过、开工或发布许可。
+
+## B05 生命周期与必要读取
+
+生命周期、模板及交接合同的实质条款按[统一审查约定](../../review-handoff.md)核对；外层解析并保护原索引／合同，未知自改继续完整读本次选定原件；先列本次必读路径和用途，实际核所选正文及必要依赖，未读／失败／部分读照实。只加载本次review动作，不加载其他动作或低优先级源兜底。
+
+业务目标／能力边界／跨PBC责任未变时复用原BRD；新增主题不补造业务批准，变化只改本次明确范围。
+
+本次独立只读，仅会话标注问题／来源／影响／最小建议；不改候选、JSON、Plan、代码或报告。人工可修订、有据不采纳或保留Q；原代码review不由此变成只读。
+
+当前目标、任务与已实现事实分开；已完成任务保留，未实施取消不记完成，进行中保留真实工作，已实现退役通过新任务。原Plan／Build实际接点和JSON辅助仍待后续，不自动下阶段、工程、提交或发布。
+
+## B05收口：单项目审查证据
+
+一次只审本次明确的业务项目／主题；必要跨主题来源仍按影响读取。对每条发现和已核事实分别给目标及来源的实际路径、起止行和短原文摘录，再给理由、反例与最小建议。最终会话按统一审查约定和外层传入的同源Schema输出findings、checkedFacts、verdict和未核范围；不能把成功Read一次当读完，不自报未读输入已核。摘录／读取检查通过仍不证明语义结论成立，误报保留反证，不自动改稿。

package/references/enterprise-sop-resources/brd/prompts/03-revise.md

@@ -0,0 +1,47 @@
+# BRD 明确委托修订任务
+
+<!-- i3:zh-guide:start -->
+## 中文使用说明
+
+按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
+
+默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
+<!-- i3:zh-guide:end -->
+
+
+仅在本轮明确企业作业或适用的真实项目选择下使用，标准流程优先保留。实际读项目规则、根README及引用的采用／输出约定，从本轮材料→项目采用副本→同宿主项目安装→可读全局安装定位。读取选定阶段清单、模板、作业提示词及共用合同，选定源失效不换新版／其他宿主。模型整理任务卡，用户不必逐项填路径；真实歧义、冲突或覆盖风险才问。
+
+内部任务卡包括实际项目根／宿主、阶段与动作、EBC或PBC／主题身份、精确业务来源／版本／条目、模板与提示词／本地修改、唯一展开目标／版本／现稿、允许写入及停点、假设／Q和影响范围。没有计算摘要如实写，不填假SHA，目录或作者摘要不证明已读。
+
+只有本轮明确委托修订才执行，审查意见不自动授予改稿。实际读当前稿、可回读旧稿、固定报告／发现ID、人工修改和真实答复；缺旧稿先停止覆盖。仅改唯一授权候选，不改来源、模板、其他主题、原Skill／命令或采用状态。
+
+## 本阶段内容核对
+
+
+- 从真实背景、目标、角色、场景和BR核对范围，候选假设与已确认事实分开。EBC一份逻辑BRD有版本历史，不增MVP层。
+- 按目标、输入输出、对象／规则责任、依赖和独立演进边界提出PBC，不能按页面、部门、表或服务机械拆分。预给候选不能冒充任意业务自动识别成功。
+- BR到PBC分配、共享／未承接项、闭环、排除与收益验证可追溯；指标、权限、负责人或里程碑未知列Q，不编造。
+- 只交业务候选和PRD交接，不要求先有AD／TestCase，不宣称单份BRD满足六项或已获准编码。
+
+## 修订与结束
+
+1. 写前逐项列发现ID→是否成立→来源理由→最小改动→影响；误报有据说明，业务未答保持Q，不为清零编造权限、指标、正式契约或通过结果。
+2. 同一问题修复到当前稿所有相关位置，保留有效目标、原编号及人工修改。上游需要改变仅标注，不越界改源；草稿修订与新业务版本分开，不机械升版或强制配套同号。
+3. 最后一次编辑后实际回读最终目标及受影响上下文；新增规范要求逐条回源，权限／状态／副作用一致，全文逐表核列数和列义，引用和覆盖重核；再改则按收尾规则再次完整回读最终稿，并重核受影响来源与检查。
+4. 逐发现回应实际处理位置、来源、剩余问题及未执行事项，修订说明由获准调用者另存。请求必要独立复查和人工审阅后停轮，不自批或自动下一阶段／Plan／Build／测试执行／发布。
+
+## B05 生命周期与必要读取
+
+按选定资源索引实际读lifecycleContract及共用模板／交接合同；先列本次必读路径和用途，实际核所选正文及必要依赖，未读／失败／部分读照实。只加载本次revise动作，不加载其他动作或低优先级源兜底。
+
+业务目标／能力边界／跨PBC责任未变时复用原BRD；新增主题不补造业务批准，变化只改本次明确范围。
+
+只写本次明确文档目标，先读现稿与人工修改并保留历史；最后编辑后实际回读。JSON、Plan、任务、代码和生产不是本次写入范围；生成文档后展示路径并交审，不自动登记JSON；用户明确选用后才登记selected，原方法停轮仍保持。
+
+当前目标、任务与已实现事实分开；已完成任务保留，未实施取消不记完成，进行中保留真实工作，已实现退役通过新任务。原Plan／Build实际接点和JSON辅助仍待后续，不自动下阶段、工程、提交或发布。
+
+## B05-r2 最后修改后的全文回读
+
+全部Write／Edit结束后，必须使用读取工具分段完整覆盖最终目标正文，超出工具截断就续读剩余段。已全文读过但之后又Edit时，须再次完整覆盖最终稿，不能只回读改动行并声称“末次修改后全文已核”。本次必要输入清单中仍有未读／失败／部分读时，先报告准确缺口，不写成已全部读取；补读不是过去已读。
+
+未完成收尾就保留实际稿和未核范围，不删除稿件、不补造通过，不登记为已完成回读的完整候选。收尾不改写业务决定，不自动进入下一阶段；只读review／recheck依然零项目写入。

package/references/enterprise-sop-resources/brd/prompts/04-recheck.md

@@ -0,0 +1,47 @@
+# BRD 独立只读复查任务
+
+<!-- i3:zh-guide:start -->
+## 中文使用说明
+
+按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
+
+默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
+<!-- i3:zh-guide:end -->
+
+先完整读取[统一审查约定](../../review-handoff.md)、本阶段README、完整模板、本次唯一动作、当前业务稿及必要上游／实际采用约束。复查另完整读准确旧稿、原始报告、逐项回应或如实未处理状态。元数据由外层解析不冒充模型已读；自改或未知规则未能确认覆盖时完整读项目选定原件，不回退发行模板。
+
+
+仅在本轮明确企业作业或适用的真实项目选择下使用，标准流程优先保留。实际读项目规则、根README及引用的采用／输出约定，从本轮材料→项目采用副本→同宿主项目安装→可读全局安装定位。由外层解析阶段清单，模型完整读取阶段README、模板、唯一作业提示词及统一审查约定，选定源失效不换新版／其他宿主。模型整理任务卡，用户不必逐项填路径；真实歧义、冲突或覆盖风险才问。
+
+内部任务卡包括实际项目根／宿主、阶段与动作、EBC或PBC／主题身份、精确业务来源／版本／条目、模板与提示词／本地修改、唯一展开目标／版本／现稿、允许写入及停点、假设／Q和影响范围。没有计算摘要如实写，不填假SHA，目录或作者摘要不证明已读。
+
+真实独立新上下文执行，作者同会话自查不是独立证据。审查者全程只读会话输出，不写候选、项目、报告文件或采用记录；无隔离条件就提供新会话任务，不宣称已独立审查。报告由获准调用者另存。
+
+## 本阶段内容核对
+
+
+- 从真实背景、目标、角色、场景和BR核对范围，候选假设与已确认事实分开。EBC一份逻辑BRD有版本历史，不增MVP层。
+- 按目标、输入输出、对象／规则责任、依赖和独立演进边界提出PBC，不能按页面、部门、表或服务机械拆分。预给候选不能冒充任意业务自动识别成功。
+- BR到PBC分配、共享／未承接项、闭环、排除与收益验证可追溯；指标、权限、负责人或里程碑未知列Q，不编造。
+- 只交业务候选和PRD交接，不要求先有AD／TestCase，不宣称单份BRD满足六项或已获准编码。
+
+## 复查与结束
+
+1. 固定实际修订稿、旧稿／原报告／逐项回应、人工答复、来源和模板；发现集或版本不对应先澄清，不猜最新。读实际全文和相关上下文，不能只看差异／作者摘要；后补读取不追认为历史已读。
+2. 按稳定发现ID分别判已关闭／部分关闭／未关闭／无法核实，给修订后位置、来源与理由；误报排除也有据，局部改正但相关条件仍矛盾不得关闭。
+3. 检查修订回归：新增要求来源与强度／例外、权限／状态／字段、拒绝／失败／未知／恢复、跨主题配套及覆盖。全文逐表核列数和列义，保留有效目标、Q和人工处理依据。
+4. 新问题用新ID标位置、来源、反例影响和建议，区分必修／缺证／可选。输出可交人工审阅／需修订／无法判断、逐发现结果、Q／建议、已读和未执行后停轮；零必修不代业务／工程／测试／发布通过，不自动改稿或更新采用。
+
+## B05 生命周期与必要读取
+
+生命周期、模板及交接合同的实质条款按[统一审查约定](../../review-handoff.md)核对；外层解析并保护原索引／合同，未知自改继续完整读本次选定原件；先列本次必读路径和用途，实际核所选正文及必要依赖，未读／失败／部分读照实。只加载本次recheck动作，不加载其他动作或低优先级源兜底。
+
+业务目标／能力边界／跨PBC责任未变时复用原BRD；新增主题不补造业务批准，变化只改本次明确范围。
+
+本次独立只读，仅会话标注问题／来源／影响／最小建议；不改候选、JSON、Plan、代码或报告。人工可修订、有据不采纳或保留Q；原代码review不由此变成只读。
+
+当前目标、任务与已实现事实分开；已完成任务保留，未实施取消不记完成，进行中保留真实工作，已实现退役通过新任务。原Plan／Build实际接点和JSON辅助仍待后续，不自动下阶段、工程、提交或发布。
+
+## B05收口：单项目审查证据
+
+一次只审本次明确的业务项目／主题；必要跨主题来源仍按影响读取。对每条发现和已核事实分别给目标及来源的实际路径、起止行和短原文摘录，再给理由、反例与最小建议。最终会话按统一审查约定和外层传入的同源Schema输出findings、checkedFacts、verdict和未核范围；不能把成功Read一次当读完，不自报未读输入已核。摘录／读取检查通过仍不证明语义结论成立，误报保留反证，不自动改稿。

package/references/enterprise-sop-resources/brd/templates/BRD.md

@@ -0,0 +1,169 @@
+# BRD 模板
+
+<!-- i3:zh-guide:start -->
+## 中文使用说明
+
+按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
+
+默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
+<!-- i3:zh-guide:end -->
+
+模板版本：v0.0.3。日期：2026-10-17。状态：自有资源候选；模板可供明确采用，业务内容与认可另行记录。
+
+采用[模板与交接合同](../../template-contracts.md)。一个 EBC 维护一份逻辑 BRD，可有多个文档版本。实例文件名为 `{EBC}-BRD_v0.0.1.md`。以下为填写结构；未知项登记 Q，建议/假设明确标注，不适用项说明依据。交付实例时用真实内容替换花括号，不预填认可或执行结果。
+
+BRD 承接原 SPEC 的目标、用户与业务成功依据；工程命令、目录、代码风格和工程动作边界由 AD、测试策略由 TestCase 承接，完整映射见共用合同 §4.1。整理业务草稿不要求先形成这些工程文档；单份 BRD 的认可也不能冒充全部规格已获批准。外部编排遵守原技能停点，不因本模板改变继承能力或强制复制 SPEC。
+
+---
+
+# {EBC名称} — 业务需求文档
+
+| 文档属性 | 实际内容 |
+| --- | --- |
+| EBC 身份与名称 | `{capabilityId；显示名称；责任边界}` |
+| 文档身份、版本、状态 | `{documentId；v0.0.1或实际版本；实际状态}` |
+| 文件位置与固定内容 | `{完整路径或仓库引用；固定副本/提交及摘要；未绑定则注明}` |
+| 发起人、维护者、编写者 | `{真实主体；业务维护与代理编写分开}` |
+| 创建/更新日期 | `{真实日期}` |
+| 采用模板及公共基线 | `{固定模板版本与内容；实际取得的集团/项目基线；缺项及影响}` |
+| 比较基准与确认范围 | `{前一有效版本或无前稿；实际认可来源；未取得确认直写未取得}` |
+
+## 0. 版本历史与采用范围
+
+| 文档版本/日期 | 实际主体 | 修改内容及来源 | 与前版关系 | 受影响 PBC/主题和处理 |
+| --- | --- | --- | --- | --- |
+| `{版本}` | `{主体}` | `{差异与固定依据}` | `{新增/保留/替代；不复用旧编号表示新需求}` | `{具体范围；待处理或实际记录}` |
+
+## 1. 项目背景
+
+### 1.1 原始诉求与现状
+
+`{保留发起人原始诉求或可回读 SRC 引用；描述当前业务方式、涉及对象与已核实事实。原件只读，整理不覆盖原始材料。}`
+
+### 1.2 问题与影响
+
+| 问题 ID | 当前问题 | 受影响对象与后果 | 严重程度及依据 | 来源/认知状态 |
+| --- | --- | --- | --- | --- |
+| `{稳定ID}` | `{具体业务问题}` | `{实际影响}` | `{事实或待核实}` | `{SRC；事实/假设/待决}` |
+
+### 1.3 业务机会
+
+`{为何当前需要改善；无资料则标待调研，不虚构市场、损失、收益或政策要求。}`
+
+## 2. 业务目标
+
+| 目标 ID | 对应问题 | 期望变化 | 当前基线 | 目标值或方向 | 衡量方式/周期 | 来源与确认情况 |
+| --- | --- | --- | --- | --- | --- | --- |
+| `{稳定ID}` | `{问题引用}` | `{业务结果}` | `{实测或Q}` | `{有依据的目标/建议/待定}` | `{口径、样本与观察期}` | `{SRC/真实答复}` |
+
+定性目标同样说明怎样观察改善。目标值在此维护一处；量化条件未决可以保存草稿，不编造默认指标。
+
+## 3. 干系人与目标用户
+
+| 用户/参与方 | 职责与核心诉求 | 主要业务动作 | 可见/可操作范围 | 规模/频率及来源 | 未决事项 |
+| --- | --- | --- | --- | --- | --- |
+| `{真实角色}` | `{职责}` | `{动作}` | `{组织/项目/租户/指定资源或Q}` | `{已知值或待核实}` | `{问题ID}` |
+
+区分需求提出、产品使用、业务决定、代为记录、内容审阅和执行授权；岗位名不自动授予全部权限。
+
+## 4. 业务需求
+
+### 4.1 能力范围
+
+`{EBC 负责的业务闭环与不负责部分；涉及哪些已有或候选 PBC，按真实业务责任说明，不按页面数量拆能力。}`
+
+### 4.2 业务需求明细
+
+| BR ID | 业务需求与价值 | 来源优先级 | 本次采用范围 | 对应问题/目标 | 来源/提出方 | 业务验收要点 |
+| --- | --- | --- | --- | --- | --- | --- |
+| `{稳定BR}` | `{具体诉求}` | `{来源等级或未给定}` | `{本次/后续/候选/排除}` | `{问题/目标}` | `{SRC及真实主体}` | `{可观察结果}` |
+
+BR 拆分、撤回或替代保留关联，不用旧 ID 指代另一诉求。优先级与交付安排分开，不把全部高优需求自动当作已批准范围。
+
+### 4.3 智能能力业务边界（适用时）
+
+`{业务目标、触发者、允许/禁止动作、可信身份、必须由人决定的事项、失败或不确定时的业务表现；无运行时智能需求则写不适用及来源，不因研发使用模型而新增产品智能功能。}`
+
+## 5. 关键用户场景
+
+| 场景 ID | 用户/触发 | 关联 BR | 主流程与业务结果 | 异常、拒绝、重做或退出 | 来源 |
+| --- | --- | --- | --- | --- | --- |
+| `{稳定ID}` | `{谁、何时}` | `{BR引用}` | `{业务步骤}` | `{影响结果的分支}` | `{SRC}` |
+
+新出现的能力须有 BR 来源；未确认建议进入 Q，不暗增范围。
+
+## 6. 业务流程与责任交接
+
+`{用文字或流程图表达现状与目标；各角色/PBC之间交什么、谁维护事实、何时可见、失败后由谁处理。现状事实与拟建方案分开，不把业务流程自动变成审批引擎或微服务。}`
+
+## 7. 非功能要求与外部约束
+
+| 要求 ID | 类别 | 业务要求 | 测量条件/来源 | 适用对象与验证时点 | 未决与责任 |
+| --- | --- | --- | --- | --- | --- |
+| `{稳定ID}` | `{性能/安全/可用性/可访问性等}` | `{业务影响与约束}` | `{有来源的口径或Q}` | `{上线前验证/运行后观察}` | `{真实责任或未指定}` |
+
+集团运行时、前端、数据库、身份、CI/CD 等规则按实际固定版本登记；此处不重新选栈或编写数据库/部署实现。未提供的基线记未取得，不假定不存在。
+
+## 8. 范围与 PBC 分配
+
+| BR/明确约束 | 本次/后续/排除/待定 | 承接 PBC | 产品需求主题或待细化 | 其他责任方/去向 | 依据及缺口 |
+| --- | --- | --- | --- | --- | --- |
+| `{稳定引用}` | `{明确分类}` | `{capabilityId；候选边界标候选}` | `{已有prdId/主题或待定，不预造FR/AC}` | `{实际对象或未分配}` | `{SRC/决定/Q}` |
+
+每条业务诉求和范围外限制都有去向；一个 BR 可以分配给多个 PBC，但共用业务事实应明确权威维护方，不产生相互冲突的副本。“本次不做”不自动变成“以后必须做”。
+
+## 9. 依赖、假设与待决问题
+
+| ID | 类别 | 内容及来源 | 核实状态/当前建议 | 对交接的具体影响 | 责任、时点与关闭依据 |
+| --- | --- | --- | --- | --- | --- |
+| `{DEP/A/Q等稳定ID}` | `{依赖/假设/问题/冲突}` | `{保留冲突双方或假设来源}` | `{未知不代答}` | `{可继续与受阻的PBC/主题/动作}` | `{实际主体或未指定；真实答复引用}` |
+
+## 10. 风险与应对
+
+| 风险 | 可能性与影响依据 | 应对/降级方向 | 责任及待决事项 |
+| --- | --- | --- | --- |
+| `{风险}` | `{事实或显式假设}` | `{建议或已确认措施}` | `{责任/Q}` |
+
+## 11. 验收与业务成功
+
+| 对应目标/BR | 成功结果或验收口径 | 衡量方式与观察期 | 验证时点与参与方 | 来源/未决 |
+| --- | --- | --- | --- | --- |
+| `{引用第2/4章}` | `{可观察结果}` | `{不另写不同目标值}` | `{功能验收/运行观察}` | `{固定依据或Q}` |
+
+功能可用与业务采纳、效率改善等运行效果分别判断，不从测试通过推定收益已实现。
+
+## 12. 里程碑安排
+
+| 里程碑 | 交付 BR/能力范围 | 预期产物 | 时间或依赖条件 | 依据/承诺状态 |
+| --- | --- | --- | --- | --- |
+| `{实际阶段}` | `{明确范围}` | `{文档/可验证结果}` | `{已知安排或待估算}` | `{真实承诺/建议/待定}` |
+
+不得凭模板虚构排期、工作量或团队承诺。
+
+## 13. 来源、认可与交接
+
+### 13.1 来源索引
+
+| SRC ID | 材料位置/提供者 | 固定版本与内容 | 已读范围与用途 | 缺口 |
+| --- | --- | --- | --- | --- |
+| `{稳定引用}` | `{原件或真实答复}` | `{可回读定位/摘要}` | `{事实/制度/参考/模板}` | `{未读或缺失直写}` |
+
+### 13.2 审阅与认可
+
+| BRD 版本/具体范围 | 实际参与者/日期 | 意见、认可或正式批准 | 固定来源与未决限制 |
+| --- | --- | --- | --- |
+| `{准确内容}` | `{未取得则注明}` | `{保留实际原意，不生成签字}` | `{真实记录；局部认可不扩为全文}` |
+
+### 13.3 PRD 交接摘要
+
+`{本次交接的BRD身份/版本/固定内容、承接PBC及主题、BR清单、排除和后续项、Q及影响、适用外部基线。PRD形成后由PRD维护具体功能和AC，不在此预填尚未产生的条目或通过结论。}`
+
+本摘要是业务交接输入，不改变原技能的审批或输出合同。Plan、质量约束、ADR 和实际验证记录等仍按各自适用方法保留，模板状态或填写参与者不产生授权。
+
+## 完成核对
+
+- 原始 SRC 可回读且保持只读，事实/推导/答复/假设分开。
+- 目标、角色、BR、场景、范围外限制及 PBC 去向完整，无无源功能。
+- 权限、历史、质量和业务成功要求未因简化而丢失；未知项有具体影响。
+- 文档版本、模板版本和认可范围明确，不预填批准、编码完成、测试通过或发布。
+- 可交接与不能交接范围分别写明；检查清单本身不是自动门禁或业务系统测试。

package/references/enterprise-sop-resources/codebuddy-project-guide.md

@@ -0,0 +1,34 @@
+# CodeBuddy 项目接入片段
+
+<!-- i3:zh-guide:start -->
+## 中文使用说明
+
+按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
+
+默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
+<!-- i3:zh-guide:end -->
+
+指引版本：v0.7.0。仅在用户明确接入时先读项目 CODEBUDDY.md，只追加以下完整有界片段，保留原内容。已有片段复用，自改／标记不全／符号链接不覆盖；更新先说明差异，按宿主要求新会话验证真实加载，不改全局规则。此指引不是自动安装器或加载证明。
+
+<!-- i3:i3-enterprise-sop:project:start -->
+## i3 企业 SOP 可选资料入口
+
+- 本轮明确标准流程时使用原方法，不读取或采用企业模板、提示词、JSON及企业目录。仅本轮明确企业SOP，或用户明确且适用于本任务的选择记录才启用；安装、本段、PRD字样或handoff.json存在都不代表选择。
+- 先实际读本文件、项目根README、适用docs/README和被引用的采用、来源、输出／命名约定。资源来源、项目真实规范和业务交接选择分开判断。
+- 资源按本轮明确对应材料→项目明确采用副本→同宿主项目安装→同宿主可读全局安装定位。生成／状态等作业实际读选定根README及stages.json；review／recheck由外层解析并保护这两项，依统一审查约定完整读阶段和业务正文。不拿安装根替换项目自改根；已选源缺失、损坏、不可读、版本／主题冲突报告准确缺口，不猜最新或用历史兜底，不恢复发行原件。
+- 读取顺序同样按优先级：先读项目根约定及其采用记录；有已选项目根时，不再读取低优先级安装／全局资源README、索引或正文，除非明确要求比较。不并行探读多套入口再事后只认其中一套。
+- 确定对应角色尚无已选资源时，才读项目.codebuddy/.i3-composer-agent.json，确认name为i3-composer-agent，按resources.references定位enterprise-sop-resources/README.md，路径相对安装清单目录。安装识别只读name／version／scope／resources等必要元数据，可先定位键再读相应范围，不全文加载assets文件列表；项目确实未安装才查同宿主全局清单；损坏／异名／失效清单不当成未安装。可读全局无需重复安装，不跨宿主或全盘搜索。
+- 生成／修订、status、交接和恢复按选定索引实际读sharedContract、handoffContract、lifecycleContract三份共用合同，再读适用阶段资料。review／recheck按所选review-handoff.md分流：外层解析元数据并保留变化检查，模型完整读当前阶段README、模板、唯一动作、业务与实际约束；未知自改继续完整读选定原件，不能把四份动作都当必读。先列本次路径／用途，再逐项成功回读，末尾核未读／失败／部分读；按根与局部manifest解析，含符号链接不得越资源根。只覆盖明确角色，未定组合说明兼容，不静默混版。
+- AD准备按需读technical-baseline辅助资料；本次要求辅助采用／模板核对时，先读索引指定辅助manifest，再读其entry和template，不漏manifest。优先复用项目已有规范／CONSTRAINTS／ADR与真实契约；骨架采用说明指向来源README／源码时也实际读。缺项准确报告文件与依赖范围，不复制总规约或换选型；辅助不是第五阶段或工程资产。
+- 企业路径交接读选定根handoff-contract.md；纯review／recheck依统一审查约定承接其实质条款，未知自改仍完整读选定原件。JSON相对路径基于明确的业务项目根；只读本次主题所选正文及必要依赖，候选不等于选择／批准，新候选不替换selected。没JSON可手动给路径，不强制补清单或重跑BRD；本轮路径覆盖不自动改变持久采用。
+- 当前最小辅助handoff.py支持init／初次或相同select／resolve，清单顶层仅schemaVersion、scope、selected；本修订未测试；先读准确--help，只有本次允许写清单才登记，不改选已有不同对象，完整恢复仍待S08。原Spec停轮时报告待登记路径，后续获准作业补登记。生成后回读并展示路径，不自动写JSON；只有明确采用后才登记selected。选用登记失败保留文档与旧清单，后续只补已选用的引用。只读任务、review／recheck零项目写入，审查报告由获准调用者另存；独立审查需真实新上下文。
+- 沿用项目命名及唯一目标，保留人工内容。同PBC各主题PRD独立版本，AD／TestCase固定直接上游，不强制同号。原型按需并行；TestCase为Plan可选输入，已有则核准确版本，没有则从AD／已采用规范核验证内容并按依赖安排补齐。
+- /i3-sop brd／prd／ad／testcase／plan或显式Skill同动作不必附长提示词；先定位实际已采用材料，仅澄清缺口。宿主可用时结构化提问，否则会话等待；取消／无答复不写文件，目标已有稿时先分新建／修订／恢复，不能猜覆盖。
+- 新项目业务文档默认spec/{能力}/，已采用目录不迁移；模板安装路径不变。四阶段起草／修订必须成功加载原Spec Skill，用外部格式能力写本次目标并保留停轮；纯状态／路径登记不生成规格。
+- 显式/i3-sop plan由同一SOP Skill按所选plan-handoff.md解析清单／明确手动输入并实际调用原规划Skill、履行本宿主原Plan命令合同；也保留原/i3-plan加明确任务。原Plan本身不被本指引改成强制读JSON。Plan／任务保留实际来源，Build按获准任务回读。原方法不会天然读写JSON，不保留一个可变清单链接就当交接成功。原内容／工具／认可／停轮保持，不修改原/i3-spec、原/i3-build auto或using，不生成影子SPEC，不自动后续文档、工程执行、提交或发布。
+- 交接范围可在项目已有采用记录中明确工作、capabilityId＋prdId、唯一清单或手动AD路径；实际填写真实路径，不保留占位。原Plan据AD及准确PRD／规范／契约／骨架／代码核六项，仍写tasks/plan.md与唯一任务目标，保留来源及FR／AC／验证。没有唯一选择先问，不默认读所有主题。
+- 原Build及原Build auto保留有效规格、Git、计划认可、测试／构建／逐任务提交条件；JSON和指引等未提交变化可能触发原停点，不隐藏、不擅自提交。恢复回读来源与任务，设计变更先核计划影响；企业跨阶段auto仍3.1.0。
+- 新增／修改／撤销需求及已实现功能退役按lifecycleContract：稳定身份、完整目标、必要消费者与配套影响；候选、selected、Plan和运行事实分开。已完成任务保留，取消不记完成，进行中保留人工工作，已实现移除须新任务。SOP资料不直接改Plan／代码，后续原Plan获准重规划、Build逐任务；只读预览零项目写入，无JSON也可按路径传递。
+- B05-r2：全部Write／Edit完成后分段完整回读最终稿，之后再改则再次完整回读，不只读改动行冒称全文核对；必要输入缺读如实报告，补读不追认过去已读。只读审查仍零项目写入。
+- 由外层调用者从选定资源根定位verification/check_reads.py，按本次适用清单及CodeBuddy原生轨迹核输入／末次编辑后全文、未选读取和审查摘录。校验不自动启用、不拦截调用、不改业务JSON或原Skill／命令，缺证据准确报告。
+<!-- i3:i3-enterprise-sop:project:end -->

package/references/enterprise-sop-resources/controlled-handoff.md

@@ -0,0 +1,41 @@
+# 单次受控交接
+
+<!-- i3:zh-guide:start -->
+## 中文使用说明
+
+按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
+
+默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
+<!-- i3:zh-guide:end -->
+
+本辅助 v0.4.0 处理明确选用的现有 BRD／PRD／AD／TestCase 路径登记、只读手动交接及[同主题准确组合改选](selection-handoff.md)。本次源码修订尚未测试、尚未发布。显式运行，不是自动安装的 Hook，不提供企业跨阶段 auto，不接管原 Spec／Plan／Build。当前适配项目级 CodeBuddy CLI、Python 3.9+，其他宿主和项目外来源保留手动方式。
+
+## 谁负责什么
+
+- 调用方根据用户本次实际选用意图、项目采用记录和准确主题准备请求；inputs 取直接上游、采用规约、共享契约、工程骨架及本次相关已有工作，不猜最高版本。原任务已经明确选用时直接承接，不要求使用人重复确认或填写全部资源路径。
+- 只读会话只开放 Read／Glob／Grep／Skill，原生加载唯一 SOP Skill 并完整读取必要来源；允许同次补读，不写稿、不提交 shell、不调用原 Spec、Plan 或 Build。原 Spec 仍用于另有明确委托的生成／修订任务。
+- 外层核真实回执、方法范围、文件快照和有界报告。漏读、失败、越界、报告矛盾或输入变化均停止登记，不扩权、循环重试、猜版本或改业务稿。
+- 只读预检通过且本次准确文档已明确选用，外层才以固定 argv、shell=false 执行一次 handoff.py select。初次选用或同路径复用无需候选预登记；不同既有选择走改选预览，不直接替换。
+- 写后只允许本次清单和必要原始字节历史变化。清单顶层仅 schemaVersion、scope、selected；保护其他主题、业务稿、Plan、任务及 scope／selected 内人工内容。旧 candidates／delivery 在已获准选用写入时随旧清单历史留存后移出当前文件，未知顶层字段先明确用途，不静默丢弃。
+
+## 调用约定
+
+调用方在项目外准备一次性 request.json：schemaVersion=1；operation 为 select 或 manual；work 为真实范围；manifest 为已有清单项目相对路径（manual 可省略）；reference 含 role、path，主题文档另有 capabilityId、prdId；inputs 为本次明确采用的来源路径数组；task 为真实任务。首次选用前可在本次明确权限内初始化三字段清单，入口本身不自动初始化。
+
+```bash
+python3 <资料根>/controlled_handoff.py --project-root <项目根> --request <调用方请求.json> --evidence-dir <全新项目外证据目录>
+```
+
+用户已明确选用本次准确文档时，调用方才加 --select-reference。没有选用委托则只返回原因、推荐及选项，不写清单；manual 始终零项目写入。选用不是业务批准或 Plan 开工批准，原方法停轮保持。
+
+旧候选登记／撤回操作和 --register-candidate、--withdraw-candidate 已移除，不转换为选用授权。未选稿件只保留实际文件和会话路径，不维护待审队列，不为弃用某稿而改 JSON 或删文件。
+
+同主题改选继续使用 selection-preview／selection-switch；只有真人确认准确预览，后续切换才加 --switch-selection，并经过新的只读预检及快照核对。该参数与 --select-reference 互不替代，预览不写项目。请求和结果位于项目外证据目录，不成为业务 JSON 的审批或任务状态。
+
+## 问题交互
+
+结果含 status、reason、recommendation、options 和真实登记尝试。缺来源、选用冲突、人工改稿取舍、拒绝或并发变化须保留现场，给原因及可选操作，不承诺宿主弹窗。methodIssues、工具真实失败、报告问题及文件变化分开；成功加载禁止方法属于方法越界，不能伪造为工具 failed 或 blocked。
+
+## 保证范围
+
+入口只约束由此进入的一次作业；原命令、其他会话和其他宿主不自动挂载该保护。工具限制依赖宿主执行，完整读取不证明理解或业务批准；瞬时文件快照不禁止用户以后修改，基础锁不保证跨编辑器事务。证据目录必须全新且在项目外；只有一次原生会话，无自动循环复测。旧验证记录只对旧候选流程有效，本修订未运行测试。