soloforge 1.1.38 → 1.1.40

package/templates/internal/rules/OOD/344/270/216SOLID/350/256/276/350/256/241/350/247/204/345/210/231.md

@@ -7,25 +7,13 @@ products:
   - '*'
 id: ka-hard-rule-OOD与SOLID设计规则
 type: governance_rule
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-ood-solid-contract
 asset_role: required
 consumed_by:
   - mc-ood-solid-contract
-primary_triggers:
-  - 面向对象设计
-  - SOLID
-secondary_triggers:
-  - 领域服务
-  - 重构
-  - 策略
-negative_triggers:
-  - 文案
-  - 样式
 priority: P1
-specificity: 5
 consumes:
   - mc-coding-readiness
 hard_blocks:

package/templates/internal/rules//344/272/247/347/211/251/345/245/221/347/272/246/350/247/204/345/210/231.md

@@ -5,16 +5,10 @@ scope:
 products:
   - '*'
 id: ka-hard-rule-产物契约规则
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-artifact-contract
-primary_triggers:
-  - 产物契约规则
-secondary_triggers: []
-negative_triggers: []
 priority: P0
-specificity: 5
 consumes:
   - mc-workflow-contract
 hard_blocks:
@@ -27,8 +21,8 @@ required_evidence:
 version: 1.1.0
 last_reviewed: '2026-06-01'
 type: governance_rule
-when: 产物契约规则
 stages: ["*"]
+triggers: ["产物契约规则"]
 ---
 
 # 产物契约规则

package/templates/internal/rules//344/273/243/347/240/201/346/263/250/351/207/212/344/270/216/346/227/245/345/277/227/345/245/221/347/272/246/350/247/204/345/210/231.md

@@ -6,35 +6,10 @@ products:
   - '*'
 id: ka-hard-rule-代码注释与日志契约规则
 type: governance_rule
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-code-maintainability-observability-contract
-primary_triggers:
-  - 业务编码
-  - 接口实现
-  - 状态流转
-  - 支付
-  - 权限
-  - 迁移脚本
-  - 数据修复
-secondary_triggers:
-  - Service
-  - Controller
-  - UseCase
-  - Handler
-  - Router
-  - Form
-  - Store
-  - 异常处理
-negative_triggers:
-  - 文案
-  - 样式
-  - getter
-  - setter
-  - fixture
 priority: P0
-specificity: 5
 consumes:
   - mc-coding-readiness
 hard_blocks:
@@ -88,7 +63,7 @@ stages: ["*"]
 
 ## 日志契约
 
-### 必须有日志
+### 日志中必须有
 - 用户登录、登出、认证失败
 - 权限拒绝、越权访问
 - 创建、修改、删除关键业务对象
@@ -101,7 +76,7 @@ stages: ["*"]
 - 降级、兜底、补偿逻辑
 - 前端关键交互：表单提交、状态变更、权限动作、支付/敏感操作、上传导入、API 调用失败
 
-### 日志必须具备
+### 日志必须具备的要素
 - 中文事件名或中文动作说明
 - 事件名或动作名
 - 业务对象 ID
@@ -111,7 +86,7 @@ stages: ["*"]
 - 关键状态变化前后值
 - 合理日志级别
 
-### 必须禁止
+### 日志中必须禁止
 - 裸 console.log（生产代码）
 - 生产代码遗留调试日志
 - catch 后无日志直接吞异常

package/templates/internal/rules//344/273/273/345/212/241/344/270/212/344/270/213/346/226/207/347/224/237/345/221/275/345/221/250/346/234/237/350/247/204/345/210/231.md

@@ -6,7 +6,6 @@ products:
   - '*'
 id: ka-hard-rule-任务上下文生命周期规则
 type: governance_rule
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-task-context-lifecycle
@@ -15,15 +14,7 @@ consumed_by:
   - mc-task-context-lifecycle
   - consumable_asset_registry
   - knowledge_injection
-primary_triggers:
-  - 任务上下文生命周期规则
-secondary_triggers:
-  - TaskContext
-  - 任务上下文
-  - task_context
-negative_triggers: []
 priority: P1
-specificity: 5
 consumes:
   - mc-task-context-lifecycle
 hard_blocks:

package/templates/internal/rules//345/220/216/347/253/257/345/256/236/347/216/260/345/267/245/347/250/213/345/245/221/347/272/246/350/247/204/345/210/231.md

