soloforge 1.1.45 → 1.1.47

package/templates/design//346/236/266/346/236/204/350/256/276/350/256/241.md

@@ -12,8 +12,8 @@ extra:
   products:
     - '*'
   lifecycle_status: active
-  version: 1.2.0
-  last_reviewed: '2026-06-04'
+  version: 2.0.0
+  last_reviewed: '2026-06-17'
   type: artifact
   domain: design
   stage: design
@@ -22,34 +22,23 @@ extra:
 
 # 架构设计文档
 
-## 1. 决策记录、范围与证据
-- 架构决策记录引用：`docs/architecture/00-架构决策记录.md`
-- 用户确认引用：
-- 输入证据引用：
-
-> **根本目标引用**：本产物的 `fundamental_need` 见需求分析文档 §1.3。若未声明，引用审查规则 FP-01。
-
-## 2. 六类架构决策状态总表
+> **产物定位**：架构阶段（4 阶段第 2 步）的产出。把"怎么做"想清楚，承接需求分析的 fundamental_need。
+> **核心纪律**：每条架构决策须有 ADR 留痕（[[开发者宪法]]），技术选型须有依据而非凭主流（[[证据驱动与反幻觉]]），须考虑回滚/兼容/安全。
+> **完成判定**：见文末。
 
-| 架构域 | 状态 | 结论 | decision_id | user_confirmation_ref | 影响产物 |
-|--------|------|------|-------------|-----------------------|----------|
-
-## 3. 需求概要
-
-### 3.1 系统角色与关注点
-| 角色 | 关注点 | 说明 |
-|------|--------|------|
+## 1. 决策记录与范围
+- 架构决策记录：`docs/architecture/00-架构决策记录.md`
+- 根本目标引用：需求分析 §1.3 `fundamental_need`
+- 输入证据引用：
 
-### 3.2 功能需求引用
-> 引用需求分析阶段的 REQ-* ID，附摘要
+## 2. 需求概要
 | REQ-ID | 需求摘要 | 对应架构模块 |
 |--------|---------|-------------|
 
-### 3.3 非功能需求清单
 | NFR-ID | 类别 | 指标 | 目标值 | 验证方式 |
 |--------|------|------|-------|---------|
 
-## 3a. 约束条件
+## 3. 约束条件
 | 约束类型 | 描述 | 来源 | 影响范围 |
 |---------|------|------|---------|
 | 技术约束 | | | |
@@ -59,53 +48,29 @@ extra:
 
 ## 4. 模块划分
 - 模块清单与职责边界
-- 模块间依赖关系图
+- 模块间依赖关系
 - 核心接口契约（模块间调用方式）
 
-## 4a. 架构范式选择（可选）
-
-### 参考范式清单
-| 范式 | 解决什么问题 | 典型适用场景 |
-|------|------------|------------|
-| DDD | 业务边界划分 | 业务领域复杂 |
-| Clean Architecture | 依赖方向控制 | 中大型系统 |
-| Hexagonal | 外部依赖隔离 | 多接入方式 |
-| Modular Monolith | 模块边界 | 不确定是否微服务 |
-| GRASP | 职责归属 | 代码组织混乱 |
-| SOLID | 代码质量 | 所有项目 |
-| ADR | 决策可追溯 | 所有中大型项目 |
-
-### 本项目采用的范式
-| 范式 | 适用范围 | 关键约束 | 决策引用 |
-|------|---------|---------|---------|
-| （仅列出选择采用的） | | | |
-
-### 偏差处理
-选择的范式如需偏离，须在 Ch1 ADR 中记录偏离原因。
-
-## 5. 业务流程、数据流向与关键 Mermaid 时序图
-- 主流程数据流向图
-- 关键数据结构定义
+## 5. 业务流程与数据流向
+- 主流程数据流向图（Mermaid）
+- 核心业务流程时序图（每个核心流程一张，请求入口→持久化→响应完整链路）
 - 数据存储方案（数据库/缓存/文件）
 
