soloforge 1.1.38 → 1.1.42

package/templates/patterns//347/272/246/346/235/237/345/256/236/347/216/260/350/247/204/350/214/203.md

@@ -1,37 +1,22 @@
 ---
 name: constrained-implementation
-when: '编码实现, 写代码, 修改代码, 代码变更, 实现, 编码, coding, 代码修改, 修bug, 修代码'
 scope:
   - backend
   - frontend
 products:
   - '*'
 id: ka-pattern-constrained-implementation
-asset_kind: pattern
 lifecycle_status: active
 owner_mechanism_id: mc-general-pattern
 authority: supporting
-primary_triggers:
-  - 编码实现
-  - 写代码
-  - 修改代码
-  - 代码变更
-  - 实现
-  - 编码
-  - coding
-  - 代码修改
-  - 修bug
-  - 修代码
 priority: P2
-specificity: 3
 version: 1.1.0
 last_reviewed: '2026-06-01'
 consumes: []
 emits: []
-secondary_triggers: []
-negative_triggers: []
 type: pattern
 stages: ["编码与单元测试"]
+triggers: ["编码实现","写代码","修改代码","代码变更","实现","编码","coding","代码修改","修bug","修代码"]
 ---
 
 ## 决策规则

package/templates/patterns//347/274/223/345/255/230/347/255/226/347/225/245/350/247/204/350/214/203.md

@@ -1,36 +1,21 @@
 ---
 name: caching
-when: '缓存策略, 缓存, cache, Redis, 热点数据, 查询优化, 缓存穿透, 缓存雪崩, @Cacheable, 缓存一致性'
 scope:
   - backend
 products:
   - '*'
 id: ka-pattern-caching
-asset_kind: pattern
 lifecycle_status: active
 owner_mechanism_id: mc-backend-pattern
 authority: supporting
-primary_triggers:
-  - 缓存策略
-  - 缓存
-  - cache
-  - Redis
-  - 热点数据
-  - 查询优化
-  - 缓存穿透
-  - 缓存雪崩
-  - '@Cacheable'
-  - 缓存一致性
 priority: P2
-specificity: 3
 version: 1.1.0
 last_reviewed: '2026-06-01'
 consumes: []
 emits: []
-secondary_triggers: []
-negative_triggers: []
 type: pattern
 stages: ["联调验证"]
+triggers: ["缓存策略","缓存","cache","Redis","热点数据","查询优化","缓存穿透","缓存雪崩","@Cacheable","缓存一致性"]
 ---
 
 ## 决策规则

package/templates/patterns//347/274/226/347/240/201/350/264/250/351/207/217/350/247/204/350/214/203.md

@@ -1,35 +1,22 @@
 ---
 name: coding-quality
-when: '编码质量, 代码规范, 代码评审, 代码质量, 重构, over-engineering, 过度设计, 代码异味'
 scope:
   - backend
   - frontend
 products:
   - '*'
 id: ka-pattern-coding-quality
-asset_kind: pattern
 lifecycle_status: active
 owner_mechanism_id: mc-general-pattern
 authority: supporting
-primary_triggers:
-  - 编码质量
-  - 代码规范
-  - 代码评审
-  - 代码质量
-  - 重构
-  - over-engineering
-  - 过度设计
-  - 代码异味
 priority: P2
-specificity: 3
 version: 1.1.0
 last_reviewed: '2026-06-01'
 consumes: []
 emits: []
-secondary_triggers: []
-negative_triggers: []
 type: pattern
 stages: ["编码与单元测试"]
+triggers: ["编码质量","代码规范","代码评审","代码质量","重构","over-engineering","过度设计","代码异味"]
 ---
 
 ## 决策规则

package/templates/patterns//347/274/272/351/231/267/347/256/241/347/220/206/350/247/204/350/214/203.md

@@ -1,34 +1,22 @@
 ---
 name: defect-management
-when: '缺陷管理, Bug修复, 缺陷闭环, 回归测试, 缺陷预防, 缺陷归因, 质量改进'
 scope:
   - backend
   - frontend
 products:
   - '*'
 id: ka-pattern-defect-management
