@xulthekl/team-flow 0.23.0 → 0.25.1

package/.claude/always/phase-guard.md

@@ -1,3 +1,3 @@
-# team-flow v0.23.0 | 阶段: {{state}} | 工作流: {{workflow}}
+# team-flow v0.25.1 | 阶段: {{state}} | 工作流: {{workflow}}
 当前阶段允许的操作由 workflow-start 路由规则定义。
 禁止跨越 DP gate 进入下一阶段。变更范围以 execution-contract.md 的 Intent Lock 为准。

package/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
     {
       "name": "team-flow",
       "description": "8-state spec workflow + compound global compounding + architecture-design (4A/DDD) + local HTML prototype + product-level orchestration + bootstrap + e2e + session handoff + workflow feedback. 23 skills + 8 agents with embedded TDD, SDD, code review, debugging, delta spec sync, and design-system-driven prototyping.",
-      "version": "0.23.0",
+      "version": "0.25.1",
       "source": "./",
       "author": {
         "name": "LT",

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "team-flow",
-  "version": "0.23.0",
+  "version": "0.25.1",
   "description": "Unified workflow plugin: team-flow (spec-driven dev: TDD/SDD/code-review/debugging) + compound-engineering core subset (brainstorm/plan/compound/strategy/ideate/proof, global compounding) + architecture-design (4A+DDD incremental design & global compounding) + prototype (local HTML prototype, zero external deps) + e2e (Playwright E2E, AC-driven) + workflow-orchestrator (product-level workflow orchestration) + workflow-bootstrap (existing project onboarding) + session-handoff (context transfer) + workflow-feedback (issue tracking). 23 skills + 8 agents, one install.",
   "source": "./",
   "author": {

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "team-flow",
-  "version": "0.23.0",
+  "version": "0.25.1",
   "description": "Spec-first workflow that bridges OpenSpec-style planning and Superpowers-style execution discipline.",
   "author": {
     "name": "MageByte",

package/.cursor-plugin/marketplace.json

@@ -5,7 +5,7 @@
   },
   "metadata": {
     "description": "Unified workflow plugin marketplace for Cursor (team-flow: team-flow + compound + architecture-design + prototype).",
-    "version": "0.23.0"
+    "version": "0.25.1"
   },
   "plugins": [
     {

package/.cursor-plugin/plugin.json

@@ -2,7 +2,7 @@
   "name": "team-flow",
   "displayName": "team-flow",
   "description": "Unified workflow plugin: team-flow (spec-driven dev: TDD/SDD/code-review/debugging) + compound-engineering core subset (brainstorm/plan/compound/strategy/ideate/proof, global compounding) + architecture-design (4A+DDD incremental design & global compounding) + prototype (local HTML prototype, zero external deps) + e2e (Playwright E2E, AC-driven) + workflow-orchestrator (product-level workflow orchestration) + workflow-bootstrap (existing project onboarding) + session-handoff (context transfer) + workflow-feedback (issue tracking). 23 skills + 8 agents, one install.",
-  "version": "0.23.0",
+  "version": "0.25.1",
   "author": {
     "name": "LT",
     "url": "https://github.com/LT"

package/.github/plugin/marketplace.json

@@ -6,13 +6,13 @@
   },
   "metadata": {
     "description": "Unified workflow plugins and skills for AI coding agents (team-flow: team-flow + compound + architecture-design + prototype).",
-    "version": "0.23.0"
+    "version": "0.25.1"
   },
   "plugins": [
     {
       "name": "team-flow",
       "description": "Unified workflow with planning artifacts, execution contracts, TDD, review gates, systematic debugging, delta spec sync, architecture-design, and local HTML prototyping.",
-      "version": "0.23.0",
+      "version": "0.25.1",
       "source": ".",
       "author": {
         "name": "LT",

package/AGENTS.md

@@ -8,7 +8,7 @@
 
 - 零运行时依赖（team-flow 底座）
 - prototype 额外 **零外部依赖、可离线**（自包含 HTML + 页面内 Tweaks 控件，无 CDN）
-- 插件保持通用，所有风格由项目 `design-system.md` / `prd.template` 注入，不固化任何公司/产品风格
+- 插件保持通用，所有风格由项目 `design-system.md` / `prd.template`（含配套 `prd-brainstorm-profile.md`）注入，不固化任何公司/产品风格
 
 ### 身份与依赖关系
 
@@ -253,11 +253,11 @@ docs/solutions/
 
 项目 `team-flow.config.json` 可注入（**插件层扩展字段，非 team-flow 原生 schema**；原生仅 `artifacts.order` / `artifacts.skip`）：
 
-- `prd.template`：PRD 模板路径
+- `prd.template`：PRD 模板路径（默认 `templates/prd.md`，GTMC D7 业务要件 11 章结构）。ce-brainstorm Phase 0.0 首次运行时若未配置，会交互式询问用户选择默认模板或自定义路径，并自动写入配置。自定义模板应配套 brainstorm profile（`<模板名>-brainstorm-profile.md`），否则回退使用内置默认的 GTMC D7 profile
 - `prototype.designSystem`：项目 `design-system.md` 路径
 - `prototype.entry`：原型入口（默认 `prototype/index.html`）
 
-读取方式：`tf runtime config --get <key>`（插件层自读，字段命名避开原生 key 冲突）。
+读取方式：`tf runtime config --get <key>`（插件层自读，字段命名避开原生 key 冲突）。`prd.template` 已纳入 DEFAULTS（`config-loader.mjs`），未配置时返回默认值而非报错。
 
 ## Architecture（team-flow 底座，TypeScript）
 

package/CHANGELOG.md

@@ -6,6 +6,127 @@ The format loosely follows Keep a Changelog.
 
 ## [Unreleased]
 
+## [0.25.1] - 2026-07-29
+
+### Changed（SKILL.md 渐进式披露拆分，P1-9，3 项）
+
+#### ce-proof (346→88 行)
+- **skills/ce-proof/SKILL.md**：保留核心决策逻辑（Identity/Credentials/Publish Mode/Edit Strategy/Safety），curl 示例和工作流移入 references
+- **skills/ce-proof/references/api-recipes.md**（新增）：Create/Read/Edit/Presence/Title/Delete 的完整 curl 示例 + 错误码表 + Marks & Privacy + When the loop breaks
+- **skills/ce-proof/references/workflows.md**（新增）：Review/Create/Pull 三个完整工作流
+
+#### ce-brainstorm (458→122 行)
+- **skills/ce-brainstorm/SKILL.md**：保留核心原则 + 每个 Phase 摘要 + reference 引用指针
+- **skills/ce-brainstorm/references/output-format.md**（新增）：OUTPUT_FORMAT 5 级优先级解析逻辑
+- **skills/ce-brainstorm/references/phase0-routing.md**（新增）：Phase 0 的 Resume/Classify/Verdict/Assess/Scope/Spine/Iteration 详细路由
+- **skills/ce-brainstorm/references/prototype-loop.md**（新增）：Phase 3.5 原型内循环完整流程
+- **skills/ce-brainstorm/references/grounding.md**（新增）：Phase 1.1 上下文扫描 + grounding scout 提示词 + Slack 路由
+
+#### ce-ideate (402→85 行)
+- **skills/ce-ideate/SKILL.md**：保留核心原则 + Phase 摘要 + reference 引用指针
+- **skills/ce-ideate/references/phase0-scope.md**（新增）：Phase 0 完整路由逻辑（输出模式/主题门/模式分类/上下文门/聚焦与容量/成本透明）
+- **skills/ce-ideate/references/grounding.md**（新增）：Phase 1 模式感知 Grounding（仓库/非仓库调度 + Web 研究 + 用户研究工件 + 综合摘要）
+- **skills/ce-ideate/references/topic-surface.md**（新增）：Phase 1.5 主题表面分解（轴标准 + 证据侦察）
+
+## [0.25.0] - 2026-07-29
+
+### Added（brainstorm profile 机制，3 项）
+
+#### Brainstorm Profile 机制
+- **templates/prd-brainstorm-profile.md**（新增）：GTMC D7 模板的 brainstorm profile，定义核心思考维度（7 项：业务流程/状态模型/权限模型/用户角色/数据关系/业务规则/系统功能）、扩展维度（6 项：画面设计/业务术语/报表需求/交互机制/非功能性需求/编码规则）、反例边界（7 项：禁止后端模块划分/前端页面结构/数据库表设计/API 接口定义/技术选型/部署架构/代码结构）和正向示例
+- **skills/ce-brainstorm/references/prd-mapping.md**：新增"Brainstorm Profile 机制"完整说明（文件命名规则、查找优先级、三段结构、自定义 Profile 指南）
+- **skills/ce-brainstorm/references/brainstorm-sections.md**：新增"Brainstorm profile coverage check"段落，确保核心维度在 PRD 中被覆盖
+
+### Changed（Phase 0 模板选择 + Phase 2 profile 驱动，4 项）
+
+#### PRD 模板交互式选择
+- **skills/ce-brainstorm/SKILL.md Phase 0.0**：PRD 模板解析改为 MANDATORY STEP——必须执行 bash 命令检查配置，未配置自定义模板时强制使用 AskUserQuestion 询问用户选择默认或自定义路径，并自动写入 `team-flow.config.json`
+- **skills/ce-brainstorm/SKILL.md Phase 2**：新增"Load brainstorm profile"步骤，按 profile 维度约束方案探索；"Approach granularity"从"mechanism/product shape"改为"profile-driven product thinking, not architecture"
+- **skills/ce-brainstorm/SKILL.md 调用模式**：明确声明 `orchestrated` 模式仅跳过 Phase 3.5，Phase 0-3 均正常执行不可跳过
+
+#### Config 默认值
+- **scripts/lib/config-loader.mjs**：DEFAULTS 增加 `prd.template: 'templates/prd.md'`，`tf runtime config --get prd.template` 未配置时返回默认值而非报错
+
+### Documentation（1 项）
+
+- **AGENTS.md**：`prd.template` 配置字段说明扩充（含 brainstorm profile 关联说明）；通用性描述补充 profile 注入机制
+
+## [0.24.1] - 2026-07-28
+
+### Fixed（prototype skill 体系补强，5 项）
+
+#### P0: design-system-architect.md 重复维护
+- **prototype/references/agents/design-system-architect.md**: 替换为迁移指针，指向 `design-system skill` 下的权威版本，消除两份文件内容漂移风险
+
+#### P0: Open Design 命名歧义
+- **prototype/SKILL.md**: description 中明确标注 "Open Design 桌面应用"（GUI 工具，互斥项）与 "nexu-io/open-design 开源设计方法论"（craft 规则借鉴源）同名不同义；新增「方法论参考与归因」段
+
+#### P1: prototype-sync 自动触发
+- **prototype/SKILL.md**: prototype-sync 段从 "SOP" 升级为 "release-archivist 自动触发"，明确标准路径是 closing 流程自动触发
+- **release-archivist/SKILL.md**: 新增 prototype-sync 执行校验段，要求检查 stdout 输出，禁止在未执行时标注为已完成
+- **release-archivist/references/closing-procedures.md**: 同步执行校验段和 write-back order 约束
+
+### Added（原型设计能力扩展，2 项）
+
+#### P2-1: 交互原型 + 线框图方法论
+- **prototype/references/interactive-prototype.md**: 新增交互原型方法论（零依赖状态管理、表单验证、多步导航、动态列表）
+- **prototype/references/wireframe.md**: 新增线框图方法论（低保真快速探索、3-5 差异化方案、并排对比）
+- **prototype/references/orchestration-flow.md**: prompt 组装顺序契约新增原型类型注入策略（wireframe / interactive / static）
+
+#### P2-2: C 端骨架扩展
+- **prototype/references/layouts.md**: 新增 §9-§14 C 端骨架（hero-xl / marketing-features / social-proof / pricing-c / faq / cta-c），新增 C 端页面节奏表
+- **prototype/references/template.html**: 新增 C 端扩展 CSS（hero-xl / pricing-card / faq-item / urgency 等）
+
+## [0.24.0] - 2026-07-28
+
+### Fixed（复利工程强制化补强，5 项）
+
+#### P0: Hook 旧名修复
+- **hooks/pre-tool-use-guard**: 修复 `.spec-superflow.yaml` → `.team-flow.yaml` 的硬编码旧名（5 处），恢复状态机编辑守卫
+- **hooks/session-start**: 修复 `spec-superflow` → `team-flow` 的硬编码旧名（3 处），恢复会话启动提示
+
+#### P1: 复利维度 guard
+- **guard/checks/compound-captured.mjs**: 新增复利捕获检查维度（learnings.md 存在性或显式 compound_skipped）
+- **guard/guard.mjs**: 将 `compound-captured` 维度挂到 `executing:closing` 转换（full 和 hotfix workflow）
+- **state-loader.mjs**: BUILTIN_DEFAULTS 新增 `compound_skipped` 字段
+- **cmd-state.mjs**: SETTABLE_FIELDS 新增 `compound_skipped` 字段，支持 `tf state set` 写入
+
+#### P1: Bootstrap DDL 提取
+- **workflow-bootstrap/scripts/recon-probe.sh**: 新增 DDL 提取能力（策略优先级：SQL 文件 > Java Entity 注解 > 占位兜底）
+  - 策略 1: 扫描 `db/migration/` 等目录的 `.sql` 文件，提取 CREATE TABLE 语句
+  - 策略 2: 扫描 `@Entity`/`@Table` 注解的 Java 类，提取表名和字段定义
+  - 策略 3: 无 DDL 源时生成占位文件，提示手动补充
+  - 新增 `--ddl-out` 参数，支持独立输出 DDL 文件
+  - JSON 输出新增 `ddl_extraction` 字段（source/table_count/tables/ddl_statements）
+
+#### P1: Bootstrap 模板引用
+- **workflow-bootstrap/SKILL.md**: B2 阶段新增 Step 0（模板初始化），从 `architecture-design/templates/` 复制 5 个模板到 `docs/architecture/`
+- **workflow-bootstrap/references/b1-reconnaissance.md**: 更新 B1.1a 章节，标注 DDL 提取已实现（v0.24.0），补充 CLI 用法和 JSON 输出字段说明
+
+#### P2: solutions 脚本测试
+- **tests/lib/solutions-capture.test.mjs**: 新增 6 个测试用例（文件创建、INDEX 追加、中文 slugify、默认 phase、无效 phase 拒绝）
+- **tests/lib/solutions-inject.test.mjs**: 新增 8 个测试用例（空索引、phase 过滤、cross-phase 包含、domain 匹配、severity 排序、top-5 截断）
+- **tests/lib/solutions-promote.test.mjs**: 新增 8 个测试用例（无 learnings、高/中/低 severity 晋升、insight 类型跳过、重复检测、多条晋升、INDEX 追加）
+- **tests/lib/solutions-index-gen.test.mjs**: 新增 7 个测试用例（全量重建、severity 排序、date 排序、7 phase 扫描、非 .md 跳过、150 条截断、空目录处理）
+- **scripts/lib/solutions-promote.mjs**: CLI 守卫增加 `NODE_ENV !== 'test'` 条件，避免 import 时触发 process.exit
+
+#### 测试修复
+- **tests/lib/guard.test.mjs**: `recordPassingClosingPrerequisites()` 新增 learnings.md 创建，满足 compound-captured 维度
+- **tests/lib/guard-specs-merged.test.mjs**: `makeChangeDir()` 新增 learnings.md 创建
+- **tests/lib/guard-tests-passing.test.mjs**: `makeChangeDir()` 新增 learnings.md 创建
+
+### Verified
+
+- check-version-consistency: ✅ PASS（全部 0.24.0，自动修复 6 处版本号）
+- npm test: ✅ 457/457 通过（428 既有 + 29 新增）
+
+### Statistics
+
+- 新增代码: ~350 行（guard 检查器 + DDL 提取 + 测试用例）
+- 修改文件: 52 个
+- 测试覆盖: solutions 四个脚本从 0% → 100%（29 个测试用例）
+- 复利强制化: executing:closing 转换新增 compound-captured 维度（learnings.md 或显式 skip）
+
 ## [0.22.5] - 2026-07-28
 
 ### Fixed（制品链评审与修复，设计 v0.9 §28）

package/GEMINI.md

@@ -8,7 +8,7 @@ The workflow is self-contained and does not require OpenSpec or Superpowers at r
 
 
 <!-- team-flow-phase-guard-start -->
-# team-flow v0.23.0 | 阶段: {{state}} | 工作流: {{workflow}}
+# team-flow v0.25.1 | 阶段: {{state}} | 工作流: {{workflow}}
 当前阶段允许的操作由 workflow-start 路由规则定义。
 禁止跨越 DP gate 进入下一阶段。变更范围以 execution-contract.md 的 Intent Lock 为准。
 <!-- team-flow-phase-guard-end -->

package/INSTALL.md

@@ -7,7 +7,7 @@
 - [Fission-AI/OpenSpec](https://github.com/Fission-AI/OpenSpec) — 规划引擎（Schema 验证、Delta Spec、工件解析）
 - [obra/superpowers](https://github.com/obra/superpowers) — 执行纪律（TDD 铁律、SDD、系统化调试、代码审查）
 
-当前发布版本：**v0.23.0**。
+当前发布版本：**v0.25.1**。
 
 ---
 

package/README.md

@@ -1,6 +1,6 @@
 # team-flow
 
-> 当前版本：`v0.23.0`
+> 当前版本：`v0.25.1`
 
 > 统一插件：**team-flow**（spec 驱动开发）+ **compound-engineering 核心子集**（全局复利）+ **architecture-design**（4A+DDD 增量设计）+ **prototype**（本地 HTML 原型）+ **e2e**（AC 驱动 E2E）+ **workflow-orchestrator**（产品级编排）+ **workflow-bootstrap**（既有项目接入）。一次安装，七套能力协同。
 

package/docs/README_en.md

@@ -126,7 +126,7 @@ npm install -g team-flow
 
 ### Version
 
-- Current: `v0.23.0`
+- Current: `v0.25.1`
 - v0.9.1 highlights: DP-4 execution-mode recommendations, a portable runtime across 17 platforms, and a raw-package smoke with no plugin-root variable.
 - Self-contained — no OpenSpec or Superpowers runtime required
 - Upstream: [Fission-AI/OpenSpec](https://github.com/Fission-AI/OpenSpec), [obra/superpowers](https://github.com/obra/superpowers)

package/docs/solutions/INDEX.md

@@ -0,0 +1,6 @@
+# Solutions Index
+<!-- 每条一行，按 severity 降序，≤150 行硬上限 -->
+| date | phase | domain | type | severity | summary | file |
+|------|-------|--------|------|----------|---------|------|
+| 2026-07-29 | cross-phase | general | insight | medium | (no summary) | cross-phase/2026-07-29-no-summary.md |
+| 2026-07-28 | cross-phase | general | insight | medium | (no summary) | cross-phase/2026-07-28-no-summary.md |

package/docs/solutions/cross-phase/2026-07-28-no-summary.md

@@ -0,0 +1,17 @@
+---
+phase: cross-phase
+domain: general
+type: insight
+severity: medium
+date: 2026-07-28
+source: 
+---
+
+## 问题描述
+(no summary)
+
+## 根因/模式
+（待补充）
+
+## 预防措施/应用方式
+（待补充）

package/docs/solutions/cross-phase/2026-07-29-no-summary.md

@@ -0,0 +1,17 @@
+---
+phase: cross-phase
+domain: general
+type: insight
+severity: medium
+date: 2026-07-29
+source: 
+---
+
+## 问题描述
+(no summary)
+
+## 根因/模式
+（待补充）
+
+## 预防措施/应用方式
+（待补充）

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "team-flow",
   "description": "Unified workflow plugin: team-flow (spec-driven dev) + compound-engineering core subset + architecture-design (4A/DDD) + prototype (local HTML). 17 skills, one install.",
-  "version": "0.23.0",
+  "version": "0.25.1",
   "contextFileName": "GEMINI.md"
 }

package/hooks/pre-tool-use-guard

@@ -1,12 +1,12 @@
 #!/usr/bin/env bash
 #
-# pre-tool-use-guard — spec-superflow implementation-edit state guard (PreToolUse)
+# pre-tool-use-guard — team-flow implementation-edit state guard (PreToolUse)
 #
 # ----------------------------------------------------------------------------
 # Purpose
 # ----------------------------------------------------------------------------
 # Blocks Write/Edit/MultiEdit implementation edits unless the active
-# spec-superflow change is in a state that permits building. This enforces the
+# team-flow change is in a state that permits building. This enforces the
 # state-machine rule that "no implementation is allowed" outside the
 # build-permitted states (exploring / specifying / bridging must finish and be
 # approved before any code is written).
@@ -15,8 +15,8 @@
 # Guard logic
 # ----------------------------------------------------------------------------
 #   1. Walk up from $PWD (current dir + max 3 parent levels) looking for
-#      `.spec-superflow.yaml`.
-#        - Not found  -> ALLOW (no active spec-superflow change in scope).
+#      `.team-flow.yaml`.
+#        - Not found  -> ALLOW (no active team-flow change in scope).
 #   2. Read the current workflow state from the `state:` line of the yaml.
 #   3. For Write/Edit/MultiEdit only:
 #        - state in {approved-for-build, executing, debugging} -> ALLOW
@@ -73,13 +73,13 @@ case "$TOOL_NAME" in
   *) allow ;;                  # anything else — allow
 esac
 
-# --- locate .spec-superflow.yaml (cwd + max 3 parent levels) ---------------
+# --- locate .team-flow.yaml (cwd + max 3 parent levels) ---------------
 dir="$PWD"
 yaml=""
 i=0
 while [ "$i" -le 3 ]; do
-  if [ -f "$dir/.spec-superflow.yaml" ]; then
-    yaml="$dir/.spec-superflow.yaml"
+  if [ -f "$dir/.team-flow.yaml" ]; then
+    yaml="$dir/.team-flow.yaml"
     break
   fi
   [ "$dir" = "/" ] && break          # reached filesystem root
@@ -87,7 +87,7 @@ while [ "$i" -le 3 ]; do
   i=$((i + 1))
 done
 
-# No active spec-superflow change in scope -> allow.
+# No active team-flow change in scope -> allow.
 [ -n "$yaml" ] || allow
 [ -r "$yaml" ] || allow
 
@@ -107,7 +107,7 @@ case "$state" in
     allow
     ;;
   *)
-    reason="spec-superflow guard: implementation edits (Write/Edit/MultiEdit) are blocked while the change is in state '$state'. Edits are only allowed in states: approved-for-build, executing, debugging. Advance the workflow to an approved build state first (see docs/state-machine.md or /spec-superflow:workflow-start). If no change is actually active, remove or fix the stray .spec-superflow.yaml."
+    reason="team-flow guard: implementation edits (Write/Edit/MultiEdit) are blocked while the change is in state '$state'. Edits are only allowed in states: approved-for-build, executing, debugging. Advance the workflow to an approved build state first (see docs/state-machine.md or /team-flow:workflow-start). If no change is actually active, remove or fix the stray .team-flow.yaml."
     # Escape backslashes and double quotes for safe JSON string embedding.
     reason_esc="$(printf '%s' "$reason" | sed 's/\\/\\\\/g; s/"/\\"/g')"
     printf '{"decision":"block","reason":"%s"}\n' "$reason_esc"

package/hooks/session-start

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
-# v0.23.0: conditional injection — detects artifacts, injects workflow-start pointer
-msg="<EXTREMELY_IMPORTANT>\nYou have spec-superflow installed. Use /spec-superflow:workflow-start ONLY when you detect an active spec-superflow change in the workspace (look for \`.spec-superflow.yaml\`, \`proposal.md\`, \`execution-contract.md\`, or \`specs/\` directories), OR when the user explicitly invokes it by name. For ordinary coding tasks without spec-superflow artifacts, do NOT invoke workflow-start — just handle the request directly.\n</EXTREMELY_IMPORTANT>"
+# v0.25.1: conditional injection — detects artifacts, injects workflow-start pointer
+msg="<EXTREMELY_IMPORTANT>\nYou have team-flow installed. Use /team-flow:workflow-start ONLY when you detect an active team-flow change in the workspace (look for \`.team-flow.yaml\`, \`proposal.md\`, \`execution-contract.md\`, or \`specs/\` directories), OR when the user explicitly invokes it by name. For ordinary coding tasks without team-flow artifacts, do NOT invoke workflow-start — just handle the request directly.\n</EXTREMELY_IMPORTANT>"
 
 # Three platforms share the same message, only output format differs.
 if [ -n "${CURSOR_PLUGIN_ROOT:-}" ]; then

package/llms.txt

@@ -3,7 +3,7 @@
 ## Overview
 spec-superflow is a self-contained workflow integration plugin for Claude Code, Cursor, OpenAI Codex CLI/App, GitHub Copilot CLI, Gemini CLI, OpenCode, WorkBuddy, and Trae. It merges spec-driven planning artifacts (proposal, specs, design, tasks) with disciplined execution guardrails (TDD, review gates, controlled handoff) into one unified workflow.
 
-Current version: v0.23.0.
+Current version: v0.25.1.
 
 ## Key Documents
 - README.md: Chinese homepage with full usage guide and FAQ

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xulthekl/team-flow",
-  "version": "0.23.0",
+  "version": "0.25.1",
   "description": "Unified plugin (23 skills + 8 agents) integrating team-flow, compound-engineering, architecture-design, prototype, design-system, workflow-orchestrator, workflow-bootstrap, e2e, session-handoff, workflow-feedback for multi-agent coding tools.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "team-flow",
-  "version": "0.23.0",
+  "version": "0.25.1",
   "description": "Unified workflow plugin: team-flow (spec-driven dev: TDD/SDD/code-review/debugging) + compound-engineering core subset (brainstorm/plan/compound/strategy/ideate/proof, global compounding) + architecture-design (4A+DDD incremental design & global compounding) + prototype (local HTML prototype, zero external deps) + e2e (Playwright E2E, AC-driven) + workflow-orchestrator (product-level workflow orchestration) + workflow-bootstrap (existing project onboarding) + session-handoff (context transfer) + workflow-feedback (issue tracking). 23 skills + 8 agents, one install.",
   "author": {
     "name": "LT"

package/scripts/guard/checks/compound-captured.mjs

@@ -0,0 +1,70 @@
+// scripts/guard/checks/compound-captured.mjs — compound engineering capture guard
+// v0.24.0: 复利贯穿强制化——executing:closing 增加 compound-captured 维度
+//
+// 规则：
+// - learnings.md 存在且非空 → pass（已记录经验）
+// - compound_skipped === true → pass（显式豁免，用户主动跳过）
+// - workflow === 'tweak' → 不进入本检查器（由 WORKFLOW_TRANSITION_CHECKS 豁免）
+// - 其他情况 → fail（提示用户执行 tf solutions capture 或显式 skip）
+//
+// 设计原则：
+// - 与 arch-design 检查器同属"产物存在性"维度，不涉及内容质量评审
+// - 只检查 learnings.md 存在，不验证 frontmatter 格式（advisory 由 ce-compound 保证）
+// - 显式 skip 必须通过 state 字段（`tf state set compound_skipped true`），防止遗忘
+
+import fs from 'node:fs';
+import path from 'node:path';
+
+/**
+ * 从 .team-flow.yaml 提取顶层字段值（与 arch-design.mjs 同源模式）
+ */
+function extractYamlField(content, field) {
+  for (const line of content.split('\n')) {
+    const match = line.match(new RegExp(`^${field}:\\s*(.*)`));
+    if (match) {
+      const val = match[1].trim();
+      return val === 'null' || val === '' ? null : val;
+    }
+  }
+  return null;
+}
+
+/**
+ * Check compound engineering capture for the executing:closing transition.
+ *
+ * @param {string} changeDir - change directory path
+ * @returns {{ pass: boolean, failures: string[] }}
+ */
+export function checkCompoundCaptured(changeDir) {
+  const failures = [];
+
+  // 1. 检查 learnings.md 存在且非空
+  const learningsPath = path.join(changeDir, 'learnings.md');
+  if (fs.existsSync(learningsPath)) {
+    const content = fs.readFileSync(learningsPath, 'utf-8').trim();
+    if (content.length > 0) {
+      return { pass: true, failures: [] };
+    }
+    // 文件存在但为空，视为未捕获
+    failures.push('learnings.md exists but is empty — run `tf solutions capture` or populate with session learnings');
+    return { pass: false, failures };
+  }
+
+  // 2. 检查显式豁免（compound_skipped === true）
+  const stateFile = path.join(changeDir, '.team-flow.yaml');
+  if (fs.existsSync(stateFile)) {
+    const raw = fs.readFileSync(stateFile, 'utf-8');
+    const skipped = extractYamlField(raw, 'compound_skipped');
+    if (skipped === 'true') {
+      return { pass: true, failures: [] };
+    }
+  }
+
+  // 3. 未捕获且未豁免 → fail
+  failures.push(
+    'Compound capture missing: no learnings.md found in change directory. ' +
+    'Run `tf solutions capture --phase review --domain <d> --type insight --severity medium --summary "..."` ' +
+    'to document session learnings, or `tf state set compound_skipped true` to explicitly skip.'
+  );
+  return { pass: false, failures };
+}

package/scripts/guard/guard.mjs

@@ -13,6 +13,7 @@ import { checkContractCurrent } from './checks/contract-current.mjs';
 import { checkDp3Approved } from './checks/dp3-approved.mjs';
 import { checkExecutionPlanReady } from './checks/execution-plan-ready.mjs';
 import { checkExecutionReviewsPassed } from './checks/execution-reviews-passed.mjs';
+import { checkCompoundCaptured } from './checks/compound-captured.mjs';
 
 // Transition matrix: <from>:<to> → required check dimensions
 const TRANSITION_CHECKS = {
@@ -21,7 +22,7 @@ const TRANSITION_CHECKS = {
   'specifying:bridging':            ['artifacts-exist', 'schema-valid'],
   'bridging:approved-for-build':    ['artifacts-exist', 'schema-valid', 'contract-fresh', 'dp-gate-passed'],
   'approved-for-build:executing':   ['artifacts-exist', 'contract-fresh', 'dp-gate-passed', 'execution-plan-ready'],
-  'executing:closing':              ['tasks-complete', 'tests-passing', 'specs-merged', 'execution-plan-ready', 'execution-reviews-passed'],
+  'executing:closing':              ['tasks-complete', 'tests-passing', 'specs-merged', 'execution-plan-ready', 'execution-reviews-passed', 'compound-captured'],
 
   // Debugging side-path
   'executing:debugging':            [],
@@ -165,6 +166,7 @@ async function main() {
     'execution-plan-ready': (dir) => checkExecutionPlanReady(dir),
     'execution-reviews-passed': (dir) => checkExecutionReviewsPassed(dir),
     'arch-design': (dir) => checkArchDesign(dir),
+    'compound-captured': (dir) => checkCompoundCaptured(dir),
   };
 
   const checks = [];

package/scripts/lib/cmd-state.mjs

@@ -26,6 +26,8 @@ const SETTABLE_FIELDS = [
   // Architecture design gate (v0.9 §26, v0.22.5 评审修复 F02)
   'arch_design_decision', 'arch_design_reason',
   'arch_design_timestamp', 'arch_design_artifacts',
+  // Compound engineering capture gate (v0.24.0 复利贯穿强制化)
+  'compound_skipped',
 ];
 
 export async function run(args) {

package/scripts/lib/config-loader.mjs

@@ -19,6 +19,9 @@ const DEFAULTS = {
   verification: {
     language: 'auto',
   },
+  prd: {
+    template: 'templates/prd.md',
+  },
 };
 
 export const MODEL_PROFILES = Object.freeze([

package/scripts/lib/solutions-promote.mjs

@@ -130,7 +130,7 @@ ${learning.body}
   return { promoted, updated };
 }
 
-if (process.argv[1]?.includes('solutions-promote')) {
+if (process.env.NODE_ENV !== 'test' && process.argv[1]?.includes('solutions-promote')) {
   const args = { _: [] };
   for (let i = 2; i < process.argv.length; i++) {
     if (process.argv[i].startsWith('--')) {

package/scripts/lib/state-loader.mjs

@@ -43,6 +43,8 @@ const BUILTIN_DEFAULTS = {
   arch_design_reason: null,
   arch_design_timestamp: null,
   arch_design_artifacts: null,
+  // Compound engineering capture gate (v0.24.0 复利贯穿强制化)
+  compound_skipped: null,
 };
 
 /**
@@ -117,6 +119,9 @@ export function writeState(changeDir, state) {
   lines.push(`arch_design_reason: ${state.arch_design_reason ?? 'null'}`);
   lines.push(`arch_design_timestamp: ${state.arch_design_timestamp ?? 'null'}`);
   lines.push(`arch_design_artifacts: ${state.arch_design_artifacts ?? 'null'}`);
+  lines.push('');
+  lines.push('# === Compound engineering capture gate (v0.24.0) ===');
+  lines.push(`compound_skipped: ${state.compound_skipped ?? 'null'}`);
 
   fs.writeFileSync(filePath, lines.join('\n') + '\n', 'utf-8');
 }

package/skills/bug-investigator/SKILL.md

@@ -49,7 +49,7 @@ Scientific method: form a single hypothesis ("I think X is the root cause becaus
 
 ### DP-5: Debug Escalation (3+ Failures)
 
-3+ failed fixes = architectural problem. Each fix revealing new problems elsewhere = wrong architecture. Record: `npx --yes --package @xulthekl/team-flow@0.23.0 tf state set <change-dir> dp_5_result <decision>`. Discuss with user before attempting more fixes.
+3+ failed fixes = architectural problem. Each fix revealing new problems elsewhere = wrong architecture. Record: `npx --yes --package @xulthekl/team-flow@0.25.1 tf state set <change-dir> dp_5_result <decision>`. Discuss with user before attempting more fixes.
 
 ## Red Flags — Return to Phase 1