-## 6. 前端、后端、安全与基础设施架构
+## 6. 架构组成
 
-### 6.1 系统上下文（C4 Level 1）
-- 系统边界与外部系统交互图
+### 6.1 系统上下文（C4 L1）
+- 系统边界与外部系统交互
 - 用户角色与接入方式
-- 外部依赖清单
 
-### 6.2 后端架构（C4 Level 2-3）
+### 6.2 后端架构（C4 L2-3）
 - 服务拆分与职责
 - 核心接口契约
 - 数据存储方案
-- **核心业务流程系统实现时序图**（每个核心业务流程必须有一张 Mermaid sequenceDiagram，
-  展示从请求入口到持久化到响应的完整调用链）
 
-### 6.3 前端架构（C4 Level 2-3）
+### 6.3 前端架构（C4 L2-3）
 - 应用结构与路由
 - 状态管理策略
-- 组件分层方案
+- 组件分层
 
 ### 6.4 安全架构
 - 认证与授权方案
@@ -113,17 +78,18 @@ extra:
 - 安全边界与信任域
 
 ### 6.5 基础设施与部署
-- 部署架构图
+- 部署架构
 - 环境规划（开发/测试/预发/生产）
 - CI/CD 策略
-- 监控与告警方案
+- 监控告警
 
 ## 7. 技术选型与依据
 | 技术决策 | 候选方案 | 最终选择 | 选择理由 | 放弃方案原因 |
 |---------|---------|---------|---------|------------|
-|         |         |         |         |            |
 
-## 8. 数据库与 API 专项产物引用
+> 选型须有依据（性能/成本/团队熟悉度/生态），禁止"业界主流所以选它"。详见 [[决策与选型]]。
+
+## 8. 专项产物引用
 - 数据库设计：`docs/design/01-数据库设计文档.md`
 - API 规格：`docs/design/02-API接口规格文档.md`
 - OpenAPI：`docs/api/openapi.yaml`
@@ -133,39 +99,31 @@ extra:
 - 核心业务状态流转
 - 触发条件、守卫条件、失败/回滚动作
 
-## 10. 非功能需求、验证策略、风险与回滚
-
-### 10.1 性能预算与质量目标
-| 类别 | 指标 | 目标值 | 测量方式 | 关联 ADR |
-|------|------|-------|---------|---------|
+## 10. 风险与回滚（必填）
 
-### 10.2 风险登记
-| RISK-ID | 风险描述 | 概率 | 影响 | 应对方案 | 关联 ADR | 状态 |
-|---------|---------|------|------|---------|---------|------|
+### 10.1 风险登记
+| RISK-ID | 风险描述 | 概率 | 影响 | 应对方案 | 关联 ADR |
+|---------|---------|------|------|---------|---------|
 
-### 10.3 回滚与灾难恢复
+### 10.2 回滚与灾难恢复
 | 场景 | RTO | RPO | 恢复策略 | 触发条件 |
 |------|-----|-----|---------|---------|
 
-### 10.4 验证策略
-| NFR-ID | 验证方法 | 验证时机 | 通过标准 |
-|--------|---------|---------|---------|
-
-## 11. 未决项、延期影响和变更追踪
+> 任何上线变更必须有回滚方案（[[开发者宪法]]）。
 
-## 12. 扩展点
-- 已识别的未来扩展方向
-- 预留的扩展机制（接口/配置/插件）
-
-## 13. 跨横切关注点
+## 11. 跨横切关注点
 | 关注点 | 方案 | 影响模块 |
 |--------|------|---------|
 | 日志与审计 | | |
 | 错误处理 | | |
 | 缓存策略 | | |
-| 国际化/本地化 | | |
 | 配置管理 | | |
 
-## 14. 术语表
-| 术语 | 定义 | 来源 |
-|------|------|------|
+## 完成判定
+
+- [ ] 每条架构决策有对应 ADR，重大选型经用户确认
+- [ ] 约束条件覆盖技术/组织/法规/预算
+- [ ] 含安全架构（认证/授权/加密）
+- [ ] 含风险登记 + 回滚方案（RTO/RPO）
+- [ ] 跨横切关注点（日志/错误/缓存/配置）有方案
+- [ ] 引用的数据库/API 专项产物路径有效