-asset_kind: pattern
 lifecycle_status: active
 owner_mechanism_id: mc-general-pattern
 authority: supporting
-primary_triggers:
-  - 缺陷管理
-  - Bug修复
-  - 缺陷闭环
-  - 回归测试
-  - 缺陷预防
-  - 缺陷归因
-  - 质量改进
 priority: P2
-specificity: 3
 version: 1.1.0
 last_reviewed: '2026-06-01'
 consumes: []
 emits: []
-secondary_triggers: []
-negative_triggers: []
 type: pattern
 stages: ["编码与单元测试", "联调验证"]
+triggers: ["缺陷管理","Bug修复","缺陷闭环","回归测试","缺陷预防","缺陷归因","质量改进"]
 ---
 
 ## 决策规则

package/templates/patterns//350/260/203/350/257/225/346/226/271/346/263/225/350/256/272.md

@@ -1,35 +1,22 @@
 ---
 name: debugging-methodology
-when: '调试, debug, 排查问题, 修复Bug, 定位错误, 根因分析, 排障, 故障排查'
 scope:
   - backend
   - frontend
 products:
   - '*'
 id: ka-pattern-debugging-methodology
-asset_kind: pattern
 lifecycle_status: active
 owner_mechanism_id: mc-general-pattern
 authority: supporting
-primary_triggers:
-  - 调试
-  - debug
-  - 排查问题
-  - 修复Bug
-  - 定位错误
-  - 根因分析
-  - 排障
-  - 故障排查
 priority: P2
-specificity: 3
 version: 1.1.0
 last_reviewed: '2026-06-01'
 consumes: []
 emits: []
-secondary_triggers: []
-negative_triggers: []
 type: pattern
 stages: ["架构设计"]
+triggers: ["调试","debug","排查问题","修复Bug","定位错误","根因分析","排障","故障排查"]
 ---
 
 ## 决策规则

package/templates/patterns//350/276/223/345/205/245/346/240/241/351/252/214/350/247/204/350/214/203.md

@@ -1,36 +1,21 @@
 ---
 name: input-validation
-when: '参数校验, 输入验证, 字段验证, 合法性校验, 入参校验, 必填, 格式校验, 参数检查, @Valid, @NotNull'
 scope:
   - backend
 products:
   - '*'
 id: ka-pattern-input-validation
-asset_kind: pattern
 lifecycle_status: active
 owner_mechanism_id: mc-backend-pattern
 authority: supporting
-primary_triggers:
-  - 参数校验
-  - 输入验证
-  - 字段验证
-  - 合法性校验
-  - 入参校验
-  - 必填
-  - 格式校验
-  - 参数检查
-  - '@Valid'
-  - '@NotNull'
 priority: P2
-specificity: 3
 version: 1.1.0
 last_reviewed: '2026-06-01'
 consumes: []
 emits: []
-secondary_triggers: []
-negative_triggers: []
 type: pattern
 stages: ["联调验证"]
+triggers: ["参数校验","输入验证","字段验证","合法性校验","入参校验","必填","格式校验","参数检查","@Valid","@NotNull"]
 ---
 
 ## 决策规则

package/templates/patterns//351/224/231/350/257/257/345/244/204/347/220/206/350/247/204/350/214/203.md

@@ -1,36 +1,21 @@
 ---
 name: error-handling
-when: '异常处理, 错误处理, 全局异常, 错误码, Exception, BusinessException, 状态码, 报错, 异常捕获, 错误响应'
 scope:
   - backend
 products:
   - '*'
 id: ka-pattern-error-handling
-asset_kind: pattern
 lifecycle_status: active
 owner_mechanism_id: mc-backend-pattern
 authority: supporting
-primary_triggers:
-  - 异常处理
-  - 错误处理
-  - 全局异常
-  - 错误码
-  - Exception
-  - BusinessException
-  - 状态码
-  - 报错
-  - 异常捕获
-  - 错误响应
 priority: P2
-specificity: 3
 version: 1.1.0
 last_reviewed: '2026-06-01'
 consumes: []
 emits: []
-secondary_triggers: []
-negative_triggers: []
 type: pattern
 stages: ["联调验证"]