@@ -6,25 +6,13 @@ products:
   - '*'
 id: ka-hard-rule-后端实现工程契约规则
 type: governance_rule
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-backend-implementation-contract
 asset_role: required
 consumed_by:
   - mc-backend-implementation-contract
-primary_triggers:
-  - 后端实现
-  - 接口实现
-secondary_triggers:
-  - Controller
-  - DTO
-  - 事务
-  - 幂等
-negative_triggers:
-  - 文案
 priority: P1
-specificity: 5
 consumes:
   - mc-coding-readiness
 hard_blocks:

package/templates/internal/rules//345/221/275/344/273/244/346/211/247/350/241/214/350/247/204/345/210/231.md

@@ -5,16 +5,10 @@ scope:
 products:
   - '*'
 id: ka-hard-rule-命令执行规则
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-command-execution
-primary_triggers:
-  - 命令执行规则
-secondary_triggers: []
-negative_triggers: []
 priority: P0
-specificity: 5
 consumes:
   - mc-tool-invocation-contract
 hard_blocks:
@@ -27,8 +21,8 @@ required_evidence:
 version: 1.1.0
 last_reviewed: '2026-06-01'
 type: governance_rule
-when: 命令执行规则
 stages: ["*"]
+triggers: ["命令执行规则"]
 ---
 
 # 命令执行规则

package/templates/internal/rules//345/221/275/344/273/244/350/267/257/347/224/261/350/247/204/345/210/231.md

@@ -6,16 +6,10 @@ products:
   - '*'
 id: ka-hard-rule-命令路由规则
 type: governance_rule
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-command-router
-primary_triggers:
-  - 命令路由规则
-secondary_triggers: []
-negative_triggers: []
 priority: P0
-specificity: 5
 stages: ["*"]
 version: 1.0.0
 last_reviewed: '2026-06-02'

package/templates/internal/rules//345/267/245/344/275/234/346/265/201/345/245/221/347/272/246/350/247/204/345/210/231.md

@@ -5,16 +5,10 @@ scope:
 products:
   - '*'
 id: ka-hard-rule-工作流契约规则
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-workflow-contract
-primary_triggers:
-  - 工作流契约规则
-secondary_triggers: []
-negative_triggers: []
 priority: P0
-specificity: 5
 consumes:
   - mc-workflow-contract
 hard_blocks:
@@ -27,8 +21,8 @@ required_evidence:
 version: 1.1.0
 last_reviewed: '2026-06-01'
 type: governance_rule
-when: 工作流契约规则
 stages: ["*"]
+triggers: ["工作流契约规则"]
 ---
 
 # 工作流契约规则

package/templates/internal/rules//345/267/245/344/275/234/346/265/201/345/257/274/350/210/252/345/245/221/347/272/246/350/247/204/345/210/231.md

@@ -6,7 +6,6 @@ products:
   - '*'
 id: ka-hard-rule-工作流导航契约规则
 type: governance_rule
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-workflow-navigation-contract
@@ -15,17 +14,7 @@ consumed_by:
   - mc-workflow-navigation-contract
   - consumable_asset_registry
   - knowledge_injection
-primary_triggers:
-  - 工作流导航契约规则
-secondary_triggers:
-  - 下一步
-  - 继续
-  - 现在能写代码吗
-  - 导航
-  - navigation
-negative_triggers: []
 priority: P0
-specificity: 5
 consumes:
   - mc-workflow-navigation-contract
 hard_blocks:
@@ -65,11 +54,12 @@ AI 不得只说“需要确认”。必须说明哪些是必须确认、哪些
    - 阻断：sf_execute
    - 必须先通过设计审计复验
 
-2. **配置未确认 → 区分自动修复与业务确认**
-   - 条件：项目阶段为 configuration_pending
-   - 阻断：除 sf_init、config_confirm 外的所有动作
-   - version 数字/字符串、scope 字符串/数组、config.evidence.json 缺失/过期/不匹配属于自动修复项，必须提示 soloforge config repair
-   - 产品类型、技术栈选择、仓库边界、业务范围等语义口径才进入 config confirm 或用户确认
+2. **配置不完整 → 补充不可探测字段**
+   - 条件：resolveConfig 返回 missing 字段（tech_stack 或 build_commands）
+   - 阻断：除 sf_init、sf_config_update、config set 外的所有动作
+   - 技术栈和构建命令由项目文件探测自动推导，无需手动配置
+   - 产品类型、交付设置等不可探测字段通过 `soloforge config set` 或 `sf_config_update` 补充
+   - 配置冲突（intent 声明与探测结果矛盾）通过 `soloforge config check` 识别
 
 3. **决策未确认 → 禁止定稿架构/详细设计/代码**
    - 条件：架构决策研讨中存在未确认域