package/templates/design//351/234/200/346/261/202/345/210/206/346/236/220.md

@@ -12,8 +12,8 @@ extra:
   products:
     - '*'
   lifecycle_status: active
-  version: 1.3.0
-  last_reviewed: '2026-06-04'
+  version: 2.0.0
+  last_reviewed: '2026-06-17'
   type: artifact
   domain: design
   stage: design
@@ -22,6 +22,10 @@ extra:
 
 # 需求分析文档
 
+> **产物定位**：需求阶段（4 阶段第 1 步）的产出。把"做什么"想清楚，不是"怎么做"。
+> **核心纪律**（[[工程执行总纲]]）：先暴露阻塞困惑，禁止把模糊需求直接转成方案；区分事实/假设/需确认。[[证据驱动与反幻觉]]：需求声明要有来源证据。
+> **完成判定**：见文末，不满足不算交付。
+
 ## 1. 需求来源
 - 需求文档/原型链接：
 - 提出人：
@@ -33,91 +37,59 @@ extra:
 **用户需要达成什么？（非解决方案描述）**
 
 fundamental_need: <!-- 如"用户需要在一个会话中选购多件商品并一次性结算" -->
-confirmed_by: <!-- 用户确认标记 -->
+confirmed_by: <!-- 用户确认标记，未确认不得进入实现 -->
 
-> **正反示例**：
+> 正反示例：
 > - ❌ `fundamental_need: "做一个购物车页面"` — 这是解决方案
 > - ✅ `fundamental_need: "用户需要在一个会话中选购多件商品并一次性结算"` — 这是用户目标
->
-> 引用审查规则：FP-01（第一性原理推理规则）
 
 ## 2. 功能点清单
 
-| 编号 | 功能点 | 页面/接口 | 业务规则 | 关联角色 | 前置依赖 | 关联功能 | 验收标准 | 状态 |
-|------|--------|----------|---------|---------|---------|---------|---------|------|
-| REQ-001 | | | | | | | | 待确认/已确认 |
+| 编号 | 功能点 | 页面/接口 | 业务规则 | 关联角色 | 前置依赖 | 验收标准 | 状态 |
+|------|--------|----------|---------|---------|---------|---------|------|
+| REQ-001 | | | | | | | 待确认/已确认 |
 
 ## 3. 术语表
 | 术语 | 含义 | 同义词（统一为） |
 |------|------|----------------|
-| | | |
 
 ## 4. 未确认项
 | 编号 | 问题 | 影响范围 | 阻塞程度 | 负责人 |
 |------|------|---------|---------|--------|
 | | | | 阻塞/非阻塞 | |
 
-## 5. 写操作失败反馈
-| 操作 | 失败场景 | 用户提示 | 重试建议 | 是否可恢复 |
-|------|---------|---------|---------|-----------|
-| | | | | |
-
-## 6. 菜单权限规划
-| 菜单路径 | 关联功能 | 角色 | 权限标识 | 默认可见 |
-|---------|---------|------|---------|---------|
-| | | | | |
+> 阻塞级未确认项不解决不得进入实现（[[工程执行总纲]] 思考先行）。
 
-## 7. 冲突与越界项
+## 5. 冲突与越界项
 | 项 | 类型（冲突/越界） | 来源 | 处理方式 |
 |----|-----------------|------|---------|
 | | | | 排除/延期/升级确认 |
 