+triggers: ["异常处理","错误处理","全局异常","错误码","Exception","BusinessException","状态码","报错","异常捕获","错误响应"]
 ---
 
 ## 决策规则

package/templates/patterns//351/224/231/350/257/257/350/276/271/347/225/214/350/247/204/350/214/203.md

@@ -1,38 +1,21 @@
 ---
 name: error-boundary
-when: >-
-  错误边界, 错误处理, 白屏, 页面崩溃, ErrorBoundary, 异常捕获, 全局错误, 前端异常, componentDidCatch,
-  fallback
 scope:
   - frontend
 products:
   - '*'
 id: ka-pattern-error-boundary
-asset_kind: pattern
 lifecycle_status: active
 owner_mechanism_id: mc-frontend-pattern
 authority: supporting
-primary_triggers:
-  - 错误边界
-  - 错误处理
-  - 白屏
-  - 页面崩溃
-  - ErrorBoundary
-  - 异常捕获
-  - 全局错误
-  - 前端异常
-  - componentDidCatch
-  - fallback
 priority: P2
-specificity: 3
 version: 1.1.0
 last_reviewed: '2026-06-01'
 consumes: []
 emits: []
-secondary_triggers: []
-negative_triggers: []
 type: pattern
 stages: ["联调验证"]
+triggers: [">-"]
 ---
 
 ## 决策规则

package/templates/patterns//351/242/206/345/237/237/351/251/261/345/212/250/350/256/276/350/256/241/350/247/204/350/214/203.md

@@ -1,35 +1,21 @@
 ---
 name: ddd-design
-when: '领域驱动设计, DDD, 领域模型, 聚合根, 值对象, 领域事件, 充血模型, 贫血模型, 模块设计'
 scope:
   - backend
 products:
   - '*'
 id: ka-pattern-ddd-design
-asset_kind: pattern
 lifecycle_status: active
 owner_mechanism_id: mc-backend-pattern
 authority: supporting
-primary_triggers:
-  - 领域驱动设计
-  - DDD
-  - 领域模型
-  - 聚合根
-  - 值对象
-  - 领域事件
-  - 充血模型
-  - 贫血模型
-  - 模块设计
 priority: P2
-specificity: 3
 version: 1.1.0
 last_reviewed: '2026-06-01'
 consumes: []
 emits: []
-secondary_triggers: []
-negative_triggers: []
 type: pattern
 stages: ["架构设计"]
+triggers: ["领域驱动设计","DDD","领域模型","聚合根","值对象","领域事件","充血模型","贫血模型","模块设计"]
 ---
 
 ## 决策规则

package/templates/procedures/OOD/350/256/276/350/256/241/345/267/245/344/275/234/346/265/201.md

@@ -1,25 +1,16 @@
 ---
 name: ood-design-workflow
 type: procedure
-when: '面向对象设计, SOLID, 领域服务, 业务规则实现, 重构'
 scope:
   - backend
   - frontend
 products:
   - '*'
 id: ka-procedure-OOD设计工作流
-asset_kind: procedure
 lifecycle_status: active
 authority: supporting
 owner_mechanism_id: mc-ood-solid-contract
-primary_triggers:
-  - OOD设计工作流
-secondary_triggers:
-  - SOLID
-negative_triggers:
-  - 文案修改
 priority: P1
-specificity: 5
 consumes:
   - mc-ood-solid-contract
 consumed_by:
@@ -27,24 +18,54 @@ consumed_by:
   - mc-backend-implementation-contract
 emits:
   - ood_design_summary
-  - code_review_findings
 required_evidence:
   - execution_evidence
-version: 1.1.0
-last_reviewed: '2026-06-01'
+version: 1.2.0
+last_reviewed: '2026-06-04'
 stages: ["详细设计"]
+triggers: ["面向对象设计","SOLID","领域服务","业务规则实现","重构"]
 ---
 
+## 适用性判定（前置门控）
+
+| 判定条件 | 适用 | 不适用 |
+|---------|------|--------|
+| 复杂对象边界（多对象协作、继承/组合关系） | ✅ | |
+| 变化点（多策略/多实现/扩展点） | ✅ | |
+| 领域服务或业务规则封装 | ✅ | |
+| 简单 CRUD 或单表操作 | | ✅ |
+| 纯 UI/样式调整 | | ✅ |
+
+不适用时：记录"不适用理由"一句话，跳过本工作流。
+
 ## 步骤
 