@@ -134,8 +124,8 @@ AI 不得只说“需要确认”。必须说明哪些是必须确认、哪些
 
 `confirmation_decisions` 必须包含：
 
-- `must_confirm`
-- `should_confirm`
-- `auto_resolvable`
+- `must_confirm`：必须用户确认的事项（业务口径、架构决策等）
+- `should_confirm`：建议确认但不阻断
+- `auto_resolvable`：可通过命令或自动推导解决
 - `blocked_reason`
 - `recommended_action`

package/templates/internal/rules//345/267/245/344/275/234/346/265/201/346/250/241/347/211/210/345/214/205/350/247/204/345/210/231.md

@@ -6,17 +6,10 @@ products:
   - '*'
 id: ka-hard-rule-工作流模版包规则
 type: governance_rule
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-workflow-template-pack
-primary_triggers:
-  - 模版消费
-  - 工作流模版
-secondary_triggers: []
-negative_triggers: []
 priority: P1
-specificity: 4
 consumes:
   - ka-hard-rule-核心工程执行原则
 hard_blocks:

package/templates/internal/rules//345/267/245/345/205/267/350/260/203/347/224/250/350/247/204/345/210/231.md

@@ -5,16 +5,10 @@ scope:
 products:
   - '*'
 id: ka-hard-rule-工具调用规则
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-tool-invocation-contract
-primary_triggers:
-  - 工具调用规则
-secondary_triggers: []
-negative_triggers: []
 priority: P0
-specificity: 5
 consumes:
   - mc-workflow-contract
 hard_blocks:
@@ -27,8 +21,8 @@ required_evidence:
 version: 1.1.0
 last_reviewed: '2026-06-01'
 type: governance_rule
-when: 工具调用规则
 stages: ["*"]
+triggers: ["工具调用规则"]
 ---
 
 # 工具调用规则

package/templates/internal/rules//346/204/217/345/233/276/350/267/257/347/224/261/350/247/204/345/210/231.md

@@ -1,22 +1,16 @@
 ---
 deprecated: true
-deprecated_note: 此模板已由 mc-command-router (命令路由) 替代。保留仅为向后兼容。
+deprecated_note: 此模版已由 mc-command-router (命令路由) 替代。保留仅为向后兼容。
 name: intent-routing
 scope:
   - '*'
 products:
   - '*'
 id: ka-hard-rule-意图路由规则
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-command-router
-primary_triggers:
-  - 意图路由规则
-secondary_triggers: []
-negative_triggers: []
 priority: P0
-specificity: 5
 consumes:
   - mc-classifier
 hard_blocks:
@@ -29,8 +23,8 @@ required_evidence:
 version: 1.1.0
 last_reviewed: '2026-06-01'
 type: governance_rule
-when: 意图路由规则
 stages: ["*"]
+triggers: ["意图路由规则"]
 ---
 
 # 意图路由规则

package/templates/internal/rules//346/211/247/350/241/214/345/256/210/345/215/253/350/257/204/344/274/260/350/247/204/345/210/231.md

@@ -5,16 +5,10 @@ scope:
 products:
   - '*'
 id: ka-hard-rule-执行守卫评估规则
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-guard-evaluation
-primary_triggers:
-  - 执行守卫评估规则
-secondary_triggers: []
-negative_triggers: []
 priority: P0
-specificity: 5
 consumes:
   - mc-task-context-lifecycle
 hard_blocks:
@@ -27,8 +21,8 @@ required_evidence:
 version: 1.1.0
 last_reviewed: '2026-06-01'
 type: governance_rule
-when: 执行守卫评估规则
 stages: ["*"]
+triggers: ["执行守卫评估规则"]
 ---
 
 # 执行守卫评估规则

package/templates/internal/rules//346/211/251/345/261/225/347/224/237/345/221/275/345/221/250/346/234/237/350/247/204/345/210/231.md