-## 8. 非功能需求
-
-### 8.1 性能要求
-
-| 编号 | 类别 | 要求描述 | 验收指标 | 优先级 | 来源 |
-|------|------|---------|---------|--------|------|
-| NFR-001 | 性能 | <!-- 如：页面首次加载时间 --> | <!-- 如：< 3s --> | P0/P1/P2 | |
-
-### 8.2 安全要求
-
-| 编号 | 类别 | 要求描述 | 验收指标 | 优先级 | 来源 |
-|------|------|---------|---------|--------|------|
-| NFR-002 | 安全 | <!-- 如：敏感数据传输加密 --> | <!-- 如：TLS 1.2+ --> | P0/P1/P2 | |
-
-### 8.3 可用性要求
-
-| 编号 | 类别 | 要求描述 | 验收指标 | 优先级 | 来源 |
-|------|------|---------|---------|--------|------|
-| NFR-003 | 可用性 | <!-- 如：系统可用率 --> | <!-- 如：≥ 99.9% --> | P0/P1/P2 | |
-
-### 8.4 兼容性要求
-
-| 编号 | 类别 | 要求描述 | 验收指标 | 优先级 | 来源 |
-|------|------|---------|---------|--------|------|
-| NFR-004 | 兼容性 | <!-- 如：目标浏览器版本 --> | <!-- 如：Chrome/Safari/Firefox 最新 2 版 --> | P0/P1/P2 | |
-
-### 8.5 数据要求
+## 6. 非功能需求
 
 | 编号 | 类别 | 要求描述 | 验收指标 | 优先级 | 来源 |
 |------|------|---------|---------|--------|------|
-| NFR-005 | 数据 | <!-- 如：数据保留策略 --> | <!-- 如：日志保留 90 天 --> | P0/P1/P2 | |
-
-> 若需求来源未提及 NFR，按项目默认 NFR 基线补齐：响应 < 3s、并发 100 用户、遵循项目安全基线、99.9% 可用率、主流浏览器最新 2 版。
-
-## 9. 用户角色
+| NFR-001 | 性能 | <!-- 如：页面首次加载 --> | <!-- < 3s --> | P0/P1/P2 | |
+| NFR-002 | 安全 | <!-- 如：敏感数据传输加密 --> | <!-- TLS 1.2+ --> | P0/P1/P2 | |
+| NFR-003 | 可用性 | <!-- 如：系统可用率 --> | <!-- ≥ 99.9% --> | P0/P1/P2 | |
 
-| 角色名称 | 角色描述 | 关联功能 | 关联菜单 | 数据权限范围 |
-|---------|---------|---------|---------|------------|
-| <!-- 如：管理员 --> | <!-- 职责和使用场景 --> | REQ-NNN | <!-- 第 6 章菜单路径 --> | <!-- 可访问的数据范围 --> |
+> 若需求来源未提及 NFR，按项目默认基线补齐：响应 < 3s、并发 100 用户、遵循项目安全基线、99.9% 可用率、主流浏览器最新 2 版。
 
-> 角色名称必须在第 6 章菜单权限和第 2 章功能点中保持一致引用。
-
-## 10. 外部接口与集成
+## 7. 用户角色与权限
+| 角色名称 | 角色描述 | 关联功能 | 数据权限范围 |
+|---------|---------|---------|------------|
 
+## 8. 外部接口与集成
 | 外部系统 | 接口类型 | 用途 | 数据流向 | 可用性要求 | 负责方 |
 |---------|---------|------|---------|----------|--------|
 | | API/Webhook/SDK/文件 | | 出/入/双向 | SLA 要求 | 己方/对方/三方 |
 
-> 若系统无外部依赖，在此章显式标注"本系统无外部接口依赖"。
+> 若系统无外部依赖，显式标注"本系统无外部接口依赖"。
+
+## 完成判定
+
+- [ ] `fundamental_need` 是用户目标而非解决方案，且 `confirmed_by` 已标记
+- [ ] 每个 REQ 有验收标准（可验证，非"功能正常"模糊表述）
+- [ ] 阻塞级未确认项已解决或已升级
+- [ ] NFR 有量化验收指标
+- [ ] 无证据的需求声明已标注来源/不确定

package/templates/operate/enforced.md

@@ -5,6 +5,8 @@ gate: operate-gate
 title: operate阶段强制检查清单
 sync_policy: engine_only
 status: active
+extra:
+  owner_mechanism: mc-stage-gate-engine
 checks:
   - id: OPR-G01
     executor: file_evidence