-1. 判断任务是否确实存在对象边界或变化点，简单改动记录不适用理由。
-2. 列出对象职责、接口、依赖方向和主要协作流程。
-3. 对五项 SOLID 原则逐项说明适用风险与取舍。
-4. 编码后执行审查和验证，以实际源码 finding 为准。
-5. 存在硬失败则修复并重验，不能仅在报告中解释。
+### Step 1: 列出对象职责与依赖
+- **属性**: LLM 推理
+- **输入**: 架构设计文档中的模块/实体定义
+- **输出**: 对象职责清单 + 依赖方向图 + 主要协作流程
+
+### Step 2: SOLID 逐项分析
+- **属性**: LLM 推理
+- **输入**: Step 1 对象职责清单
+- **输出**: SOLID 风险与取舍分析
+- **Agent 行为**: 对 S/O/L/I/D 逐项分析，每项标注风险（高/中/低）+ 取舍说明
+
+### Step 3: 修正硬失败
+- **属性**: LLM 推理 + 确定性校验混合
+- **输入**: Step 2 SOLID 分析
+- **输出**: 修正后设计 + 验证证据
+- **Agent 行为**: 高风险项必须修正；修正后重新分析对应项；最多 3 轮；低风险项可标注"已知取舍"
 
 ## 输出摘要
 
-| 对象/模块 | 单一职责 | 依赖接口 | 变化点 | SOLID 风险 | 验证证据 |
-|---|---|---|---|---|---|
-| | | | | | |
+| 对象/模块 | 单一职责 | 依赖接口 | 变化点 | SOLID 风险等级 | 修正状态 | 验证证据 |
+|---|---|---|---|---|---|---|
+
+## 输出消费方式
+- 数据库设计（E-01 Step 2）和 API 设计（E-01 Step 3）引用本工作流的对象职责清单和 SOLID 分析
+- 编码后的 SOLID 审查由编码阶段代码审查流程负责，不在此工作流中
+
+## 注意事项
+- 本工作流仅在详细设计阶段执行，不跨阶段
+- 输出摘要表必须填写完整，不得留空行

package/templates/procedures/Schema/345/217/230/346/233/264/346/265/201/346/260/264/347/272/277.md

@@ -1,22 +1,15 @@
 ---
 name: schema-change-pipeline
 type: pipeline_procedure
-when: '数据库结构变更, 加字段, 改字段, 新建表, 加索引, DDL变更, schema变更, 数据库迁移'
 scope:
   - backend
 products:
   - '*'
 id: ka-procedure-Schema变更流水线
-asset_kind: pipeline_procedure
 lifecycle_status: active
 authority: supporting
 owner_mechanism_id: mc-knowledge-asset-governance
-primary_triggers:
-  - Schema变更流水线
-secondary_triggers: []
-negative_triggers: []
 priority: P1
-specificity: 5
 consumes:
   - mc-knowledge-asset-governance
 emits:
@@ -28,25 +21,26 @@ required_evidence:
 version: 1.1.0
 last_reviewed: '2026-06-01'
 stages: ["编码与单元测试", "联调验证"]
+triggers: ["数据库结构变更","加字段","改字段","新建表","加索引","DDL变更","schema变更","数据库迁移"]
 ---
 
 # 数据库变更管线
 
-### 第1步：变更设计
+## 第1步：变更设计
 评估变更类型（加列/改列/删列/加索引/数据迁移/新建表）。确认向前兼容性（新列默认值或允许 NULL）。制定四层兼容策略（数据库→接口契约→前端展示→导出逻辑）。
 模版：数据库变更方案模版.md
-产出保存到：.soloforge/output/01-变更方案.md
+产出保存到：docs/architecture/02-数据库设计文档.md
 工具：sf_command
 
-### 第2步：迁移脚本
+## 第2步：迁移脚本
 编写 migration 脚本（正向 + 回滚），确保幂等。大表加列使用分批更新策略。大表加索引使用 ONLINE DDL。禁止 migration 中写业务逻辑。
