@xulthekl/team-flow 0.45.0 → 0.46.0

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

@@ -1,3 +1,3 @@
-# team-flow v0.45.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.45.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.45.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.45.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.45.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.45.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.45.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.45.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,22 @@ 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）

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.45.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.45.0**。
+当前发布版本：**v0.46.0**。
 
 ---
 

package/README.md

@@ -1,6 +1,6 @@
 # team-flow
 
-> 当前版本：`v0.45.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.45.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,7 @@
 <!-- 每条一行，按 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 |

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.45.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.45.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.45.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.45.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.45.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.45.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/skills/architecture-design/SKILL.md

@@ -176,7 +176,7 @@ change 进入 closing 阶段时，由 release-archivist 调用 `tf arch-merge` C
 | 变更级（默认） | workflow-start（exploring→specifying） | 五项检查 | `changes/<name>/architecture/` 三件套 + sql/ | architecture-design 子代理 |
 | 产品级（product 模式） | workflow-orchestrator S3.5（architecture 阶段） | 8 步全系统结构级设计（无五项检查） | `docs/architecture/iterations/vN/architecture.md`（6 产物快照） | architecture-design product 模式子代理（唯一 owner） |
 
-**产品级模式执行**：按 `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：只写快照不写全局。
+**产品级模式执行**：按 `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：只写快照不写全局。
 
 ### 独立调用
 

package/skills/architecture-design/references/s3.5-architecture-template.md

@@ -2,7 +2,7 @@
 
 > 产品级架构设计（architecture 阶段）产出的权威文档模板。基于 4A + DDD 方法论，覆盖 6 类产物。
 > 位置：`docs/architecture/iterations/vN/architecture.md`（预测态快照，P1：不写全局当前态）。
-> 产出后须经产品级评审门（architecture-reviewer product 视角）PASS 才进 S4。
+> 产出后须经产品级评审门（architecture-reviewer product 视角）PASS 才进 S3（2026-08-19：ARCH 上移 S3 前，原"进 S4"）。
 
 ## 文档骨架
 

package/skills/architecture-design/references/s3.5-product-architecture.md

@@ -1,6 +1,6 @@
 # S3.5 产品级架构设计 SOP（v0.35.0，v0.14 §59/§60）
 
-> architecture 阶段（S3 之后、S4 之前）的执行 SOP。产出 `docs/architecture/iterations/vN/architecture.md`（预测态快照）。
+> architecture 阶段（2026-08-19 调整：S2 之后、S3 之前——ARCH 上移，S3 计划/S4 拆分是最终任务拆分须基于架构；原" S3 之后、S4 之前"历史位置）的执行 SOP。产出 `docs/architecture/iterations/vN/architecture.md`（预测态快照）。
 > **owner**：architecture-design skill 的 **product 模式**子代理（唯一 owner，声明见 architecture-design/SKILL.md「独立调用」扩展）。
 > **时序（P1）**：只写快照不写全局；change 关闭时 arch-merge 回写实际增量；迭代收尾快照标 `archived` 退役。
 
@@ -48,7 +48,7 @@
 | A5 | 与全局基线一致性（旧项目逆向重建产物 vs 现状代码） |
 | A6 | conventions 合规 |
 
-规则：≤3 轮修复循环 + 收敛检测（连续两轮不一致项不缩小 → 转人工）；PASS 才进 S4。
+规则：≤3 轮修复循环 + 收敛检测（连续两轮不一致项不缩小 → 转人工）；PASS 才进 S3（2026-08-19：ARCH 上移 S3 前，原"进 S4"）。
 **skip 时**：architecture-reviewer 不执行，但 skip 必须物化（iterations/vN/SKIPPED 标记 + 理由）。
 
 ### 复利捕获（Step 9，v0.36.3 复利链路修复）

package/skills/project-initialize/SKILL.md

@@ -0,0 +1,61 @@
+---
+name: project-initialize
+description: 项目初始化引导。工作空间代码服务为空时触发：识别需初始化 → 引导架构选择（glaf4 体系/前端分离/单体微服务/拆分）→ 服务命名确认 → 创建服务子目录 → 委托初始化骨架（glaf4 走 glaf4-dev PROJECT_INITIALIZE，非 glaf4 走内置引导）。
+---
+
+# Project Initialize（项目初始化引导）
+
+产品级初始化引导流程（v2.1 §6.5，2026-08-19 LT 定案）。工作空间代码服务为空时，引导用户完成架构决策、创建服务子目录并委托初始化骨架。
+
+## 触发条件
+
+由编排层 Pre-check 检测驱动（v2.1 §6.5 触发接入，评审 M2 补全）：
+- **场景①（orchestrator）**：需求迭代架构设计（ARCH）评审 PASS 后、S3 计划前——架构快照涉及服务未初始化
+- **场景②（workflow-start）**：change 阶段发现服务缺漏——AskUserQuestion 区分「未拉取」（git pull/检出后继续）vs「需要初始化」（引导本 skill）
+- **场景③（直接）**：工作空间代码服务为空（无服务子目录/技术栈特征），用户显式初始化
+
+## 流程（顺序执行）
+
+### Step 1 识别需初始化
+
+检测工作空间是否有服务子目录/技术栈特征；为空 → 进入引导。
+
+### Step 2 引导新会话
+
+提示用户启动新会话（干净上下文，避免与 change 工作流混杂）。参考 session-handoff 会话交接机制。
+
+### Step 3 架构选择（AskUserQuestion 逐项）
+
+1. **是否 glaf4 体系**？（影响委托路径——glaf4 走 glaf4-dev，非 glaf4 走内置引导）
+2. **是否前端分离**？（前后端独立目录 vs 合并）
+3. **单体 or 微服务**？
+4. **若微服务 → 拆分方式**？（按领域/按模块/按团队）
+
+决策树与判定依据见 `references/architecture-choice.md`。
+
+### Step 4 服务命名确认
+
+基于架构选择确定服务列表，AskUserQuestion 确认命名（禁止擅自命名）。
+
+### Step 5 创建服务子目录
+
+team-flow 创建空目录（如 `services/<svc>/`）+ `git init` + `.gitignore`（忽略 `.glaf4-dev/` 等运行期目录）。布局与命名规则见 `references/service-layout.md`。
+
+### Step 6 委托初始化
+
+- **glaf4 体系** → 委托 glaf4-dev PROJECT_INITIALIZE（进入空服务子目录初始化骨架）。协议见 `references/glaf4-initialize-delegation.md`
+- **非 glaf4** → workflow-bootstrap **B1.5 全新项目路径**（交互式技术栈选择 + 可选骨架生成，test-capability v1.0 §4.3）
+
+## Guardrails
+
+- 服务命名必须用户确认，不擅自命名
+- 不创建非空目录、不覆盖已有内容
+- glaf4 委托前置：glaf4-dev 已装 + JDK8 + 离线依赖就绪（见 reference）
+- **glaf4 委托前置风险（评审 B1）**：gen-service 空检查需对 `.git`/`.gitignore`/`.glaf4-dev` 白名单化——glaf4-dev v0.3.0 未实现前 glaf4 委托会 BLOCK（缓解与调时序见 reference）
+- 与 workflow-bootstrap 边界：本 skill 管**骨架生成引导**（含 B1.5 全新项目路径），bootstrap 管**既有项目侦察/基线**（职责分离）
+
+## 产出
+
+- 服务子目录（骨架工程）
+- `.gitignore`（忽略 `.glaf4-dev/`）
+- 委托记录（若 glaf4 委托，run 终局证据）

package/skills/project-initialize/references/architecture-choice.md

@@ -0,0 +1,55 @@
+# 架构选择决策树（project-initialize Step 3）
+
+> 设计来源：`docs/plan/glaf4-dev-integration-design.md` v2.1 §6.5（PROJECT_INITIALIZE 定案）
+> 用途：初始化引导时，逐项 AskUserQuestion 收集架构决策，确定服务列表与委托路径。
+
+## 决策维度（4 项，顺序执行）
+
+### 1. 是否 glaf4 体系？
+
+**判定依据**：团队技术栈是否基于 GLAF4 框架（Maven 依赖 `gtmc-glaf4-starter-parent`，包前缀 `com.gtmc.glaf4.framework.*`）。
+
+**影响**：
+- ✅ glaf4 → Step 6 委托 glaf4-dev PROJECT_INITIALIZE（骨架生成走 gen-service.py 六套模板）
+- ❌ 非 glaf4 → Step 6 workflow-bootstrap 内置引导（Java/JS/Python 技术栈选择）
+
+**判定**（AskUserQuestion）：
+- 是（GLAF4 框架体系）
+- 否（标准 Spring Boot / 其他技术栈）
+- 不确定 → 提示检查团队既有项目依赖，或选"否"走标准引导
+
+### 2. 是否前端分离？
+
+**判定**：业务是否有独立前端团队/部署单元。
+
+- 前后端分离 → 服务子目录拆为 `services/backend/` + `services/frontend/`（或独立 repo）
+- 合并（monolith 内嵌前端资源）→ 单服务目录
+
+### 3. 单体 or 微服务？
+
+**判定**：业务复杂度/团队规模/部署独立性需求。
+
+- 单体（monolith）→ 单服务，gen-service `--type monolith`
+- 微服务 → 进入维度 4（拆分）
+
+### 4. 微服务拆分方式？
+
+| 拆分维度 | 依据 | 例 |
+|---|---|---|
+| 按领域（DDD） | 业务域边界清晰，独立演进 | order/user/payment 服务 |
+| 按模块 | 技术模块独立部署 | gateway/backend/bff 服务 |
+| 按团队 | 团队自治部署 | 每团队一服务 |
+
+拆分结果 → 服务列表（每个服务一个子目录，命名走 Step 4 确认）。
+
+## 服务列表推导
+
+```
+单体 + glaf4        → [backend]（monolith）
+单体 + 非 glaf4     → [backend]（标准技术栈）
+单体 + 前端分离     → [backend(monolith), frontend]
+微服务 + glaf4      → [<svc1>, <svc2>, ...]（按拆分维度）
+微服务 + 前端分离   → [<svc1>, ..., frontend]
+```
+
+服务列表进入 Step 4 命名确认。

package/skills/project-initialize/references/glaf4-initialize-delegation.md

@@ -0,0 +1,55 @@
+# glaf4-dev PROJECT_INITIALIZE 委托协议（project-initialize Step 6）
+
+> 设计来源：`docs/plan/glaf4-dev-integration-design.md` v2.1 §6.5（2026-08-19 定案）
+> 用途：glaf4 体系服务子目录创建后，委托 glaf4-dev 初始化骨架。
+
+## 前置（实证就绪，2026-08-19）
+
+| 前置 | 状态 | 验证 |
+|---|---|---|
+| glaf4-dev 插件已装 | ✅ | `~/.claude/plugins/installed_plugins.json` 有 glaf4-dev v0.3.0 |
+| JDK 8 | ✅ | 本机 jdk-1.8.jdk（1.8.0_411）+ Corretto 8；flow 要求 JDK8（模板 1.8 + 旧 Lombok） |
+| 离线 Maven 依赖 | ✅ | 本地 `~/.m2/repository/com/gtmc/` 有 gtmc-glaf4-starter-parent；编译走 `--offline` |
+| 服务子目录为空 | ✅ | Step 5 team-flow 创建空目录 + git init + .gitignore |
+
+## 委托流程
+
+```text
+1. 确认前置（上表）
+2. 调 glaf4-dev 统一入口（mode_hint=PROJECT_INITIALIZE）
+   → 路由到 PROJECT_INITIALIZE 七模式流：
+     inspect → plan → scaffold → test-bootstrap → smoke-green → validate
+3. run 终局 PASS → 骨架工程落地服务子目录
+4. 证据回灌（可选）：glaf4-evidence-export → test record（骨架基线测试）
+```
+
+## gen-service 空目录冲突（实证 + 缓解）
+
+**实证（2026-08-19）**：flow scaffold 写死 `gen-service.py --out <target_root>`，而 run 树 `.glaf4-dev/runs/` 先建在 target_root 下 → gen-service 空检查 `os.listdir` 非空 → **BLOCKED**（`out dir not empty`）。
+
+**非空来源（评审 B1 补全，2026-08-19）**：gen-service 空检查 `os.listdir` **无任何隐藏文件过滤**，以下三类都会触发 BLOCK：
+1. `.glaf4-dev/`（run 树，glaf4-dev 自建基础设施）
+2. `.git/`（Step 5 `git init` 产生）
+3. `.gitignore`（Step 5 写入）
+
+**缓解**：gen-service 空检查需对 `.git`/`.gitignore`/`.glaf4-dev` 三类基础设施条目**白名单化**（run 树与 git 元数据非工程内容）；**或调时序**——先对真空目录跑 gen-service（此时仅 run 树在，`.git` 未建），完成骨架后再 `git init` + `.gitignore`，且 gen-service 至少容忍 `.glaf4-dev`。**glaf4-dev v0.3.0 未实现白名单化前，glaf4 委托会 BLOCK**（SKILL Guardrails 已标注此前置风险）。
+
+**run 树位置（LT 决策 2026-08-19）**：不设专门外置方案——run 树在 target_root 是 glaf4-dev 统一约定，`.glaf4-dev/` 由 `.gitignore` 忽略，非关键路径。
+
+## gen-service 参数（scaffold 调用）
+
+```bash
+python3 <plugin-root>/scripts/gen-service.py \
+  --type <monolith|agg|infra|gateway|bff-backend|bff-open> \
+  --domain <业务域> --name <服务名> --out <服务子目录>
+```
+
+- `--type/--domain/--name/--out` 必填（gen-service.py L182-185）
+- 六种服务类型对应 templates/ 下模板树
+- 骨架含 pom.xml（引用 `gtmc-glaf4-starter-parent`）+ src + 资源，≈90+ 文件（monolith/infra 92、agg 68、bff-backend 48、bff-open 40、gateway 11）
+
+## 边界
+
+- **本协议只委托骨架生成**：业务代码（Controller/Service/Repository 等）走后续 change 级委托（FEATURE_TDD 等）
+- 委托失败 → run 终局 FAIL/BLOCKED → 恢复路径（重试/降级/转人工）
+- 与 workflow-bootstrap 边界：本协议管 glaf4 骨架，workflow-bootstrap 管既有项目侦察/基线

package/skills/project-initialize/references/service-layout.md

@@ -0,0 +1,63 @@
+# 服务子目录布局与命名（project-initialize Step 4/5）
+
+> 设计来源：`docs/plan/glaf4-dev-integration-design.md` v2.1 §6.5（PROJECT_INITIALIZE 定案）
+
+## 目录布局约定
+
+```
+<workspace>/
+├── services/               # 服务容器（微服务/多服务）
+│   ├── <svc>/              # 每个服务一个子目录（Step 5 创建）
+│   │   ├── .gitignore
+│   │   └── （骨架，委托初始化后）
+│   └── ...
+├── docs/                   # 工作空间文档
+└── .team-flow/             # team-flow 项目状态
+```
+
+- **单体**：可直接在 `<workspace>/` 根或 `services/<svc>/` 下建
+- **微服务/多服务**：统一 `services/<svc>/` 容器，每服务独立子目录 + 独立 git
+
+## 命名规则
+
+- **kebab-case**（小写 + 连字符），如 `order-service`、`user-backend`
+- 语义：业务域 + 服务类型（`<domain>-<type>`），如 `order-backend`、`bff-open`
+- **必须用户确认**（Step 4 AskUserQuestion），禁止擅自命名
+
+## .gitignore 模板（Step 5 写入）
+
+```gitignore
+# team-flow / glaf4-dev 运行期基础设施
+.team-flow/
+.glaf4-dev/
+
+# 构建产物
+target/
+build/
+.gradle/
+
+# IDE
+.idea/
+.vscode/
+*.iml
+
+# OS
+.DS_Store
+
+# Node（前端分离场景）
+node_modules/
+dist/
+```
+
+> `.glaf4-dev/` 是 glaf4-dev 的 run 树（运行期基础设施，RUNS_REL 约定），必须 gitignore 避免污染版本库（v2.1 §6.5 实证：run 树在 target_root 下，不忽略会被 git add 跟踪）。
+
+## 创建动作（Step 5）
+
+```bash
+mkdir -p services/<svc>
+cd services/<svc>
+git init
+# 写入 .gitignore（如上模板）
+```
+
+创建后确认空目录 + git init + .gitignore 就绪，再进入 Step 6 委托。

package/skills/workflow-bootstrap/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: workflow-bootstrap
-description: 既有项目接入初始化器。在首次使用 team-flow 时执行一次性"侦察 + 基线建立"：代码库侦察 → 架构基线文档化 → 领域词汇提取 → 目录初始化 → 路径判断。完成后进入 workflow-orchestrator。不适用于：全新项目（无代码库，直接用 workflow-orchestrator）、已建立基线的项目（baseline.md 已存在）。
+description: 既有项目接入初始化器。在首次使用 team-flow 时执行一次性"侦察 + 基线建立"：代码库侦察 → 架构基线文档化 → 领域词汇提取 → 目录初始化 → 路径判断。完成后进入 workflow-orchestrator。不适用于：全新项目（无代码库，直接用 workflow-orchestrator）、已建立基线的项目（baseline.md 已存在）。B1.5 提供全新项目骨架引导（交互式技术栈选择 + 可选骨架生成，被 project-initialize 非 glaf4 分支委托，2026-08-19）。
 ---
 
 # Workflow Bootstrap（既有项目接入初始化器，v0.6 新增）

package/skills/workflow-orchestrator/SKILL.md

@@ -68,23 +68,29 @@ prd_draft → user_review → prototype_loop → prd_frozen → completed
 
 调用 `/ce-brainstorm`（mode: orchestrated）产出 PRD 草稿；**冻结前派 `prd-completeness-reviewer` 子代理做 PRD 完整性评审**（v0.15.0，管"说得全不全"）；原型循环由编排层直接编排（prototype skill 内部编排产出 → prototype-reviewer 自动评审 → 人工评审 → 冻结）；冻结语义为 `frozen_downstream`（迭代内变更不升版）。反馈环路检查点：scope 是否合理。详见 `references/s2-prd-prototype-loop.md`。
 
-### S3: 计划阶段
-**入口一次性问定计划模式**（业务/一人公司），调用 `/ce-plan`（`pipeline_mode: orchestrator` + `plan_mode: business|solo`，跳过仪式开销、保留 repo research + change splitting + 依赖 DAG + 技术方向）产出 `requirement/vN/plan.md`。plan 只到产品级策略 + 高阶技术设计，**不含接口清单**（属各 change 的 spec-writer）。反馈环路检查点：plan 是否暴露 PRD scope 问题（是→回退 S2）。详见 `references/s3-plan-pipeline.md`。完成条件：plan.md 产出 + S3 状态 = completed，**下一步进 ARCH**（v0.36.0）。
-
-### ARCH: 产品级架构设计（v0.36.0 新增，S3 之后、S4 之前）
+### ARCH: 产品级架构设计（v0.36.0 新增；2026-08-19 LT 调整上移 S3 前——S3 计划/S4 拆分是最终任务拆分，须基于架构）
 
 **⛔ MANDATORY：执行 ARCH 阶段前，必须先读取 `references/state-model.md`「architecture 阶段」+ `architecture-design/references/s3.5-product-architecture.md`**
 
-产品级架构设计：基于迭代版本 vN 产出覆盖所有模块的整体详细架构（预测态快照，P1：只写快照不写全局）。
+产品级架构设计：基于迭代版本 vN 产出覆盖所有模块的整体详细架构（预测态快照，P1：只写快照不写全局）。**ARCH 在 S3 之前**——计划（S3）与拆分（S4）是最终任务拆分，必须基于架构定稿（聚合/服务/模块）进行。
 
 **场景判定（入口三态）**：全新项目 → 正向设计（首轮不可跳过）；旧项目首轮（`arch_baseline` 缺失）→ 逆向重建 L0 骨架 → 渐进深化；已建档 + 迭代无结构性变更 → 跳过（**skip 必须物化**：写 `docs/architecture/iterations/vN/SKIPPED` 标记 + 理由，判定者=编排器+用户确认）。
 
 **执行**：调用 architecture-design skill 的 **product 模式**子代理（8 步设计：限界上下文/聚合注册表/指令事件/状态机/概念 ER/时序），产出 `docs/architecture/iterations/vN/architecture.md`（6 产物，provenance 标注）。
 
-**评审门**：产出经 architecture-reviewer product 视角（`review_mode: product`，A1-A6）评审，**PASS 才进 S4**。
+**评审门**：产出经 architecture-reviewer product 视角（`review_mode: product`，A1-A6）评审，**PASS 才进 S3**。
 
 **输出契约**：`docs/architecture/iterations/vN/architecture.md` + 评审 verdict；`orchestrator.yaml` 中 ARCH phase 状态 = completed（`workflow_phase: architecture`）。**首轮项目（`arch_baseline` 缺失）评审 PASS 后执行 `tf arch init --mode reconstruction|design --baseline-ref requirement/vN/` 打戳**（v0.36.3）——arch 门禁豁免键由此建立，项目进入「已建档」正轨。
 
+**ARCH 后 Pre-check：服务初始化检测（v0.45.0 project-initialize 触发接入，场景①）**：评审 PASS 后、S3 计划前，检查架构设计涉及的服务是否已初始化——
+1. 从 `docs/architecture/iterations/vN/architecture.md`（聚合注册表/服务列表）提取本次迭代涉及的服务
+2. 检查工作空间是否有对应服务子目录 + 技术栈特征（pom.xml/package.json 等）
+3. 缺漏服务 → 提示用户：「架构设计涉及服务 X/Y/Z 尚未初始化，需要初始化对应项目代码吗？」确认后引导执行 `project-initialize` skill（架构选择 → 服务命名确认 → 创建空服务子目录 → 委托初始化）
+4. 已存在（未拉取）→ 提示用户 git pull/检出对应服务
+
+### S3: 计划阶段
+**入口一次性问定计划模式**（业务/一人公司），调用 `/ce-plan`（`pipeline_mode: orchestrator` + `plan_mode: business|solo`，跳过仪式开销、保留 repo research + change splitting + 依赖 DAG + 技术方向）产出 `requirement/vN/plan.md`。plan 只到产品级策略 + 高阶技术设计，**不含接口清单**（属各 change 的 spec-writer）。**S3 在 ARCH 之后**——基于架构定稿（聚合/服务/模块）做计划与拆分（2026-08-19 LT 调整）。反馈环路检查点：plan 是否暴露 PRD scope 问题（是→回退 S2）。详见 `references/s3-plan-pipeline.md`。完成条件：plan.md 产出 + S3 状态 = completed，**下一步进 S4**。
+
 ### S4: 拆分验证与分发
 
 **⛔ MANDATORY：执行S4阶段前，必须先读取 `references/s4-split-validate.md`**

package/skills/workflow-orchestrator/references/s3-plan-pipeline.md

@@ -42,10 +42,10 @@ ce-plan 在 orchestrator pipeline 上下文中减少仪式开销，但**保留
 
 - plan 是否暴露了 PRD 的范围问题？
   - **是** → 回退 S2，触发 PRD vN 内修订（记录变更原因）。详见 feedback-loops.md「S3 → S2」
-  - **否** → 进 ARCH（architecture 阶段，v0.35.0 产品级架构设计，见 state-model.md「architecture 阶段」）
+  - **否** → 完成 S3，进 S4（2026-08-19：ARCH 已上移 S3 前完成，S3 基于架构定稿——见 state-model.md「architecture 阶段」）
 
 ## 完成条件
 
 - `requirement/vN/plan.md` 已产出，含 change 拆分 + 依赖 DAG + 技术方向
 - `.team-flow/requirements/<req-id>/orchestrator.yaml` 中 S3 状态 = completed
-- 下一步：进入 ARCH 阶段，产出 `docs/architecture/iterations/vN/architecture.md` 后进 S4（v0.35.0）
+- 下一步：进 S4 拆分验证与分发（ARCH 已在 S3 前完成，产出 `docs/architecture/iterations/vN/architecture.md`，2026-08-19）

package/skills/workflow-orchestrator/references/s4-split-validate.md

@@ -20,7 +20,7 @@
 
 进入拆分前先校验：
 
-- **项目 arch_baseline 缺失（存量/重建未完成）** → WARN 不阻断（reason: 'project architecture baseline not established — S3.5 reconstruction pending'），提示先跑 S3.5 重建产出 L0 骨架。
+- **项目 arch_baseline 缺失（存量/重建未完成）** → WARN 不阻断（reason: 'project architecture baseline not established — ARCH reconstruction pending'），提示先跑 ARCH（原名 S3.5）重建产出 L0 骨架。
 - **已建档项目** → 校验 `docs/architecture/iterations/vN/architecture.md` 存在且覆盖 plan.md 各 change 触及的全部 BC。不覆盖 → FAIL，回退 ARCH 阶段补快照（feedback-loops.md「S4 → ARCH」）。
 - **skip 物化**：ARCH 阶段显式跳过（iterations/vN/ 占位含 skipped 标记 + 理由）→ PASS。
 

package/skills/workflow-orchestrator/references/state-model.md

@@ -76,7 +76,7 @@ prd_version: v1                       # PRD 版本
 
 ## architecture 阶段（S3.5，v0.35.0 新增）
 
-> 产品级架构设计阶段，位于 S3 计划之后、S4 拆分之前。设计依据：设计增强方案 v0.14 §59。
+> 产品级架构设计阶段。**2026-08-19 调整：位于 S2 之后、S3 计划之前**（ARCH 上移，S3 计划/S4 拆分是最终任务拆分须基于架构；原" S3 计划之后、S4 拆分之前"历史位置）。设计依据：设计增强方案 v0.14 §59。
 
 **phase id**：`ARCH`；顶层 `workflow_phase: architecture`（语义 kebab-case）。
 **命名约定**：新阶段一律用 kebab-case 语义名（历史值保留不迁移，避免无价值 churn）。
@@ -110,7 +110,7 @@ phases:
 **门禁**（v0.14 §59.4）：
 | 门禁 | 挂点 | 校验 | 豁免 |
 |------|------|------|------|
-| 产品级评审门 | ARCH→S4 | architecture-reviewer product 视角 PASS | skip 时仍要物化标记 |
+| 产品级评审门 | ARCH→S3（2026-08-19：ARCH 上移 S3 前，原 ARCH→S4） | architecture-reviewer product 视角 PASS | skip 时仍要物化标记 |
 | arch-readiness | exploring:specifying（guard 存在性）+ S4 拆分（LLM 覆盖校验） | iterations/vN/ 快照覆盖 change 触及的 BC | arch_baseline 缺失 → WARN 不 FAIL |
 | arch-snapshot | executing→closing | 本轮快照已落盘 | 在途 change legacy 豁免 |
 

package/skills/workflow-start/SKILL.md

@@ -90,6 +90,12 @@ Guard: `tf runtime guard check <dir> exploring specifying --json` → fail = BLO
 ### Route to contract-builder (dispatch sub-agent)
 Guard: `... check <dir> specifying bridging --json` → fail = BLOCK. Artifacts exist, implementation requested, contract missing/stale. Include `DP-3: 契约批准`. **full workflow 必产 test-matrix.md（v0.13 §52 B1）**：契约 `## Test Matrix` 段 + 非空矩阵文件 + `tf state rebuild` 捕获 hash；确无测试需求只能显式 skip + 理由（`test_matrix_skipped=true` + `test_matrix_skip_reason`）。GLAF4 Java 项目实施委托（glaf4-dev）与矩阵工具选择见 `references/routing-rules.md`「Route to glaf4-dev 实施委托」。
 