@@ -46,6 +48,15 @@ checks:
     evidence_required: ["校验 SQL 结果 + 覆盖表/记录数"]
     gate: operate-gate
     target: "self"
+  - id: RELNOTE-STRUCT
+    executor: document_structure
+    check_type: deterministic
+    severity: warning
+    gate: operate-gate
+    required_artifact: 发布说明模版
+    rule: "发布说明须包含「1. 版本信息」「2. 变更摘要」「5. 验证结果」「6. 回滚方案」章节"
+    evidence_required: ["docs/audits/04-发布说明.md"]
+    target: "self"
 ---
 
 # operate-gate 强制检查清单

package/templates/operate//344/270/212/347/272/277/350/247/202/345/257/237.md

@@ -1,57 +1,78 @@
 ---
-id: ka-rule-domain-operate-rollout-monitoring
+id: ka-guidance-上线观察
 kind: guidance
 title: 上线观察
+sync_policy: copy_to_project
+status: active
 triggers:
   - 上线
   - 观察
   - 监控
   - rollout
-sync_policy: copy_to_project
-status: active
+  - 灰度
+  - 发布
+  - 回滚
+  - 熔断
+  - 发布后
+target_artifact:
+  - deploy_config
+  - release_note
 extra:
-  updated_at: '2026-06-15'
-  lifecycle_status: active
   name: rollout-monitoring
   scope:
     - '*'
   products:
-    - deploy_config
-    - release_note
-  type: constraint
-  version: 1.0.0
-  last_reviewed: '2026-06-11'
-  domain:
-    - operate
+    - '*'
+  type: procedure
+  lifecycle_status: active
+  version: 2.0.0
+  last_reviewed: '2026-06-17'
   verification_layer: L2
   stage: operate
+  domain: operate
   owner_mechanism: mc-domain-operate
 ---
 
-## 上线观察规则
+# 上线观察：发布后怎么盯、什么时候回滚
+
+> operate-gate 的 OPR-G01~05 是确定性门禁；本 guidance 是发布值守的方法。
+> [[开发者宪法]]：破坏性/线上操作必须可回滚、有人盯。
+
+## 灰度发布
+
+- 小流量先上（1% → 10% → 50% → 100%），每档观察一个周期
+- 每档观察指标无异常再放量
+- 灰度期间保留快速回滚能力
+
+## 观察指标（对应 OPR-G01~03）
+
+- **错误率**：5xx 在基线 ±20% 内（OPR-G01）
+- **延迟**：P99 不超基线 1.5 倍（OPR-G02）
+- **新错误模式**：日志无部署前不存在的错误（OPR-G03）
+- **业务指标**：核心业务量/转化率无异常下跌
 
-### 观察指标
+## 熔断回滚
 
-1. **错误率监控**
-   - 上线后 15 分钟内 5xx 错误率不得超过基线的 2 倍
-   - 新增的错误码必须立即通知
+回滚触发条件（命中任一立即回滚，不要犹豫）：
+- 错误率超基线 2 倍且持续
+- P99 超基线 3 倍
+- 业务核心指标崩跌
+- 数据不一致告警
 
-2. **延迟监控**
-   - P99 延迟不得超过基线的 1.5 倍
-   - 关键接口响应时间必须持续观察 30 分钟
+回滚操作：
+- 按预演过的回滚方案执行（OPR-G04，总耗时 ≤ 5 分钟）
+- 回滚后确认指标恢复 + 数据一致性（OPR-G05）
+- 留痕：回滚原因/时间/操作人/结果
 
-3. **业务指标**
-   - 核心业务流程（下单/支付/登录）成功率不得下降
-   - 数据一致性校验必须在上线后执行
+## 发布后验证
 
-4. **回滚触发条件**
-   - 错误率超过阈值 → 自动回滚
-   - 业务流程完全中断 → 立即回滚
-   - 数据不一致 → 暂停发布 + 人工评估
+- 数据一致性校验 SQL 全过（OPR-G05）
+- 核心业务流程线上复验（非只看监控）
+- 确认无遗留告警
 