-产出保存到：.soloforge/output/02-migration.sql
+产出保存到：docs/architecture/02-migration.sql
 工具：sf_stage_execute
 
-### 第3步：代码适配
+## 第3步：代码适配
 更新 Entity/DTO 映射。更新接口契约（请求/响应字段）。更新前端展示和表单。更新导出逻辑（如有）。更新相关测试数据和测试用例。
 工具：sf_stage_execute
 
-### 第4步：验证验收
+## 第4步：验证验收
 开发环境执行 migration 验证表结构。运行全量测试。代码审查重点关注：四层兼容完整性、回滚脚本有效性、大表性能影响评估。
 工具：sf_gate_check, sf_review, sf_stage_advance

package/templates/procedures//344/270/215/347/241/256/345/256/232/346/227/266/345/244/264/350/204/221/351/243/216/346/232/264/346/265/201/347/250/213.md

@@ -0,0 +1,92 @@
+---
+name: brainstorm-when-uncertain
+type: procedure
+scope: ['*']
+stages: ["需求分析", "架构设计", "详细设计", "编码与单元测试"]
+lifecycle_status: active
+owner_mechanism_id: mc-generic-review
+id: ka-procedure-不确定时头脑风暴流程
+authority: supporting
+priority: P0
+version: 1.0.0
+last_reviewed: '2026-06-04'
+triggers: ["头脑风暴", "brainstorm", "不确定", "你看着办", "都行"]
+---
+
+# 不确定时头脑风暴流程
+
+## 适用场景
+
+当用户表达不确定、需求不明确、技术选型开放、或 AI 自检不确定时，触发本流程辅助决策。本流程为全局流程，不属于特定管线阶段。
+
+## 不确定类型分类
+
+| 类型 | 触发关键词/信号 | 典型场景 |
+|------|---------------|---------|
+| 用户不确定 | "你看着办"/"都行"/"不确定"/"都可以" | 用户对方案选择无偏好 |
+| 需求不明确 | 需求描述矛盾/遗漏/模糊 | 需求文档存在冲突 |
+| 技术选型开放 | 多种技术方案均可/无明确约束 | 架构设计阶段技术选型 |
+| AI 自检不确定 | 置信度低/多种解释均合理 | AI 无法确定用户真实意图 |
+
+## 流程步骤
+
+### 步骤 1：识别不确定类型
+区分四类不确定，确定进入头脑风暴的原因。
+
+### 步骤 2：列举候选方案（≥ 3 个）
+每个候选方案须包含：
+- 描述：方案概述
+- 优势：该方案的优点
+- 劣势：该方案的缺点
+- 适用场景：最适合的情况
+
+**检查点**：方案间有本质区别（非假多样性）。若 3 个方案本质相同（仅措辞不同），须重新思考。
+
+**若 fundamental_need 为空 → 必须先触发 FP-01**（第一性原理推理规则），补充根本目标后再继续。
+
+### 步骤 3：标注 AI 偏好
+对每个方案标注 AI 偏好：推荐/可选/不推荐 + 理由。AI 偏好基于：
+- 与 fundamental_need 的契合度
+- 技术复杂度和风险
+- 项目约束条件
+- 维护成本
+
+### 步骤 4：呈现给用户
+以对比表格呈现，突出关键差异维度。表格至少包含：方案/优势/劣势/AI偏好/推荐理由。
+
+### 步骤 5：用户选择
+用户明确选择一个方案。用户回复须为明确的方案选择（非"都可以"/"你定"）。
+
+**未通过** → 进入用户模糊降级策略。
+
+### 步骤 6：记录决策
+将用户选择写入对应阶段产物：
+- 需求分析 → 更新需求分析文档
+- 架构设计 → 更新架构决策记录
+- 详细设计 → 更新设计文档
+- 编码阶段 → 更新技术决策注释
+
+## 用户模糊降级策略
+
+当用户回复仍为模糊/不确定时，按 3 级降级处理：
+
+| 级别 | 降级策略 | 条件 |
+|------|---------|------|
+| 1 级 | 重新引导 | 用户首次模糊 → 重新解释差异，追问偏好维度 |
+| 2 级 | 标注偏好 + 可推翻 | 用户二次模糊 → AI 标注推荐方案，告知用户可推翻 |
+| 3 级 | 直接采纳 | 用户三次模糊 → AI 采纳推荐方案，记录"用户未明确选择" |
+
+## 互触发关系
+
+| 触发条件 | 触发动作 |
+|---------|---------|
+| 头脑风暴步骤 2 中 fundamental_need 为空 | → 触发 FP-01（第一性原理推理规则） |
+| FP-03 检测到表面修复（同类问题 ≥ 3 次） | → 建议触发第一性原理推理 |
+| FP-01 和头脑风暴同时需要时 | → FP-01 优先（先确定根本目标，再做方案选择） |
+
+## 禁止行为
+
+1. **禁止直接选唯一方案**：不得在未列举 ≥ 3 个方案的情况下直接推荐唯一方案
+2. **禁止用"建议"替代对比**：不得仅说"建议方案 A"而不提供方案对比
+3. **禁止跳过枚举**：不得跳过候选方案列举步骤直接进入用户选择
+4. **禁止 3 方案本质相同**：候选方案间须有本质区别，不得通过假多样性绕过