+### Route 前 Pre-check：服务缺漏检测（v0.45.0 project-initialize 触发接入，场景②；位置 = contract-builder 后、DP-4 前）
+
+dispatch build-executor 前，检查 change 涉及的服务是否在工作空间存在：从 design.md/specs 涉及的 target 类提取所属服务，检查服务子目录 + 技术栈特征（pom.xml/package.json 等）。**缺漏 → AskUserQuestion 确认**：
+- **「未拉取」**：服务已存在于远端/其他分支 → 提示 git pull/检出对应服务后继续
+- **「需要初始化」**：全新服务 → 引导 `project-initialize` skill（架构选择 → 服务命名确认 → 创建空服务子目录 → 委托初始化骨架），完成后回 change 继续
+
 ### Route to build-executor (dispatch sub-agent)
 Contract exists and approved, contract matches artifacts. Include `DP-4: 执行模式选择`: propose waves, run `tf execution recommend <change-dir> [--wave ...]`, show the user every available mode plus evidence and the recommendation, then obtain a clear selection. The command saves a current receipt; before the first implementation edit, `build-executor` must run `tf execution plan <change-dir> --mode <selected> --confirm ...` (and `--acknowledge-recommendation` when the selected mode differs from the recommendation) using matching artifacts, contract, and waves, then `tf execution show <change-dir> --json`; report the saved revision, selected mode, recommendation alignment, ordered waves, and actual concurrent-dispatch capability. A revision must repeat recommend and confirmation. Do not transition to `executing` until `show` reports `current: true`; then run `... check <dir> approved-for-build executing --json` → fail = BLOCK. **v0.13 §49 门禁前移**：该 guard 含 `test-matrix-ready` 维度——full 模式非存量 change 必须"带着矩阵开工"（矩阵存在非空 OR 显式 skip 附理由）；FAIL 时回 bridging 让 contract-builder 补矩阵，或按指引显式 skip，禁止绕过。