@@ -6,17 +6,10 @@ products:
   - '*'
 id: ka-hard-rule-扩展生命周期规则
 type: governance_rule
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-extension-contract
-primary_triggers:
-  - 扩展注册
-  - 权限申请
-secondary_triggers: []
-negative_triggers: []
 priority: P1
-specificity: 4
 consumes:
   - ka-hard-rule-核心工程执行原则
 hard_blocks:

package/templates/internal/rules//346/212/200/346/234/257/345/206/263/347/255/226/344/270/273/346/235/203/350/247/204/345/210/231.md

@@ -6,7 +6,6 @@ products:
   - '*'
 id: ka-hard-rule-技术决策主权规则
 type: governance_rule
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-decision-sovereignty
@@ -15,16 +14,7 @@ consumed_by:
   - mc-decision-sovereignty
   - consumable_asset_registry
   - workflow_template
-primary_triggers:
-  - 技术决策主权规则
-secondary_triggers:
-  - 技术选型
-  - 目录确认
-  - 架构不确定项
-  - 风险动作
-negative_triggers: []
 priority: P1
-specificity: 5
 consumes:
   - mc-decision-sovereignty
 hard_blocks:

package/templates/internal/rules//346/225/217/346/204/237/344/277/241/346/201/257/345/244/204/347/220/206/350/247/204/345/210/231.md

@@ -5,24 +5,10 @@ scope:
 products:
   - '*'
 id: ka-hard-rule-敏感信息处理规则
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-privacy-boundary
-primary_triggers:
-  - 敏感信息处理规则
-secondary_triggers:
-  - 敏感信息
-  - 脱敏
-  - 隐私
-  - 日志
-  - 输出
-  - console
-  - print
-  - log
-negative_triggers: []
 priority: P0
-specificity: 5
 consumes:
   - mc-privacy-boundary
 hard_blocks:
@@ -35,8 +21,8 @@ required_evidence:
 version: 1.1.0
 last_reviewed: '2026-06-01'
 type: governance_rule
-when: 敏感信息处理规则
 stages: ["*"]
+triggers: ["敏感信息处理规则"]
 ---
 
 # 敏感信息处理规则
@@ -74,9 +60,9 @@ stages: ["*"]
 - 健康隐私信息（病历、诊断、处方）
 
 ### 脱敏要求
-- 手机号：仅显示前 3 后 4（如 138****5678）
-- 身份证：仅显示前 3 后 4（如 310***********1234）
-- 银行卡：仅显示后 4 位（如 ****5678）
+- 手机号：仅显示前 3 后 4（如 `138****5678`）
+- 身份证：仅显示前 3 后 4（如 `310***********1234`）
+- 银行卡：仅显示后 4 位（如 `****5678`）
 - token/密钥：仅显示前 4 位或哈希值
 
 ### 检查范围

package/templates/internal/rules//346/226/275/345/267/245/346/214/207/344/273/244/345/245/221/347/272/246/350/247/204/345/210/231.md

@@ -6,18 +6,10 @@ products:
   - '*'
 id: ka-hard-rule-施工指令契约规则
 type: governance_rule
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-instruction-contract
-primary_triggers:
-  - 代码修改
-  - 文件创建
-  - 重构操作
-secondary_triggers: []
-negative_triggers: []
 priority: P0
-specificity: 5
 consumes:
   - ka-hard-rule-核心工程执行原则
 hard_blocks:

package/templates/internal/rules//346/227/245/345/277/227/346/262/273/347/220/206/350/247/204/345/210/231.md

@@ -6,21 +6,10 @@ products:
   - '*'
 id: ka-hard-rule-日志治理规则
 type: governance_rule
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-log-governance
-primary_triggers:
-  - 日志治理
-  - 输出噪音
-  - json 输出
-secondary_triggers:
-  - user feedback
-  - logger
-negative_triggers:
-  - 用户项目业务日志
 priority: P1
-specificity: 4
 consumes:
   - log_governance
 hard_blocks:

package/templates/internal/rules//346/234/272/345/210/266/350/207/252/346/262/273/347/220/206/350/247/204/345/210/231.md