-### 验收项
+## 禁止
 
-- [AC-01] 监控面板已就绪
-- [AC-02] 告警阈值已配置
-- [AC-03] 回滚触发条件已定义
-- [AC-04] 观察窗口期已设定（至少 30 分钟）
+- 无回滚方案就上线（违规）
+- 全量直上无灰度（违规，除非低风险配置变更且说明）
+- 指标异常不回滚硬扛（违规）
+- 回滚方案没演练过（违规，OPR-G04）

package/templates/operate//345/217/221/345/270/203/350/257/264/346/230/216.md

@@ -22,6 +22,9 @@ extra:
 
 # 发布说明
 
+> **产物定位**：operate 阶段产出。记录发布内容/影响/验证/回滚，是上线可追溯的凭证。
+> **核心纪律**：任何上线变更必须有回滚方案（[[开发者宪法]]）；发布说明须含回滚章节（operate-gate RELNOTE-STRUCT 守护）。
+
 ## 1. 版本信息
 - 版本号：
 - 发布日期：

package/templates/operate//351/203/250/347/275/262/351/205/215/347/275/256.md

@@ -0,0 +1,83 @@
+---
+id: ka-artifact-部署配置
+kind: artifact
+title: 部署配置
+sync_policy: copy_to_project
+status: active
+extra:
+  name: deploy-config
+  scope:
+    - '*'
+  products:
+    - '*'
+  lifecycle_status: active
+  version: 1.0.0
+  last_reviewed: '2026-06-17'
+  type: artifact
+  domain: operate
+  stage: operate
+  owner_mechanism: mc-generic-artifact
+---
+
+# 部署配置
+
+> **产物定位**：operate 阶段必出。把环境、依赖、部署方式、健康检查、回滚定清楚。
+> **核心纪律**：部署可回滚（[[开发者宪法]]）；配置走环境变量不硬编码（[[安全加固]]）。
+> **完成判定**：见文末。
+
+## 1. 环境规划
+| 环境 | 用途 | 访问范围 | 数据来源 | 配置差异 |
+|------|------|---------|---------|---------|
+| 开发 | | | | |
+| 测试 | | | | |
+| 预发 | | | | |
+| 生产 | | | | |
+
+## 2. 环境变量与密钥
+| 变量名 | 用途 | 是否敏感 | 默认值 | 各环境取值来源 |
+|--------|------|---------|--------|--------------|
+
+> 敏感变量必须走密钥管理/环境变量注入，禁止写入镜像或代码（shared-gate SEC-02）。
+
+## 3. 依赖服务
+| 服务 | 用途 | 版本 | 访问方式 | SLA/可用性要求 | 失败降级 |
+|------|------|------|---------|--------------|---------|
+| 数据库 | | | | | |
+| 缓存 | | | | | |
+| 消息队列 | | | | | |
+
+## 4. 部署方式
+- 部署形态：Docker / k8s / 裸机 / Serverless
+- 镜像/制品来源：
+- 部署流程：构建 → 推送 → 拉起 → 健康检查 → 放量
+
+## 5. 健康检查与资源
+| 项 | 配置 |
+|----|------|
+| 健康检查端点 | |
+| 就绪检查 | |
+| 存活检查 | |
+| CPU/内存限制 | |
+| 副本数/扩缩容策略 | |
+
+## 6. 监控告警
+| 指标 | 告警阈值 | 处理动作 |
+|------|---------|---------|
+| 错误率 | | |
+| P99 延迟 | | |
+| 资源使用率 | | |
+
+## 7. 回滚方案（必填）
+| 场景 | 回滚方式 | 回滚耗时 | 验证方法 | 触发条件 |
+|------|---------|---------|---------|---------|
+
+> operate-gate OPR-G04：回滚预案须在预发演练，总耗时 ≤ 5 分钟。
+
+## 完成判定
+
+- [ ] 四环境规划完整（开发/测试/预发/生产）
+- [ ] 敏感变量标注并走密钥管理（无硬编码）
+- [ ] 依赖服务列出失败降级
+- [ ] 健康检查（就绪+存活）配置
+- [ ] 监控告警覆盖错误率/延迟/资源
+- [ ] 回滚方案有且可演练

