@xulthekl/team-flow 0.44.0 → 0.46.0

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

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

package/.claude-plugin/marketplace.json

@@ -1,6 +1,6 @@
 {
   "name": "team-flow",
-  "description": "Unified workflow plugin: team-flow + compound-engineering core subset + architecture-design + prototype + workflow-orchestrator + workflow-bootstrap + e2e + session-handoff + workflow-feedback + business-analysis. 25 skills + 16 agents, one install.",
+  "description": "Unified workflow plugin: team-flow + compound-engineering core subset + architecture-design + prototype + workflow-orchestrator + workflow-bootstrap + e2e + session-handoff + workflow-feedback + business-analysis. 26 skills + 16 agents, one install.",
   "owner": {
     "name": "LT",
     "url": "https://github.com/LT"
@@ -8,8 +8,8 @@
   "plugins": [
     {
       "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 + independent business analysis. 25 skills + 16 agents with embedded TDD, SDD, code review, debugging, delta spec sync, and design-system-driven prototyping.",
-      "version": "0.44.0",
+      "description": "8-state spec workflow + compound global compounding + architecture-design (4A/DDD) + local HTML prototype + product-level orchestration + bootstrap + e2e + session handoff + workflow feedback + independent business analysis. 26 skills + 16 agents with embedded TDD, SDD, code review, debugging, delta spec sync, and design-system-driven prototyping.",
+      "version": "0.46.0",
       "source": "./",
       "author": {
         "name": "LT",

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "team-flow",
-  "version": "0.44.0",
-  "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) + business-analysis (independent requirement/scenario artifact). 25 skills + 16 agents, one install.",
+  "version": "0.46.0",
+  "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) + business-analysis (independent requirement/scenario artifact). 26 skills + 16 agents, one install.",
   "source": "./",
   "author": {
     "name": "LT",

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "team-flow",
-  "version": "0.44.0",
+  "version": "0.46.0",
   "description": "Spec-first workflow that bridges OpenSpec-style planning and Superpowers-style execution discipline.",
   "author": {
     "name": "MageByte",
@@ -26,7 +26,7 @@
   "interface": {
     "displayName": "team-flow",
     "shortDescription": "Spec-first workflow with guarded execution.",
-    "longDescription": "A self-contained Codex workflow plugin with 25 skills for intent exploration, planning artifacts, execution contracts, TDD execution, review gates, systematic debugging, closure, delta spec sync, and independent business analysis.",
+    "longDescription": "A self-contained Codex workflow plugin with 26 skills for intent exploration, planning artifacts, execution contracts, TDD execution, review gates, systematic debugging, closure, delta spec sync, and independent business analysis.",
     "developerName": "MageByte",
     "category": "Developer Tools",
     "composerIcon": "./assets/icon.svg",

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.44.0"
+    "version": "0.46.0"
   },
   "plugins": [
     {

package/.cursor-plugin/plugin.json

@@ -1,8 +1,8 @@
 {
   "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) + business-analysis (independent requirement/scenario artifact). 25 skills + 16 agents, one install.",
-  "version": "0.44.0",
+  "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) + business-analysis (independent requirement/scenario artifact). 26 skills + 16 agents, one install.",
+  "version": "0.46.0",
   "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.44.0"
+    "version": "0.46.0"
   },
   "plugins": [
     {
       "name": "team-flow",
       "description": "Unified workflow with planning artifacts, execution contracts, TDD, review gates, systematic debugging, delta spec sync, architecture-design, independent business analysis, and local HTML prototyping.",
-      "version": "0.44.0",
+      "version": "0.46.0",
       "source": ".",
       "author": {
         "name": "LT",

package/AGENTS.md

@@ -1,6 +1,6 @@
 # AGENTS.md · team-flow
 
-> team-flow 统一插件 = **team-flow**（spec 驱动开发）+ **compound-engineering 核心子集**（全局复利）+ **architecture-design**（4A+DDD 增量设计）+ **prototype**（本地 HTML 原型）+ **e2e**（AC 驱动 Playwright E2E）+ **workflow-orchestrator**（产品级编排）+ **workflow-bootstrap**（既有项目接入）。一次安装，七套能力协同（25 skills + 16 agents），支持 9 安装面（Claude Code, Cursor, OpenAI Codex CLI/App, GitHub Copilot CLI, Gemini CLI, OpenCode, WorkBuddy, Trae, ima-copilot）。
+> team-flow 统一插件 = **team-flow**（spec 驱动开发）+ **compound-engineering 核心子集**（全局复利）+ **architecture-design**（4A+DDD 增量设计）+ **prototype**（本地 HTML 原型）+ **e2e**（AC 驱动 Playwright E2E）+ **workflow-orchestrator**（产品级编排）+ **workflow-bootstrap**（既有项目接入）。一次安装，七套能力协同（26 skills + 16 agents），支持 9 安装面（Claude Code, Cursor, OpenAI Codex CLI/App, GitHub Copilot CLI, Gemini CLI, OpenCode, WorkBuddy, Trae, ima-copilot）。
 
 ## What This Is
 
@@ -12,7 +12,7 @@
 
 ### 身份与依赖关系
 
-- **team-flow**（本插件）：Claude Code / Cursor 等宿主的插件实体（`plugin.json` name = `team-flow`），包含 25 个 skills + 16 个 agents + hooks + templates
+- **team-flow**（本插件）：Claude Code / Cursor 等宿主的插件实体（`plugin.json` name = `team-flow`），包含 26 个 skills + 16 个 agents + hooks + templates
 - **@xulthekl/team-flow**（npm 底座包）：team-flow 的 CLI 工具层（`package.json` name = `@xulthekl/team-flow`，bin = `tf` / `team-flow`），提供状态机、校验、复利 CLI 等运行时能力
 - 关系：team-flow 插件 **包含** @xulthekl/team-flow npm 包作为底座（同一仓库、同一版本）。skills 中的 `tf ...` 调用的是已全局安装的 @xulthekl/team-flow CLI，版本由 session-start hook 自动同步
 - 历史身份（已废弃）：`spec-superflow`（npm 包名，0.11.0 后停止发布）/ `ssf`（CLI 前缀）/ `.spec-superflow.yaml`（状态文件）—— 详见设计增强方案 v0.9 §27
@@ -33,7 +33,7 @@ node --test tests/e2e.test.mjs --test-name-pattern="parseDeltaSpec"
 npm run validate
 ```
 
-## 能力概览（十套合一，25 skills）
+## 能力概览（十套合一，26 skills）
 
 ### 1. team-flow（底座，9 skills）
 spec 驱动开发过程。8 态变更机：`exploring → specifying → bridging → approved-for-build → executing → closing`（另有 `debugging` 侧路径 + `abandoned` 终态）。
@@ -61,7 +61,7 @@ spec 驱动开发过程。8 态变更机：`exploring → specifying → bridgin
 - 用法：`/e2e [原型|集成|验收] [spec路径]`
 
 ### 6. workflow-orchestrator（1 skill，产品级编排，v0.7 重设计 + v0.15.0 多需求）
-- 编排产品级工作流：S1 路径路由（含需求选择）→ S2 PRD+原型（循环上提，orchestrator 直接编排，**冻结前 PRD 完整性评审**）→ S3 ce-plan（pipeline 快速路径，**入口问定 plan_mode**）→ **ARCH 产品级架构设计（v0.36.0：architecture-design product 模式 8 步 → iterations/vN/architecture.md 快照 → 评审门 PASS 才进 S4）** → S4 拆分验证+分发 → S5 全局监控
+- 编排产品级工作流：S1 路径路由（含需求选择）→ S2 PRD+原型（循环上提，orchestrator 直接编排，**冻结前 PRD 完整性评审**）→ **ARCH 产品级架构设计（v0.36.0：architecture-design product 模式 8 步 → iterations/vN/architecture.md 快照 → 评审门 PASS 才进 S3；2026-08-19 上移 S3 前，S3 计划/S4 拆分是最终任务拆分须基于架构）** → S3 ce-plan（pipeline 快速路径，**入口问定 plan_mode**，基于 ARCH 架构定稿）→ S4 拆分验证+分发 → S5 全局监控
 - v0.7 关键变更：原型循环从 ce-brainstorm 内部上提到 orchestrator 层直接编排；新增反馈环路（vN 内修订+变更履历，非升版）；新增增量入口（S1 路径路由器，**7 种入口路径**，v0.20.0 增「原型补跑/重跑」）；S5 多 change 并行时必选
 - **v0.20.0**：S1 路由新增第 7 种入口「原型补跑/重跑」（PRD 冻结 ∧ prototype 缺失/需重做 → 部分重入 S2 原型循环，PRD 不动、保留有效 S3/S4）；后台子代理等待范式（依赖完成通知，禁 TaskOutput 轮询）（设计 §22）
 - **v0.15.0 多需求并行**：`.team-flow/registry.yaml` 注册表 + 每需求一份 `.team-flow/requirements/<req-id>/orchestrator.yaml`，状态天然隔离
@@ -143,8 +143,8 @@ STRATEGY.md CONCEPTS.md 产品策略(BA) / 领域词汇
   S3 计划阶段 → ce-plan（pipeline 快速路径，入口问定 plan_mode）
      plan.md：change 拆分 + 依赖 DAG + 高阶技术方向（不含接口清单）
      反馈环路：plan 暴露 PRD 问题可回退 S2
-  [ARCH 产品级架构设计（v0.36.0）] → architecture-design product 模式 8 步设计
-     → docs/architecture/iterations/vN/architecture.md（6 产物快照，预测态不写全局）→ 评审门 PASS 才进 S4
+  [ARCH 产品级架构设计（v0.36.0；2026-08-19 上移 S3 前）] → architecture-design product 模式 8 步设计
+     → docs/architecture/iterations/vN/architecture.md（6 产物快照，预测态不写全局）→ 评审门 PASS 才进 S3
      skip 须物化（iterations/vN/SKIPPED）；旧项目首轮 arch_baseline 缺失 → 逆向重建
   S4 拆分验证与分发 → arch-readiness 门（快照覆盖 change 触及 BC）→ change-split-auditor 审计（必选门禁）→ 创建 change → 进入 team-flow
      并行策略建议 + 验收标准预分配；反馈环路：依赖图不可执行可回退 S3
@@ -174,7 +174,7 @@ STRATEGY.md CONCEPTS.md 产品策略(BA) / 领域词汇
   全局作为下一 change / 下一 PRD 版本的 grounding → 闭环
 ```
 
-## Skills 索引（25 个）
+## Skills 索引（26 个）
 
 | Skill | 归属 | 用途 |
 |---|---|---|
@@ -203,6 +203,7 @@ STRATEGY.md CONCEPTS.md 产品策略(BA) / 领域词汇
 | session-handoff | 会话交接 | 上下文腐化时压缩会话为交接文档（v0.16.0） |
 | workflow-feedback | 工作流反馈 | 工作流问题结构化记录（v0.16.0） |
 | business-analysis | 独立业务分析 | 将任意输入整理为 requirement/vN/business-analysis.md（独立外挂，v0.44.0） |
+| project-initialize | 项目初始化引导 | 工作空间代码服务为空时：架构选择（glaf4/前端分离/单体微服务/拆分）→ 服务命名确认 → 创建服务子目录 → 委托初始化（glaf4 走 glaf4-dev，非 glaf4 走内置引导）（v0.45.0） |
 
 ### 触发域分层（v0.12.0 新增）
 

package/CHANGELOG.md

@@ -4,6 +4,38 @@ All notable changes to `team-flow` will be documented in this file.
 
 The format loosely follows Keep a Changelog.
 
+## [0.46.0] - 2026-08-19
+
+### Added（PROJECT_INITIALIZE 场景 + project-initialize skill + ARCH 上移，v0.46.0）
+
+设计来源：`docs/plan/glaf4-dev-integration-design.md` v2.1 §6.5（2026-08-19 LT 定案）
+
+- **新增 `project-initialize` skill**：产品级初始化引导流程——识别需初始化 → 引导新会话 → 架构选择（glaf4 体系/前端分离/单体微服务/拆分）→ 服务命名确认 → team-flow 创建空服务子目录（git init + .gitignore）→ 委托初始化（glaf4 走 glaf4-dev PROJECT_INITIALIZE，非 glaf4 走 workflow-bootstrap B1.5）；3 references（architecture-choice / service-layout / glaf4-initialize-delegation）
+- **触发接入**（编排层 Pre-check 检测驱动，不靠用户显式触发）：
+  - orchestrator ARCH 评审 PASS 后、S3 前：Pre-check 1 服务初始化检测（场景①）
+  - workflow-start Route to build-executor 前：Pre-check 2 服务缺漏检测（场景②，AskUserQuestion 区分"未拉取 git pull"vs"需要初始化"）
+- **ARCH 上移 S3 前**（LT 决策）：S3 计划/S4 拆分是最终任务拆分须基于架构——orchestrator / CLAUDE.md SOP / architecture-design / state-model / s3-plan-pipeline 统一"PASS 才进 S3"
+- **实证闭合**：gen-service 空目录冲突（run 树 .glaf4-dev 存在 → `out dir not empty` BLOCKED）+ 环境就绪（JDK8 + 本地 gtmc-glaf4-starter-parent + 空目录生成 92 文件）
+- **双评审修复**：skill-reviewer（B1 gen-service 缓解补 .git/.gitignore 白名单化 + M1 bootstrap 契约 + M2 触发场景）+ code-reviewer（F1-F3 ARCH 残留/计数同步）
+- skill 计数 25→26 全平台同步（plugin.json / .claude-plugin / .cursor-plugin / .codex-plugin / gemini-extension / README / AGENTS）
+- 708/708 测试通过
+
+## [0.45.0] - 2026-08-18
+
+### Added（glaf4-dev 集成增强，v0.45.0）
+
+设计来源：`docs/plan/glaf4-dev-integration-design.md` v2.1（glaf4-dev 统一开发技能族 v0.3.0，生产+测试全委托）
+
+- **运行时探测**（接口①）：`tf glaf4-delegation detect <root>` 三态检测（is_glaf4_java / glaf4_dev_available / delegation_mode）+ 写 `.team-flow/team-flow.config.json` 的 `glaf4_dev` 段；git root ≠ target_root 时写 git root 冗余副本（多服务 OR 聚合 enabled + delegation_mode 保留）；config-loader 查找链补 git root `.team-flow/`
+- **test-matrix-export v2**（接口②）：支持 test-matrix-vnext（schema_version 2.0）——模块名从 case.target 推导、kind→work_mode 映射（REFACTOR→TDD 记 footer）、write_targets 数组多行拆分 + `#方法` 锚点、case_id 与 rewriteIndex 正则兼容 WARN、`validateSchemaVersion` 版本门（未知版本显式 BLOCK）
+- **S1 guard 改造**（接口③）：`EXECUTION_MODES` 扩入 `glaf4-delegation`；execution-recommendation 补 recommend 链（glaf4DelegationAvailable 注入 available_modes + 白名单改引用单一真相源）；cmd-execution 支持 `--mode glaf4-delegation --wave w1:serial:delegate` 单 wave 计划
+- **证据回灌**（接口④）：`tf glaf4-evidence-export` 聚合 glaf4-dev run 终局 PASS 证据（模式→证据阶段映射、每 batch 最终 GREEN、executed_classes 去重、surefire 兼容行、total=0 边界、environment_error 分流）→ `tf test record --from` 落盘
+- **委托协议 CLI**：`tf glaf4-delegation`（confirm DP-4 委托确认 5 项 + write-set.json 落盘 + 契约段 diff WARN；verify-write-set 门禁级对账；verify-tasks 审计；record-partial 落 partial writes；reset 删 plan 重走 DP-4）
+- **delegation-status guard 维度**：executing:closing 校验 `delegation_status`（failed 阻断直到人工重置；retry_count≥3 提示上限）
+- **skip 禁令**：glaf4-delegation 模式禁 `test_matrix_skipped`（唯一例外 TEST_BOOTSTRAP），三个测试门禁统一接入
+- **GLAF4 Delegation 段**：contract-builder SKILL 重写 GLAF4 路由 + `references/glaf4-delegation.md`（骨架矩阵先行时序 + closing 时序协议）+ `templates/execution-contract.md` 段占位；workflow-start 路由从 glaf4-tests → glaf4-dev 实施委托
+- **四轮覆盖度评审闭环**：2 阻塞（C1 探测断链/C2 版本契约）+ 5 Important（模板表头盲区/嵌套工程根/多服务污染/detect 接线/mode last-write-wins）+ 12 Minor 全修，707/707 测试通过
+
 ## [0.44.0] - 2026-08-17
 
 ### Added（独立 business-analysis skill/agent，v0.44.0）

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.44.0 | 阶段: {{state}} | 工作流: {{workflow}}
+# team-flow v0.46.0 | 阶段: {{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.44.0**。
+当前发布版本：**v0.46.0**。
 
 ---
 

package/README.md

@@ -1,6 +1,6 @@
 # team-flow
 
-> 当前版本：`v0.44.0`
+> 当前版本：`v0.46.0`
 
 > 统一插件：**team-flow**（spec 驱动开发）+ **compound-engineering 核心子集**（全局复利）+ **architecture-design**（4A+DDD 增量设计）+ **prototype**（本地 HTML 原型）+ **e2e**（AC 驱动 E2E）+ **workflow-orchestrator**（产品级编排）+ **workflow-bootstrap**（既有项目接入）。一次安装，七套能力协同。
 
@@ -34,7 +34,7 @@
 git clone <your-repo> && <cli> plugin install ./team-flow
 ```
 
-> 不同宿主 CLI 的安装子命令略有差异（如 Claude Code 为 `/plugin add`，Cursor 为 `plugin install`）。以宿主文档为准；本插件提供单一 `plugin.json`，一次安装即加载全部 25 个 skills。
+> 不同宿主 CLI 的安装子命令略有差异（如 Claude Code 为 `/plugin add`，Cursor 为 `plugin install`）。以宿主文档为准；本插件提供单一 `plugin.json`，一次安装即加载全部 26 个 skills。
 
 ## 配置（插件层扩展字段）
 
@@ -70,7 +70,7 @@ specs/<cap>/        每变更设计/任务/契约 + learnings.md
 STRATEGY.md CONCEPTS.md 策略 / 领域词汇
 ```
 
-## 十套能力（25 skills）
+## 十套能力（26 skills）
 
 - **team-flow**（9）：workflow-start / need-explorer / spec-writer / contract-builder / build-executor / code-reviewer / spec-merger / release-archivist / bug-investigator
 - **compound 核心子集**（6）：ce-brainstorm / ce-plan / ce-compound / ce-strategy / ce-ideate / ce-proof

package/agents/architecture-design.md

@@ -28,7 +28,7 @@ You are an independent architecture designer. You read the change brief, plan, e
 | change（默认） | workflow-start（exploring→specifying） | 五项检查 | `changes/<name>/architecture/` 三件套 + sql/ | 产品级快照（BC 边界/聚合注册表），只引用不重定义 |
 | product | workflow-orchestrator S3.5（ARCH 阶段） | 8 步全系统结构级设计（无五项检查） | `docs/architecture/iterations/vN/architecture.md`（6 产物） | 本快照是产品级唯一事实源 |
 
-**product 模式**：按 `references/s3.5-product-architecture.md` SOP（8 步）+ `references/s3.5-architecture-template.md` 模板 + `references/s3.5-loading-protocol.md` 加载协议；产出经 architecture-reviewer product 视角评审（`review_mode: product`）PASS 才进 S4；时序 P1：只写快照不写全局。
+**product 模式**：按 `references/s3.5-product-architecture.md` SOP（8 步）+ `references/s3.5-architecture-template.md` 模板 + `references/s3.5-loading-protocol.md` 加载协议；产出经 architecture-reviewer product 视角评审（`review_mode: product`）PASS 才进 S3（2026-08-19：ARCH 上移 S3 前，原"进 S4"）；时序 P1：只写快照不写全局。
 
 ## Inputs
 

package/docs/README_en.md

@@ -126,7 +126,7 @@ npm install -g team-flow
 
 ### Version
 
-- Current: `v0.44.0`
+- Current: `v0.46.0`
 - 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

@@ -2,6 +2,8 @@
 <!-- 每条一行，按 severity 降序，≤150 行硬上限 -->
 | date | phase | domain | type | severity | summary | file |
 |------|-------|--------|------|----------|---------|------|
+| 2026-08-19 | cross-phase | general | insight | medium | (no summary) | cross-phase/2026-08-19-no-summary.md |
+| 2026-08-18 | cross-phase | general | insight | medium | (no summary) | cross-phase/2026-08-18-no-summary.md |
 | 2026-08-17 | cross-phase | general | insight | medium | (no summary) | cross-phase/2026-08-17-no-summary.md |
 | 2026-08-07 | cross-phase | general | insight | medium | (no summary) | cross-phase/2026-08-07-no-summary.md |
 | 2026-08-06 | cross-phase | general | insight | medium | (no summary) | cross-phase/2026-08-06-no-summary.md |

package/docs/solutions/cross-phase/2026-08-18-no-summary.md

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

package/docs/solutions/cross-phase/2026-08-19-no-summary.md

@@ -0,0 +1,17 @@
+---
+phase: cross-phase
+domain: general
+type: insight
+severity: medium
+date: 2026-08-19
+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) + business-analysis (independent requirement/scenario artifact). 25 skills, one install.",
-  "version": "0.44.0",
+  "description": "Unified workflow plugin: team-flow (spec-driven dev) + compound-engineering core subset + architecture-design (4A/DDD) + prototype (local HTML) + business-analysis (independent requirement/scenario artifact). 26 skills, one install.",
+  "version": "0.46.0",
   "contextFileName": "GEMINI.md"
 }

package/hooks/session-start

@@ -1,11 +1,11 @@
 #!/usr/bin/env bash
-# v0.44.0: auto-sync CLI version with plugin version
+# v0.46.0: auto-sync CLI version with plugin version
 set -e
 
 # ═══════════════════════════════════════════════════════════════
 # Plugin version (update this when releasing new versions)
 # ═══════════════════════════════════════════════════════════════
-PLUGIN_VERSION="0.44.0"
+PLUGIN_VERSION="0.46.0"
 
 # ═══════════════════════════════════════════════════════════════
 # Step 1: Auto-sync CLI version with plugin version

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.44.0.
+Current version: v0.46.0.
 
 ## Key Documents
 - README.md: Chinese homepage with full usage guide and FAQ

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xulthekl/team-flow",
-  "version": "0.44.0",
-  "description": "Unified plugin (25 skills + 16 agents) integrating team-flow, compound-engineering, architecture-design, prototype, design-system, workflow-orchestrator, workflow-bootstrap, e2e, session-handoff, workflow-feedback, business-analysis for multi-agent coding tools.",
+  "version": "0.46.0",
+  "description": "Unified plugin (26 skills + 16 agents) integrating team-flow, compound-engineering, architecture-design, prototype, design-system, workflow-orchestrator, workflow-bootstrap, e2e, session-handoff, workflow-feedback, business-analysis for multi-agent coding tools.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "team-flow",
-  "version": "0.44.0",
-  "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) + business-analysis (independent requirement/scenario artifact). 25 skills + 16 agents, one install.",
+  "version": "0.46.0",
+  "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) + business-analysis (independent requirement/scenario artifact). 26 skills + 16 agents, one install.",
   "author": {
     "name": "LT"
   },

package/scripts/guard/checks/delegation-status.mjs

@@ -0,0 +1,56 @@
+// scripts/guard/checks/delegation-status.mjs — GLAF4 委托状态位 guard（v2.1 §6.7）
+//
+// 规则（v2.1 §6.7 委托失败恢复闭环）：
+// - execution_mode !== 'glaf4-delegation' → pass（透明，不干预非委托 change）
+// - delegation_status === 'success' → pass（委托已成功完成）
+// - delegation_status === 'failed' → FAIL（阻断 closing 直到人工重置——三选一恢复）
+// - delegation_status 缺失 / null / in_progress → FAIL（委托未成功完成，closing 前必须终局）
+//
+// 设计原则：
+// - 与 compound-captured 同属"状态位约束"维度，确保 delegation_status 有 guard 约束力
+//   （否则状态位无约束力，三选一恢复全靠人工纪律）
+// - 状态位经 `tf state set delegation_status <in_progress|success|failed>` 程序化写入
+
+import { readState } from '../../lib/state-loader.mjs';
+
+/**
+ * Check GLAF4 委托状态位（executing:closing 维度）
+ * @param {string} changeDir
+ * @returns {{ pass: boolean, failures: string[] }}
+ */
+export function checkDelegationStatus(changeDir) {
+  const state = readState(changeDir);
+
+  // 非 glaf4-delegation 模式：透明放行（可选接入，非 GLAF4 项目完全不受影响，v2.1 §8）
+  if (state.execution_mode !== 'glaf4-delegation') {
+    return { pass: true, failures: [] };
+  }
+
+  if (state.delegation_status === 'success') {
+    return { pass: true, failures: [] };
+  }
+
+  const failures = [];
+  if (state.delegation_status === 'failed') {
+    // I3（2026-08-18）：retry_count 封顶 3 机械提示——达到上限必须走降级/转人工，不再允许重试
+    const retryCount = Number.isInteger(state.delegation_retry_count) ? state.delegation_retry_count : 0;
+    const atLimit = retryCount >= 3;
+    failures.push(
+      'GLAF4 委托状态位为 failed——closing 前必须人工处置（v2.1 §6.7 三选一）：'
+      + (atLimit
+        ? `⚠️  delegation_retry_count=${retryCount} 已达上限 3——禁止继续重试，必须走 ② 降级 build-executor（glaf4-delegation reset 删 plan 重走 DP-4）或 ③ 标记阻塞转人工排障。`
+        : `① 重试（delegation_retry_count 封顶 3，当前 ${retryCount}）② 降级 build-executor（glaf4-delegation reset 删 plan 重走 DP-4）③ 标记阻塞转人工排障。`)
+      + '处置后 `tf state set delegation_status success`（或重置为 in_progress 继续委托）。'
+    );
+  } else if (state.delegation_status === 'in_progress') {
+    failures.push(
+      'GLAF4 委托状态位仍为 in_progress——委托 run 尚未终局，closing 前必须完成委托并回灌证据后置为 success。'
+    );
+  } else {
+    failures.push(
+      'GLAF4 委托状态位缺失（delegation_status 未记录）——glaf4-delegation 模式 change 必须先完成委托，'
+      + '证据回灌 + 对账通过后 `tf state set delegation_status success`。'
+    );
+  }
+  return { pass: false, failures };
+}

package/scripts/guard/checks/test-gate-exemptions.mjs

@@ -32,6 +32,19 @@ export function skipMissingReason(state) {
   return state?.test_matrix_skipped === 'true' && !hasExplicitSkip(state);
 }
 
+/**
+ * v2.1 §6.3 skip 禁令：glaf4-delegation 模式禁止 test_matrix_skipped（唯一例外 TEST_BOOTSTRAP 零测试）。
+ * 防止"矩阵权威在 glaf4-dev"被误读为"矩阵可 skip"导致零测试证据关闭（测试门三道短路后门）。
+ * @returns {string|null} 违规原因（null = 无违规）
+ */
+export function glaf4SkipViolation(state) {
+  if (state?.execution_mode !== 'glaf4-delegation') return null;
+  if (state?.test_matrix_skipped !== 'true') return null;
+  // 唯一例外：TEST_BOOTSTRAP 零测试（reason 显式声明）
+  if (/TEST_BOOTSTRAP/.test(state?.test_matrix_skip_reason || '')) return null;
+  return 'glaf4-delegation 模式禁止 test_matrix_skipped（唯一例外 TEST_BOOTSTRAP 零测试，skip_reason 须显式声明 TEST_BOOTSTRAP）';
+}
+
 export const SKIP_REASON_HINT =
   "test_matrix_skipped=true requires test_matrix_skip_reason — record it: "
   + "tf state set <dir> test_matrix_skip_reason '<why this change needs no test matrix>'";

package/scripts/guard/checks/test-matrix-complete.mjs

@@ -10,6 +10,7 @@ import { computeTestMatrixHash } from '../../lib/hash.mjs';
 import {
   isLegacyChange,
   skipMissingReason,
+  glaf4SkipViolation,
   SKIP_REASON_HINT,
   contractDeclaresTestMatrix,
   readTestMatrixFile,
@@ -28,6 +29,11 @@ export function checkTestMatrixComplete(changeDir) {
 
   // Step 2 — 显式 skip：必须附理由（可审计豁免）。
   if (state.test_matrix_skipped === 'true') {
+    // v2.1 §6.3 skip 禁令：glaf4-delegation 模式禁止 skip（唯一例外 TEST_BOOTSTRAP）
+    const glaf4Violation = glaf4SkipViolation(state);
+    if (glaf4Violation) {
+      return { pass: false, failures: [glaf4Violation] };
+    }
     if (skipMissingReason(state)) {
       return { pass: false, failures: [SKIP_REASON_HINT] };
     }

package/scripts/guard/checks/test-matrix-ready.mjs

@@ -8,6 +8,7 @@ import { readState } from '../../lib/state-loader.mjs';
 import {
   isLegacyChange,
   skipMissingReason,
+  glaf4SkipViolation,
   SKIP_REASON_HINT,
   contractDeclaresTestMatrix,
   readTestMatrixFile,
@@ -26,6 +27,11 @@ export function checkTestMatrixReady(changeDir) {
 
   // Exemption 2：显式 skip（必须附理由）。
   if (state.test_matrix_skipped === 'true') {
+    // v2.1 §6.3 skip 禁令：glaf4-delegation 模式禁止 skip（唯一例外 TEST_BOOTSTRAP）
+    const glaf4Violation = glaf4SkipViolation(state);
+    if (glaf4Violation) {
+      return { pass: false, failures: [glaf4Violation] };
+    }
     if (skipMissingReason(state)) {
       return { pass: false, failures: [SKIP_REASON_HINT] };
     }

package/scripts/guard/checks/tests-passing.mjs

@@ -9,7 +9,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { readState } from '../../lib/state-loader.mjs';
-import { isLegacyChange, skipMissingReason, SKIP_REASON_HINT } from './test-gate-exemptions.mjs';
+import { isLegacyChange, skipMissingReason, glaf4SkipViolation, SKIP_REASON_HINT } from './test-gate-exemptions.mjs';
 
 /**
  * 解析结构化 test_result：
@@ -68,6 +68,11 @@ export function checkTestsPassing(changeDir) {
 
   // 显式 skip（必须附理由）。
   if (state.test_matrix_skipped === 'true') {
+    // v2.1 §6.3 skip 禁令：glaf4-delegation 模式禁止 skip（唯一例外 TEST_BOOTSTRAP）
+    const glaf4Violation = glaf4SkipViolation(state);
+    if (glaf4Violation) {
+      return { pass: false, failures: [glaf4Violation] };
+    }
     if (skipMissingReason(state)) {
       return { pass: false, failures: [SKIP_REASON_HINT] };
     }

package/scripts/guard/guard.mjs

@@ -18,6 +18,7 @@ import { checkTestMatrixComplete } from './checks/test-matrix-complete.mjs';
 import { checkTestMatrixReady } from './checks/test-matrix-ready.mjs';
 import { checkArchReadiness } from './checks/arch-readiness.mjs';
 import { checkArchSnapshot } from './checks/arch-snapshot.mjs';
+import { checkDelegationStatus } from './checks/delegation-status.mjs';
 
 // Transition matrix: <from>:<to> → required check dimensions
 const TRANSITION_CHECKS = {
@@ -37,7 +38,7 @@ const TRANSITION_CHECKS = {
   'approved-for-build:executing':   ['artifacts-exist', 'contract-fresh', 'dp-gate-passed', 'execution-plan-ready', 'test-matrix-ready'],
   // v0.35.0 (v0.14 §59.4): arch-snapshot 新增——"先快照后回写"的强制化（legacy 豁免）。
   // 仅在 full workflow 挂；hotfix/tweak 沿用 §59.4 豁免（紧急/微调不挂）。
-  'executing:closing':              ['tasks-complete', 'tests-passing', 'specs-merged', 'execution-plan-ready', 'execution-reviews-passed', 'compound-captured', 'test-matrix-complete', 'arch-snapshot'],
+  'executing:closing':              ['tasks-complete', 'tests-passing', 'specs-merged', 'execution-plan-ready', 'execution-reviews-passed', 'compound-captured', 'test-matrix-complete', 'arch-snapshot', 'delegation-status'],
 
   // Debugging side-path
   'executing:debugging':            [],
@@ -188,6 +189,7 @@ async function main() {
     'test-matrix-ready': (dir) => checkTestMatrixReady(dir),
     'arch-readiness': (dir) => checkArchReadiness(dir),
     'arch-snapshot': (dir) => checkArchSnapshot(dir),
+    'delegation-status': (dir) => checkDelegationStatus(dir),
   };
 
   const checks = [];

package/scripts/lib/cmd-state.mjs

@@ -21,6 +21,9 @@ const SETTABLE_FIELDS = [
   'dp_1_result', 'dp_1_timestamp', 'dp_1_decisions', 'dp_1_confirmed',
   'dp_2_result', 'dp_2_timestamp', 'dp_2_decisions', 'dp_2_confirmed',
   'dp_3_result', 'dp_3_timestamp', 'dp_3_decisions', 'dp_3_confirmed',
+  // v2.1 §6.6/§6.7：GLAF4 委托决策与状态位（dp_4_result 仍由 tf execution plan --confirm 程序化写入，不在列表）
+  'dp_4_glaf4_mode', 'dp_4_write_set_hash',
+  'delegation_status', 'delegation_retry_count', 'delegation_partial_writes',
   'dp_5_result', 'dp_5_timestamp', 'dp_5_decisions', 'dp_5_confirmed',
   'dp_6_result', 'dp_6_timestamp', 'dp_6_decisions', 'dp_6_confirmed',
   'dp_7_result', 'dp_7_timestamp', 'dp_7_decisions', 'dp_7_confirmed',

package/scripts/lib/config-loader.mjs

@@ -28,6 +28,13 @@ const DEFAULTS = {
     // 各 skill 上下文加载时按 phase 过滤注入
     // 示例: { database: ".team-flow/conventions/db-design.md", ... }
   },
+  glaf4_dev: {
+    // glaf4-dev 运行时探测结果（v2.1 §4 接口①）
+    // contract-builder 产出 execution-contract 时实时探测写入；delegation_mode 由用户/编排开关
+    enabled: false,
+    version: null,
+    delegation_mode: 'auto',
+  },
 };
 
 export const MODEL_PROFILES = Object.freeze([
@@ -89,6 +96,10 @@ function findConfigFile(startDir) {
       encoding: 'utf-8',
       stdio: ['pipe', 'pipe', 'pipe'],
     }).trim();
+    // v2.1 评审 C1（2026-08-18）：git root 优先查 .team-flow/（writeGlaf4DevConfig 落点，
+    // contract-builder 在工程根写探测结果，changeDir 子目录需经此读到），再查 legacy 位置。
+    const gitTeamFlowDir = join(gitRoot, '.team-flow', 'team-flow.config.json');
+    if (existsSync(gitTeamFlowDir)) return gitTeamFlowDir;
     const gitPath = join(gitRoot, 'team-flow.config.json');
     if (existsSync(gitPath)) return gitPath;
   } catch {