package/templates/procedures//344/270/273/351/223/276/350/267/257/346/216/245/345/205/245/351/252/214/350/257/201/346/265/201/347/250/213.md

@@ -5,16 +5,10 @@ scope:
 products:
   - '*'
 id: ka-procedure-主链路接入验证流程
-asset_kind: procedure
 lifecycle_status: active
 authority: supporting
 owner_mechanism_id: mc-main-path-integration
-primary_triggers:
-  - 主链路接入验证流程
-secondary_triggers: []
-negative_triggers: []
 priority: P1
-specificity: 5
 consumes:
   - mc-main-path-integration
 emits:
@@ -22,12 +16,13 @@ emits:
   - module_accessibility_status
 required_evidence:
   - execution_evidence
-version: 1.1.0
-last_reviewed: '2026-06-01'
+version: 1.2.0
+last_reviewed: '2026-06-04'
 type: procedure
-when: 主链路接入验证流程
 stages: ["编码与单元测试", "联调验证"]
+triggers: ["主链路接入验证流程"]
 ---
+
 # 主链路接入验证流程
 
 ## 步骤
@@ -36,6 +31,10 @@ stages: ["编码与单元测试", "联调验证"]
 2. 扫描谁导入了该模块 (scanModuleImporters)
 3. 从入口点追踪可达性 (traceModuleReachability)
 4. 收集可观测证据 (collectModuleObservability)
+   evidence_required:
+     - "模块导入者列表（scanModuleImporters 输出）"
+     - "入口点可达性追踪日志（traceModuleReachability 输出）"
+     - "集成测试文件路径（findIntegrationTests 输出）"
 5. 查找集成测试 (findIntegrationTests)
 6. 判断接入状态 (integrated / implemented_not_integrated / ...)
 7. 运行 orphanGate 和 validateMainPathIntegration

package/templates/procedures//344/273/243/347/240/201/351/227/250/347/246/201/346/265/201/347/250/213.md

@@ -1,23 +1,16 @@
 ---
 name: code-gate
 type: procedure
-when: '代码门禁, 代码审查门禁, gate review, 发布门禁, 上线检查, 代码评审, 发布审查'
 scope:
   - backend
   - frontend
 products:
   - '*'
 id: ka-procedure-代码门禁流程
-asset_kind: procedure
 lifecycle_status: active
 authority: supporting
 owner_mechanism_id: mc-guard-evaluation
-primary_triggers:
-  - 代码门禁流程
-secondary_triggers: []
-negative_triggers: []
 priority: P1
-specificity: 5
 consumes:
   - mc-guard-evaluation
 emits:
@@ -28,6 +21,7 @@ required_evidence:
 version: 1.1.0
 last_reviewed: '2026-06-01'
 stages: ["编码与单元测试", "联调验证"]
+triggers: ["代码门禁","代码审查门禁","gate review","发布门禁","上线检查","代码评审","发布审查"]
 ---
 
 ## 适用场景