@@ -6,21 +6,10 @@ products:
   - '*'
 id: ka-hard-rule-机制自治理规则
 type: governance_rule
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-mechanism-health
-primary_triggers:
-  - 机制健康
-  - 主链路消费
-  - 死代码
-secondary_triggers:
-  - lazy import
-  - mechanism id
-negative_triggers:
-  - 普通业务编码
 priority: P1
-specificity: 4
 consumes:
   - mechanism_health_check
 hard_blocks:

package/templates/internal/rules//346/236/266/346/236/204/345/206/263/347/255/226/347/240/224/350/256/250/350/247/204/345/210/231.md

@@ -1,18 +1,12 @@
 ---
 name: architecture-decision-workshop
 id: ka-rule-architecture-decision-workshop
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 scope: ['*']
 products:
   - '*'
-primary_triggers:
-  - 架构设计
-  - 系统设计
-  - 技术架构
 priority: P0
-specificity: 5
 version: 1.1.0
 last_reviewed: '2026-06-01'
 owner_mechanism_id: mc-architecture-decision-workshop
@@ -44,3 +38,7 @@ stages: ["*"]
 ## 低风险边界
 
 普通缺陷修复、样式或文案调整、只读解释不触发完整六域研讨；涉及契约、数据、安全、部署或重大模块边界变化时重新触发。
+- ADR-HARD-01: 每条架构决策必须有对应 ADR，禁止口头决策不留记录
+- ADR-HARD-02: ADR 状态变更必须经用户确认，Agent 不得自动变更状态
+- ADR-HARD-03: 已 Accepted 的 ADR 被推翻时，必须创建新 ADR 并标注 Superseded-By
+- ADR-HARD-04: 跳过决策研讨必须用户明确声明，Agent 不得自行跳过

package/templates/internal/rules//346/240/207/345/207/206/350/265/204/344/272/247/350/246/206/347/233/226/350/247/204/345/210/231.md

@@ -6,20 +6,10 @@ products:
   - '*'
 id: ka-hard-rule-标准资产覆盖规则
 type: governance_rule
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-standard-asset-coverage
-primary_triggers:
-  - 标准资产覆盖
-  - 模版覆盖
-  - 资产契约
-secondary_triggers:
-  - templates
-  - asset coverage
-negative_triggers: []
 priority: P0
-specificity: 5
 consumes:
   - template_asset_contract_registry
   - explicit_asset_registry

package/templates/internal/rules//346/240/270/345/277/203/344/275/223/351/252/214/345/216/237/345/210/231.md

@@ -1,23 +1,15 @@
 ---
 name: core-experience-principle
-when: '新增机制, 新增模版, 新增 workflow, 发布门禁'
 scope: ['*']
 products:
   - '*'
 owner_mechanism_id: mc-core-experience-principle
 id: ka-hard-rule-core-experience-principle
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
-primary_triggers:
-  - 机制强
-  - 路径短
-  - 规则硬
-  - 体验轻
 consumes:
   - mc-plan-proposal-gate
 priority: P0
-specificity: 5
 version: 1.1.0
 last_reviewed: '2026-06-01'
 hard_blocks:
@@ -29,6 +21,7 @@ required_evidence:
 fallback: manual_required
 type: governance_rule
 stages: ["*"]
+triggers: ["新增机制","新增模版","新增 workflow","发布门禁"]
 ---
 
 ## 核心体验原则

package/templates/internal/rules//346/240/270/345/277/203/345/267/245/347/250/213/346/211/247/350/241/214/345/216/237/345/210/231.md

@@ -5,16 +5,10 @@ scope:
 products:
   - '*'
 id: ka-hard-rule-核心工程执行原则
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-core-engineering-principles
-primary_triggers:
-  - 核心工程执行原则
-secondary_triggers: []
-negative_triggers: []
 priority: P0
-specificity: 5
 consumes:
   - mc-all-mechanisms
 hard_blocks:
@@ -26,8 +20,8 @@ required_evidence:
 version: 1.1.0
 last_reviewed: '2026-06-01'
 type: governance_rule
-when: 核心工程执行原则
 stages: ["*"]
+triggers: ["核心工程执行原则"]
 ---
 
 # 核心工程执行原则
@@ -128,7 +122,7 @@ stages: ["*"]
 
 ## 原则冲突优先级
 
-```
+```text
 安全/权限/隐私 > Goal-Driven Execution > Think Before Coding > Surgical Changes > Simplicity First
 ```