package/templates/shared/enforced.md

@@ -2,17 +2,21 @@
 id: shared-enforced
 kind: enforced
 gate: shared-gate
-title: 跨阶段通用强制检查清单
+title: 共享硬底线
 sync_policy: engine_only
 status: active
+extra:
+  owner_mechanism: mc-stage-gate-engine
 checks:
+  # —— SoloForge 自身架构边界（守护引擎不被污染）——
   - id: SHD-LLM01
     executor: regex_pattern_scan
     rule: "SoloForge 源码禁止直接调用 LLM API（架构边界：编排引擎不绑定模型，产出上限由客户端 AI 决定）"
     severity: error
     check_type: deterministic
     pattern: '/(?:anthropic|openai)\.(?:messages|chat)\.(?:create|completions)|new\s+Anthropic\(|new\s+OpenAI\(/'
-    languages: [通用]
+    languages:
+      - 通用
     evidence_required:
       - "regex_pattern_scan 扫描结果（src/ 无 LLM API 直接调用命中）"
     gate: shared-gate
@@ -23,13 +27,50 @@ checks:
     severity: warning
     check_type: deterministic
     pattern: '/throw\s+new\s+Error\(\s*"[A-Za-z]/'
-    languages: [ts, 通用]
+    languages:
+      - ts
+      - 通用
     evidence_required:
       - "regex_pattern_scan 扫描结果（src/ 无英文 throw Error/日志）"
     gate: shared-gate
     target: self
+  # —— 用户项目代码安全底线 ——
+  - id: SEC-01
+    executor: regex_pattern_scan
+    rule: "禁止提交私钥内容（含 BEGIN PRIVATE KEY 头）"
+    severity: error
+    check_type: deterministic
+    pattern: '/-----BEGIN (RSA |EC |DSA |OPENSSH |)PRIVATE KEY-----/'
+    languages:
+      - 通用
+    evidence_required:
+      - "regex_pattern_scan 扫描结果（git diff 变更文件无私钥泄露）"
+    gate: shared-gate
+    target: self
+  - id: SEC-02
+    executor: regex_pattern_scan
+    rule: "禁止硬编码高熵密钥/密码（password/secret/api_key/token 赋值字面量）"
+    severity: warning
+    check_type: deterministic
+    pattern: "/(password|passwd|secret|api[_-]?key|access[_-]?key|private[_-]?key|auth[_-]?token)\\s*[:=]\\s*[\"'][^\"'\\s]{12,}/i"
+    languages:
+      - 通用
+    evidence_required:
+      - "regex_pattern_scan 扫描结果（命中须确认是否测试 fixture/文档示例，真实密钥必须改走环境变量或密钥管理）"
+    gate: shared-gate
+    target: self
 ---
 
-# shared-gate 跨阶段通用强制检查清单
+# shared-gate 共享硬底线
+
+跨所有阶段、不可商量的底线。`gate_registry_bridge` 从此文件聚合到 shared-gate。分两类：
+
+**SoloForge 自身架构边界**（守护引擎源码不被污染）：
+- `SHD-LLM01`：源码不直接调 LLM（error）—— 编排引擎不绑定模型
+- `SHD-COMMENT01`：源码错误/日志中文（warning）
+
+**用户项目代码安全底线**：
+- `SEC-01`：私钥泄露（error，高确定性零误报）
+- `SEC-02`：硬编码密钥（warning，可能误报测试 fixture，命中后人工确认）
 
-跨阶段通用强制规则（所有研发阶段都适用，由 shared-gate 聚合）。
+> 各域代码质量门禁（中文注释/无空 catch/类型安全/Controller 不含业务逻辑等）见对应域 enforced；路径穿越写入由运行时 scope_controller 强制，不在此重复。